=== Believintech Post Sync for Airtable ===
Contributors: believintech
Tags: airtable, api integration, data sync, custom post type, automation
Requires at least: 5.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Sync Airtable records to a WordPress custom post type with flexible column mapping and on-demand create or update functionality.

== Description ==

Believintech Post Sync for Airtable connects your Airtable base to WordPress and lets you create or update posts in a dedicated Custom Post Type from your Airtable records.

Watch the demo video: https://youtu.be/6ZNXy5aweT0

Features include:

* Save Airtable Base ID, Table ID or Name, and API Token from the WordPress admin.
* Fetch the column list from your Airtable table.
* Map each Airtable column to a WordPress post field (Title, Description, Featured Image, or Meta Field).
* Create new posts or update existing posts in the `bptsa_air_sync` Custom Post Type when records are synced.
* Map every fetched Airtable column to a WordPress field.

This plugin is not affiliated with, endorsed by, or sponsored by Airtable. "Airtable" is a trademark of Formagrid, Inc., used here only to describe the service this plugin connects to.

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/` or install it through the WordPress admin.
2. Activate the plugin from the Plugins screen.
3. Open **Airtable Integration** in the WordPress admin menu and enter your Airtable Base ID, Table ID or Name, and API Token.
4. Click **Fetch Airtable Columns Data** to load your column list, map the columns to WordPress fields, then click **Create or Update Records** to sync.

== Frequently Asked Questions ==

= Where do I find my Airtable API token? =

Generate a personal access token at https://airtable.com/create/tokens with read access to the base you want to sync.

= Where do I find my Base ID and Table ID? =

You can find your Base ID and Table ID from the Airtable API documentation page for your base at https://airtable.com/api.

= Does the plugin send any of my WordPress content to Airtable? =

No. The plugin only reads from Airtable and writes to your WordPress database. Nothing about your WordPress site is sent to Airtable.

= Is there a demo video? =

Yes. You can watch the setup and sync demo here: https://youtu.be/6ZNXy5aweT0

== External services ==

This plugin connects to the Airtable REST API (https://api.airtable.com/v0/) to read records from your Airtable base and create or update them as posts inside WordPress.

What the service is used for:
The Airtable API is used to fetch the columns and records of the Airtable base you configure, so the plugin can map and synchronize them into a WordPress Custom Post Type (`bptsa_air_sync`).

What data is sent and when:
The plugin sends your Airtable Personal Access Token (as a Bearer token), the configured Base ID, and the configured Table ID or Name in the URL/query of each request. Requests are sent only when a logged-in WordPress administrator explicitly clicks **Fetch Airtable Columns Data** or **Create or Update Records** on the plugin settings page. No WordPress data is sent to Airtable.

This service is provided by Airtable (Formagrid, Inc.):

* Terms of Service: https://www.airtable.com/company/terms-and-policies
* Privacy Policy: https://www.airtable.com/company/privacy

== Changelog ==

= 1.0.0 =
* Initial release.
