=== Gigaom OpenCalais ===

Contributors: abackstrom, borkweb, methnen, misterbisson, zbtirrell

Tags: bSuite, taxonomies, terms, tag suggestions, opencalais

License: GPLv2

Requires at least: 3.7

Tested up to: 4.0

Stable tag: trunk

Easier tagging thanks to suggestions from OpenCalais

== Description ==

Integrates OpenCalais tag suggestions in the WordPress edit interface. Supports multiple and custom taxonomies. Maps between OpenCalais entities and facts and WordPress taxonomies, including custom taxonomies.

Suggested tags are shown in the editor interface in the same UI sections where tags are typically added.

Use of this plugin requires an API key and is limited by the API license and terms of service. Register for an API key at http://www.opencalais.com/user/register .

See installation section for custom configuration instructions.

= Batch auto-tagging =

The plugin also includes (not pretty) tools for automatically tagging previously published content. Logged-in users with sufficient permissions can visit wp-admin/admin-ajax.php?action=go_opencalais_autotag which will automatically start tagging content.

= In the WordPress.org plugin repo =

Eventually at: https://wordpress.org/plugins/go-opencalais/

= Fork me! =

This plugin is on Github: https://github.com/GigaOM/go-opencalais

== Installation ==

1. Place the plugin folder in your wp-content/plugins/ directory and activate it.
2. Follow the configuration instructions below to set the api_key

= Configuration =

In your theme or another plugin, add a filter on the go_config hook that returns an array of taxonomies when the the 2nd paramter is go-opencalais

• Config array format example:

   array(
   	'api_key' => 'insert your api key here',
   	'post_types' => array( 'post' ),
   	'confidence_threshold' => 0,
   	// Number of characters to allow for stuggested tags
   	'max_tag_length' => 100,
   	// The number of allowed ignored tags per post
   	'max_ignored_tags' => 30,
   	'mapping' => array(
   		// In the format of 'OpenCalais entity name' => 'WordPress taxonomy',
   		'socialTag' => 'post_tag',
   	),
   	'autotagger' => array(
   		// Term to indicate when a post has been autotagged already
   		'term' => 'autotagged',
   		// The relevance threshold at which to not add a tag
   		'threshold' => 0.29,
   		// Number of posts to auto tag per batch
   		'num' => 5,
   	),
   );

That configuration is where the api_key is specified, as well as mapping between OpenCalais entities and WordPress taxonomies, valid post types on which to suggest terms, etc.