=== Contexto ===

Contributors: thetwentyseven2727
Tags: TinyMCE
Requires at least: 4.6
Tested up to: 4.7
Stable tag: 4.3
Requires PHP: 5.2.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html


Contexto add extra information to your post and pages. Just click the button, the plugin will do the rest! 


== Description ==

'It's impossible to understand the nuances of the world without some contextual clues' -Contexto.

Contexto is a TinyMCE plugin that works with [Wikidata](https://www.wikidata.org/wiki/Wikidata:Main_Page) and [TextRazor](https://www.textrazor.com/) APIs.

It adds images, description and links to help you to enrich your content. While creating or editing a post or page, select the words that you want to give some 'context', click the button and Contexto will find and add the extra information for you.

Visitors will hover with their mouse to those words you selected in the text, and they will see the descriptions, images and Wikidata links, that would enrich your content.

Contexto would give your users extra information to understand your content, without leaving your page to find the meaning of those words.

Currently [Wikidata](https://www.wikidata.org/wiki/Wikidata:Main_Page) has 46,091,721 items. Contexto can find people, places, brands, and anything that Wikidata has registered. If you cannnot find an item, just register to [Wikidata](https://www.wikidata.org/wiki/Wikidata:Main_Page) and contribute to the best database in the world.

You MUST register to [TextRazor](https://www.textrazor.com/) to make this plugin works. It is free to register and includes 500 requests per day.

You do not need to register to [Wikidata](https://www.wikidata.org/wiki/Wikidata:Main_Page). However, feel free to register and contribute to the project.


== Features ==

* Automatically adds extra content
* Select a word, sentences or paragraphs
* Easy to set up
* Mobile friendly


== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/contexto` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress
3. Use the Admin Panel->Contexto screen to configure the plugin
4. Follow the instructions in Settings page


== How does it work? ==

1. Create or edit a post or a page
2. Select a word or a sentence with your mouse
3. Click the button "Contexto me!"
4. Contexto automatically will search the word highlighted
5. If a word has been found, it will add the image and description found in Wikidata
6. Update or publish


== Configuration ==

1. Register on [TextRazor](https://www.textrazor.com/) with the free plan
2. You will receive a API key in your email
3. Paste your API key in the Admin Panel->Contexto screen


== Contact us ==

Got questions or feedback? Let me know! Contact me at media@thetwentyseven.co.uk.


== Contributors ==

Want to contribute? Check out the Contexto WordPress plugin on [GitHub](https://github.com/thetwentyseven/contexto).


== Frequently Asked Questions ==

= Can I select more than one word? =

Yes you can. However, it might be possible that Contexto find words that you do not want to publish. For that reason, we recommend to select a word per click.

= What is confidence? =

The confidence is the level of what [TextRazor](https://www.textrazor.com/) thinks is correct as a valid entity. [TextRazor](https://www.textrazor.com/) uses an ever increasing number of signals to help spot valid entities, all of which contribute to this score. In the admin panel you can select the level of minimum confidence to [TextRazor](https://www.textrazor.com/) to find words. The score ranges from 1 to 10, with 10 representing the highest confidence that this is a valid entity.

= Can I change the box colours? =

Yes you can. Contexto has clear structure so you can modify easily the colours.


== Screenshots ==

1. Front-end user view.
2. Contexto settings page
3. TinyMCE editor button


== Changelog ==

= 1.0 =
* First release.