Schritt für Schritt ein eigenes WordPress Plugin programmieren

Band 1

Dipl. Ing. (FH) Florian Simeth

Impressum

Copyright: © 2015 – 2022 Dipl. Ing. (FH) Florian Simeth

Dipl. Ing. (FH) Florian Simeth
Fürbergring 13
94259 Kirchberg i. Wald
Web: wp-plugin-erstellen.de
E-Mail: florian@wp-plugin-erstellen.de

Umschlaggestaltung:
Simeth Florian; Joachim Ciliox, AnzeigenSpezialist.de

Satz und Layout:
Florian Simeth

Umschlagbild:
© Michael Rosskothen – Fotolia.com

1 Auflage; Januar 2015

2 Auflage; Januar 2017

Diese Online-Ausgabe wird ständig überarbeitet.

Die Informationen in diesem Buch wurden mit größter Sorgfalt erarbeitet. Dennoch können Fehler nicht vollständig ausgeschlossen werden. Verlag, Autoren und Übersetzer übernehmen keine juristische Verantwortung oder irgendeine Haftung für eventuell verbliebene Fehler und deren Folgen.

Ebenso wurden die in diesem Buch angegebenen Internet-Adressen und -Dateien vor Drucklegung geprüft (Stand: Januar 2015). Der Verlag, die Autoren und Übersetzer übernehmen keine Gewähr für die Aktualität und den Inhalt dieser Adressen und Dateien und solcher, die mit ihnen verlinkt sind.

Alle Warennamen werden ohne Gewährleistung der freien Verwendbarkeit benutzt und sind möglicherweise eingetragene Warenzeichen. Der Verlag und die Autoren richten sich im Wesentlichen nach den Schreibweisen der Hersteller. Das Werk einschließlich aller seiner Teile ist urheberrechtlich geschützt.

Bei den in diesem Buch abgebildeten Firmenlogos, Anzeigen, Anzeigenausschnitten, Internetseiten und Produktabbildungen handelt es sich ausschließlich um Anschauungsbeispiele. Es wird ausdrücklich darauf hingewiesen, dass eine Vervielfältigung und Nutzung zu anderen Zwecken nicht gestattet ist.

Alle Rechte vorbehalten einschließlich der Vervielfältigung, Übersetzung, Mikroverfilmung sowie Einspeicherung und Verarbeitung in elektronischen Systemen.

Index

• 1. Erfolgreich ein WordPress Plugin erstellen
• 2. Der Überblick
• 3. Ein Leitfaden zur Plugin-Entwicklung
  • 3.1. Eine Plugin-Datei erstellen
  • 3.2. Der richtige Plugin-Name
  • 3.3. Der Kopfbereich
  • 3.4. Lizenzverträge
  • 3.5. Coding Standards
  • 3.6. Dokumentations-Standards
  • 3.7. Präfixe und Entwurfsmuster
  • 3.8. Datei- und Verzeichnisstruktur
  • 3.9. Die ersten Codezeilen
• 4. Hooks
  • 4.1. Actions
    • 4.1.1. do_action()
    • 4.1.2. add_action()
    • 4.1.3. do_action_ref_array()
    • 4.1.4. remove_action()
    • 4.1.5. remove_all_actions()
    • 4.1.6. has_action()
    • 4.1.7. did_action()
    • 4.1.8. current_action()
    • 4.1.9. doing_action()
    • 4.1.10. Mögliche Action Hooks
    • 4.1.11. Art der Übergabe von Funktionen
  • 4.2. Filter
    • 4.2.1. apply_filters()
    • 4.2.2. add_filter()
    • 4.2.3. apply_filters_ref_array()
    • 4.2.4. remove_filter()
    • 4.2.5. remove_all_filters()
    • 4.2.6. has_filter()
    • 4.2.7. current_filter()
    • 4.2.8. doing_filter()
    • 4.2.9. Mögliche Filter Hooks
    • 4.2.10. Schnellrückgabe-Funktionen
    • 4.2.11. Art der Übergabe von Funktionen
  • 4.3. Filter und Actions finden
  • 4.4. Einfaches Beispiel mit Hooks: Drafts for Friends
    • 4.4.1. Plugin-Header
    • 4.4.2. Menü anlegen
    • 4.4.3. Einstellungsseite: Anzeigen der bereits freigegebenen Beiträge
    • 4.4.4. Einstellungsseite: Hinzufügen von Entwürfen
    • 4.4.5. Einstellungsseite: Verarbeiten des Formulars
    • 4.4.6. Anzeige des Entwurfs im Frontend
    • 4.4.7. Fehlerbehebung
    • 4.4.8. Deinstallation
    • 4.4.9. Der komplette Code
    • 4.4.10. Erweiterungs- und Verbesserungsmöglichkeiten
• 5. Plugin Integration
  • 5.1. Top- und Second-Level Menüs
  • 5.2. Metaboxen
  • 5.3. Die Settings API
  • 5.4. Die Options API
  • 5.5. Widgets API
• 6. Plugin Sicherheit
  • 6.1. Nonces
  • 6.2. Benutzerrechte
  • 6.3. Rollen
  • 6.4. Filtern: Validieren und Säubern
  • 6.5. Superglobale Variablen
  • 6.6. Formulare
  • 6.7. Sichere Datenbankmanipulationen
  • 6.8. Sicherheit im Allgemeinen
• 7. Internationalisierung
  • 7.1. Allgemeine Sprachdatei-Funktionen
  • 7.2. Übersetzungsfunktionen
    • 7.2.1. __()
    • 7.2.2. _e()
    • 7.2.3. _x()
    • 7.2.4. _ex()
    • 7.2.5. esc_attr__()
    • 7.2.6. esc_attr_e()
    • 7.2.7. esc_attr_x()
    • 7.2.8. esc_html__()
    • 7.2.9. esc_html_e()
    • 7.2.10. Die esc_html_x()
    • 7.2.11. _n()
    • 7.2.12. _nx()
    • 7.2.13. _n_noop()
    • 7.2.14. _nx_noop()
    • 7.2.15. translate_nooped_plural()
    • 7.2.16. translate_user_role()
    • 7.2.17. get_translations_for_domain()
  • 7.3. Platzhalter in Übersetzungen
  • 7.4. Übersetzung von Javascript-Inhalten
  • 7.5. Übersetzungsdateien erstellen
• 8. Benutzer und Rechte
  • 8.1. Benutzer-Handling
    • 8.1.1. Benutzer anlegen
    • 8.1.2. Benutzer aktualisieren (updaten)
    • 8.1.3. Benutzer löschen
    • 8.1.4. Benutzer aus der Benutzertabelle auslesen
    • 8.1.5. Aktuellen Benutzer auslesen
    • 8.1.6. Aktuellen Benutzer festlegen
    • 8.1.7. Prüfen ob ein Benutzer eingeloggt ist
    • 8.1.8. Mehrere Benutzer auslesen
  • 8.2. Benutzer-Metadaten
  • 8.3. Benutzerdaten in Multisite-Umgebungen
  • 8.4. Weitere Benutzerfunktionen
• 9. Shortcode API
  • 9.1. Einen Shortcode erstellen
  • 9.2. Standardwerte von Shortcode Attributen
  • 9.3. Einen Shortcode entfernen
  • 9.4. Alle Shortcodes löschen
  • 9.5. Existenz eines Shortcodes prüfen
  • 9.6. Inhalte auf Shortcode prüfen
  • 9.7. Shortcodes aus einem Inhalt entfernen
  • 9.8. Shortcodes umwandeln
  • 9.9. Weitere Shortcode-Funktionen
  • 9.10. Anmerkungen zu den Shortcodes
• 10. Daten abfragen mit der HTTP API
  • 10.1. Grundlagen für HTTP-Abfragen
  • 10.2. Helfer-Funktionen
  • 10.3. Verbindungsmethode testen
  • 10.4. Fortgeschrittene Konfigurationsmöglichkeiten
  • 10.5. Mögliche Stolpersteine
  • 10.6. Beispiel: Abruf der Anzahl von Facebook-Likes
  • 10.7. Plugin-Updates empfangen
• 11. Daten Zwischenspeichern: die Transient API
  • 11.1. set_transient()
  • 11.2. get_transient()
  • 11.3. delete_transient()
  • 11.4. Hinweise und Notizen
• 12. Benutzerdefinierte Artikeltypen
  • 12.1. Benutzerdefinierten Artikeltypen erstellen
  • 12.2. Capabilities in benutzerdefinierten Artikeltypen
  • 12.3. Post Type entfernen
  • 12.4. Hilfsfunktionen für benutzerdefinierte Artikeltypen
    • 12.4.1. Prüfen auf Hierarchie
    • 12.4.2. Prüfen ob ein Artikeltyp existiert
    • 12.4.3. Artikeltyp zurückgeben
    • 12.4.4. Erstellten Benutzerdefinierten Artikeltyp auslesen
    • 12.4.5. Bezeichnungen zurückgeben
    • 12.4.6. Registrierte Artikeltypen zurückgeben
    • 12.4.7. Hinzufügen von Features
    • 12.4.8. Entfernen von Features
    • 12.4.9. Alle Features zurückgeben
    • 12.4.10. Auf Feature prüfen
    • 12.4.11. Artikeltypen nach Feature suchen
    • 12.4.12. Post in anderen Artikeltyp umwandeln
    • 12.4.13. Prüfen auf Sichtbarkeit
  • 12.5. Frontend-Loop mit benutzerdefinierten Artikeltypen
• 13. Benutzerdefinierte Taxonomien (Taxonomy API)
  • 13.1. Taxonomien registrieren
  • 13.2. Taxonomien entfernen
  • 13.3. Registriertes Taxonomie zurückgeben
  • 13.4. Registrierte Taxonomien zurückgeben
  • 13.5. Taxonomie für ein Objekt erstellen
  • 13.6. Taxonomie von Objekt entfernen
  • 13.7. Hilfsfunktionen für Taxonomien
    • 13.7.1. Prüfen auf Hierarchie
    • 13.7.2. Prüfen ob eine Taxonomie existiert
    • 13.7.3. Bezeichnungen zurückgeben
    • 13.7.4. Taxonomie-SQL-Query erzeugen
  • 13.8. Taxonomien im Frontend
• 14. Benutzerdefinierte Ausdrücke (Terms API)
  • 14.1. Einen neuen Term erstellen
  • 14.2. Überprüfen ob ein Term existiert
  • 14.4. Anzahl der Terme einer Taxonomie ausgeben
  • 14.4. Term aus der Datenbank auslesen
  • 14.5. Term anhand verschiedener Daten lesen
  • 14.6. Terme einer Taxonomie auslesen
  • 14.7. Hierarchisch gelistete Kind-Terme auslesen
  • 14.8. Eltern und Kind Beziehung von Termen
    • 14.8.1. Prüfen auf Kind-Term
    • 14.8.2. Prüfen auf Eltern-Term
  • 14.9. Term löschen
  • 14.10. Term aktualisieren
  • 14.11. Alle Objekte eines Terms zurückgeben
  • 14.12. Term-Objekt-Verbindungen
  • 14.13. Arbeiten mit Termen im Frontend
    • 14.13.1. Term-Permalink
    • 14.13.2. Term-Beschreibung
    • 14.13.3. Terme als Liste ausgeben
  • 14.14. Ausnahmefall: Kategorien und Schlagwörter
• 15. CSS und JavaScript API
  • 15.1. CSS- und JS- Hooks
  • 15.2. JavaScript
    • 15.2.1. Standard JavaScript-Dateien
    • 15.2.2. JavaScripte registrieren
    • 15.2.3. JavaScripte einbinden
    • 15.2.4. Daten zum JavaScript-Aufruf hinzufügen
    • 15.2.5. Internationalisierung von JavaScript-Inhalten
    • 15.2.6. Registrierung eines JavaScriptes lösen
    • 15.2.7. JavaScript-Dateien aushängen
    • 15.2.8. Überprüfen ob ein Script eingehängt wurde
    • 15.2.9. Javascript-Metadaten
• 16. Cronjobs
  • 16.1. Cronjob anlegen/planen
  • 16.2. Cronjob entfernen
  • 16.3. Prüfen, ob ein Cron bereits geplant wurde
  • 16.4. Eigene Zeitintervalle festlegen
  • 16.5. Einzelnen Cronjob planen
  • 16.6. Cronjob neu planen
• 17. Rewrite API
  • 17.1. So funktioniert ein Rewrite
  • 17.2. Eine neue Rewrite Regel anlegen
  • 17.3. Neue Rewrite Variablen anlegen
  • 17.4. Rewrite-Variablen abrufen
  • 17.5. Rewrite-Variablen setzen
  • 17.6. Rewrite-Variable entfernen
  • 17.7. Rewrite-Cache leeren
  • 17.8. Plugin fertigstellen (Zwischenkapitel)
  • 17.9. Eine neue Permalink-Struktur anlegen
  • 17.10. Eine Permalink-Struktur entfernen
  • 17.11. Url zur Post-ID auflösen
• 18. Metadata API
  • 18.1. Metadaten anlegen
  • 18.2. Metadaten updaten
  • 18.3. Metadaten auslesen
  • 18.4. Metadaten löschen
  • 18.5. Metadaten anhand einer Meta-ID bearbeiten
  • 18.6. Helfer-Funktionen
  • 18.7. Meta-Schlüssel registrieren
• 19. Database API
  • 19.1. Wichtige Klassen-Parameter
  • 19.2. Wichtige Klassen-Methoden
  • 19.3. Eine Verbindung aufbauen und schließen
  • 19.4. Datenbank auswählen
  • 19.5. Beispiel
  • 19.6. Weitere Datenbank-Methoden
• 20. REST-API
  • 20.1. Schlüsselkonzepte der REST-API
  • 20.2. Nützliche Funktionen der REST-API
  • 20.3. Authentifizierung
  • 20.4. Die REST-API erweitern
    • 20.4.1. Benutzerdefinierte REST-Felder
    • 20.4.2. Benutzerdefinierte Links
    • 20.4.3. Eigene Endpunkte
    • 20.4.4. Benutzerdefinierte Inhaltstypen in der REST API
    • 20.4.5. Controller-Klassen
      • 20.4.5.1. Eigenen Endpunkt-Controller für benutzerdefinierte Inhaltstypen
      • 20.4.5.2. Eigenen Endpunkt-Controller abgeleitet von WP_REST_Controller
  • 20.5. Benutzung der REST-API
    • 20.5.1. Backbone.js Bibliothek
    • 20.5.2. Nutzung der REST-API mit dem API-Fetch Paket
    • 20.5.3. Nutzung der REST-API mit jQuery
    • 20.5.4. Nutzung der REST API mit dem Data-Modul
• 21. Objektorientierung (OOP) in WordPress Plugins
  • 21.1. Dependency Injection in WordPress
  • 21.2. Dependency Injection Beispiel-Plugin
• 22. Block Editor APIs
  • 22.1. Einen Block programmieren
  • 22.2. Block-Einstellungen in der Sidebar
  • 22.3. Blöcke transformieren
• 23. Best Practices
  • 23.1. Konsequenz im Layout
    • 23.1.1. Einstellungsseiten
    • 23.1.2. Überschriften
    • 23.1.3. Icons
    • 23.1.4. Hinweisnachrichten
    • 23.1.5. Buttons
    • 23.1.6. Formularfelder
    • 23.1.7. Tabellen
    • 23.1.8. Submit Button
  • 23.2. Errorhandling
  • 23.3. Nützliche WordPress Funktionen die kaum jemand kennt
    • 23.3.1. antispambot()
    • 23.3.2. wp_list_pluck()
    • 23.3.3. trailingslashit() & untrailingslashit()
    • 23.3.4. human_time_diff()
    • 23.3.5. zeroise()
    • 23.3.6. make_clickable()

Zu Anfang

Dank

Melanie, danke, dass du mir den Mut gemacht hast, dieses Buch zu schreiben.

Vorwort

Vielen Dank, dass Sie sich für dieses Buch entschieden haben. Ich gehe davon aus, dass Sie von WordPress bereits Vieles gehört haben. Es ist mittlerweile zum weit verbreitetsten System zur Verwaltung von Webseiten geworden. Über ein Drittel aller Internetseiten werden via WordPress bereitgestellt. So zumindest die Aussage der Redaktion von w3techs.com, die regelmäßig Umfragen zu allen gängigen Web-Technologien durchführt¹. Kein anderes System hat mehr Marktanteil. Und dem kann man ruhig Glauben schenken, wenn man bedenkt, dass mittlerweile Größen wie CNN, The New York Times oder eBay WordPress erfolgreich einsetzen.

Fünfzehn Jahre lang steht WP, wie WordPress oft kurz genannt wird, nun schon zum Download bereit. Im Januar 2004 gab es Matt Mullenweg für die globale Verwendung frei. Es entstand aus dem Weblogsystem b2/cafelog, welches zur damaligen Zeit nicht mehr weiterentwickelt wurde. Daraus ließe sich ableiten, dass WordPress lediglich ein Blogging-System wäre. Über die Jahre hat sich allerdings sehr viel getan.

Da WordPress als Open-Source verfügbar ist, wurde es nicht nur für Unternehmen, sondern auch für jeden Individualisten einfach, eine Website zu erstellen und zu bearbeiten. Letztlich war genau das auch die Intention von Matt: Eine Website soll von jedem sehr einfach und kostengünstig erstellt und verwaltet werden können. Die konstante Weiterentwicklung, die sehr starke Verbreitung und nicht zuletzt die Unterstützung der gesamten Community haben dazu geführt, dass aus WP ein umfangreiches Content-Management-System, kurz CMS, geworden ist.

Mittlerweile existieren mehr als 55.000 Plugins (Stand: April 2019) alleine in der kostenlosen Plugin-Datenbank auf wordpress.org. Zum Vergleich: Anfang 2014 waren es noch 28.000 und im Janaur 2017 ca. 48.000. Dem Ideenreichtum der Benutzer scheinen keine Grenzen gesetzt zu sein. Dazu kommt, dass auch der kommerzielle Plugin-Markt (also alle nicht-kostenlos erhältlichen Plugins) stetig wächst. 2016 gab es 1,48 Milliarden Downloads². Das entsprach einem Wachstum von 34%. Tendenz steigend.

WordPress macht es einem Entwickler aber auch wirklich einfach, Erweiterungen zu programmieren. Doch auch nach fünfzehn Jahren gibt es ein großes Problem: Die Dokumentation ist noch immer unvollständig und auf Deutsch nicht verfügbar. Solche Inhalte lassen sich zwar auch kostenlos im Netz finden. Diese sind jedoch oft weit verstreut, in kleine Code-Schnipsel zerteilt und nicht selten einfach so alt, dass sie in einem neuen Plugin gar nicht mehr funktionieren würden. Deshalb möchte ich mit diesem Buch einen Einblick in die WordPress-Plugin-Programmierung und geben und mit der erweiterten Fassung einen Überblick über alle Schnittstellen (APIs) geben und aktuelle Beispiele aufzeigen.

Viel Spaß beim Coden!

Einführung

WordPress ist wohl deshalb so populär, weil es kostenlos ist. Die Open-Source Software lässt sich herunterladen, verändern oder weiterverbreiten. Und mindestens genauso einfach ist es, die Funktionalität durch Plugins zu erweitern.

Ein sehr früher Meilenstein in der Entwicklung von WordPress war, dass es schon in Version 1.2, die bereits vier Monate nach der ersten Version veröffentlicht wurde, die Möglichkeit der Erweiterung durch Plugins vorsah. Dadurch war es möglich, WordPress so zu modifizieren, dass es den eigenen Vorstellungen entsprach. Der große Vorteil dabei war, damals wie heute, dass der eigentliche Quelltext von WordPress (kurz: der „Core“, engl. für „Kern“) dabei nicht angetastet werden musste.

Für Plugin-Entwickler ist eine solche Konstellation unglaublich effizient. Denn man muss sich nur noch auf die Programmteile konzentrieren, mit denen man sich persönlich auskennt. So lässt sich zum Beispiel die Funktion wp_mail() ganz einfach nutzen, um Mails zu versenden. Es ist nicht unbedingt nötig, zu wissen wie die Funktion intern arbeitet. Dennoch ist es aber auch möglich, direkt in das Verhalten von wp_mail() einzugreifen, ohne die Grundfunktion an sich zu verändern.

Auch wenn die kostenlose Plugin-Datenbank auf wordpress.org eine schier unendliche Masse an Erweiterungen bereitstellt, werden Sie bald feststellen, dass es Plugins gibt, die nicht mehr funktionieren, nicht mehr weiterentwickelt werden oder nicht genau den Funktionsumfang haben, den Sie gerade benötigen. Es liegt also nahe, sich ein eigenes Plugin oder zumindest eine Abwandlung eines vorhandenen Plugins selbst zu programmieren.

Wer soll dieses Buch lesen?

Dieses Buch wurde in erster Linie für Webentwickler geschrieben, die in Zukunft mit WordPress arbeiten wollen. Es soll die Entwicklung eines WordPress-Plugins von Grund auf beschreiben, setzt aber auch ein bestimmtes Vorwissen (siehe unten) voraus.

Es kann aber auch dazu benutzt werden, das eigene Wissen zu erweitern. Egal ob man haupt- oder nebenberuflich bereits mit WordPress zu tun hat oder hatte. Es kann nie schaden, zu wissen was „unter der Haube“ steckt und wie man letztlich so eingreifen kann, dass die „Maschine“ genau das tut, was man gerne möchte.

Oder Sie sind ein Blogger der sich dafür interessiert, wie die eigene Bloggingplattform tickt und wie man sie selbst anpassen kann. Wer weiß, vielleicht schreiben Sie eines Tages sogar selbst in die Online-Dokumentation von WordPress und erklären den Lesern die einzelnen Funktionen. Auch das kann ein Anreiz sein und ist im übrigen gar nicht so abwegig. Schon 2015 – auf dem WordCamp in Köln – saß ich in einem Vortrag in dem erwähnt wurde, dass viele zukünftige Programmierer heute direkt von WordPress zu PHP kommen.

Letztlich ist es ein Buch für all diejenigen, die WordPress selbst erweitern möchten.

Was Sie benötigen

Dieses Buch setzt voraus, dass Sie bereits im Besitz eines Webservers oder eines einfachen Webspeicherplatzes sind, auf dem WordPress installiert ist. Dass die 5-Minuten-Installation so einfach ist, dass auch der Laie damit zurechtkommt, dürfte sich längst herumgesprochen haben. Viele Webhoster bieten mittlerweile auch automatische Installationsroutinen an. Damit lässt sich WordPress noch schneller und oft in weniger als ein paar Sekunden installieren.

Um alles etwas einfacher zu gestalten, wäre es von Vorteil, wenn Ihre WP-Installation auf Ihrem lokalen Rechner läuft (localhost). Das macht es Ihnen leichter, ein Plugin zu entwickeln. Mit den kostenlosen Tools MAMP (für Mac OS X), WAMP (für Windows) oder LAMP (für Linux) ist das in wenigen Augenblicken geschehen. Natürlich funktioniert das auch mit virtuellen Maschinen. Auch hierfür existieren Anwendungen wie „Local by Flywheel“.

Das Herz dieses Buches bilden die großen und kleinen Code-Ausschnitte (kurz: Schnipsel). Fast alle Schnipsel sind in PHP geschrieben und oft mit HTML ausgezeichnet. Sie sollten deshalb zumindest einfachen PHP-Code lesen und schreiben können. Sie müssen jedoch kein Guru im Umgang mit PHP sein. Ich werde versuchen, schwierigen Code soweit es geht so zu beschreiben, dass Sie ihn verstehen können.

Ab und an werden Sie ebenfalls auf Datenbankabfragen stoßen, die allesamt mit MySQL beschrieben werden. Grundkenntnisse in der Syntax dieser Sprachen helfen Ihnen, mehr zu verstehen.

Dies gilt auch für die Abschnitte, die Javascript-Inhalte behandeln. Die Stichwörter hier sind jQuery sowie AJAX. Aber Achtung: Seit Ende 2018 (mit Erscheinen der Version 5.0) setzt WordPress immer mehr auf JavaScript. Dort explizit auf den Einsatz von React. PHP wird dementsprechend immer unwichtiger (aber nicht vernachlässigbar) werden. Ich erzähle Ihnen gleich noch etwas mehr darüber.

Was dieses Buch beinhaltet

Während der Entstehung dieses Buches stand WordPress 4.1 in den Startlöchern. Mittlerweile sind wir bei Version 5.2 angekommen. Bis Ende 2016 erschienen ungefähr drei Hauptversionen pro Jahr die immer wieder neue Möglichkeiten mit sich brachten. Mullenweg hat sich dann allerdings von diesem Release-Zyklus verabschiedet und den Fokus auf drei Dinge gelegt: Design, Editor und REST-API.

Die REST-API fand in Version 4.4 Einzug in den Core. Sie enthielt zum ersten mal die Infrastruktur, die dann in Version 4.7 noch um die so genannten Content-Endpoints erweitert wurde. Damit war es zum ersten Mal möglich, WordPress-Inhalte über eine Schnittstelle abzurufen oder zu verändern. Das ermöglicht z.B. das Abrufen von Daten über externe Software. Auch ist es damit möglich, WordPress headless (also “kopflos”) ohne Frontend zu betreiben oder das Frontend in einer komplett anderen Technologie (z.B. mit ReactJS) zu betreiben. Seit Version 5.0 geschieht dies auch massenhaft. Mit der Einführung des neuen Block-Editors (getauft “Gutenberg”) wird fast ausschließlich in JavaScript (bzw. React) für diesen Editor entwickelt.

In den letzten Jahren wurden viele PHP-Funktionen zu so genannten APIs (engl. für Application Programming Interface) zusammengefasst und viele – wie z.B. die REST-API – kamen neu hinzu. Sie sollen den Umgang mit WordPress erleichtern und stellen gleichzeitig sicher, dass sie auch noch in zukünftigen Versionen funktionieren werden.

In den letzten zwei Jahren habe ich viele Rezensionen von meinen Käufern gesammelt. Eine Rezension ist mir dabei im Kopf geblieben. Der Verfasser meinte, dass das eBook für ihn zu sehr eine Funktionsreferenz als ein Lernbuch sei. Diese Meinung habe ich – bis jetzt – zwar nur einmal gehört, dennoch habe ich mir die Frage oft selbst gestellt: „Ist es wirklich zu sehr eine Funktionsreferenz? Und wenn ja: kann ich es anders machen? Oder anders gefragt: muss ich das überhaupt?“

Diese Frage hat sich über die letzten zwei Jahren dann selbst beantwortet. Und zwar aus einer ganz anderen Schiene heraus. Ich war auf der Suche nach guten WordPress Entwicklern. Fast alle von ihnen schworen darauf, WordPress zu kennen und ein guter Entwickler zu sein. Letzteres war dabei immer der Fall. Erstens leider nicht. Herausfinden konnte ich das, weil ich einigen Entwicklern eine Testaufgabe gab. Sie sollten einen UNIX-Zeitstempel relativ zur aktuellen Zeit lesbar zu machen. Ich wollte also darstellen, dass z.B. ein Zeitstring von einem Kommentar so dargestellt wird:

geschrieben vor x Sekunden

oder

geschrieben vor x Minuten

oder

geschrieben vor x Stunden.

Je nachdem, was für den Menschen besser lesbar wäre.

Fast alle Entwickler schrieben dafür ihre eigene PHP-Funktion. Dabei wäre es so einfach gewesen. In WordPress gibt es die Funktion nämlich schon. Sie nennt sich human_time_diff().

Aus diesem Grunde werde ich weithin in diesem Buch versuchen, so viele interne WordPress-Funktionen wie möglich zu beschreiben. Natürlich mit möglichst ausführlichen Beispielen.

PHP und JavaScript

Aus Erfahrung weiß ich, dass gerade viele der kleineren Code-Schnipsel auch in Zukunft noch voll funktionsfähig sein werden. Mein erstes, kostenloses und ins WordPress-Plugin-Verzeichnis eingetragenes Plugin ging online, als Version 3.3 aktuell war. Ohne viel zu verändern, funktioniert es noch heute tadellos. Zwar handelt es sich dabei nur um ein sehr kleines Script, der Grund, warum es heute noch funktioniert, ist vermutlich aber ein anderer: Einmal eingeführte Funktionen werden bei einem Versionssprung von WordPress nicht einfach entfernt. Stattdessen wird versucht, dem Entwickler eine Fehlermeldung anzuzeigen, die auf den Missstand hinweist.

Letzteres stellt aber auch ein Problem dar. Durch die Rückwärts-Kompatibilität hat sich WordPress aus PHP-Sicht nicht stark weiterentwickelt. Enwturfsmuster (wie MVC, Singleton, Dependency Injection, etc.) gibt es in WordPress kaum bis gar nicht. So wurde WordPress zum jetzigen Stand fast ausschließlich funktionell programmiert. Dennoch gibt es ein paar Klassen die Sie in diesem Buch ebenfalls kennen lernen werden.

Dass sich WordPress PHP-technisch nicht weiterentwickelt hat ist sicherlich auch der Grund warum es in den StackOverflow-Umfragen von Entwicklern mittlerweile zur “most dreaded”, also zur “unbeliebtesten” Web-Plattform gewählt wurde.

“Web Platform” ist an dieser Stelle ein gutes Wort. Denn das beliebte CMS ist mittlerweile nicht mehr nur ein Content-Managment-System. Tatsächlich hält immer mehr JavaScript Einzug in WordPress. Allen voran das Framework ReactJS.

Die Struktur dieses Buches

Ich habe das Buch gedanklich in zwei Bände geteilt. Der erste Band liegt Ihnen gerade vor und gibt im ersten Kapitel einen Überblick über das Arbeiten mit WordPress und geht im zweiten Kapitel in einen allgemeinen Leitfaden zur Plugin-Entwicklung über.

Das dritte Kapitel bespricht die sogenannten Hooks. Das Verständnis der Hooks ist Voraussetzung für die Programmierung von Plugins mit WordPress und ist damit ein ideales Grundgerüst für den Start.

Angefangen mit dem Kapitel Plugin-Integration werde ich alle gängigen APIs beschreiben. Von der Dashboard-Widget API, über die HTTP-API bis hin zur Rewrite-, Shortcode- und Widget-API. Diese Kapitel können in der Reihenfolge gelesen werden, wie Sie sie benötigen, wohingegen die ersten drei Teile jeweils aufeinander aufbauen.

Der Quellcode

Während Sie im Buch lesen, können Sie entweder den Quellcode der einzelnen Code-Schnipsel direkt abtippen oder ganz einfach kopieren, indem Sie dem jeweiligen Link folgen. All diese Inhalte finden Sie auf Github. Sie sind frei erhältlich und können jederzeit kostenlos von Ihnen benutzt werden. Beachten Sie, dass ich keinerlei Verantwortung für die Richtigkeit der Code-Schnipsel übernehmen kann, falls diese in den produktiven Einsatz gelangen sollten.

Fehler im Quellcode

Ich versuche, möglichst alle Inhalte fehlerfrei zu halten. Aber natürlich ist niemand perfekt. Wenn Sie einen Fehler im Buch oder in einem Quellcode finden, lassen Sie es mich bitte wissen. In Zeiten von eBooks sind diese relativ schnell ausgebessert. Somit steigt nicht nur die Qualität dieses Buches. Zusätzlich ersparen Sie einem anderen Leser vielleicht eine stundenlange Fehlersuche.

Sie glauben, Sie haben einen Fehler gefunden? Sicherlich haben Sie bereits einen Github Account, der es Ihnen erlaubt, diesen selbst zu beheben oder Kommentare zu hinterlassen. Ansonsten schreiben Sie bitte direkt an florian [a t] florian-simeth.de.

Vielen Dank!

1. http://w3techs.com/technologies/overview/contentmanagement/all/ Stand: Dezember 2013 Stand: Oktober 2014 ↩︎
2. https://twitter.com/post_status/status/805160669733654528 ↩︎