Upgrading from 3.8.0 to 3.9.0
Also called: update the add-on, old shortcode removed, rda_dokan_store_listing, store list shortcode, migrate settings, convert shortcode, upgrade notice
What this does
Section titled “What this does”Version 3.9.0 is a rebuild on Dokan’s own store list and product page. Your saved settings and your members’ favourites carry over on the first page load after the update. Old data is never deleted.
What changed
Section titled “What changed”| 3.8.0 | 3.9.0 |
|---|---|
[rda_dokan_store_listing], [rda_dokan_vendors] |
Removed. Use Dokan’s [dokan-stores]. |
| Reign - Vendors widget | Removed. Use a Dokan widget. |
| Store header options | Removed. Set the header in Dokan. |
| Own vendor box and extra sold by markup | One Sold by line plus Dokan’s vendor card. |
- Update the add-on and load any page. The first page load moves your old settings across.
- Look for the admin notice that lists pages still using a removed shortcode. It shows to administrators on the Plugins, Dashboard, Themes, Updates and Reign Settings screens.
- Click Convert the store list shortcode to fix the pages in one go. Or edit the pages yourself and use
[dokan-stores]. - If the notice says the “Reign - Vendors” widget is still placed, remove it under Appearance > Widgets.
- Click Dismiss when you are done.
You’ll know it worked when
Section titled “You’ll know it worked when”The notice is gone, and your store list pages show Dokan’s store list in your chosen card style.
Good to know
Section titled “Good to know”What does the convert button keep?
Section titled “What does the convert button keep?”Only per_page, search, per_row and featured carry over. After a convert, the notice names any other setting that was dropped, for example orderby or layout. It also links the pages to check.
What does the notice list?
Section titled “What does the notice list?”It lists up to 10 pages for each shortcode, with edit links. It also says when only the first 200 matching posts were checked. Child theme template copies that are older than the add-on are listed in a notice too.
What about [rda_dokan_vendors]?
Section titled “What about [rda_dokan_vendors]?”It has no automatic replacement. Edit those pages yourself. An escaped [[rda_dokan_store_listing]] is left as written and is not listed.
What happens to my members’ favourites?
Section titled “What happens to my members’ favourites?”Each member’s saved list is copied once, when they next load a page. Duplicates and deleted products are removed. The old list stays in place.
How do my old settings map across?
Section titled “How do my old settings map across?”The first page load reads your 3.8.0 settings once and writes the new ones. Nothing is deleted. A setting you never changed gets the 3.9.0 default.
| 3.8.0 setting | 3.9.0 setting |
|---|---|
| Store list layout, layout two | Store card style: Centered |
| Store list layout, any other | Store card style: Dokan |
| “Show sold by in pro meta” or “show vendor info in pro page” turned on | Vendor block: Sold by line |
| Neither of those turned on | Vendor block: None |
| Hide store tab (inverted: when set, the tab showed) | Store tab on vendor profiles |
| Mark favourite | Favourite products |
| Product, review and order activity | Post to the activity stream when |
For developers
Section titled “For developers”The old keys are the reign_dokan_store_list_layout, reign_dokan_show_sold_by_in_pro_meta and reign_dokan_show_vendor_info_in_pro_page theme options. Others are hide_store_tab, mark_favorite, product_activity, review_activity and order_activity.

