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®
What You're Getting
ParrotWP® is a WordPress plugin that syncs your Cadmium Education Harvester data directly into WordPress, creating presentations and presenter profiles as custom post types.
Prerequisites Before Purchase:
- Active Cadmium account with Education Harvester API access
- Cadmium API key (contact your Cadmium representative)
- WordPress hosting that meets our technical requirements
What’s Included:
- ParrotWP® plugin files
- Advanced Custom Fields Pro (ACF) plugin
- Pre-configured field templates for Cadmium data
- License codes for ParrotWP®
Purchase Process:
- Buy – Complete your purchase at ParrotWP.com
- Access – Log in to My Account → Downloads
- Download – Get your plugin files and license codes
- Next – Proceed to Installation
Enter License Codes for ParrotWP®
Let's Make it Official
License codes are only active for the duration of your ParrotWP® subscription. This includes both ParrotWP® and Advanced Custom Fields Pro. If you opt not to renew, both your ParrotWP® and Advanced Custom Fields Pro licenses will be deactivated.
Step 1: Install the Plugins
- In WordPress, go to Plugins → Add New → Upload Plugin
- Upload and activate the ParrotWP® plugin file
- Repeat the same process and upload and activate the Advanced Custom Fields Pro plugin file
- Both plugins should now appear in your active plugins list
Step 2: Get Your License Codes
- Log in to My Account
- Click Orders → View (under Actions)
- Scroll down to find your license codes (displayed in green)
Step 3: Activate ParrotWP®
- In WordPress, click ParrotWP® in your sidebar menu
- Enter your ParrotWP® license code
- Click Activate
What Happens Next: After activation, you’ll see new menu items under ParrotWP®:
Main Dashboard & Content:
- Dashboard – Overview of ParrotWP® performance and sync status
- All Presentations – Complete list of your imported presentations with key details
- All Presenters – Complete list of your imported speakers/presenters with key details
Content Organization:
- Categories – Auto-generated categories from your Cadmium data to organize presentations
- Tags – Auto-generated tags from your Cadmium data for additional organization
- Sponsors – Sponsor information connected to your presentation data
Import & Sync Management:
- Import – Run manual syncs and configure import settings
- Import History – View logs of successful and failed imports
- Field Selection – Choose which Cadmium fields to import (customize what data you need)
- Field Transformations – Convert data formats (e.g., “3/1/25” → “March 1st, 2025”)
Plugin Configuration:
- Settings – Core plugin settings and automated sync (CRON) options
- Calendar Settings – Configure calendar display, event location, and related features
- Data Cleanup – Reset ParrotWP® settings and configurations if needed
Step 4: Activate Advanced Custom Fields Pro
Support Note: For Advanced Custom Field issues, contact ParrotWP® support, not the ACF developer directly.
Import Your Custom Fields
Custom Fields
What This Does: Custom fields define what data ParrotWP® can store from Cadmium (presentation titles, speaker bios, session times, etc.). You need to import these field templates so WordPress knows how to handle your Cadmium data.
Before You Start:
- Advanced Custom Fields Pro should be installed
- You should have the ParrotWP® download files from your account
Step 1: Locate Your Field Files
- Find the ParrotWP-ACF-Items.zip file in your downloaded ParrotWP® files
- Unzip this file
- Look for the Import Into ACF folder
- You’ll see two .json files:
event_fields_import_acf.json(for presentation data)presenter_fields_import_acf.json(for speaker data)
Step 2: Import the Field Templates
- In WordPress, go to Custom Fields → Tools
- Under “Import Field Groups,” click Choose File
- Upload
event_fields_import_acf.jsonfirst, then click Import - Repeat: click Choose File again
- Upload
presenter_fields_import_acf.json, then click Import - Important: Make sure that both sets of fields are assigned to their respective post types. Event fields should be assigned to Cadmium Presentations and Presenter fields should be assigned to Cadmium Presenters.
Important Notes:
- Existing ACF Users: Don’t reinstall ACF if you already have it – our version is identical to the standard version
What’s Next: Your WordPress site now knows what data to expect from Cadmium. Time to connect to your Cadmium API and sync your data!
Sync Your Data Once
Time to Sync
What This Does: This connects ParrotWP® to your Cadmium account and imports all your presentation and presenter data into WordPress for the first time.
Step 1: Connect to Cadmium
- Go to ParrotWP® → Settings
- Enter your Cadmium API key (get this from your Cadmium representative)
- Click Save Changes
Step 2: Configure Your Import
- Go to ParrotWP® → Import
- Under Update Mode: Select “Update all entries”
- Under Import Mode: Select “Yes”
- Under Delete Mode: Select “Yes” (removes presentations deleted from Cadmium)
- Batch Size: Choose how many items to import at once
- Recommended: 5-10 presentations (prevents server timeouts)
- Slower hosting? Use 5 or fewer
- Faster hosting? You can try 10-15
Step 3: Run Your First Sync
- Click “Run Import Presentations” first
- Wait for completion – you’ll see a progress bar
- Then click “Run Import Presenters.”
- Wait for completion again
Critical: Don’t Leave This Page. Stay on the import page during the entire process. Leaving can cause incomplete or corrupted imports.
What to Expect:
- Import time depends on your data size (could be minutes to an hour)
- The progress bar shows the current status and the items imported
- Larger event catalogs take longer
If Something Goes Wrong:
- Check ParrotWP® → Import History for error logs
- Try reducing your batch size
- Contact support if imports repeatedly fail
Verify Your Import
Success! Your Cadmium data is now in WordPress
Check Your Results: Once the import progress bars show 100% complete, it’s time to verify everything worked correctly.
Step 1: Check Your Presentations
- Go to ParrotWP® → All Presentations
- What you should see:
- List of presentation titles as WordPress posts
- Same number of presentations as in your Cadmium system
- Recent import date/time stamps
Step 2: Check Your Presenters
- Go to ParrotWP® → Presenters
- What you should see:
- List of all your speakers/presenters
- Same number of presenters as in your Cadmium system
Step 3: Verify the Data
- Click on any presentation or presenter
- What you should see:
- Detailed custom field data from Cadmium
- Speaker bios, session descriptions, schedules, etc.
- All fields populated (no empty critical fields)
If Something Looks Wrong:
- Missing data? Check ParrotWP® → Import History for errors
- Partial import? Your batch size might be too large – try a smaller number
- No data at all? Verify your API key in Settings
- Still having issues? Contact ParrotWP® support with your import history logs
What’s Next:
- Set up automated syncing in Settings → CRON options
- Customize your field selection in Field Selection
- Start building your presentation display pages
- Explore Calendar Settings for event scheduling features
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.