Ich schreibe hier, weil ich mit der Unterstützung von Sergej, dem Entwickler, super zufrieden bin. Er ist (fast) immer erreichbar, nett und hilfreich. Neue Funktionswunsch? Kein Problem! Gibt’s meistens mit dem nächsten Update. Das ist genau der Vorteil von kostenpflichtiger Software im Vergleich zur open source Software. Man bekommt guten Support. Bei Open Source Software kann es passieren, dass der Entwickler keine Lust mehr hat, und das Produkt einfach von heute auf morgen einstellt. Bei bezahlter Software passiert das nicht so einfach.

WPSEO gibt es auf www.wpseo.de (Affiliate-Link). Sergej hat auch noch ein paar andere Plugins geschrieben, u.a. die AntispamBee. Und sein Twitter-Stream ist auch interessant.

Alle Aufrufe der Settings-API sollten im Hook ‘admin_init’ gemacht werden. Die zwei wichtigsten Aufrufe der API sind die beiden Funktionen add_settings_field zum Anzeigen einer Option und register_setting zum Speichern. Hier zunächst ein Beispiel. Hier wird ein Textfeld auf der “Schreiben”-Optionsseite hinzugefügt:

add_action('admin_init', 'test_admin_init');
function test_admin_init() {
  add_settings_field(
    'test_option',
    '<label for="test_option">Test</label>',
    'test_option',
    'writing',
    'default',
    array()
  );
  register_setting('writing','test_option');
}

function test_option() {
  $value = get_option('test_option');
  echo '<input type="text" class="regular-text"
    id="test_option" name="test_option" value="'.$value.'" />';
}

Fangen wir mit der einfachen Funktion an: register_setting

register_setting sorgt dafür, dass eine Option gespeichert wird sobald auf der entsprechenden Seite der Speichern-Button gedrückt wurde. Sie hat zwei Parameter. Der erste Parameter gibt an auf welcher Seite die Option hinzugefügt wurde und beim Speichern mitgespeichert werden soll. Der zweite Parameter ist der Name der Option. Genau unter diesem Namen wird die Option auch in der Datenbank abgelegt. In dem Fall oben ist es die Option test_option auf der Seite writing. Optionen können auf allen acht Standardoptionsseiten von WordPress hinzugefügt werden:

• general
• writing
• reading
• discussion
• media
• privacy
• permalink
• misc

Die andere Funktion add_settings_field hat einige Parameter mehr.

add_settings_field(
  $option_name,
  '<label for="'.$option_name.'">'.
    $option_description.
  '</label>',
  $callback_function_name,
  $page,
  'default',
  array()
);

Ich denke die meisten Parameter sind so bereits klar. Hier einige Anmerkungen:
Der zweite Parameter gibt den Text vor dem Optionsfeld aus. Bei WordPress ist es üblich, dass dieser Text ein Label ist (also den Fokus an das Input-Element weitergibt). Das geschieht aber nicht automatisch und muss extra angegeben werden. Mit diesem Funktionsaufruf wird noch nicht das Eingabefeld angezeigt. Darum kümmert sich die Callback-Funktion. Hier das passende Beispiel:

function test_option() {
  $value = get_option('test_option');
  echo '<input type="text" class="regular-text"
    id="test_option" name="test_option" value="'.$value.'" />';
}

Die Funktion muss den aktuellen Wert selbst laden und anschließend das komplette Input-Element ausgeben. Der Name des Input-Elements muss der Name der Option sein (s. register_setting). Bitte nicht die ID vergessen, sonst funktioniert das label nicht.

Gruppieren

Wenn das Plugin mehr als eine Option hat, ist es sinnvoll die Optionen zu gruppieren. Dafür muss zuerst eine Gruppe anlegt werden und anschließend können die Optionen dieser Gruppe zuordnen werden. Gruppe anlegen:

add_action('admin_init', 'test_admin_init');
function test_admin_init() {
  add_settings_section(
    'test_section',
    'Test Titel',
    'test_section_description',
    'writing'
  );
  ...
}

function test_section_description() {
  echo '<p>info</p>';
}

Die Callback-Funktion gibt die Beschreibung zu der Gruppe aus und wird vor den Optionsfeldern angezeigt. Damit sie richtig formatiert wird, sollte in der Callback-Funktion auch ein Absatz ausgegeben werden. Um ein Optionsfeld dieser Gruppe zuzuordnen, muss nur der vorletzte Parameter in der add_settings_field von ‘default’ auf den Sectionname (im Beispiel ‘test_section’) geändert werden. Beispiel:

add_settings_field(
  'test_option',
  '<label for="test_option">Test</label>',
  'test_option',
  'writing',
  'test_section',
  array()
);

Best Practise

Ich habe jetzt schon einige male die Settings-API benutzt. Dabei wurde mir eins klar. Es ist wichtig die Bezeichner überall gleich zu wählen, sonst kommt man durcheinander. Was meine ich damit: Im Falle der test_option habe ich an allen Stelle test_option verwendet:

• Optionsname
• Name der Callback-Funktion (ggf. mit einheitlichem Prefix versehen)
• Name und ID des Input-Elements

Das Gleiche gilt natürlich auch für die Section und deren Callback-Funktion. Wenn möglich sollte auch eine Vereinheitlichung über Plugingrenzen angestrebt werden.

Die Settings-API unterstützt auch die objekt-orientierte Programmierung. Alle Callback-Funktionen können auch als array mit Verweis auf &$this angegeben werden.

Das offizielle Feedsmith-Feedburner-Plugin für WordPress ist inzwischen etwas in die Jahre gekommen. Es hat ein Problem: Es leitet alle Feeds an Feedburner weiter. Wenn jemand nur einen Feed von einem Autor, einem Tag oder einer Kategorie haben möchte, kommt er nicht dran, wenn das Plugin aktiv ist. Außerdem ist es nicht mehr so schick für zwei Eingabefelder eine extra Seite im wp-admin zu haben.

Diese Probleme löst mein Plugin. Nach der Aktivierung findet sich die Eingabe für die zwei verschiedenen Feeds auf der “Lesen”-Seite im wp-admin. Wenn dort Feeds eingetragen wurden, wird auf diese Feeds nur weitergeleitet, wenn die generellen Feeds aufgerufen wurden. Autoren-, Kategorie-, Tags- und alle anderen Archiv-Feeds sind freizugänglich.

Neben diesen Neuerungen gibt es auch die Möglichkeit zu Testzwecken die Weiterleitung zu deaktivieren. Beim Feedsmith-Plugin muss man dafür den Browserstring ändern. Bei meinem Plugin muss nur der URL-Parameter “noredirect” angegeben werden. (Die Änderung des Browserstrings funktioniert natürlich auch, damit Feedburner an den Feed kommt). Beispiel: http://hetjens.com/feed/?noredirect

Version: 0.2 – Download
Getestet nur mit WordPress 2.8.x

Es gibt Situationen da ist es praktisch, wenn das Blog nicht öffentlich zugänglich ist. Dafür gibt es (neben einigen anderen Plugins) jetzt auch das “Hetjens Registered Only”-Plugin. Es basiert auf der Arbeit von Carthik A. Sharma wurde aber trotz nur 20 Zeilen Code stark verändert.

Sobald das Plugin aktiviert ist, wird jedem nicht angemeldeten Besucher der WordPress-Anmeldebildschirm gezeigt. Nach der erfolgreichen Anmeldung wird der Besucher weitergeleitet zu der Seite, die er eigentlich aufrufen wollte (egal, ob Homepage, wp-admin oder einen Artikel) [Das ist aber in WordPress eingebaute Funktionalität und wird nicht durch das Plugin bereitgestellt].

Version 0.3 – Download

Manchmal kann es aber sinnvoll sein einen abweichsenden Titel einzustellen. Diese Möglichkeit bietet das “Hetjens Link Widget Title Plugin”. Es wurde nur mit WordPress 2.8.x getestet. Mit älteren Versionen kann es nicht funktionieren, da mit WP-2.8 die Schnittstelle für Widgets geändert wurde.

Nach der Aktivierung gibt es in dem Einstellungsdialog des Widgets eine Text-Box für den Titel. Dieser eingegebene Titel wird als Widget-Title auf dem Blog angezeigt. Wird das Feld leer gelassen, zeigt das Plugin den Standardtitel (Kategorienamen) an.

Version: 0.1 – Download