WordPress to Canvasflow - Plugin
To begin publishing from WordPress please contact us to request an API key and enable WordPress publishing on your account.
To get started, follow the steps outlined below to set up your WordPress instance and Canvasflow account.
Installing the Canvasflow for WordPress Plugin
- Download the Canvasflow WordPress Plugin by searching from the Plugins page found in your WordPress dashboard (alternatively download here and extract to ‘/wp-content/plugins/canvasflow’)
- Activate the plugin. Please Click here If you have trouble when attempting to activate the plugin
To configure your plugin:
- Navigate to the 'Canvasflow' tab now found in your WordPress dashboard
- Select 'Settings'
- Paste the API key provided into the API field and save to validate and sync
- Select the publication you wish to connect to
- Select the default style you'd like applied to your published articles (This can be overridden when you publish an article if required
- Include Title: Choose whether you'd like to include the article Title in content published to Canvasflow (When disabled, only the post's body content will be published)
- Auto Publish: Choose whether you'd like content to be auto-published to the connected distribution platform when publishing from WordPress (e.g. Wordpress -> Canvasflow -> Twixl App)
- Custom Post Types: Add any custom post types set up in your WordPress instance to make them eligible for publishing
- Merge Adjacent Paragraphs: Disabling this option forces paragraphs to be treated as individual components within Canvasflow. For example, if the option is disabled and an article with adjacent paragraphs is published to Canvasflow, it will output in Canvasflow as:
[Title] [Paragraph] [Paragraph] [Image]
[Title] [Paragraph] [Image]
(each closed bracket representing an individual component)
Publishing an article from WordPress
With the plugin installed and connected to Canvasflow, a Canvasflow Publish Widget will be displayed in the Editor of any post, next to where you find Metatags, Feature Image and Category options. Here's an example:
If this widget isn't visible after installing the plugin, it may need to be enabled using the ' Screen Options' menu at the top right
The publish widget enables content to be published from within the editor to fit seamlessly into your workflow. Simply select a Style (or leave as default) and select ‘ Publish to Canvasflow’.
Should for any reason the post fail to publish an 'Error' message will appear. If an error message is displayed, it's advised to check your plugin settings to ensure the correct API key and publication has been selected. Please contact our support team if you have problems when attempting to publish article content.
Using the Post & Upload Manager
For more control over publishing content, the Canvasflow plugin provides two additional menus:
- Select the article(s) you would like to make eligible to be published to Canvasflow
- Click 'Save' to confirm
- The selected article(s) will now be available via the 'Upload Manager' menu
Within the ' Upload Manager', you'll find all articles selected from the 'Posts Manager' and articles that have been previously published from the publish widget. Using the item options you can:
- Upload / Update - Uploads the article to Canvasflow. This button can take several different forms which indicate the current status of the article.
- Grey - Indicates a new article that has never been published to Canvasflow
- Green - Once successfully published. the upload icon will appear green indicating it is synced with your Canvasflow publication
- Orange - An article that has previously been uploaded to Canvasflow but whose content has been changed will display an 'orange' upload icon, indicating it is out of sync with your Canvasflow publication. Click publish to update the article content.
- Collection/Issue/Style - The options are displayed depending on what is available in the connected publication. For example, an 'Issue' tab will be available if connected to an Issue-Based Canvasflow publication, and 'Collection' will be available if connected to a publication with collections set up