This is a massive update which breaks backwards compatibility for many LifterLMS features. A database migration is also necessary for upgrading users to reformat certain pieces of information which are being accessed differently in 3.0.0
We strongly recommend that you backup your website before upgrading and, if possible, test LifterLMS 3.0.0 in a non-public-facing testing environment to ensure compatibility with your theme and other plugins and to ensure that 3.0.0 changes do not adversely affect your existing website.
Please thoroughly read the following changelog and, if necessary, submit support tickets or post in the forums with any questions prior to upgrading. LifterLMS Support cannot and will not manually resolve migration issues which may arise from upgrading to 3.0.0.
- New shortcodes to be documented later, checkout “includes/class.llms.shortcodes.php” if you’re feeling anxious
- All kinds of CSS changes to make LifterLMS, in general, be a little less old looking
- Added a number of CSS classes to various areas in the Checkout template at “templates/checkout/form-checkout.php”
- Added a “Cancel” button that allows you to hide the coupon form if the user decides not to add a coupon
- Removed jQuery animations from the coupon form toggle in favor of a CSS class toggle. If you decide you want some animations on the form add some CSS transitions to the
.llms-coupon-entryelement (and children) to change when the class
.activeis added or removed from the element.
- Fixed some redundant text on single payment confirmation screen. (“Single payment of single payment of”)
- Added a link to memberships listed under “My Memberships” on the LifterLMS Account Screen
- LifterLMS Order posts have been renamed in the database from “order” to “llms_order” to prevent any potential conflicts with other plugins. Automated database migration will handle the renaming of old orders.
- Fixed undefined variable notice generated by Sections without any lessons inside of them
- renamed function
- added a class for interacting with a course TRACK, instantiated by a track term or term_id (
- password strength meter and related settings / options via utilizing WordPress password strength functions available
- cleaned up the lesson locked tooltips to be a bit more sane and also utilized in course navigation on individual lessons.
- Updated admin menus for LifterLMS content to be more sane and organized and intuitive and so on and so forth
NOTE: at this release, LifterLMS PayPal is the only payment gateway that will work with this release. We haven’t started working on Stripe 4.0.0 which will work with LifterLMS 3.0.0
- Payment gateways powered by a new abstract gateway class
- PayPal has been removed from LifterLMS and is available as premium extension
- LifterLMS “Notices” have been rewritten, slightly.
- Most templates have been updated
- associated CSS has been updated
- Some sanity has been added to the related functions
Post “Model” Concept / Overhaul
Updated classes for programmatically accessing all sorts of data related to custom post types registered by LifterLMS.
These post types currently include:
- Access Plans — a non-public post type associated with courses and memberships which store payment related information
- Coupons (replaces includes/class.llms.coupon.php)
- Courses (replaces includes/class.llms.course.php)
- Lessons (replaces includes/class.llms.lesson.php)
- Orders (replaces includes/class.llms.order.php
- Products — can be instantiated from courses or memberships (replaces includes/class.llms.product.php)
- Transaction — a non-public post type associated with orders which store completed/attempted transaction data
Improved admin metabox methods (and related)
- Updated custom LifterLMS Admin Metaboxes to have a more sane programmatic interface. This affects nearly all admin metabox classes in the plugin.
- A set of methods and classes have been added to improve the programmatic interface around custom post type post tables. These can be found in “includes/admin/post-types/post-tables”
- New class
LLMS_Couponallows for easy getting & setting of coupon data.
- Updated coupon post table to include relevant coupon information for all coupons at a glance
- Refactored admin panel coupon metabox generation to utilize new model for saving data
- Added translation functions to all strings in coupon settings screen
- Added new coupon settings
- Expiration Date — coupons cannot be applied to a purchase after the expiration date
- Payment Type — coupons can only be applied to either single or recurring payment plans. Existing coupons will be treated as single payment coupons until updated by the Admin.
- First Payment Discount — Applies only to recurring payment coupons. Determines the discount applied to the first payment of a recurring payment transaction.
- Recurring Payments Discount — Applies only to recurring payment coupons. Determines the discount applied all payments (other than the first) of a recurring payment transaction.
- Description — Record internal notes for a coupon visible only by admins on the admin panel
- The “Coupon Code” field has been removed in favor of the WordPress Coupon Post Title being utilized as the code. After upgrading, an automated database migration will move all coupon code fields to the title. The title previously functioned as the coupon description. During the migration the existing title will be moved to the new description field.
- Added Order Statuses
- Completed – Single payment only. Denotes a successful transaction
- Active – Recurring only. Denotes the subscription is active with no issues
- Expired – Recurring only. Denotes the subscription has ended and is no longer active
- Refunded – Denotes the order has been refunded.
- Cancelled – Denotes the order has been cancelled manually by an admin.
- Failed – Denotes payment has failed. For subscriptions a failed payment will switch from “active” to “failed”
- Pending – Denotes that the order has been created but payment has not been completed yet
- Admin panel order table new features:
- The following columns are now sortable in ascending and descending orders: Order, Product, and Date
- Added totals based on order type (single or recurring) to the “Total” column
- Added an order status column for quick status review
- Order notes available for internal and system notes. powered by WP comments. lots of inspiration (and code) from WooCommerce, thank you <3
- Added a bunch of currency settings (as well as right-side currency and decimal-less currency support!)
- Pricing Table at “templates/product/pricing-table.php” utilized by courses and memberships for displaying access plan information. Replaces “templates/membership/purchase-link.php” and “templates/course/purchase-link.php”
- Course Taxonomy Templates at “templates/course/categories.php”, “templates/course/tags.php”, and “templates/course/tracks.php” display comma separated lists for course custom taxonomy terms
- Course Prerequisite Template at “templates/course/prerequisites.php” displays prerequisite information (course and tracks) for a given course.
- Meta Wrapper templates at “templates/course/meta-wrapper-end.php” and “templates/course/meta-wrapper-start.php” wrap some HTML around various meta data output about a course
- Significantly updated checkout process with all kinds of new templates including:
- Unified “Lesson Preview” at “templates/course/lesson-preview.php” displays “buttons” in course syllabus (on course page) and in course navigation (on lesson pages)
- Various template hook priority changes in order to make adding content between default LifterLMS areas easier
New & Updated Admin Interfaces & Templates
- Significantly improved, changed, or brand new templates for metaboxes for various post types:
llms_confirm_payment_url()– Retrieve the URL used for confirming LifterLMS Payments
llms_cancel_payment_url()– Retrieve the URL users are directed to when cancelling a payment
- Removed some legacy default options that were being created and are no longer required for new installations.
- Removed unused
update_courses_archive()function & related hook
Now utilizing a forked version of Select2 to prevent 3.5.x conflicts we’ve been plagued with
- Removed filter
- Removed unused
LLMS_Product->set_price_html_as_value()because we didn’t like it anymore, don’t use anything instead.
displaying_sidebar_in_post_types()function with the
lifterlms_order_process_pending_redirecthas been replaced with
lifterlms_order_process_beginhas been deprecated
LLMS_Course::check_enrollment()with various new utilities. See
llms_is_user_enrolled()for fastest use.
- Officially removed the
- Officially removed the
PluginUpdateCheckerclass stubs we created to prevent updating issues with LifterLMS extensions during our transition to 2.0.0. This library has caused nothing but pain for everyone on our team and many of our users. It’s gone now, forever.
- Removed function
lifterlms_template_single_price()and replaced with
- Removed templates at “includes/course/price.php” and “includes/membership/price.php” in favor of “includes/product/pricing-table.php”
LLMS_Person::create_new_person()in favor of
LLMS_Person->set_user_login_timestamp_on_register()and are simply adding the metadata during registration
lifterlms_register_postaction hook which fired after new user registration validation, this has been replaced with
lifterlms_new_person_addressfilters, replaced with
LLMS_Person::login_user()in favor of
- background updater
- system report facelift + inclusion of all new settings via
- Fix setup wizard styles to follow update admin panel styles
- add links to last step of setup wizard for documentation and demo
- removed a bunch of deprecated coupon-related functions
- added a “force ssl” option to ensure checkout is secured
- added settings and options around recurring payments and staging sites to prevent duplicate charges when testing on a cloned site
- Check course restrictions automatically when checking lesson
- Added user_id to all access function checks to allow for checks for non current user
- course restriction messages display regardless of enrollment status
- check memberships and lock purchase of members only access plans
- Fixed titles of course closed and open messages on the course restrictions options
- record a start date for access plans based off when order moves to complete or active for the first time
- automatically expire limited access plans
- gave a quick facelift & unification to a lot of admin panel elements
- Color consistency updated according to LLMS brand guide
- Unified front and backend button classes
- Updated all frontend buttons to have consistent classes
- Removed the “FREE” lesson SVG in favor of simple text which allows translating
- Install & activation overhauls. Resolves #179
- jQuery MatchHeight lib unignored
- A bunch of settings pages updated and a bunch of settings deprecated
- Gateways setting page removed
- Memberships & Courses page combined into “Catalogs” settings
- Added a data getting class used by the tracker class
- added a new page creation function with better intelligence that (hopefully) prevents duplicate pages from being created during core page installation
- new default country setting
- all order status changes recorded as order notes
- pending orders can be completed after failed payments
- better handling for gateways with fields
- JS spinners support multiples via start & stop!
- Updated (and semi-finished) analytics
- achievement metabox converted
- minor updates to voucher class
- Added a “post state” visible on the Pages posts table identifying if the page is saved as a LifterLMS page (EG: Checkout Page)
- Fixed copy/paste error of duplicate enrollment closed message on course restrictions tab
- Removed WC integration in favor of WC
- Upgrade “back to course” template to new lesson API
course/parent-course.phpfor template naming consistency
strictwhen auto generating usernames when creating from email addresses, resolves #182
3.0.0 Auto Upgrader
- lots of postmeta data rekeyed
- intelligently generated defaults for various pieces of new meta data on courses, lessons, and memberships
- automatically generate access plans from existing course and membership data
- update existing orders to pull semi-accurate data into analytics based on new database structure
- cleans database of a ton of deprecated options and postmeta data
- Course auto enrollment for Memberships has been restored
- Works exactly the same as previously except auto-enrollment is not dependent on a course “belonging to” the membership via membership restrictions. This is because membership restrictions no longer apply to courses
- Charts! I’m really excited about this. I know we still need more data but please say nice things to me, I worked really hard on these little charts.
- Updated styles & interface
- Restrict individual forums (and their topics) to LifterLMS Membership levels
- Fixes broken course display on bp profile
- Adds memberships subpage to bp profile
- Admin notices class for managing admin notices, it’s pretty neat!
Student Management on Courses and Memberships
- All new and improved student management interface for managing student enrollments from courses and memberships
llms_meta_fields_course_main, replace with
- Manual Payment Gateway can now be enabled on the frontend!
- When a manual payment is recorded the user will be redirected to a view order page where they will be prompted to make a manual payment
- Define the payment instructions on the admin panel “Checkout Settings”
- Once you verify payment, head to the pending order and hit the “Record a Manual Payment” button to record the transaction
- Upon recording the order status will be upgraded to “Complete” and the user will be enrolled automatically
Student Dashboard Upgrades
- More sane template hooks and functions
- Pagination on Courses endpoint (view only a preview on the main dashboard)
- Orders history & view orders screens!
Deprecated options (and related functions where applicable) for the following course & membership options:
In all scenarios either a
add_filter (returning false) or a
remove_action() can be used to replicate the option.