=== Mathilda ===
Contributors: unmus
Tags: twitter, tweets, social, content, reclaim
Requires at least: 4.5
Tested up to: 4.5.1
Stable tag: 0.1
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Mathilda brings back control of your tweets.

== Description ==

Mathildy is trying to give you back control of your tweets. The plugin takes your tweets from twitter permanently and saves them into the WordPress database. After that the tweets can be displayed on the blog chronologically (but do not have to). Indeed, Twitter is also blogging, micro-blogging so to speak. 

= Functions =

* Copy your tweets back
* Copy your tweeted images back
* Display your tweets on the blog
* Import of your complete tweet history
* Export your tweets as CSV file
* Plugin Healthy Check
* Languague: English

= Live Demo =

[Here!](https://www.unmus.de/tweets/)

= Related Links =

[Plugin Page (German)](https://www.unmus.de/wordpress-plugin-mathilda/)

== Installation ==

1. Upload plugin folder to the /wp-content/plugins/ directory
2. Activate the plugin through the Plugins menu in WordPress
3. Follow the configuration manual

== Frequently Asked Questions ==

= A question that someone might have =

An answer to that question.

= Which Tweets are displayed in the blog? =

Mathilda focuses on the core functionality of Twitter meaning only Text-Tweets, Images, Hashtags, Mentions and Links are displayed. Image Series, Surveys, Quotes, Videos and GEO-Locations are not supported. 

= Why does Mathilda not support Retweets or Replies? =

Retweets are not your data and replies are more like communication than posts. That is why we do not show them.

= Can I use Mathilda without Crons? =

Theoretically yes. But you have to run the cron job manually, which is not a nice solution.

= What do I have to do first, run the cron or import my tweets?

All the same. It works both. Mathilda is flexible.

= How long is the cron running? =

The initial load will take several minutes. If you have thousands of tweets, thousands of objects must be copied. The regular cron will not take more as 2 minutes. 

== Screenshots ==

1. Mathilda Settings
2. Mathilda Tools
3. Tweets @ User Interface

== Changelog ==

= 0.1 =
* May 2016
* Initial Version

== Configuration ==

1. Register your Mathilda-Instance as Twitter-Application for API Access [apps.twitter.com](apps.twitter.com)
2. Activate the plugin in WordPress
3. Maintain OAUTH Access Token, OAUTH Access Token Secret, Consumer Key, Consumer Secret and your Twitter Account in the settings(Settings/Mathilda)
4. Import your tweet history (optional, can be done later)
5. Run the Mathilda Cron (Tools/Tweets) - this will take several minutes
6. Create a WordPress page (page name must match the matilda slug)
7. Plan the cron regularly (Target-URL: www.yourblog.com/wp-contents/plugins/mathilda/mathilda_cron.php) 

= How can I import my tweet history? =

Twitter API provides access to your 3200 latest tweets. If you have not written more, the import is not required. To import your tweets, you must download your tweet archive from Twitter (Profile/Settings/Your Twitter Data). Your archive contains the folder "data/js/tweets". Upload the containing files to "www.yourblog.com/wp-content/uploads/mathilda-import/". Now you can run the import (Tools/Tweets).

= CSS classes =

You know the game! Mathilda can not assure that it looks fine on your theme. That is why all mathilda UI elements can be addressed with individual CSS selctors. Please use your debugger to find the right classes. 

= Data & Files =

Mathilda creates 4 folders within wp-content/uploads.

* mathilda-twitterapi = Archive of the Twitter API data
* mathilda-images = Tweet Image Folder
* mathilda-export = Export Directory 
* mathilda-import = Import Directory