Migration from v4 plugin version

GD Content Tools Pro v5.0 is a completely rewritten plugin, and it shares no code with GD Custom Posts and Taxonomies Tools Pro v4.x. This article details on what can be migrated into the new plugin.

The new plugin is not compatible with old plugins, and some of the features from the old plugin are no longer available in the new plugin. It is important to know what can be and what can’t be transferred from the old plugin to the new plugin.

Objects Transfer

Custom post types

You can transfer all post types you have defined through the old plugin. To do this, use the Tools -> v4 Transfer: Objects panel. You can select one or more post type to transfer. Each transferred post type will be set as inactive (in case you still have the old plugin running). Once you complete the transfer and deactivate the old plugin, go through all transferred post types to activate them.

Plugin is not affecting data stored in the posts and postmeta tables, they will not be removed by using transfer tools.

Transfer Objects Panel
Transfer Objects Panel

Custom taxonomies

You can transfer all taxonomies you have defined through the old plugin. To do this, use the Tools -> v4 Transfer: Objects panel. You can select one or more taxonomy to transfer. Each transferred taxonomy will be set as inactive (in case you still have the old plugin running). Once you complete the transfer and deactivate the old plugin, go through all transferred taxonomies to activate them.

Plugin is not affecting data stored in the terms and related tables, they will not be removed by using transfer tools.

Default and third party objects

Settings related to default and third party post types and taxonomies can’t be transferred. Main reason is that new plugin is not longer able to fully override and modify these objects. Old plugin was able to do it, but in most cases, you would end up with broken functionality. To avoid such issues, and because this was a very rarely used feature, the new plugin can’t do this anymore.

But, there are some things you can still set to every post type and taxonomy. For post types, you can enable some of the special plugin features and modify the list of taxonomies. For each taxonomy, you can enable some of the special plugin features (like term images).

Meta Transfer

Transfer meta fields and meta boxes

All meta/custom fields and meta boxes can be transferred from old plugin via the Tools -> v4 Transfer: Meta panel. All fields are supported for transfer. As for the meta boxes, all of them will be imported as Legacy Metabox. They are made to mimic the old type of meta boxes from plugin version v4 to allow or getting the data saved by the old plugin. These boxes can’t include complex meta fields and you can’t convert them to Custom Metaboxes.

The old plugin has Meta Groups feature for merging 2 or more meta boxes in the tabbed interface. This feature is no longer available in the new plugin.

bbPress meta boxes integration

This can’t be transferred at all. Old v4 integration had several bugs related to individual forum settings, and transferring such information would create problems. So, new bbPress integration works differently and much better, so you will need to set it up again.

Widgets Transfer

All three widgets from v4 plugin are part of the new plugin. But, they are not named the same way, so they will not be visible upon transfer. They also have different options and some of the features, so you will need to add them again.

Code Transfer

The code you have used in the theme or other plugins can’t be transferred. New objects and functions are quite different and there is no way to directly replace them. But, follow the knowledge base articles provided for the new plugin to get code examples for meta boxes, fields, and other things. If you need help with the specifics, please stop by the support forum.

Transfer Process Overview

Here is the best way to complete the transfer data from GD Custom Posts and Taxonomies Tools Pro v4:

  1. Install and activate GD Content Tools Pro v5.
  2. Open the Tools panel, v4 Transfer: Objects.
  3. Select all post types and taxonomies, and click Transfer button.
  4. Recheck all post types and taxonomies transferred, make sure all settings are ok, check if the taxonomies are properly assigned.
  5. If you used old plugin meta fields and boxes, open the Tools panel, v4 Transfer: Meta.
  6. Select all fields and boxes, and click Transfer button.
  7. Recheck all fields and boxes transferred, make sure all settings are ok.
  8. Open WordPress Widgets panel.
  9. Remove old GD Custom Posts and Taxonomies Tools Pro v4 widgets.
  10. Add widgets from GD Custom Tools Pro v5 plugin.
  11. If you used bbPress and meta boxes integration, open Meta bbPress panel and add meta boxes assignment.
  12. Disable GD Custom Posts and Taxonomies Tools Pro v4 plugin.
  13. Enable all post types and taxonomies in GD Content Tools Pro plugin.
0
0
218
Rate this article

You are not allowed to rate this post.

Comments

Leave a Reply