Mathilda

Das WordPress Plugin Mathilda kopiert fortlaufend deine Tweets aus Twitter und speichert sie in der WordPress Datenbank. Die Tweets können im Blog chronologisch angezeigt werden (müssen aber nicht). Twitter ist ja auch irgendwie bloggen, mikro-bloggen sozusagen.

Mathilda WordPress Plugin

Funktionen

    • Fortlaufendes Zurückkopieren der eigenen Tweets
    • Fortlaufendes Zurückkopieren der vertweeteten Bilder
    • Anzeige der Tweets im Blog
    • Basis Tweet Statistiken
    • Import der gesamten Twitter Historie
    • Export der Tweets im CSV-Format
    • Sprache: Englisch, Deutsch (nur im FrontEnd)

    Screenshots

    Screenshot: WordPress Plugin Mathilda Settings

    Screenshot: Mathilda Tools (Version 0.3)

    Live Demo

    Hier!

    Anleitungen

    Installation und Konfiguration

     
    Twitter Archiv importieren

    Installation

    1. Aus dem WordPress Directory das Plugin laden
    2. Plugin aktivieren
    3. Konfigurationsanleitung folgen

    Konfiguration

    Nach der Installation sind folgende Schritte erforderlich.

    1. Registrierung des Plugins bei Twitter für den Zugriff auf die Twitter API
    2. Eingabe von OAUTH Access Token, OAUTH Access Token Secret, Consumer Key, Consumer Secret sowie des eigenen Twitter Logins in den Einstellungen von Mathilda
    3. Durchführung des ersten Kopiervorgangs (Load Tweets unter Werkzeuge/Tweets)
    4. Anlegen einer WordPress-Seite zur Anzeige der Tweets im Blog (der Slug der Seite muss dem Mathilda Slug entsprechen)

    Frequently Asked Questions

    Welche Tweets werden im Blog angezeigt

    Mathilda beschränkt sich auf die Kernfunktionalität von Twitter und zeigt im Blog Text-Tweets, Bilder, Hashtags, Mentions, Links und Gallerien an. Umfragen, Threads, Stories, Video, GEO-Locations und Places werden aktuell nicht unterstützt.

    Warum werden keine Retweets im Blog angezeigt?

    Retweets sind strenggenommen keine eigenen Daten. Aus diesem Grund werden Retweets bei der Verarbeitung ausgeklammert.

    Werden die Tweets automatisch geladen?

    Ja. Allerdings muss der erste Kopiervorgang manuell durchgeführt werden. Danach werden die Tweets automatisch kopiert.

    Wie oft werden die Tweets von Twitter geladen?

    Neue Tweets werden alle 15 Minuten geladen. Die Periode (in Minuten) kann jedoch auch in den Plugin Einstellungen geändert werden.

    Was ist der Unterschied zwischen dem Laden und dem Import?

    Das Laden kopiert deine letzten Tweets online über die Twitter API fortlaufend in die WordPress Datenbank. Der Import hingegegen kopiert dein vollständiges Tweet Archiv dateibasiert in die WordPress Datenbank. Hierfür muss man zuvor das Archiv bei Twitter downloaden. Wie das genau funktioniert, steht weiter unten (oder einfach das Video oben schauen).

    Muss ich jetzt erst Tweets laden oder den Import ausführen?

    Ist eigentlich egal. Funktioniert beides. Mathilda ist flexibel. Allerdings wird der automatische Kopiervorgang nur aktiviert, wenn zuvor ein initialer, manueller Kopiervorgang durchgeführt worden ist.

    Wie kann ich meine Twitter Historie importieren?

    Dazu musst du dein Twitter-Archiv bei Twitter herunterladen (Profil/Einstellungen/Deine Twitter Daten). Das Twitter-Archiv enthält einen Ordner namens data/js/tweets. Darin liegen viele Dateien, deren Namen nach dem Muster MONAT-JAHR.json aufgebaut sind. Diese Dateien enthalten deine Tweets im JSON-Format und du musst sie in den Ordner www.deinblog.de/wp-content/uploads/mathilda-import/ kopieren. Danach kannst du den Import unter Werkzeuge/Mathilda starten. Die Import-Dateien kannst du auf deinem Webspace liegen lassen, damit bei späteren Updates fehlende Daten neu eingelesen werden können.

    Wie geht Mathilda mit der kanonischen URL um?

    Mathilda greift nicht in den bestehenden Prozess der kanonischen URLs in WordPress ein. Wenn man die kanonische URL für die Mathilda Seiten ändern möchte, muss man die Konfiguration über ein SEO Plugin vornehmen.

    Was ist beim Einsatz von Caching Plugins zu beachten?

    Die Länge der Cron Periode in Kombination mit der Konfiguration des Caching determiniert, wie frühzeitig ein Tweet im Blog angezeigt wird. Sofern ein Tweet as early as possible im Blog angezeigt werden soll, sollte die Seite mit den Tweets vom Caching ausgeschlossen werden. Eine andere Möglichkeit besteht darin, die betroffene Seite aus dem Cache zu entfernen, sobald neue Tweets geladen wurden (siehe API unten).

    Unterstützt Mathilda die neuen 260 Zeichen Tweets?

    Ja.

    Warum erfordern manche Updates einen Plugin-Reset und Daten-Reload?

    Das Plugin befindet sich noch in einer frühen Entwicklungsphase. Es ist noch ein langer Weg zur stabilen Version 1.0. Um Dateninkonsistenz sowie Prozessierungsfehler zu vermeiden, muss nach einigen Updaes ein Daten-Reload durchgeführt werden. Irgendwann wird Mathilda jedoch einen Reifegrad erreichen, der solche Daten-Reloads nicht mehr erfordert.

    Wird WordPress Multisite von Mathilda unterstützt?

    Nein. In einer Multisite Umgebung ist Mathilda nur teilweise lauffähig. Das Plugin funktioniert auf der Hauptseite, aber nicht auf den Kinderseiten innerhalb des Netzwerks.

    Ich habe Embedding aktiviert, aber der Content wird nicht eingebunden?

    Nach der Aktivierung der Funktion kann es bis zu 15 Minuten dauern, bis die ersten verlinkten Inhalte eingebettet werden. Die Einbettung funktioniert auch nur bei Quellseiten, welche den Standard oEmbed unterstützten. Der nötige Embed Code wird im Hintergrund alle 15 Minuten in kleinen Portionen angefordert. Aus diesem Grund kann es ein paar Tage dauern bis alle Inhalte geladen sind. Wenn das WordPress auf https Verschlüsselung läuft, werden auch nur https verschlüsselte Inhalte eingebunden.

    Wie geht Mathilda mit dem nofollow Attribut um?

    Twitter Backlinks werden als nofollow deklariert. Dies betrifft Hashtags, Mentions und den Backlink des Tweets selbst. Links innerhalb des Tweets erhalten follow als Attribut.

    Tweet Typen

    Folgende Arten von Tweets werden unterstützt.

    • 140 Character Tweets
    • 280 Character Tweets
    • Replys
    • Quotes

    Twitter Objekte

    Folgende Twitter Objekte werden unterstützt.

    • Images
    • Hashtags
    • Links
    • Mentions
    • Galleries

    Daten & Verzeichnisse

    Mathilda legt nach der Installation vier Verzeichnisse an.

    • mathilda-twitterapi = Archivierung der kopierten Daten
    • mathilda-images = Speicherort der Tweet-Bilder
    • mathilda-export = Export-Verzeichnis
    • mathilda-import = Import-Verzeichnis

    API

    WordPress Action: mathilda_tweets_updated (wird gefeuert, wenn neue Tweets geladen wurden)

    Cron Jobs

    Nachstehende Programme werden von Mathilda im wpCron System von WordPress durchgeführt.

    • Autoload Tweets (alle 15 Minuten, anpassbar)
    • Get Embed Code from External Source (alle 15 Minuten, anpassbar)
    • Import Tweets (jede Minute, sofern der Import läuft)

    CSS-Klassen

    You know the game! Es gibt tausende von WordPress Themes und jedes Theme hat ein individuelles Design. Aus diesem Grund ist die Wahrscheinlichkeit recht hoch, dass man die Optik der Tweets für das eigene Theme nachformatieren muss (style.css). Dazu kann jedes Element von Mathilda auf dem User Interface über CSS angesteuert werden. Bitte benutze einen Debugger, um das richtige Element zu finden.

    Download

    WordPress Plugin Mathilda @ WordPress Plugin Directory
    WordPress Plugin Mathilda @ unmus

    Support

    Formal wird kein Support für Mathilda angeboten. Für Hinweise und Fehlerberichte bin ich aber trotzdem sehr dankbar. Fehler bitte im Support Forum von Mathilda auf WordPress.org berichten. Verbesserungsvorschläge und Anregungen bitte per eMail an mathilda@unmus.de.

    Danke

    Valentin Bachem

    Lizenz

    Mathilda ist Open Source und steht unter der GPLv3 Lizenz.

    Quellcode

    Der aktuelle Quellcode der nächsthöheren Version in Entwicklung ist auf GitHub verfügbar. Der Quellcode der aktuellen Version sowie aller vorherigen Versionen sind bei WordPress.org hinterlegt.

    Changelog

    Version 0.10 “Deadshot”

    Juni 2018

    • Feature: Unterstützung von Gallerien
    • Bugfix: URL Rendering (sofern mehr als 1 Link im Tweet enthalten

    Version 0.9 “Renee Montoya”

    April 2018

    • Feature: Import Tweet Archiv reinvented
    • Feature: Neuer Naviationstyp (Limited Numbering)
    • Verbesserung: Differenzierte Notifikationen auf öffentlichen Seiten
    • Verbesserung: Sichere Ausführung
    • Änderung: Initialer Kopiervorgang ist nun auf 200 Tweets begrenzt
    • Änderung: Anzeige des Datums
    • Aktualisiert: Plugin Handbuch
    • Korrektur: https Embedding
    • Sonstiges: Code Verbesserungen

    Version 0.8.1 “Maps”

    September 2017

    • Bugfix: Unterstützung von MariaDB
    • API: Neue Action mathilda_tweets_updated

    Version 0.8 “Neo Gotham”

    August 2017

    • Neue Einstellung: Backlink zu Twitter
    • SEO: Backlinks zu Twitter werden als NoFollow deklariert
    • Verbesserung: Letztes Update @ WordPress wird im Dashboard angezeigt

    Version 0.7 “Undercloud”

    März 2017

    • Feature: Unterstützung von Extended Tweets (Extended API Mode)
    • Feature: Vollständiger oEmbed Support
    • Feature: Embedding Cache für bessere Performance
    • Verbesserung: Truncate Prüfung im Plugin Healthy Check hinzugefügt
    • Verbesserung: Highlighting von Warnungen und Fehlern im Plugin Healthy Check
    • Verbesserung: Embed Yes or No Option in den Plugin Einstellungen
    • Verbesserung: Links im Eintrag des Plugins auf der Plugin-Seite
    • Verbesserung: Dokumentation der Tweet Quelle
    • Bugfix: Mathilda Multisite Support Notice auf WordPress Child Seiten

    Version 0.6.1 “Calamity”

    Februar 2017

    • Bugfix: Mathilda ist jetzt mit Yoast SEO kompatibel

    Version 0.6 “Poison Ivy”

    Februar 2017

    • Feature: YouTube Embedding
    • Feature: Plugin Reset
    • Verbesserung: Inkludiert Meta Daten von der Twitter API für bessere Verarbeitung
    • Verbesserung: Statistiken für Retweets, Replies and Quotes
    • Verbesserung: Update Notices
    • Verbesserung: Datenkonsistenzprüfung im Plugin Healthy Check
    • Verbesserung: Prüfung auf allow_url_fopen in Plugin Healthy Check
    • Verbesserung: Zusätzliche Processing Information in Plugin Healty Check
    • Verbesserung: Include oder Exclude Quotes vom Mathilda Loop
    • Verbesserung: Expert Settings
    • Bugfix: Bilder in originaler Größe anzeigen
    • Bugfix: Verstecke Bottom Navigation, wenn Navigation nicht erforderlich/li>

    Version 0.5

    Januar 2017

    • Feature: Dashboard Widget mit Tweet Statistik
    • Feature: Hyperlink Rendering Option (Shortlink oder Reallink)
    • Feature: Unterstützung von Zeilenumbrüchen innerhalb Tweets
    • Feature: Einstellung um Mathilda CSS zu deaktivieren
    • Bugfix: Inititaler Cron konnte in bestimmen Fällen nicht gestartet werden
    • Bugfix: Korrekte Zeit wird angezeigt, wenn die Zeitzone über UTC Offset definiert ist
    • Bugfix: CSS Klasse für die Ausrichtung von Bildern
    • Verbesserung: Twitter API Zugriffe optimiert
    • Sicherheit: Aufruf von Mathilda Funktionalität außerhalb WordPress nicht mehr möglich

    Version 0.4.2

    Juli 2016

    • Bugfix: UTC Fallback, wenn keine Zeitzone in den WordPress Einstellungen definiert

    Version 0.4.1

    Juli 2016

    • Bugfix: Anzeige von Leerzeichen, wenn URL in Tweet enthalten

    Version 0.4

    Juli 2016

    • Feature: Custom Mathilda Cron Periode
    • Feature: Weitere Mathilda Bottom Navigation
    • Enhancement: W3C Validated HTML Code
    • Enhancement: W3C Validated CSS Code
    • Enhancement: Quellcode jetzt auf GitHub verfügbar
    • Bugfix: Anzeige von Tweets auf Seiten mit Leerzeichen im Namen
    • Bugfix: Navigation wird ausgeblendet, wenn nur wenige Tweets verfügbar
    • Bugfix: Autoflush Rewrite Rules wird nur durchgeführt, wenn Slug geändert

    Version 0.3

    Juni 2016

    • Replies werden unterstützt
    • Update Process für spätere Plugin Updates
    • Lokalisierung: Deutsch @ FrontEnd
    • Mathilda Handbuch integriert
    • Unterstützung von Zeitzonen und lokaler WordPress Zeit
    • Hinweis vor erstmaligem Cron und Import
    • Verhinderung von TimeOuts bei Cron und Import
    • Flash Rewrite Rules sobald Mathilda Slug geändert wird
    • Ergebnisseite für Plugin Healthy Check
    • Besseres Mathilda Development UI
    • Weitere Developer Settings
    • Rechenfehler beim Import
    • HTML Fehler bei Cron und Import korrigiert
    • Fehlende Erfolgsmeldung beim Cron ergänzt
    • Fehlende Prüfung des Import Ordner ergänzt

    Version 0.2

    June 2016

    • WebCron wird durch WP-Cron ersetzt
    • Import als internes statt externes Skript
    • Veröffentlichung im WordPress Plugin Directory

    Version 0.1

    Mai 2016

    • Initiale Version
    11. Juni 2018