Skip to content

Also called: update from old version, migrate settings, 5.1.0 to 5.2.0, shortcodes renamed, old reviews, upgrade stuck, LearnMate, wp reign-ld upgrade

Version 5.2.0 is a rebuild. A one-time upgrade moves your saved data so nothing is lost. It then removes the old copies.

The upgrade starts by itself and works in small batches.

  1. Update the add-on to 5.2.0.
  2. Open any admin page as an administrator. The upgrade runs for a few seconds at a time.
  3. If no administrator visits, WP-Cron finishes it in the background.
  4. On a large site, run wp reign-ld upgrade to do it all at once.

While it runs, an admin notice on the Dashboard, Plugins and Updates screens says so.

The next of those screens shows a one-time notice that lists what moved. The same lines stay in the Update status card under Reign Settings > Integrations, then Configure on the LearnDash tile.

Step What happens
Settings Old course page, archive and card settings move to the new fields. Sites that used the 5.1.0 course page get the Classic template, so the page looks the same.
Archive layout Layout One becomes Classic cards. Layout Two becomes Reign default. Layout Three becomes Soft cards.
Sections and cards The old hide switches become unticked boxes under Sections, Cards show and Filter bar. Hide Read More button unticks Cards show > Button.
Focus mode “Modern” focus mode becomes the Focus mode extras switch.
Shortcodes [reign_courses] becomes [modern_courses] in posts, pages, Elementor data and text, HTML and block widgets. Until that runs, the old name still shows the grid, so visitors never see raw shortcode text.
Reviews Each 5.1.0 review becomes a LearnDash review with the same status, rating, title, author, date and text. Replies follow.
Review switch Courses show or hide reviews the way 5.1.0 did. LearnDash’s per-course setting now controls this.
Community Group and activity settings move to the new Community cards. Social group links are kept.
Default images A default cover or course image that pointed at a placeholder 5.2.0 no longer ships is cleared, so the theme placeholder shows. Images from your media library are never touched.
Clean-up Old flags and per-course layout values are no longer read. Post meta is kept under a _reign_ld_510_ prefix, not deleted. Permalinks are rebuilt.

Yes. The content as it was is kept. Run wp reign-ld upgrade --revert-shortcodes to put back every post, revision and Elementor value not edited since the update.

  • Group reviews. LearnDash reviews courses only. Saved group reviews stay as ordinary comments. The Update status card gives the count.
  • LearnDash group links with the switch off. 5.1.0 could store a link nobody chose. The upgrade removes those links and keeps their ids under a _reign_ld_510_ prefix. Members and groups are not touched.
  • Activity message texts. 5.1.0 never used them.
  • Settings with no 5.2.0 use. Curriculum layout, profile layout, the old distraction-free options and the dashboard text are removed. LearnDash has its own settings for these.

What about templates I copied into my theme?

Section titled “What about templates I copied into my theme?”

If you copied 5.1.0 or LearnMate templates into your theme, they no longer load. See Template overrides for the new folder and the outdated-override check.

5.1.0 class names, learnmate_* filters and review hooks are removed. See Hooks and filters.

Run wp reign-ld upgrade. Without WP-CLI, open any admin page as an administrator and wait a few seconds.