- Connect to Canto
- Login to Canto
- Plugin Options
- Using the Canto Plugin with WordPress ‘Gutenberg’ Editor
- Image Options in WordPress Gutenberg
- Additional Metadata
- Plugin Support
How to install the plugin
Installing the Canto WordPress plugin can be done either by searching for Canto via the Plugins > Add New screen in your WordPress dashboard or by using the following steps:
- Download the plugin here or from the official Wordpress website: https://wordpress.org/plugins/canto/
- Upload the ZIP file through the Plugins > Add New > Upload screen in your WordPress dashboard
- Activate the plugin through the 'Plugins' menu in WordPress
Configure and authorize your account under the Settings > Canto left navigation menu. Click Connect and enter your account credentials. You will be automatically redirected back to WordPress.
Connect to Canto
Once you have activated the plugin, you will need to connect to the Canto API. Navigate to Settings > Canto in the WordPress Admin sidebar menu.
Then you will see the following option. Most users will connect with the default option: company.canto.com.
If your Canto subdomain ends in .canto.global or you use a legacy connection to .cantoflight.com, then select the appropriate option.
Login to Canto
When you click Login to Canto you will reach our OAuth connection screen. Please enter in your Canto subdomain and login information to connect your WordPress install to the Canto API.
- If you have SSO set up, you may log in with your SSO login.
- Once authenticated, click Allow.
- You will be automatically redirected back to your Settings page with authentication details provided.
Note: The security token will need to be refreshed at the date indicated (30 days from when you authenticated). Your images will still be active within WordPress, but you will not be able to access the Canto API until you re-authenticate by following the login process again. This means the automatic update will not work until you re-authenticate again.
The plugin options will use the Canto API and operate as background tasks when enabled.
Duplicate check - This option will use the unique file identifier in Canto and check your WordPress Media Library. If the unique file identifier is located, it will update any information from Canto into WordPress but insert the existing media link so you only have 1 copy on your WordPress site.
Automatic Updates - This uses the WordPress Cron functionality to search your WordPress Media Library for files imported from Canto. It will import the latest version, file information, and metadata and update accordingly in the media library. Please be advised that your site performance could be affected if you choose to run this option frequently (Every Day) and do not have the appropriate server resources available for large media library searches.
How to use the Canto plugin with WordPress ‘Gutenberg’ editor
The Canto WordPress Plugin creates a Gutenberg Block that allows you to import an asset from Canto directly into the WordPress editor.
- To use the Canto block, click the Add Block icon and search for, or click Canto under Common Blocks.
- This will create the Canto block with a button to open a modal overlay with the Canto interface. From here you simply locate your assets from the folder tree or by using the search function.
- Once you locate the asset, simply click on the file thumbnail. It will open another modal with the file details to review. Then you can click Insert into Post to import from Canto into WordPress.
Image options in WordPress Gutenberg
Once the image is imported into WordPress, the modal popups will automatically close and send you to the standard editor screen.
From here, you can set your options as you normally would any image in WordPress. This includes alignment, alt text, image sizes defined by your theme, link to the image, as well as any additional options that are defined by your theme.
When an image is imported from Canto into WordPress, it also pulls in metadata that was imported or added in Canto. This includes all the standard file info fields such as file name, title, description, and dimensions. But we also import any data that is set in the Copyright and Terms & Condition metadata fields from Canto.
Support for Canto WordPress plugin
Like all great WordPress plugins, ours is publicly available under the GNU General Public License. You are welcome to clone or branch to use as needed, or keep up-to-date as we continue to add more awesome features!