=== Raoa LMS ===

Contributors: raoatech
Tags: lms, elearning, courses, education, learning
Requires at least: 6.2
Tested up to: 7.1
Requires PHP: 8.0
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
 
The free WordPress LMS for course creators. Build courses with lessons and quizzes, track progress, and manage learning with student and instructor dashboards.
 

== Description ==
 
Raoa LMS is a free, self-contained learning management system for WordPress. Create courses with sections, lessons, and quizzes; enroll students for free; track progress through course completion; and manage everything from branded student and instructor dashboards — without requiring another LMS or store plugin.

**LMS Features**
 
**Courses & curriculum**
 
✅ Courses with orderable sections, lessons, and quizzes
✅ Course metadata: duration, difficulty, requirements, and learning outcomes
✅ Categories and tags for organizing the catalog
✅ Featured image / course thumbnail support
✅ Related courses carousel on the course single page
 
**Lessons**
 
✅ Rich lesson content via the WordPress editor
✅ Optional video URL (YouTube, Vimeo, or direct file URL)
✅ Optional lesson duration
✅ Preview lessons for guests and non-enrolled visitors
 
**Quizzes**
 
✅ Multiple choice (single or multiple correct answers)
✅ True / false questions
✅ Pass percent, retry limits, and attempt history
✅ Optional quiz timer (deadline stored when the attempt starts; late answers discarded on the server)
✅ Automatic grading with pass / fail results
✅ Correct answers never exposed in public HTML, JavaScript, or REST
 
**Enrollment & progress**
 
✅ Free one-click enrollment for logged-in students
✅ Lesson complete and quiz progress toward course completion
✅ Course completion when required curriculum items are done
✅ Progress tracking on the learning page and student dashboard
 
**Catalog & discovery**
 
✅ Explore-style course archive with hero banner
✅ Sidebar filters (search, category, difficulty, rating, and more)
✅ Grid and list views with sorting
✅ Course reviews and ratings from enrolled students (when enabled)
 
**Accounts & dashboards**
 
✅ Login, student register, instructor register, lost password, and reset password
✅ Unified student and instructor account portal
✅ Student dashboard: My courses and learning progress
✅ Instructor role with ownership of own courses
✅ Instructor dashboard: owned courses, student counts, and basic progress
✅ Instructor profile: bio, avatar, designation, and expertise on the course page
✅ LMS pages auto-created and selected on activation
 
**Admin & settings**
 
✅ Tabbed settings: General, Courses, Emails, Permalinks, Advanced
✅ Brand colors and archive filter configuration
✅ View enrollments / students (permission-aware)
✅ Import / Export for courses, settings, and enrollments CSV
✅ Privacy exporters and erasers for enrollments, progress, quiz scores, and profile data
✅ Suggested privacy-policy text under Settings → Privacy
✅ Uninstall keeps student and course data by default (optional full wipe)
✅ Translation-ready text domain: `raoa-lms`
 
**Shortcodes**
 
* `[raoa_courses]` — course grid
* `[raoa_dashboard]` — student / instructor portal
* `[raoa_instructor_dashboard]` — legacy instructor dashboard alias
* `[raoa_login]`, `[raoa_register]`, `[raoa_register_instructor]`
* `[raoa_lost_password]`, `[raoa_reset_password]`
 
== Screenshots ==

1. Course page — explore the course archive with filters, sorting, and course cards.
2. Course details page — single course view with overview, instructor, and enroll sidebar.
3. Related courses — carousel of related courses on the course details page.
4. Login form — student and instructor login screen.
5. Student register form — create a student account.
6. Instructor register form — apply for an instructor account.
7. Student dashboard — overview of enrolled courses and learning progress.
8. Student dashboard courses — My Courses list inside the student portal.
9. Instructor dashboard — instructor overview with owned courses and student counts.
10. Instructor my courses — manage courses from the instructor portal.
11. General settings — Raoa LMS General settings tab.
12. Course settings — Raoa LMS Courses settings tab.
13. Permalink settings — Raoa LMS Permalinks settings tab.
14. Advanced settings — Raoa LMS Advanced settings tab.

== Installation ==
 
1. Upload the `raoa-lms` folder to `/wp-content/plugins/`, or install the zip via **Plugins → Add New → Upload Plugin**.
2. Activate **Raoa LMS**.
3. LMS pages (Courses, Dashboard, Login, Register, and related) are created automatically when needed.
4. Open **Raoa LMS** in wp-admin to create courses, lessons, and quizzes.
5. Configure **Raoa LMS → Settings** (archive filters, brand colors, and pages).
6. Assign the instructor role and publish courses.
 
== Frequently Asked Questions ==
 
= Is this a full enterprise LMS? =
 
No. Raoa LMS 1.0 is a **basic LMS**: courses, lessons, quizzes, free enrollment, progress, completion, and an account portal. Paid checkout, certificates, live classes, assignments, drip content, and marketplace payouts are out of scope for this release.
 
= Do I need a store plugin? =
 
No. This version does not sell courses.
 
= Can guests enroll? =
 
No. Students must log in or register before enrolling. Preview lessons remain viewable without enrollment when enabled on a lesson.
 
 
= What type of data does the plugin store? =
 
* **Enrollments** — user, course, source, dates
* **Progress** — completed lessons and quizzes per course
* **Quiz attempts** — scores and pass/fail (not answer keys)
* **Profile** — biography, designation, expertise, social URLs, and instructor application flags
* **Uploads** — profile photo and cover image files owned by the user
 
Use WordPress **Tools → Export Personal Data** / **Erase Personal Data**. Raoa LMS registers exporters and erasers for this data. Suggested privacy-policy wording is also added under **Settings → Privacy**.
 
 
= What happens if I uninstall? =
 
By default, student and course data are **kept**. Enable **Remove data on uninstall** in Raoa LMS Settings before deleting the plugin if you want options, custom tables, LMS content, plugin roles, and pages this plugin created removed. Existing site pages that were only reused (including the WordPress Privacy Policy page) are not deleted.
 
 
== Changelog ==
 
= 1.0.1 =
* Update plugin description.
* Fix related courses carousel continuous infinite loop on the course details page.
* Improve related course fill when same-category matches are limited.

= 1.0.0 =
* Initial public release.
* Courses, curriculum (sections / lessons / quizzes), free enrollment, progress, and completion.
* Optional quiz timer: the deadline is stored when the attempt starts and late answers are discarded on the server.
* Explore course archive: dark hero banner, sidebar filters, grid/list cards, reviews.
* Account system: login, student/instructor registration, password recovery, unified portal.
* Tabbed settings, auto-created LMS pages, import/export tools.
* Privacy exporters/erasers and suggested policy text; uninstall keeps data by default.
* Design-token frontend (course single, archive, portal, auth).
* REST namespace `raoa/v1` for courses, enrollment, and progress (no quiz keys).
* WordPress.org review hardening: enqueued scripts, lesson embed escaping, instructor approval required, admin menu position, i18n fixes.
 
== Upgrade Notice ==
 
= 1.0.1 =
Updated plugin description. Fixes the related courses carousel infinite loop on the course details page.

= 1.0.0 =
Initial public release of Raoa LMS.