Chorus User Guide

Page tree

The Third Light Plugin for WordPress seamlessly integrates your existing Chorus system with WordPress, allowing you to browse, crop and use files (images and office documents only) from Chorus in your WordPress posts. It can be downloaded here. 

Please note that our plugin is only tested against a default WordPress installation. If you use custom WordPress editors or wish to add 'Fetch from Third Light' buttons to other pages, you may need to create your own plugin. Please see the Third Light Browser resources which will enable your developers to integrate Chorus with other CMS systems or WordPress editors.


Requirements

To use the WordPress plugin, you must meet the following requirements:

  • WordPress version 3.4 or above, currently tested up to version 4.6.1
  • WordPress must be running on PHP5.4 or above.

Installation

Steps within WordPress:

  1. In the WordPress administration menu, click Plugins > Add New > Upload Plugins > Upload the thirdlightbrowser-latest.zip > Install > Activate
  2. Alternatively, copy the plugin folder into your WordPress installation's /wp-content/plugins directory.
  3. In your WordPress administration menu, navigate to the Plugins menu and activate the Third Light Browser plugin that will now be listed.
  4. Having activated the plugin, a new submenu under the Settings menu will appear, named Third Light Browser. Click on this, and enter a valid URL to your Chorus site. Other settings are optional.

Now, when you create or edit a post, a new button will be available next to the WordPress Media button, which opens the Third Light browser. This browser provides a window into Chorus, and allows you to browse, select, and crop images before inserting them into your WordPress post.

Additional Configuration

Once installed, additional configuration is possible in the Third Light Browser settings menu (Settings -> Third Light Browser).

Output formats denote the sizes and formats of image that you can export images into WordPress from Chorus. Some example formats are preset, but new formats can easily be added or removed. This provides a consistency to the images that are exported to WordPress.

For each format, you can specify

  • Name - used to identify the output option inside the Third Light browser
  • Width - desired width (in pixels) of the output format
  • Height - desired height (in pixels) of the output format
  • Format - image file format to use
  • CSS Class - optional default CSS class to add to images inserted using this output format.

By setting automatic login to use a username or email address unique to a user in Chorus, and then providing an API Key, the Third Light Browser will automatically log in as that user, bypassing the need to manually do so.

FAQ

The Third Light Media button is greyed out on the add/edit post page, how can I enable it?

If the Third Light Media button is greyed out, it means that one or more of your settings is incorrect. The primary cause of this is that the URL has not been set, or is no longer valid. Navigate to Settings -> Third Light Browser, and make sure that the URL entered is valid. The plugin will attempt to verify this when you click Save and will notify you if the URL appears to be incorrect.

I am using a custom text editor in WordPress, will this plugin work with it?

As long as the third party text editor implements the standard WordPress hook (wp.media.editor.insert) to allow text to be inserted into it, it should work just as well as the native editor.

  • No labels