Table of Contents
Visual Portfolio 3.0 is a major version and includes some substantial Skin template changes. Before you upgrade to v3.0, please make sure you backup your site. Before upgrading to production, we recommend testing the new version on a staging site.
Automatic merge
For most galleries, you just need to open the page editor (if you are using the Gutenberg block) and re-save your post. Saved Layouts are already merged, but you can also try to re-save them.
New gallery features will be automatically merged with your gallery.
Visual Portfolio Pro
If you are using the Visual Portfolio Pro plugin, it should be updated to v2 to work with new features.
Custom styles or code
In case you have added custom styles for Caption or for Meta elements, you will need to rewrite it. In v3.0 we changed classes and variable names and split the Caption → Overlay + Caption.
3rd-party Skins
In case your theme or 3rd-party plugin adds custom Skins and uses builtin_controls, the author of this theme/plugin should change these configs.
To understand how these settings changed, look at the Classic Skin controls for example – https://github.com/nk-crew/visual-portfolio/blob/3663e3c80ba35f54abd359e2ce65c3a78659b256/classes/class-admin.php#L923-L991
There are fallbacks for old builtin_controls configs and it will not break, but consider changing it, as in future major releases (v4 or later) these fallbacks will be removed