Upgrading from 1.x
Version 2.0.0 moves the plugin’s settings from C4D Plugin Manager to its own page at C4D Swatches. The plugin no longer needs C4D Plugin Manager or Redux Framework. Your products, photos and attribute types are not touched.
Before you update
- Back up your site, as you would before any plugin update.
- Keep C4D Plugin Manager active. The plugin reads your old settings from it. If Plugin Manager is off when 2.0.0 first loads, nothing is converted. See If Plugin Manager was off.
What happens when you update
The conversion runs once, on the first page load after the update (any page, front end or dashboard), when Plugin Manager is active. It copies:
- Your settings, such as the shop page options, gallery, zoom and Ajax settings. They keep their values on the new tabs.
- The colour of each option, from the old Color Defined screen. They appear on the Colours tab.
- Your styling (sizes, borders, colours, fonts), as CSS. It goes into the Custom CSS tab, under a comment line that says “Imported from Plugin Manager settings in 2.0.0”, so your shop looks the same as before.
If something was copied, you see a notice in the dashboard: “Your settings, term colours and styles have moved to their own menu, C4D Swatches.” Click Check settings to open the new page, then Dismiss.
While Plugin Manager is active, a second notice on the Plugins screen and on the new settings page tells you it’s no longer needed. You can dismiss it too.
Plugin Manager’s own data isn’t deleted. The old settings stay where they were.
What the removed settings became
The colour, size, border and typography settings no longer exist as settings. They became CSS:
| Old settings | Now |
|---|---|
| Swatch size, spacing and borders (product page and shop page) | CSS. See Style swatches with CSS. |
| Text button colours, background, border, size, font | CSS |
| Tooltip background, text colour, font and padding | CSS |
| Image popup size and border colour, zoom box size and colour | CSS |
| Attribute label font, thumbnail width | CSS |
| Multi Orders box colours, border and size | CSS |
| Colours of each option (Color Defined) | The Colours tab |
| Everything that changes how the plugin works, such as gallery, zoom, Ajax and shop page options | Stays a setting. See the Settings reference. |
If a style you had set looks different after the update, open the Custom CSS tab and look for it in the imported block. You can edit or delete any of it.
If Plugin Manager was off when you updated
With Plugin Manager off, version 1.x ran on its built-in defaults, so there was nothing to convert, and 2.0 starts on the same defaults. If you’re missing settings, colours or styling you had set before, you can get them back:
- Activate C4D Plugin Manager again.
- Delete the option
c4d_woo_vs_db_versionfrom your database. With WP-CLI:wp option delete c4d_woo_vs_db_version. A database tool such as phpMyAdmin works too: delete the rowc4d_woo_vs_db_versionin theoptionstable. - Load any page of your site. The plugin fills in what’s missing.
Settings you already saved on the new page are kept. Only settings that don’t exist yet are filled in, and the imported styling is only added when the Custom CSS box is empty. If you changed things on the new page since the update, check them afterwards.
If you need help, ask in the support forum on WordPress.org.
After the update
- Open each tab once and compare it with your shop. The Settings reference explains every setting.
- You can deactivate and delete C4D Plugin Manager if no other plugin of yours uses it. The newer versions of our other plugins don’t. See What C4D Plugin Manager does.
- Deleting Variation Images from the Plugins screen removes its settings, but keeps your products’ photos and attribute types.
Going back to 1.x
Plugin Manager’s data is never changed by the update, so 1.x still finds its old settings if you go back. But 1.x doesn’t read the new settings page, so anything you changed on it after updating stays in 2.0. Keep C4D Plugin Manager if you think you might go back.
Questions
Do I lose my photos or attribute types? No. Photos in the Swatch Images box, swatch types and per-product settings are stored with your products and attributes, and the update doesn’t change them.
Is anything behind a paid version? No. Every feature of the plugin is free, and there’s no limit on photos per option.
The colours of my options are gone. Check the Colours tab first, and your colour attribute name on the General tab. If the tab is empty and Plugin Manager was off during the update, follow the steps above.
I’m on a multisite network. The conversion runs on each site on its own, the first time a page of that site loads.