=== Mathilda ===
Contributors: unmus
Tags: twitter, tweets, social, content, reclaim
Requires at least: 4.5
Tested up to: 4.5.2
Stable tag: 0.2
License: GPLv2
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Donate link: http://www.unmus.de/

Mathilda brings back control of your tweets.

== Description ==

Mathilda is trying to give you back control of your tweets. The plugin takes your tweets from twitter 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 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 (See other Notes)

== Frequently Asked Questions ==

= 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.

= Will the tweets be loaded automaticly? =

Yes. But the first load must be done manually (Tools/Tweets). Otherwise the autoload will not activated.

= How often will the tweets be loaded? =

Currently your tweets will be fetched from Twitter every 15 minutes. Mathilda uses the WP-Cron for this.

= What is the difference between Cron and Import? =

The cron takes your tweets online through the Twitter API and saves them into the WordPress Database. The Import takes your tweets from the files of your Twitter Archieve and saves them into the WordPress Database. For this, you must download your archieve from Twitter (see below).

= 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. Please wait until you have the success message at the end of the page.

= After I changed the slug and tweet page name, tweets will not be displayed anymore. =

Please flush your permalink-settings (Settings/Permalinks). Just save, that is all.

= Initial Cron and Import finish with a TimeOut Error. What's next? =

In this case the duration of the initial load exceed the max php execution time on your webhosting environment. Please change the value to 5 to 10 Minutes. If your provider does not allow this, try to manipulate the max php script execution time with htaccess (php_value max_execution_time). If this is also not working, please run the import step by step (each load with 12 files). 

= 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).

== Screenshots ==

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

== Changelog ==

= 0.2 =
* May 2016
* Replacement of WebCron with WP-Cron
* Import Script is changed from external script to WordPress Function
* First Version published at WordPress Plugin Directory

= 0.1 =
* May 2016
* Initial Release

== Upgrade Notice ==

= 0.2 =
This version does not require a webcron anymore.

== Configuration ==

1. Register your Mathilda-Instance as Twitter-Application for API Access [apps.twitter.com](https://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. Run the initial Mathilda Cron (Tools/Tweets) - this will take several minutes
5. Create a WordPress page (page name must match the mathilda slug) 

= How to setup Mathilda? =
[Screencast Video](https://apps.twitter.com) (german)

= 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