Aeropage Sync for Airtable Plugin

A powerful, easy to use combination of tools that allow you to automatically (or manually) generate WordPress posts with custom metadata.

Create WordPress posts from your Airtable data.

Install the WordPress Plugin

The WordPress Connector has two parts, a WordPress plugin that pulls your Airtable data into wordpress, and an API tool to connect with airtable here.

To connect to wordpress, use the Aeropage Sync for Airtable plugin. You can find it in the WordPress directory by searching for “Aeropage“.

Add a Custom Post Type

Once the plugin is installed, just open it from the sidebar and “Add Post”.

After clicking “Add a Post” you will be shown a form.

Title

The title of the custom post type will usually be the same name as the table you”re importing data from in Airtable.

Dynamic URL

The dynamic url can be “SEO” friendly by using the name eg “shure-headphones” or it can be easier to manage potential duplicate names by using the unique id of each record.

API Token

Continue to the next steps to create a token to use with the api connector.

Auto Sync

A cron job that is executed in an hourly interval which is based on WordPress Cron implementation. WordPress Cron is WordPress’s task scheduler that runs on site visits to handle tasks like publishing posts and checking for updates.

WordPress Cron, and to an extent auto sync, relies on site traffic, so on low-traffic sites, tasks may not run on time.

If you have an access to the hosting server settings, you can update it like so:

Disable WordPress Cron in wp-config.php:

define('DISABLE_WP_CRON', true); 

Set up a server cron job to run wp_cron.php every hour:

*/5 * * * * curl http://example.com/wp-cron.php?doing_wp_cron 

When submitted this will create a custom post type and automatically add a new post for every record in your connected Airtable

To complete the form you will need an API token (below)…

Create API Connector & Token

The api connector stores your connection info and prepares the data in the response to be used in WordPress.

Connect to Airtable

After clicking new and creating your project, copy and paste the url to the airtable data you want to connect. To find out more details on this step, click on the instructions button.

Post Data & Fields (MetaData)

you can create dynamic values for your posts when they appear in “loops” on your WordPress archive pages, query and loop templates

Post Title

If you want to make a custom title, instead of using the default name of the records.

Post Image

The image will be automatically downloaded to your wordpress media library.

Post Excerpt

A short description of the post content.

Fields (Metadata)

By default, every field in your airtable record will be created as post metadata. If you want to prevent some data from being synced, click the field settings and toggle off the ones you want to exclude.

Attachment Proxy

Replaces temporary links in your attachment fields with permanent urls.

💡 After making changes, you need to refresh the data to see the result.

Posts Preview

You can see a preview of how your posts would look in a WordPress loop by click on the “posts” view. This can be used to confirm the Post Title, Image and Excerpt are correct before you syncronize with WordPress.

Syncronizing with Airtable

Once your data is setup in Aeropage…

• Open the settings.
• Click on the “token” field to copy it.
• Go back to Wordrpress plugin, “create post” page.
• Paste your token into the API Token field.

💡 Auto sync can be toggled on to check for new and changed data.

After a few seconds, you should see your data appear in the right – and a Success message.

You are now ready to save the post, which will syncronize you posts for the first time. After syncronizing your custom post will appear in the WordPress menu, and a post will have been added for each record in your Airtable data.

💡 The first time you sync it can take longer as it”s downloading your featured images.

You should also see the featured images for each post in your media library.

Finished

You can now use your custom post to make queries and templates → also use custom post meta data, for any of the fields in your Airtable data when making Single Post templates. The custom posts and metadata should work with all your favorite builders.

Gutenberg

• Create loops using the “Query Loop” Block
• Make templates for your single posts.

Elementor

• Create loops using the “Loop Template” widget.
• Make templates for your single posts.

Divi

• Refer to documentation for how to make loops with custom posts and metadata.

Update your Data

To manually resync your data, make changes or delete – just click the icons below.

Make changes to the configuration

Resyncronize your data manually.

If you have auto sync toggled on, your posts will be updated automatically after running the cron job.

1. Upload the plugin folder to your /wp-content/plugins/ folder.
2. Go to the Plugins page and activate the plugin.
3. Create an API connector for Airtable on tools.aeropage.io.
4. Setup your custom post type, and sync your Airtable data to WordPress.

1. 

   Main plugin panel

2. 

   Adding a Post.

3.1.1
* Updates to the Auto Sync interval

3.1.0
* Sync by batch to avoid the 504 errors

3.0.0
* Mapping an Aeropage project to a post type
* Mapping Airtable Fields to a registered post meta and ACF support
* Setting an Airtable field as Post Content
* HTML support in Airtable fields for WYSIWYG editors

2.0.3
* Fixed bugs
* UI Improvements

2.0.2
* Fixed bugs
* Added a new flow for syncing
* UI Improvements

2.0.1
* Bug fixes

2.0.0
* New version released
* Added a method for letting users select airtable fields for categories

1.3.1
* Fixed the links for the tools website.

1.3.0
* Added View Record menu item in the admin bar
* UI changes and i mprovements

1.2.3
* Fixed the plugin import issue
* fixed issues reported for syncing and image upload to wordpress

1.2.2
* Fixed the image upload issue

1.2.1
* Fixed sync issues
* Fixed the links

1.2.0
* Added resyncing data in the admin bar
* Added a post status option in the Add/Edit Pages
* Added support for opening the Airtable URL of an Aeropage in a separate tab
* UI Improvements

1.1.0
* Added support for feature image downloading from airtable

1.0.4
* UI fixed and improvements

1.0.3
* Sync fixes and UI improvements

1.0.2
* UI improvements to the admin bar

1.0.1
* General bug fixes

1.0
* Plugin released.