Ein neues Plugin: Schnittstellen definieren (Ⅰ)

Ich mag Schnittstellen. Schnittstellen (engl. Interfaces) sind ein Instrument objektorientierter Programmierung und sollen – salopp gesagt – sicherstellen, dass verschiedene Programmteile verlässlich zusammen arbeiten können.

Dies spielt besonders dann eine Rolle, wenn Erweiterungen oder ähnliches später und/oder von anderen erstellt werden sollen.

Schnittstellen wären auch eine Möglichkeit für WordPress gewesen, jedoch wurde darauf verzichtet; wohl auch, da PHP keine reine objektorientierte Programmiersprache ist. Auch werden die meisten bei der Entwicklung eines Plugins darauf verzichten, ich jedoch nicht.

Mir gefällt, dass ich auf diese Weise Ideen und Anforderungen in Code festschreiben kann, ohne bereits ins Detail gehen zu müssen; und es entstehen Arbeitsanweisungen für die konkreten Klassen.

Folgende Schnittstellen sind mir in den Sinn gekommen:

ILeo_Sitemap_Xml

1. <?php
2. /*
3. Deklariert Methoden und Konstanten für eine XML-Datei
5. Author: Hermann J. Leopold
6. Email: hermann.leopold@leopoldnet.de
7. Date: 2017-01-30
9. /*
10. interface ILeo_Sitemap_Xml
11. {
13. // Ich mag die Idee, dass ein ständig gleich benötigtes Zeichen einmal festgelegt wird.
14. const csTagAuf = "<";
16. // Hier kann festgelegt werden, ob es nach einem XML-Tag einen Zeichenumbruch geben soll.
17. // const csTagZu = ">";
18. const csTagZu = ">\n";
20. // Das Wichtigste: Das XML-Dokument als String
21. function toString();
23. }

Datei: ILeo_Sitemap_Xml.php

Natürlich wird so eine XML-Datei nicht annährend vollständig beschrieben, doch für das Plugin reicht es. Da sich Inhalt und Attribute der Elemente unterscheiden, brauche ich dafür keine Methoden vorschreiben. Das Festlegen der spitzen Klammern als Konstanten ist nicht Humor, sondern es bringt Vorteile:

• Einmal festeglegt, kann man sie nur noch vergessen, aber nicht verwechseln. Da es auch nur eine Methode geben wird, in der die Klammern verwendet werden, sind die Tags stets richtig (oder stets falsch).
• Bei der schließenden Klammer kann festgelegt werden, ob es Zeilenumbrüche geben soll. Diese machen zwar das XML-Dokument lesbarer, aber auch größer.

ILeo_Sitemap

1. <?php
2. /*
3. Deklariert Methoden und Konstanten für eine sitemap.xml
5. Author: Hermann J. Leopold
6. Email: hermann.leopold@leopoldnet.de
7. Date: 2017-01-30
9. Verzeiht mein Denglish..
10. /*
11. interface ILeo_Sitemap
12. {
13. // Symbolname des Wurzelelements
14. const csRootSymbol = "urlset";
16. // Der übliche Dateiname, sollte er nicht ersetzt werden.
17. const csDefaultName = "sitemap.xml";
19. // Legt den Namen der Datei fest; bsp.: sitemap.xml
20. function setSitemapName($sName);
22. // Gibt die Url der Website an; bsp.: leopoldnet.de
23. // Wichtig, da die Verweise meist relativ sind, aber absolut sein müssen.
24. function setSiteUrl($sUrl);
26. // Der Pfad zum Speichern wird auch benötigt.
27. function setPath($sPath);
29. // Das Wichtigste: Seiten der sitemap hinzufügen.
30. // Was eine Seite ausmacht, wird in der ILeo_Sitemap_Page festgelegt.
31. function addPage(ILeo_Sitemap_Page $oPage);
33. }

Datei: ILeo_Sitemap.php

Der Name der Datei ist nicht festgelegt; somit wäre es möglich, für verschiedene Suchmaschinen unterschiedliche Sitemaps zu erstellen. Auch der Speicherpfad ist (im Rahmen des Möglichen) wählbar; es muss nicht das Wurzelverzeichnis sein.

Wichtig ist das hinzufügen der Seiten. Die dafür vorgesehene Methode ‚addPage()‘ erwartet einen Parameter vom (noch) unbekannten Typ ILeo_Sitemap_Page. Alles, was eine Seite (aka Page) ausmacht, wird in der nächsten Schnittstelle deklariert.