Wordpress + Coda Starter Kit

Explore

Wordpress + Coda Starter Kit

1. Install & Connect

New User Accounts

Level: Basic

IMPORTANT: Please do not rush through this guide. If you miss one step then you may have to start over. Take your time and read the instructions carefully. Account connection issues can occur easily with multiple attempts so beware!

The below guide is best for first time Pack installs only.

If you have previously connected an account or already installed this pack go to

Re-Connect Accounts⁠

⁠

If you tried to install and had issue, then a clean up may be required first to start fresh again, also go to

Re-Connect Accounts⁠

⁠

If you have connection breakages or need to fix a connection without deleting your doc go to

Repair Accounts⁠

⁠

Step 1 - Create a fresh Coda doc

To get started we are going to install the pack and create a new connection. You will have the option to copy this template later but first we need to get an account added.

Create a new blank Coda doc. Call it “Connecting Account”

Step 2 - Install the Wordpress Plugin

2.1 Install the Wordpress plugin.

Download the “

Wordpress To Coda⁠

” plugin. Add to your Wordpress site like normal and activate it.

⁠

2.3 IMPORTANT: Ensure Permalinks have been set-up.

Plain Permalinks will not work with the Wordpress API. Ensure you re-save your Permalinks to anything other than Plain.

Settings>Permalinks, click your permalinks (not Plain) and/or make sure click “Save Changes” again.

⁠

There are 3 sync functions we need to test to ensure it is fully functional.

Function

Request Type

Direction

API Authentication

More Info

Syncing Tables To Coda

“GET”

Coda pulling data from Wordpress

Coda Pack

Open

Button & Actions

“POST” or “PUT”

Coda sending data to Wordpress

Coda Pack

Open

Embed On Wordpress

“GET”

Wordpress pulling data from Coda using Shortcodes

API Token & WP Plugin

Open

Template & Management Tables

Connecting to multiple actions & formulas

Open

There are no rows in this table

⁠

Step 3 - Create Your Pack Credentials

4.1 Create a new Wordpress user

Navigate to Wordpress>User>Add New and create a new user with Administrator role.

Copy & save the username in your new “Connecting Account” doc for adding later.

NOTE: We recommend creating a new user to keep track of your Coda connections and prevent accidental user deletion - however it is possible to use an existing user with Administrator role if you wish.

4.2 Create an Application password

Click on the newly created username and then scroll down to Application passwords. Create a new application password while ensuring to check the Coda Wordpress checkbox.

Go to All Users >

⁠

Click on the newly created user

⁠

Scroll down and fill in the Application password details remembering to check the Coda Wordpress Integration checkbox.

⁠

Click the “Add New Application Password“ button

Copy & save the new application password next to your username in your “Connecting Account” doc for adding later.

⁠

Before moving on please decide on either:

A: Connecting to your new fresh doc

Experienced Coda users who want to start fresh and deep dive using your own doc go to Step 4A next. You will always have a chance to copy this template again later if you wish.

B: Copying this template and re-syncing the account

A good option for beginners and recommended for those wishing to test out the Pack and take advantage of all our pre-built tables, buttons and formulas. Go to Step 4B

⁠

Step 4A - Connecting to your new fresh doc

If you created a new doc you will need to manually install the Wordpress to Coda Pack

To install click the “Insert” button (top right) then “Packs”. In the search bar, search for our Pack and then click the pack to open the Pack popup - but before doing that read the next points first...

Once the doc is copied a pop will appear asking you to “Connect my account”

Paste in your Wordpress credentials from the previous Step 3. that you saved in your “Connecting Account” doc and click “Continue” button. (see example below)

If you push “Connect later” you will have to delete that doc and copy again. (don’t ask why ;))

IMPORTANT: The Username = Wordpress username and Password = Application Password. Read previous steps carefully if confused.

⁠

Paste in your credentials from the previous Step 3 that you saved in your “Connecting Account” doc and click “Continue” button

If it asks who can take actions we recommend “Only You” for beginners unless you wish your organisation to also access it.

IMPORTANT: This pack has the ability to create, delete and update users including changing user passwords. Please be careful when sharing with other people in your organisation.

You will now see your connected Pack and all the tables and buttons

⁠

5.1.1 If you Copied This Template Doc in Step 1

If you copied this doc the pack will already be installed. You just need to connect a new account to the pack now.

IMPORTANT: Choosing “Shared” will determine if other Coda users within your organisation can access the data and have the power to change data on your Wordpress site. We recommend adding Private account to start.

Navigate to your Pack settings (Insert>Packs>Wordpress+Coda>Settings).

Click on “Private | + Connect an account” or “Shared | + Add a shared account” button

⁠

A pop up will appear asking you to connect. Go to next step 5.3.

Step 4B - Copying this template and re-syncing the account

You can copy the doc by clicking the green button below but before that read the next points ...

Once the doc is copied a pop will appear asking you to “Connect my account”

Paste in your Wordpress credentials from the previous Step 3. that you saved in your “Connecting Account” doc and click “Continue” button. (see example below)

If you push “Connect later” you will have to delete that doc and copy again. (don’t ask why ;))

⁠

Copy Doc

⁠

IMPORTANT: The Username = Wordpress username and Password = Application Password. Read previous steps carefully if confused.

Paste in your credentials from the previous Step 3 that you saved in your “Connecting Account” doc and click “Continue” button

If it asks who can take actions we recommend “Only You” for beginners unless you wish your organisation to also access it.

IMPORTANT: This pack has the ability to create, delete and update users including changing user passwords. Please be careful when sharing with other people in your organisation.

You will now see your connected Pack and all the tables and buttons

⁠

Step 5 - Activate Coda Developer Mode & Create a Coda API token.

5.1 Enable Coda Developer mode if not already active.

Go your

account settings⁠

and scroll to “LABS” then switch on developer mode. Refresh page. This only needs done once no matter how many times you use this pack in the future.

⁠

5.2 Generate a Coda API token.

In your

account settings⁠

scroll to API Settings and click the button to generate an API token.

⁠

Add a Name to reference your token such as “Coda Wordpress Pack API Token”

Click “Add a restriction” and enter Doc or table and Read Only type access.

Copy the url of your new Coda doc or copied template you are installing the pack on following the below format.

Example below of a correct entry

⁠

Click “Generate API Token” button

Once the token is generated click Copy token & save in your new “Connecting Account” doc for adding later.

⁠

IMPORTANT: This needs to be done for every new Coda doc created or copied you wish to connect. If you copy or duplicate a doc or even revert to a new version you will need to redo these steps again as the API token only targets the specific docID it’s been set-up for. It’s also worth noting that Coda targets the DOC ID and not the doc name. So do not worry about changing the name of your Coda doc.