=== LessonKiln ===
Contributors: webangon
Tags: lms, courses, lessons, e-learning, blocks
Requires at least: 6.3
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 0.2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Block-based LMS for WordPress. Build courses and lessons with the block editor.

== Description ==

LessonKiln is a learning management system built for the block editor. Create courses and their lessons as regular WordPress content and design them with blocks.

= Courses =

* A **Course** post type with its own archive, featured image, excerpt and block editor content.
* A **Course lessons** box on the course edit screen lists the course's lessons and has an **Add lesson** button that opens a new lesson already linked to the course.
* The course list shows how many lessons each course has.

= Lessons =

* A **Lesson** post type (LessonKiln > Lessons), written with the block editor like any post.
* Each lesson belongs to a course, chosen in the **Lesson settings** box.
* Set the lesson order with the **Order** field (Page Attributes) and an optional **duration** in minutes.
* The lesson list shows each lesson's course, order and duration, and can be filtered by course.

= Blocks =

* **Course Lessons** – the numbered list of a course's lessons with excerpts, durations, the lesson count and total length. Pick a course, or leave it on "Current course" to use the course being viewed – or, on a lesson, the lesson's course, with the current lesson highlighted (a course outline for a lesson sidebar).
* **Lesson Navigation** – previous and next lesson links, a link back to the course and "Lesson X of Y".

Both blocks are rendered on the server, so they always show the course's current lessons.

= Works without setup =

Single course pages show the lesson list and single lesson pages show the lesson navigation automatically, unless you've placed the block yourself. To turn this off:

`add_filter( 'lessonkiln_auto_append', '__return_false' );`

= For developers =

* `lessonkiln_get_course_lessons( $course_id )` – a course's published lessons in order.
* `lessonkiln_get_lesson_course_id( $lesson )` – a lesson's course ID.
* `lessonkiln_get_lesson_siblings( $lesson )` – previous / next lesson, position and total.
* Lesson meta `lessonkiln_course_id` and `lessonkiln_duration` are available in the REST API.

LessonKiln doesn't connect to any external service.

== Installation ==

1. Upload the `lessonkiln` folder to `/wp-content/plugins/`.
2. Activate LessonKiln from the Plugins screen.
3. Go to LessonKiln > Add New Course and publish a course.
4. In the course's **Course lessons** box, click **Add lesson**, or go to LessonKiln > Lessons > Add New Lesson and choose the course in **Lesson settings**.

== Frequently Asked Questions ==

= How do I change the order of lessons? =

Edit a lesson and set **Order** under Page Attributes. Lessons are listed from the lowest number up; lessons with the same number are listed by title.

= Can I put the lesson list somewhere else? =

Yes. Add the **Course Lessons** block anywhere – in the course content, a page, or a template. When the block is in the content, the automatic list is not added.

= What happens to lessons when I delete a course? =

When a course is permanently deleted, its lessons are kept and unlinked from it. You can then move them to another course.

== Changelog ==

= 0.2.0 =
* New: Lesson post type, linked to a course, with order and duration.
* New: Course Lessons and Lesson Navigation blocks.
* New: Lesson list on course pages and previous / next navigation on lesson pages.
* New: Course lessons box, lesson columns and course filter in the admin.

= 0.1.0 =
* Initial release: Course post type.
