How to Use WPSiteSync for Menus

Installation

The WPSiteSync for Menus add-on needs to be installed on both the Source site that you will be syncing Content from, as well as the Target Site that you are Pushing Content to.

To install WPSiteSync for Menus, you need to upload the Zip file that you downloaded from the wpsitesync.com web site after your purchase. To do this, go to your Plugins -> Add New page. Here, you can see an “Upload Plugin” button next to the title that reads “Add Plugins.” Click on the Upload Plugin button. On the next page, you will find a “Choose File” button. You can click on this and select the file from the File Chooser dialog. Once the file is selected, click on the “Install Now” button and your plugin will be uploaded and installed. On the following screen, select the “Activate Plugin” link and the WPSiteSync for Menus plugin is ready for use.

This process needs to be repeated on both the Source site and the Target site.

Configuration

The WPSiteSync for Menus add-on requires no configuration for use. It will make use of the existing Settings for WPSiteSync for Content.

Using WPSiteSync for Menus

To use the WPSiteSync for Menus add-on, start by going to the Appearance -> Menu page within your WordPress admin. On this page, you see some additional buttons added to the screen as shown here, indicated with the red arrows:
sync_docs_menus

The two buttons are similar in behavior to the “Push to Target” and “Pull from Target” buttons that you see when Syncing Content. These “Push to Target” and “Pull from Target” buttons only work on the menu currently being edited. Any other menus will remain unmodified.

If you’re using the WPSiteSync for Pull plugin, the “Pull from Target” button will be displayed in blue, indicating that this feature is ready for use.

To use the syncing features, select the menu you want to work with by using the “Select a menu to edit” drop-down control and clicking on the “Select” button. The page will reload and the desired menu will be displayed and ready for editing.

If you are making any changes to the menu contents, Navigation levels, order of the menu items, etc. you need to save your changes before Syncing. This will write all of the information to the WordPress database and making it available for Syncing. When the menu is ready to be synced, you can click on the “Push to Target” button and the menu, along with all of its settings including Navigation labels, hierarchy, custom CSS classes, descriptions, etc. will be Pushed to the configured Target site.

On the Target, if the menu does not already exist, it will be created and all of the Pages and links will be added to it. If the menu already exists, it will be updated with the contents of the menu from the Source site. In addition, any references to URLs on the Source site will be modified to the appropriate URL of the Target site automatically.

One thing to note: If the menu you wish to Push contains Page or other Content Links that do not exist on the Target site, then the menu will not be able to be created on the Target site because of this missing Content. Error messages will be displayed after Syncing, informing you of any Content that needs to be created on the Target site. You will need to edit those Pages and Push the Content to the Target site before Syncing the Menu can be done.

License Keys

For information on how to activate the License Key for WPSiteSync for Menus, please see this article: How to Configure License Keys for WPSiteSync add-ons.

Being the Product Architect at ServerPress, LLC, Dave brings 35+ years of experience bridging traditional architecture with innovative Workflow solutions. Creator of WPSiteSync, among many other products, he loves pushing technology to the limit. His motto: No coffee. No code.