unmus

Valentin

<p>Mathilda is trying to give you back some control of your tweets. The plugin copies your tweets from Twitter continuously and saves them into the WordPress database. The tweets can be displayed on the blog chronologically (but do not have to). Indeed, Twitter is also blogging, micro-blogging so to speak.</p>
<h4>Features</h4>
<ul>
<li>Copy your tweets back</li>
<li>Copy your tweeted images back</li>
<li>Display your tweets on the blog</li>
<li>Shows basic tweet statistics</li>
<li>Import your complete tweet history</li>
<li>Export your tweets as CSV file</li>
<li>Languague: English, German (only FrontEnd)</li>
</ul>
<h4>Live Demo</h4>
<p><a href="https://www.unmus.de/tweets/" rel="nofollow ugc">Here!</a></p>
<h3>Future of this Plugin</h3>
<p>As Twitter has decided to discontinue free access to the Twitter API in February 2023, I have stopped using Twitter, which also impacts the future of this plugin. For a longer period of time, the plugin was still able to execute API calls strangly enough. The plugin is using the Twitter API Standard v1.1. In the meantime Twitter became X and also free write access to v1.1 is still possible, but X has removed the required endpoint to fetch data. As consequence the core feature of the plugin is not working anymore, which is very sad. Independent from this, displaying of already received tweet data is still possible with this plugin. This feature will be kept alive until further notice. But further development in general is discontinued.</p>
<h3>Configuration</h3>
<ol>
<li><a href="https://dev.unmus.de/wp-content/uploads/Mathilda-Twitter-App-Registration.pdf" rel="nofollow ugc">Register</a> your Mathilda-Instance as Twitter-Application for API Access <a href="https://apps.twitter.com" rel="nofollow ugc">apps.twitter.com</a></li>
<li>Activate the plugin in WordPress</li>
<li>Maintain OAUTH Access Token, OAUTH Access Token Secret, Consumer Key, Consumer Secret and your Twitter Account in the settings</li>
<li>Run the initial load (Tools/Tweets)</li>
<li>Create a WordPress page (page slug must match mathilda slug)</li>
</ol>
<h3>Further Information</h3>
<h4>Supported Tweet Types</h4>
<p>Following tweet types are supported.</p>
<ul>
<li>140 Character Tweets</li>
<li>280 Character Tweets</li>
<li>Replys</li>
<li>Quotes</li>
</ul>
<h4>Supported Tweet Objects</h4>
<p>Following tweet objects are supported.</p>
<ul>
<li>Images</li>
<li>Hashtags</li>
<li>Links</li>
<li>Mentions</li>
<li>Galleries</li>
</ul>
<h4>Architecture</h4>
<p>Data storage and process logic is separated from the WordPress Framework. The toots are not saved in the table wp_posts. And TootPress is not registering a custom post type for the toots as well.</p>
<h4>CSS classes</h4>
<p>All mathilda UI elements can be addressed with individual CSS selectors. Please use your debugger to find the right classes.</p>
<h4>Data & Files</h4>
<p>Mathilda creates 4 folders within wp-content/uploads.</p>
<ul>
<li>mathilda-twitterapi = Archive of the Twitter API data</li>
<li>mathilda-images = Tweet Image Folder</li>
<li>mathilda-export = Export Directory </li>
<li>mathilda-import = Import Directory </li>
</ul>
<h4>wpCrons</h4>
<ul>
<li>Autoload Tweets (every 15 minutes, customizable)</li>
<li>Get Embedding Code from External Source (every 15 minutes, customizable)</li>
<li>Import Tweets (every Minute, if Import is running)</li>
</ul>
<h4>API</h4>
<p>WordPress Action: mathilda_tweets_updated (fired on tweet update)</p>
<h4>Related Links</h4>
<ul>
<li><a href="https://www.unmus.de/mathilda/" rel="nofollow ugc">Plugin Page (German)</a></li>
<li><a href="https://github.com/circuscode/mathilda" rel="nofollow ugc">Source Code @ GitHub</a></li>
</ul>
<h4>How to setup Mathilda?</h4>
<p><a href="https://www.unmus.de/mathilda/#screencast" rel="nofollow ugc">Screencast Video</a> (German)</p>
<h4>How to split large JSON files?</h4>
<p><a href="https://github.com/jhsu98/json-splitter" rel="nofollow ugc">JSON Splitter</a></p>


Mathilda

Mathilda copies your tweets from Twitter to WordPress.

<p>TootPress copies your toots from Mastodon to WordPress continuously. The toots can be displayed chronologically in the blog, making your timeline accessible to other people outside of Mastodon. In addition, you regain ownership of your own data back.</p>
<h4>Features</h4>
<ul>
<li>Copy your toots back</li>
<li>Copy your tooted images back</li>
<li>Display your toots on the blog</li>
<li>Retrieve your complete timeline</li>
<li>Languague: English, German (only FrontEnd)</li>
</ul>
<h4>Live Demo</h4>
<p><a href="https://www.unmus.de/troets/" rel="nofollow ugc">Here!</a></p>
<h3>Setup Manual</h3>
<ol>
<li>Install the Plugin in WordPress</li>
<li>Create an Application on your Mastodon Instance to get API Access (under Settings/Development)</li>
<li>Restrict the Authorization of the created Application to Read (all data)</li>
<li>Maintain Mastodon Instance and Access Token in the TootPress Settings</li>
<li>Retrieve your Account ID (in WordPress under Tools/Toots)</li>
<li>Maintain the Account ID in the TootPress Settings</li>
<li>Create a new WordPress Page and add the Page to your Menu</li>
<li>Maintain the Page ID in the TootPress Settings (you find the Page ID in URL of the Browser when editing the Page in WordPress)</li>
<li>Run Mastodon API Request once (in WordPress under Tools/Toots)</li>
<li>Activate Steady Fetch</li>
<li>That’s it!</li>
</ol>
<h3>Instructions for Use</h3>
<ul>
<li>You find TootPress in WordPress in the area of Settings and Tools</li>
<li>Steady Fetch activates the automatic and regular load of new toots</li>
<li>First API Request will copy your last 40 toots</li>
<li>New toots will be loaded every 15 minutes (customizable)</li>
<li>You can load your complete timeline into WordPress with the eponymous function</li>
<li>Loading your complete timeline can take several hours depending of the amount of toots</li>
<li>480 toots are loaded per hour as maximum</li>
<li>You can run a Mastodon API Request everytime at your own with the eponymous function</li>
<li>There is no prescribed order for the execution of Steady Fetch, Complete Timeline or manual requests</li>
<li>If problems occur, TootPress provides a Healthy Check</li>
</ul>
<h3>Further Information</h3>
<h4>Supported Toot Objects</h4>
<p>Following toot objects are supported.</p>
<ul>
<li>Text</li>
<li>Images</li>
<li>Galleries</li>
<li>URLs</li>
<li>Hashtags</li>
<li>Mentions</li>
</ul>
<h4>Not supported Toot Objects</h4>
<p>Following toot objects are not supported.</p>
<ul>
<li>Audio</li>
<li>Video</li>
<li>Poll</li>
<li>Teaser</li>
<li>Quotes</li>
</ul>
<h4>Excluded Toot Types</h4>
<p>Following toot types are excluded from the data transfer.</p>
<ul>
<li>Boosts</li>
<li>Replys</li>
<li>Private Toots</li>
</ul>
<h4>Architecture</h4>
<p>Data storage and process logic is separated from the WordPress Framework. The toots are not saved in the table wp_posts. And TootPress is not registering a custom post type for the toots as well.</p>
<h4>CSS classes</h4>
<p>TootPress comes with basic CSS Styles. For best fit it is required to add additional styles in your theme. All TootPress UI elements can be addressed with individual CSS selectors. Please use the browser development tools to find the right classes.</p>
<h4>Data & Files</h4>
<p>TootPress creates 2 folders within the WordPress Uploads Directory.</p>
<ul>
<li>tootpress-mastodonapidata = Archive of the received Mastodon API data</li>
<li>tootpress-images = Toot Image Folder </li>
</ul>
<h4>wpCrons</h4>
<ul>
<li>Steady Fetch (every 15 minutes, customizable)</li>
<li>Load Complete Timeline (every 5 minutes)</li>
</ul>
<h4>TootPress API</h4>
<p><strong>Action: tootpress_toots_update</strong><br />
It will be fired after toot update to execute custom post-processing.<br />
You can use the following code.</p>
<pre><code>function tootpress_toots_update_postprocessing() {

    // Add your code to be executed here

}
add_action('tootpress_toots_update', 'tootpress_toots_update_postprocessing');
</code></pre>
<p><strong>Filter: tootpress_preamble_filter</strong><br />
It outputs html content before the toot loop.<br />
You can use the following code.</p>
<pre><code>function tootpress_preamble_add( $preamble ) {

    // Add your filter code here
    // Example: $preamble='<p>Hello World.</p>';

    return $preamble;

}
add_filter( 'tootpress_preamble_filter', 'tootpress_preamble_add', 10, 1 );
</code></pre>
<p><strong>Filter: tootpress_closing_filter</strong><br />
It outputs html content after the last toot loop.<br />
You can use the following code.</p>
<pre><code>function tootpress_closing_add( $content ) {

    // Add your filter code here
    // Example: $content='<p>Hello World.</p>';

    return $content;

}
add_filter( 'tootpress_closing_filter', 'tootpress_closing_add', 10, 1 );
</code></pre>
<p><strong>Filter: tootpress_menu_forward_label</strong><br />
This filter overwrites the forward label in the bottom navigation.<br />
You can use the following code.</p>
<pre><code>function tootpress_menu_forward_label_change( $label ) {

    // Add your filter code here
    // Example: $label='Newer Posts';

    return $label;

}
add_filter( 'tootpress_menu_forward_label', 'tootpress_menu_forward_label_change', 10, 1 );
</code></pre>
<p><strong>Filter: tootpress_menu_backward_label</strong><br />
This filter overwrites the backward label in the bottom navigation.<br />
You can use the following code.</p>
<pre><code>function tootpress_menu_backward_label_change( $label ) {

    // Add your filter code here
    // Example: $label='Older Posts';

    return $label;

}
add_filter( 'tootpress_menu_backward_label', 'tootpress_menu_backward_label_change', 10, 1 );
</code></pre>
<p><strong>Filter: tootpress_beforeloop_filter</strong><br />
This filter outputs content before the toot loop (on all tootpress pages).<br />
You can use the following code.</p>
<pre><code>function tootpress_beforeloop_filter_add( $content, $page_number ) {

    // Add your filter code here
    // Example: $content='<p>Page '.$page_number.'</p>';

    return $label;

}
add_filter( 'tootpress_beforeloop_filter', 'tootpress_beforeloop_filter_add', 10, 2 );
</code></pre>
<p><strong>Filter: tootpress_afterloop_filter</strong><br />
This filter outputs content after the toot loop (on all tootpress pages).<br />
You can use the following code.</p>
<pre><code>function tootpress_afterloop_add( $content, $current_page_number, $last_page_number ) {

    // Add your filter code here
    // Example: $content='<p>Page '.$current_page_number.' of '.$last_page_number.'</p>';

    return $content;

}
add_filter( 'tootpress_afterloop_filter', 'tootpress_afterloop_add', 10, 3 );
</code></pre>
<p><strong>Filter: tootpress_mastodon_logo_filter</strong><br />
This filter overwrites the Mastodon Logo with Custom Logo.<br />
You can use the following code.</p>
<pre><code>function tootpress_mastodon_logo_change ( $img ) {

    // Standard Value
    // <img class="toot-symbol" src="FILE-URL" alt="Toot Symbol" width="35" height="37"/>

    // Add your filter code here
    // Example: $img='<img class="toot-symbol" src="FILE-URL" alt="Custom Toot Symbol" width="32" height="32"/>';

    return $img;

}
add_filter( 'tootpress_mastodon_logo_filter', 'tootpress_mastodon_logo_change', 10, 1 );
</code></pre>
<p><strong>Filter: tootpress_between_filter</strong><br />
This filter adds custom HTML between the toots.<br />
You can use the following code.</p>
<pre><code>function tootpress_create_element_between ( $content ) {

    // Add your filter code here
    // $content='<hr/>';

    return $content;

}
add_filter( 'tootpress_between_filter', 'tootpress_create_element_between', 10, 1 );
</code></pre>
<p><strong>Filter: tootpress_toot_content_filter</strong><br />
This filter can be used to manipulate the toot content.<br />
You can use the following code.</p>
<pre><code>function tootpress_manipulate_content ( $content ) {

    // Add your filter code here
    // $content=str_replace('href=','target="_blank" href=',$content); 

    return $content;

}
add_filter( 'tootpress_toot_content_filter', 'tootpress_manipulate_content', 10, 1 );
</code></pre>
<p><strong>Filter: tootpress_date_filter</strong><br />
This filter overwrites the date output with custom format.<br />
You can use the following code.</p>
<pre><code>function tootpress_date_custom_format ( $date, $year, $month, $day, $hour, $minute, $second ) {

    // $date = 2023-05-30 22:40:28
    // $year = 2023
    // $month = 05
    // $day = 30
    // $hour = 22
    // $minute = 40
    // $second = 28

    // Add your filter code here
    // $date=$day.'.'.$month.'.'.$year.' '.$hour.':'.$minute.':'.$second;

    return $date;

}
add_filter( 'tootpress_date_filter', 'tootpress_date_custom_format', 10, 7 );
</code></pre>
<p><strong>Filter: tootpress_image_filter</strong><br />
This filter can be used to manipulate image tags.<br />
You can use the following code.</p>
<pre><code>function tootpress_image_manipulate ($img_tag,$filename,$description,$width,$height,$image_directory_path,$amount_of_images,$image_number) {

    // Amount of Images
    // ----------------
    // 1 = Single Image
    // >1 = Gallery + Size of Gallery

    // Image Number
    // ------------
    // This number indicates position within the gallery

    // Add your filter code here
    // $img_tag=str_replace('alt=','class="tootpress-image" alt=',$img_tag);

    return $img_tag;

}
add_filter( 'tootpress_image_filter', 'tootpress_image_manipulate', 1, 8 );
</code></pre>
<h4>Related Links</h4>
<ul>
<li><a href="https://github.com/circuscode/tootpress" rel="nofollow ugc">Source Code @ GitHub</a></li>
<li><a href="https://www.unmus.de/tootpress/" rel="nofollow ugc">Official Plugin Page</a> (German)</li>
</ul>


TootPress

TootPress copies your toots from Mastodon to WordPress.

Mathilda vs TootPress