Air WP Sync Documentation

To install our Air WP Sync plugin in WordPress, follow the steps below:

• Download the plugin file to your computer
• Log in to your WordPress dashboard
• On the left-hand side menu, click on “Plugins” and then “Add New”
• Click the “Upload Plugin” button at the top of the page
• Click the “Choose File” button and select the plugin file you downloaded in step 1
• Click the “Install Now” button
• Wait for the plugin to be installed, and then click the “Activate” button

After installing and activating the plugin in WordPress, it will appear in the admin menu and access to the connection and configuration settings.

Before creating a connection, you are prompted to enter your license key to validate the installation of the plugin. To activate this license key, go to Air WP Sync > Settings.

The license key is available both in your purchase confirmation email, as well as on wpconnect.co > My Account > My Downloadable Products > License Keys, View Licenses.

You will then be redirected to the purchase page of your product. Click on the key icon to see the license number appears and copy-paste it into your Air WP Sync License Key field.

Once the license key is copied into the Air WP Sync settings, be sure to click the “Activate” button. If your license key is valid, a green checkmark will appear and you just need to save the settings by clicking the “Update settings” button.

You can then begin creating your connections.

To create a new connection to your Airtable account, go to Air WP Sync > All Connections, click the “Add New” button and enter a name for your connection.

⚠️ Air WP Sync now uses Personal access tokens
Personal access tokens in Airtable are in Now in beta. This a new, more secure way to grant API access to your Airtable data. Create multiple tokens, grant them access to specific bases, and manage them individually.

You will be asked for an Access token to connect your account. We recommend that you retrieve this token using the this link. Once you are on the overview page of your Airtable account click on the «  Go to developer hub » button. Move to the Personal access token section and click on the « create new token »  button. Choose a name for your token and then select Scopes to determine your token’s perimeter. In order to use our plugin your token needs to be able to: 

• data.records:read (See the data in records)
• schema.bases:read (See the structure of a base, like table names or field types)

Finally, in Access part, add the workspaces and bases for which you want to grant access to your token. And click on the « Save changes » button.

Once it has been generated, you can copy and paste it into the Access Token field.

Once your Personal access token has been entered in the field, choose the database from which you want to import content, as well as the table and/or views. You also have the option to add formula filters to your views, which work the same way as in Airtable.

⚠️ CAUTION for Air WP Sync Free users: Airtable API key is now deprecated, you can no longer use it. Please replace it with a Personal access token. To generate and configure these tokens, follow the following URL.

• Post: An article is a content that can be published on a blog or website. They are generally used to share news or information and are usually organized chronologically on a blog or website. They are created and managed in the “Posts” section of the WordPress dashboard.

• Page: A page is static content that is usually part of a website’s navigation menu. They are used to display information. They are created and managed in the “Pages” section of the WordPress dashboard.

In the case where you are using a theme and/or specific development, several other post types may be available to you. These are all Custom Post Types that have already been defined by your installed themes or plugins or by the developers of your WordPress site.

Our Air WP Sync plugin offers the ability to create your own Custom Post Types on-the-fly specifically for your imported content.

⚠️ Although WooCommerce Product CPT appears on the list, it’s only available for basic mapping configuration. WooCommerce for Airtable full integration will be available soon.

For the Custom Post Type that you will create from the Air WP Sync plugin, you will find the possibility of mapping the following WordPress fields: Title, Content, Slug, Custom Field.

It also allows you to create your own Custom Fields.

⚠️ CAUTION, if you decide to change the configuration and no longer use the Custom Post Type created specifically through the Air WP Sync plugin, this CPT created on-the-fly will no longer exist in WordPress and the content imported will also no longer be available.

Like in WordPress, imported content from Airtable can have different status: Published, Draft, Scheduled, Pending, Private.

Each of these status checks the following conditions:

• PUBLISHED content is publicly visible on your website
• DRAFT content is saved as a work in progress and is not visible to the public
• SCHEDULED content is set to be published at a specific date and time in the future
• PENDING content is waiting for review or approval before it can be published
• PRIVATE content is only visible to logged-in users with the appropriate permissions

Depending on the status chosen, the synchronized content will receive the status defined in the settings.

If you decide to change the status in the configuration later, note that the change in status of already imported content will depend on the import strategy you have defined (see the different content import strategies).

You can now link your database fields with WordPress fields.

To do so, click the “Add field” button. Two drop-down lists are then available, one contains the fields of your Airtable database, the second the WordPress fields with which you can map them.

Post

For articles, you will find the possibility to map the following WordPress fields: Title, Featured Image, Content, Excerpt, Slug, Tag, Category or Custom Field.

Page

For pages, you will find the possibility to map the following WordPress fields: Title, Featured Image, Content, Slug, or Custom Field.

Existing Custom Post Type

For existing Custom Post Types, i.e. created by plugins or WordPress themes present on your site, you will find the possibility of mapping the following WordPress fields and any Fields linked to your CPT: Title, Content, Slug, Taxonomies or Custom Field.

Taxonomies are used to group similar content across multiple CPTs. They can be used to create filters or searches for your content.

Example of fields available for a Property CPT: Title, Content, Slug, Property type (taxonomy), City (taxonomy), Custom Field, etc.

Custom Fields

You can also consider adding specific fields to your content imported from WordPress by mapping your Airtable field to a Custom Field that you can name and which you will find in the imported content once the synchronization is complete.

⚠️ CAUTION, if you modify the configuration and remove a Custom Field that was created from the Air WP Sync plugin, you will not find it in any of the imported content.

Need to know more to understand how our Air WP Sync plugin works? We invite you to watch our video tutorial or our Step by Step Tutorial (free version)!

Triggers allow you to control when data is imported from Airtable to WordPress. There are three possible trigger options: manual, recurrent and instant.

• MANUAL: It allows you to manually import the data by clicking on the “Sync now” button. This is useful if you need to import data occasionally or want more control over when to import.
  
• RECURRENT: It allows you to schedule the import of data at regular intervals. You can choose how often the import should occur, such as every 5 minutes, hourly, daily, or weekly. This is useful if you want to regularly update your WordPress site with the latest data entered into Airtable.
  For better performance, you can set a cron job using WP-Cron: see our tutorial here.
  
• INSTANT: It allows you to import data as soon as it is added or updated in Airtable (depending on the selected import strategy). This is useful if you want your WordPress site to be in real-time sync with Airtable, but it can also be resource-intensive if you have a large amount of frequently updated data. To do so, you’ll have to create an automation. Follow this link to see our full tutorial on how to create an automation in Airtable.