=== Tutor LMS Mobile ===
Contributors: lazycoders, nmkhan, phpfour, rbraju3m, nadimleads, nusrat001, tanjilalom
Donate link: https://lazycoders.co/
Tags: tutor lms, mobile app, online courses, elearning, lms app
Requires at least: 6.2
Tested up to: 7.1
Stable tag: 0.9.37
Requires PHP: 7.4
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Turn your Tutor LMS website into a native iOS and Android learning app. Install, connect, and your students can start learning on mobile.

== Description ==

### 🎓 The Official Mobile App for Tutor LMS

**Give your students a native iOS and Android learning experience** — without hiring mobile developers, writing a single line of code, or paying monthly SaaS fees.

The Tutor LMS Mobile App plugin connects your WordPress + Tutor LMS site to a beautiful, fully-featured native mobile app. Courses, lessons, quizzes, progress, and student activity all sync in real time between your website and the app over a secure REST API.

Whether you're running an **online academy**, **coaching business**, **corporate training portal**, or **skill marketplace**, this plugin gives your learners a premium mobile experience.

👉 Official Website: [Tutor LMS Mobile App](https://lazycoders.co/tutor-lms-mobile/)
👉 Get Support: [Support](https://www.lazycoders.co/support/)
👉 Documentation: [User Guide](https://lazycoders.co/docs/)

---

### 🎯 Why a Dedicated Mobile App?

Web-only Tutor LMS sites lose learners to:

* Distracting browser tabs and notifications
* Poor mobile UX from non-responsive themes
* No app icon on the home screen — out of sight, out of mind
* No native video performance

A dedicated mobile app puts your academy on every student's home screen, with the speed, polish, and reach that only native apps deliver.

---

### ✅ What This Plugin Does

* **Connects your Tutor LMS site to the native mobile app** — flip one switch in WP Admin to expose the mobile API
* **Syncs every course, lesson, quiz, and student** — no duplicate data, no manual export
* **Unified student progress** — learners switch between web and mobile without losing their place
* **Real-time content updates** — publish a new course on the web, it appears in the app instantly
* **One-click member onboarding** — email every member a connection QR code straight from your dashboard

---

### 📱 Mobile App Features

The app surfaces your Tutor LMS content through the plugin's REST API:

**Course Catalog**
Browse all published courses with filtering by category and sorting (newest, oldest, A–Z, Z–A). Beautiful course cards with featured images and instructor info.

**Course Categories**
Full course-category navigation, including nested categories, search, and counts.

**Course Details Page**
Full curriculum view with sections, lessons, quizzes, and previewable content. Requirements, what-you-will-learn, materials, and target-audience sections — all dynamic.

**Video Lesson Player**
Native video playback for self-hosted, YouTube, Vimeo, and embedded video sources, with lesson-completion tracking.

**Quizzes**
Quiz attempts with per-question answer submission, attempt results, and a per-question attempt breakdown. Timer, attempts, and pass marks are all respected.

**Course Progress Tracking**
Real-time completion percentage per course, lesson-completion marking, mark-course-complete, and a course retake/reset flow.

**Student Dashboard**
"My Courses" filtered by enrolled, active (in-progress), or completed — plus wishlist, all paginated.

**Wishlist**
Add or remove any course from a personal wishlist and browse it from the dashboard.

**Course Q&A**
Students can post questions on a course and reply within threads — without leaving the app.

**Course Reviews & Ratings**
View star ratings and submit a 1–5 star review with comments after enrolling.

**Instructor Profile**
Instructor bio, course list, student counts, and rating breakdown — fully dynamic.

**Enrollment**
One-tap enrollment for free courses, with progress immediately synced back to your WordPress site.

---

### 🔜 Coming Soon

* Tutor LMS Pro features (Drip content, Prerequisites, Course Bundle, Multi-instructor, Assignments, Gradebook)
* Paid-course checkout (WooCommerce / Easy Digital Downloads)
* Announcements and certificates in-app
* Offline lesson download
* Push notifications
* Live class integration (Zoom, Google Meet, Jitsi)
* In-app messaging between students and instructors
* Dark mode

---

### 💼 Perfect For

**Online Academies** – Launch a branded learning app without hiring mobile developers.

**Coaches & Course Creators** – Give your students a premium, distraction-free mobile experience.

**Corporate Training Teams** – Roll out internal training on iOS and Android from your existing Tutor LMS portal.

**Schools & Universities** – Extend your Tutor LMS classrooms beyond the browser with a dedicated mobile app.

**Skill Marketplaces** – Run a multi-instructor course marketplace with a native app experience.

**Agencies & Freelancers** – Offer mobile learning apps as a deliverable. One dashboard, one client handoff.

---

### 🔗 Privacy & Data

This plugin connects your WordPress site to the mobile app via a secure REST API. All course data, student progress, and authentication remain on **your** WordPress database — we never store learner data on external servers.

* [Support Policy](https://lazycoders.co/support-policy/)
* [Privacy Policy](https://lazycoders.co/privacy-policy/)

== Screenshots ==

1. Overview – Connect your site and invite members from WP Admin
2. Settings – Enable the mobile API with a single toggle
3. Course Catalog in the App – Beautiful course cards on mobile
4. Course Details – Full curriculum with sections and lessons
5. Video Lesson Player – Native playback with progress tracking
6. Student Dashboard – My Courses, Wishlist, and progress
7. Quiz Experience – Mobile-optimized quiz attempts and results

== Installation ==

**Requirements:** The free Tutor LMS plugin must be installed and activated first.

1. Upload the `tutor-lms-mobile` folder to `/wp-content/plugins/`, or install it via **Plugins → Add New**.
2. Activate the plugin through the **Plugins** menu.
3. Go to **WP Admin → Tutor LMS Mobile → Settings** and set **Enable Tutor LMS Mobile** to **Yes** to switch on the mobile API.
4. On the **Tutor LMS Mobile → Overview** page, enter your license key and click **Activate** to connect your site.
5. (Optional) Choose who can see the app-download button (everyone, logged-in users, or no one) and save.
6. Use **Email all members** to send every registered user the download links and a connection QR code.

**Get Your Students on Mobile in 5 Minutes:**

1. Install and activate the plugin, then enable the mobile API.
2. Activate your license to connect the site.
3. Download the app and scan the connection QR code to link it to your site.
4. Test course browsing, video playback, and the quiz flow on your phone.
5. Request your branded build to publish on the App Store and Google Play.

== Frequently Asked Questions ==

= Do I need coding skills to use this plugin? =
No. If you can install a WordPress plugin and use Tutor LMS, you can run this mobile app — no coding required at any step.

= Do I need Tutor LMS Pro? =
No — the plugin works fully with the free Tutor LMS plugin. Tutor LMS Pro features (drip content, prerequisites, assignments, multi-instructor, gradebook) are on our roadmap.

= How do students connect the app to my site? =
After installing the app, students scan the connection QR code shown in your WP Admin (or in the invitation email you send) to link the app to your site. You can email this QR code to every member with one click from the Overview page.

= How is course and student data kept in sync? =
Tutor LMS stores everything on your WordPress database, and the app reads and writes through this plugin's secure REST API. Students can switch between web and mobile without losing their place.

= Does it support video lessons from YouTube, Vimeo, and self-hosted sources? =
Yes. All video sources supported by Tutor LMS — self-hosted, YouTube, Vimeo, external URL, embedded — play natively inside the app.

= Are quizzes supported? =
Yes. Students can take quiz attempts, submit answers per question, and view their attempt results and a per-question breakdown inside the app.

= Can I control who sees the app download button? =
Yes. From the Overview page you can show the download button to everyone, only logged-in users, or no one.

= How do I publish to the App Store and Google Play? =
We provide a branded build of the app under your own developer account. You get the App Store and Google Play listings under your brand, with our team guiding submission.

= Where is my course and student data stored? =
On your own WordPress site — same as before. The mobile app reads from your site via a secure REST API. We do not store learner data on external servers.

= What if I need help? =
Our support team is ready to assist. Visit our [helpdesk](https://www.lazycoders.co/support/) for documentation, guides, and direct support.

== Changelog ==

= 0.9.37 (November 3, 2026) =

* Added: Course Prerequisites support — a Course Prerequisite(s) card on the Info tab, with a tick on each finished course
* Added: Prerequisite course titles open the course, as on web
* Added: Lessons, quizzes & assignments locked until prerequisites are done, with Back to course
* Added: Gradebook support — a Gradebook tab for enrolled students
* Added: Final grade in the grade's colour, with points when the site shows them
* Added: Graded quizzes & assignments listed under a Title / Total Grade / Result header; titles open the item
* Added: "No grading system found" & "No Gradebook Data" states as on web
* Added: Course Bundle support — bundle cards on Home with the course-count pill & sale ribbon
* Added: All / Course / Bundle filter when the site's Course Filter is on
* Added: Bundle page — About, What Will You Learn, Courses in the Bundle, totals & instructors
* Added: Course, author, category & instructor names on the bundle page open as links
* Added: Enroll Now on a free bundle enrols you in every course, then shows Bundle Progress
* Added: Paid bundles go into the cart as one item, with View Cart & Buy Now
* Added: Enrollment validity line on the bundle page
* Added: Enrolled bundles as one card in My Courses, with progress & their courses inside
* Added: Notifications support — a bell with the unread count on Home & Dashboard, updating by itself
* Added: Notifications inbox with All / Unread tabs & Mark all as read beside them
* Added: Tapping a notification opens its course, announcement, Q&A, quiz or assignment
* Added: Newest notification shown as a banner on Home, as on web
* Added: Push notifications for the events the site turns on
* Added: On-site & push notification boxes on New / Edit Announcement
* Added: Course search in the app bar on Category & My Courses
* Added: "How would you rate this course?" pop-up after Complete Course
* Added: Uncategorized chip on Category & My Courses
* Improved: Supports PHP 7.4 to 8.5, the latest versions
* Improved: Scroll hint (fade & ‹ › arrows) on the course tab row
* Improved: Assignment marks card matches web — order, icons & two-decimal marks
* Improved: Profile → Certificates page matches web
* Improved: Loading spinner while a certificate loads
* Improved: "Finish Course Early?" dialog matches web
* Improved: Plain hint in the Profile phone number field
* Fixed: Matching, Image Matching, Image Answering, Ordering & old Single Choice questions showing only a text box
* Fixed: Skipped quiz questions left out of the total, so a quiz could pass on 1 answer
* Fixed: Required quiz questions could be skipped on submit
* Fixed: Resubmit offered while a resubmission was still pending review
* Fixed: Failed assignment showing Continue Assignment instead of Resubmit after going back
* Fixed: Instructors & admins seeing no student questions in Discussions
* Fixed: Empty My Courses returning a "No courses found" error
* Fixed: Resources tab missing on courses with no files
* Fixed: Quiz not going back to the lesson after "Yes, leave quiz"
* Fixed: Empty gap under the course tab row
* Fixed: Passed badge & › arrow not reaching the edge of the quiz attempt card

= 0.9.11 (October 20, 2026) =

* Added: Course Preview support — free preview lessons open for guests & students not enrolled
* Added: Exercise files & comments on free preview lessons, as on web
* Added: Lesson Notes tab — write, edit, delete & filter notes
* Added: Take Note button, with the video time stamped on video lessons
* Added: Multi Instructors support — every instructor listed, author first, names linked to profiles
* Added: Certificate support — "Certificate of completion" on courses & View Certificate once complete
* Added: Certificates list in Profile & a certificate page matching web (image & details)
* Added: Download Certificate as PDF, plus Share & Copy link
* Added: Download Certificate button on completed course cards
* Added: Course completes itself after the last lesson when auto-complete is on
* Added: Content Drip support — lessons unlock by date, days after enrollment, in order or after prerequisites
* Added: Drip lock screens matching web, with Continue Previous Lesson & prerequisite links
* Added: Earned Grade, Total Attempts & Retry Quiz after failing a pass-required quiz
* Added: Enrollment support — seat limits, enrollment period, pause & expiry
* Added: Closed, paused, not-yet-open & full notices on cards & course pages, with dates & times
* Added: Enrollment validity & closing date on the course page
* Added: Expired & Unpaid enrollments shown as on web
* Added: Server-side enrollment checks for full, closed & paused courses
* Added: Assignments support — overview with marks, attempts, duration & deadline, then Start Assignment
* Added: Assignment submit page with a rich-text answer & file attachments (formats & limits shown)
* Added: Assignment attempts table with Pending / Passed / Failed & earned marks
* Added: Edit a pending attempt; Details page with your submission & instructor feedback
* Added: Assignments list in Profile
* Added: Complete the Course button on lessons, quizzes & assignments
* Added: Scroll hint (fade & › arrow) on the lesson tab row
* Improved: Add to Cart stays on the page & switches to View Cart
* Improved: Saved popup after a download, with View to open the file
* Improved: Lesson comment box matches web
* Improved: Copy icon beside the app version on the Add Site screen
* Fixed: Guests able to load paid lesson content through the API
* Fixed: WordPress Plugin Check errors
* Fixed: Enroll Course on a course card enrolling at once instead of opening the course
* Fixed: Course card still showing Enroll Course & 0 enrolled after enrolling
* Fixed: Reviews tab missing on paid courses
* Fixed: Course Progress card shown to students not enrolled
* Fixed: Continue Lesson on Quiz Summary hidden under the navigation bar
* Fixed: Previous / Next bar rising above the keyboard while typing
* Fixed: Downloading a file again overwriting the earlier copy
* Fixed: Downloads saved to Documents instead of Download on Android

= 0.7.77 (October 1, 2026) =

* Added: Quiz Summary after each attempt, as on web (score ring, time taken of the limit, pass marks, answer review)
* Added: "Quiz Submitted" popup with View Results after submitting a quiz
* Added: "Times up!" popup that ends the quiz when the timer runs out
* Added: "Starting Quiz in" countdown for quizzes with auto start on
* Added: Quiz pagination in Shapes, Numbers or Radio style
* Added: Full Page quiz layout with every question on one page & a single Submit
* Added: App version shown on the Switch Site page
* Improved: Quiz page shows course progress & Retake this Course
* Improved: Hide question number setting followed during quizzes
* Improved: Back arrow hidden once a quiz starts; phone Back asks before leaving
* Improved: Q&A question view matches web, with Newest / Oldest reply sort
* Improved: Live build shows only the version number in the side menu
* Fixed: Skip Question missing on the first question
* Fixed: Earned Grade missing after failed attempts (follows the final grade setting)
* Fixed: Unfinished attempts showing In progress with no result, time or marks
* Fixed: Quitting a quiz opening the Quiz Summary instead of the quiz page
* Fixed: Edited pending review disappearing from Profile → Reviews

= 0.7.43 (September 20, 2026) =

* Added: Lesson comments for students & admins
* Added: Student profile pages, opened from names in Reviews, Q&A & comments
* Added: Review popup after finishing a course, whether the last item is a lesson or a quiz
* Added: Guest browsing of public courses, previewable lessons & course details
* Added: Buy Now & View Cart buttons that follow the Tutor LMS checkout settings
* Added: Retake Course from the lesson details page, with its own popup
* Added: Full-screen view for course & lesson featured images
* Added: Lesson video duration & section description info icon in Course Content
* Added: Reload option on the lesson details page
* Improved: Course pages follow Tutor LMS Page Features settings (Instructor Info, Wishlist, Q&A, Author, Level, Share, Total Enrolled, About & more)
* Improved: Course sorting & instructor profile links follow Tutor LMS settings
* Improved: Lessons, reviews, Q&A & Announcements locked until enrollment, as on web
* Improved: Q&A shows every student's question with name, avatar & Reply, on the course & in Profile
* Improved: Pending reviews shown to their author on the course & in Profile
* Improved: Quiz info, question & result pages match web (Total Marks, Next, Quit, Retry Quiz)
* Improved: Profile area regrouped to match the web dashboard
* Improved: Course cards & details match web (price & rating decimals, byline, category, enrolled count, placeholder image, empty states)
* Improved: Free courses drop the Free tag for a full-width Enroll button
* Improved: App settings changes apply on reload, no re-login needed
* Improved: Sign-in icon in the app bar when logged out & placeholder text on login fields
* Improved: Long lesson titles can be viewed in full
* Improved: Removed the preset LazyCoders.co site from the site list
* Improved: Notification permission prompt hidden until push notifications ship
* Fixed: Course Progress card & Start / Continue / Complete / Retake buttons showing the wrong state
* Fixed: Complete Course & Retake not updating course progress
* Fixed: Continue Learning & lesson Next not opening the next lesson (Finish button added)
* Fixed: Submitting a review doing nothing
* Fixed: Error when a course's first topic is a quiz
* Fixed: Abandoned quiz attempt blocking retakes
* Fixed: Bookmarks changed on web not syncing to the app
* Fixed: Shortcode videos not playing & raw [video]/[audio] shortcodes in lessons
* Fixed: Wrong video thumbnails, duplicate play buttons & missing YouTube controls on intro videos
* Fixed: Google login button missing from the login page
* Fixed: Site connect & switch-site issues (extra URL slug, wrong landing page, no remove confirmation, missing back option, drawer icon doing nothing)
* Fixed: App reopening on the QR scan page & drawer showing the previous user's name after logout
* Fixed: Back button & bottom content overlapping the screen edges on course details

= 0.7.27 (August 10, 2026) =

* Added: Sign in with Google from the login page
* Added: Sign in with a one-time password (OTP)
* Added: License key activation inside the app
* Added: Automatic app version check
* Fixed: Phone number marked as required in Profile Settings when it is not required on the web
* Fixed: Navigation drawer bottom slipping under the device safe area

= 0.7.15 (July 19, 2026) =

* Added: Categories, Bookmark & Share options on the course details page
* Added: Q&A posting for admins & assigned instructors on course details
* Added: Course progress bar, completed-lesson count & tab counts on My Courses
* Added: Course ratings on wishlist cards
* Added: Delete option for the profile cover photo
* Improved: Q&A & Announcement tabs now shown by role (superadmin & course-author instructor only)
* Improved: "Continue" button shown instead of "Start Learning" for in-progress courses
* Improved: Course-content topic details bottom sheet now scrolls and has a close button
* Improved: "Course Progress" title hidden when there is no progress bar
* Improved: Reviews tab shows a "No review found" message when empty
* Improved: Removed the unnecessary reload icon from the course details page
* Improved: Dashboard cards now share the same alignment
* Improved: Removed the bookmark icon from My Courses cards
* Fixed: Submitting a course review not working
* Fixed: Instructor page not showing the latest course
* Fixed: Course instructor not clickable on the course details page
* Fixed: Instructor page courses missing course duration
* Fixed: Instructor page social icon order not matching the web
* Fixed: Uploaded profile cover photo not appearing in profile settings
* Fixed: Default profile cover image not matching the web

= 0.6.93 (June 8, 2026) =

* Added: Course progress bar on the course details page for enrolled students, tied to "Start Learning" and lesson completion
* Added: Course progress bar on the course details page for instructors and admins
* Added: "Mark as Complete" option and progress bar on the lesson details page
* Added: Download confirmation popup for attachments, showing the saved file location with a link
* Added: Categories, Bookmark, and Share options on the course details page
* Improved: Role-based course details tabs — Q&A and Announcements shown only to the relevant roles (Superadmin sees them; normal users and non-author instructors don't)
* Improved: Lesson details tabs (Overview, Exercise, Comments) now appear only when that content is available
* Improved: Lesson overview now renders rich text formatting — headings, bold, links — instead of plain text
* Improved: Long course-content topic titles now display in full on the course details page
* Improved: Added a close button to the course-content topic details bottom sheet for long titles and content
* Improved: Removed the unnecessary reload icon from the course details page
* Improved: "Course Progress" title is now hidden when there is no progress bar to show
* Improved: "My Courses" All tab now shows a proper "No data found" empty state
* Improved: Course Reviews tab now shows a "No review found" message when empty
* Improved: Removed the placeholder dummy image previously shown on empty lesson details pages
* Fixed: Submitting a course review not working
* Fixed: "No Viewable content yet" error when the first topic in a course is a quiz
* Fixed: Home page course card button color now matches the design
* Fixed: Home page "Sort by" not working for Course Title (Z–A)
* Fixed: Home page "Sort by" issues — default option not staying selected and the first option appearing twice
* Fixed: Course details star/rating mark not working
* Fixed: Misplaced hint icon beside the topic name on the course details page
* Fixed: Drawer → Settings reload not working
* Fixed: Course list now refreshes automatically after enrolling in a course
* Fixed: Lesson details page not showing the full lesson name
* Fixed: "Fill in the Blanks" quiz layout not matching the design
* Fixed: Quiz details page showing an incorrect total attempts count

= 0.6.05 (May 20, 2026) =

* Initial release
* Added: WordPress plugin connector with a secure Tutor LMS Mobile REST API
* Added: Enable/disable mobile API toggle and license activation from WP Admin
* Added: Connection QR code generation and "email all members" invitation flow
* Added: App-download button visibility control (everyone / logged-in / none)
* Added: Course catalog with category filtering and sort order
* Added: Course categories endpoint (search, counts, nesting)
* Added: Course details page with full curriculum, requirements, and what-you-will-learn
* Added: Video lesson player support with lesson-completion tracking
* Added: Quiz attempts, per-question answer submission, results, and attempt breakdown
* Added: Student dashboard — My Courses (enrolled / active / completed) and wishlist
* Added: Course progress, mark complete, and course retake/reset
* Added: Free-course enrollment
* Added: Course Q&A (questions and threaded replies)
* Added: Course reviews and ratings
* Added: Instructor profile page

== Upgrade Notice ==

= 0.6.93 =
Adds course and lesson progress tracking, "Mark as Complete", role-based course detail tabs, and a range of UI fixes across the home, course details, lesson, quiz, and review screens. Tested up to WordPress 7.0.

= 0.6.05 =
Initial release of the Tutor LMS Mobile App plugin. Requires the free Tutor LMS plugin to be installed and activated.
