Get Setup, Installed, And Sync'd In Seconds
DEVELOPED FOR EASE OF IMPLEMENTATION
Below you will find our ParrotWP® documentation., which covers installation, syncing, and advanced features.
Purchase ParrotWP®
LET’S GET STARTED
To get started, you will need to download your plugin files and have a valid license code from ParrotWP.com. You can find these on our website in the My Account section by clicking on Downloads. Make sure you also have a valid Cadmium account with access to the Education Harvestor API. You will need this API key for later use (see your Cadmium rep for details).
Once you have all of these items, go ahead and log into your WordPress system. Next:
- Click on Plugins
- Click Add New
- Click Upload Plugin
- Click Choose File and select the ParrotWP labeled file
- Click Install Now
- Click Activate
You will need to repeat these steps for the Advanced Custom Fields Pro (ACF) plugin, (if you do not use this plugin already) which is packaged with your purchase.
Enter License Codes for ParrotWP®
LICENSE CODES
After purchasing ParrotWP® you will receive the necessary ParrotWP® license codes in the My Account section. To retrieve them in My Account, first, log in and click on Orders, click on View under Actions, and scroll down a bit to see your license code (in green).
In your WordPress dashboard, click on ParrotWP® in your WordPress sidebar menu and enter your license information to activate your plugin. Once ParrotWP® is activated you will see a slew of new menu items added to your WordPress sidebar menu underneath ParrotWP®.
- All Presentations is a custom post type added to your WordPress installation and will be the designated location for any data passed through the Cadmium API.
- Presenters are a Presenters data subset to store your presenters separate from your All Presentations list. (NEW in 2.1+)
Importing Your Custom Fields
CUSTOM FIELDS
Also added to your sidebar menu, after installing Advanced Custom Fields Pro (ACF), is a new menu item labeled ACF. Within this next step, you will need to do a few things:
- Enter your Advanced Custom Fields Pro license code by clicking on Custom Fields and then selecting Updates from the drop-down menu.
- All support inquiries for ACF need to go through our support portal. Do not contact the ACF plugin developer. They will not provide any support to you.
- Locate the ParrotWP-ACF-Items.zip file in your ParrotWP® packaged files. This file contains all the available Cadmium fields (both Event and Presenter fields) in the Education Harvestor API.
- Unzip this zip file and locate two .json files in the Import Into ACF folder
- Click on Custom Fields and select Tools from the menu.
- Click on Choose File under Import Field Groups and upload (one at a time) the event_fields_import_acf.json and presenter_fields_import_acf.json files.
NOTE: If you already use the pro version of this plugin on your website, don’t install this plugin over your existing version. There are no differences between our version and the version available on the ACF website.
If you’re updating from ParrotWP® 1.0, upload the new presenter_fields_import_acf.json file only. There are no new fields in the event_fields_import_acf.json file.
Sync Your Data Once
TIME TO SYNC
Now that all the plugin files are installed, and all license codes are activated, it is time to sync your data. In the WordPress sidebar menu, click on ParrotWP® > Settings and enter your Cadmium API key and click Save Changes.
Once the changes are saved, click ParrotWP® > Import. Next choose Update all entries, under Update Mode, select Yes, under the next option, then select Yes next to deleting entries deleted from Cadmium. Lastly, depending on your web hosting, choose how many presentations you want to import at a time. We recommend 5-10. Then select Run Import Presentations first and then select Run Import Presenters.
Below a progress bar will be shown showing the progress of your import alongside how many presentations are being imported.
Visit ParrotWP in the Menu
CHECK RESULTS
After a few minutes, click on ParrotWP® > All Presentations to see the results of your import from the Cadmium Education Harvestor API.* You will see all the presentation names listed as WordPress Post Titles. Next, click on ParrotWP® > Presenters to see a list of all of your presenters. When you click on any entries, you will see a long list of custom field data populated with your Cadmium field data.
Congrats! Your data is now in WordPress.
* Depending on the number of presentations being imported, you may have to wait longer to see a complete list of your presentations. Do not leave the import page during import or you run the risk of importing your data incorrectly.
Before purchasing ParrotWP®, please check that your hosting environment fulfills our minimum requirements to guarantee successful syncing.
ParrotWP’s® operation demands significant hosting resources, mainly throughout the syncing process. To achieve optimal performance, it’s essential to have the capability to adjust server-related settings and timings. This flexibility ensures that the plugin can efficiently manage data transfers and updates without overburdening the server, improving reliability and speed. Ensuring your hosting environment can accommodate these adjustments will help maximize the plugin’s effectiveness and ensure seamless integration with your website.
- PHP/WordPress memory limits must be at least 128MB
- Max Vars must be above 4,000
- Scripts must be allowed to be executed for a minimum of 900 seconds (often referred to as max_execution_time).
- Example: WP Engine hosting*, your script execution time is only 60 seconds.
- PHP 7.4 or greater – PHP 8 for optimal performance
- MySQL 5.6 or greater OR MariaDB version 10.1 or greater
- WordPress 5+ with server-side CRON available
*WP Engine has a short script execution timer, which impacts the ability to import larger agendas.