Skip to content

Upgrade your job board add-on from 3.1.0 (Upgrade from 3.1.0)

Reign WP Job Manager Addon overviewPremiumGet Reign WP Job Manager Addon →

Also called: update the add-on, upgrade to 3.2.0, move my settings, lost job map, lost job search bar, job list shortcode changed, migrate settings.

Version 3.2.0 is a rebuild. The first time it runs, it moves your saved choices to the new settings. It never deletes anything you saved. If you go back to 3.1.0, your old data is still there.

  • Take a backup, as you would before any update.
  • Make sure the Reign theme is 8.1.0 or newer and WP Job Manager is active. If either is missing, the add-on pauses, but the move still works.
  1. Update the add-on to 3.2.0.
  2. Open any admin screen. The move starts on its own and runs in small batches.
  3. Wait for the notice “Reign WP Job Manager Addon is moving your saved settings to version 3.2.0”. It shows on the Plugins, Dashboard, Updates and Reign Settings screens, and it finishes by itself.
  4. When the move ends, read the success notice. It shows once and lists what moved.
  5. Go to Reign Settings > License and check that your licence key is there. A saved key is passed to Reign, which moves it.
  6. If a warning lists pages that use the old search bar, open each page and remove the shortcode. The warning has a link to each page.

The warning that lists pages still using the old search bar

  • Single job and resume layouts. Every old layout becomes the Reign default. Version 3.2.0 offers the Reign default and Reading.
  • Job list. The old list layout becomes the default rows. The old grid or card layout becomes Grid. The old column count is dropped.
  • Resume list. The old list layout becomes Rows. The old grid or card layout becomes the Reign cards.
  • Extra fields. The thirteen on or off choices move over. A field that was off but already has terms stays on, so no saved term disappears from a page.
  • List shortcodes. [jobmate_job_listing] and [jobmate_resume_listing] become [jobs] and [resumes] in the content of every post type. Revisions and menu items are left out. Old versions of a page keep the old text in the revision history.
  • The map at the top of the job and resume lists, and the map on the job page.
  • The search bar shortcode [jobmate_job_search_filter]. WP Job Manager’s own filters above the list replace it.
  • The slider, the colour options and the add-on’s own licence page.

One success notice says what moved. Your job and resume pages open with the layouts you expect. No warning is left about the old search bar.

What does the warning about the old search bar mean?

Section titled “What does the warning about the old search bar mean?”

A page still holds [jobmate_job_search_filter]. The warning lists up to 10 pages, each with a link, and then says “and N more”. The add-on remembers up to 200 pages. A page leaves the list when it no longer holds the shortcode.

No. A site that never ran 3.1.0 starts on the defaults. A site that only has the 3.1.0 on or off options counts as a 3.1.0 site.

The old settings key, the map options, the extra field options, all terms, and all post and user meta. They stay unread. You can go back to 3.1.0 at any time.

My site is large. How do I move everything at once?

Section titled “My site is large. How do I move everything at once?”

The data moves in small batches when an administrator opens the admin. It also moves in the background with WP-Cron. To move it all now, run wp reign-jb upgrade. It prints “Still moving data…” until it is done, and it is safe to run again. It also works while the add-on is paused.

Why does a list shortcode still show as plain text?

Section titled “Why does a list shortcode still show as plain text?”

The add-on rewrites only post content. It changes only a tag followed by a space, ] or /. A list shortcode inside page-builder data or a widget keeps its old name. Change it by hand to [jobs] or [resumes].

See Messages and notices.

The add-on keeps these options. All of them are removed on uninstall.

Option Holds
reign_options['wpjm'] Your settings (values equal to the default are not stored)
reign_jb_upgrades Which upgrade steps are finished
reign_jb_upgrade_log The lines shown in the success notice
reign_jb_upgrade_noticed Set once the success notice has been shown
reign_jb_upgrade_cursor Progress of the shortcode rewrite on large sites
reign_jb_search_pages Pages that still hold the dropped search shortcode

The WP-Cron event reign_jb_upgrade runs the move in the background. It is cleared on uninstall. The 3.1.0 data is never touched. The batch budget is 5 seconds per request.