coyote-team / coyote-wp

Wordpress Plug-in for Coyote
2 stars 2 forks source link
coyote-api coyote-service coyote-wordpress-plugin

Coyote WordPress plugin

The Coyote WordPress plugin allows for images in posts and pages to have their text description ("alt attribute") be managed by a connected Coyote description service. This means that all the image descriptions on your WordPress website can be managed remotely in Coyote.

Once the plugin is set up to connect to a valid Coyote API account, image meta-data stored in your WordPress installation may potentially be stored by Coyote. The plugin may also query the Coyote service to provide necessary functionality. Please familiarise yourself with the Coyote Terms of Service.

How it works

When the plugin is installed and its filters are enabled, it replaces image alt attributes in your posts with those retrieved from the Coyote service. When Coyote users change image descriptions, those descriptions are approved, and remote updates are enabled, those filters will also reflect these updates. The plugin effectively functions as a content filter; it does not permanently change the content of your WordPress posts or pages.

Installation

Download the plugin from the WordPress plugin registry and install it, or use the built-in WordPress plugin manager.

Configuration

Navigate to Settings > Coyote to configure the plugin. The following settings are available:

General plugin settings

Stand-alone mode

While stand-alone mode can be set manually, it is also automatically engaged when the plugin repeatedly fails to communicate with the Coyote API. When this happens, administrators can manually disable stand-alone mode and attempt to remediate the failing configuration. The plugin will attempt to recover from stand-alone mode mode by querying the API at a 5-minute interval.

API specific settings

Some of these settings become available once a working Endpoint and Token configuration has been provided.

Tools

Usually when first installing the plugin, you might want to do a first indexation of all the images in your WordPress installation and create associated resources on the Coyote API side. This tool uses a remote processor (See "Processor endpoint" in the general settings) to process your existing posts in batches. It can take a few minutes depending on the size of your WordPress installation.

Gutenberg support

The Gutenberg editor as of current does not support the required integration the plugin needs. There is an outstanding GitHub issue.

What If

I want to go back to manually managing original alt attributes

You can deactivate the plugin in your WordPress plugin settings page. Alternatively, on the Coyote plugin settings page, you can disable the "Filter posts through Coyote" option.

I want to stop using the Coyote service but retain the alt attributes provided so far

Don't deactivate the plugin: disable remote updates instead (see the plugin configuration).