“Die Prinzipien der kontrollierten Zugriffssteuerung sind Bestandteil jeder modernen Webanwendung und müssen bei deren Entwicklung verstanden sein. Das Zend Framework bietet hierfür die nötigen Komponenten und Mechanismen an. In diesem Artikel erklären wir dessen Funktionsweisen und zeigen, wie diese elegant eingesetzt werden.”

Dieser Artikel erklärt die Mechanismen der Authentifizierung und Autorisierung, gibt einen Einblick in den Request-Lebenszyklus des Zend Frameworks und zeigt anhand eines Beispiel-Algorithmus, wie die Zugriffsteuerung zentral integriert werden kann.

Autoren: Matthias Brusdeylins
Sprache: Deutsch
Zeichen: 37011
Links: Ausgabe 1.2009, Artikel-Quellcodes

“Nach einem ausgiebigen Betatest hat die Firma Zend Anfang dieses Jahres die finale Version ihrer kommerziellen Entwicklungsumgebung für PHP auf den Markt gebracht – das Zend Studio for Eclipse. Zu den wichtigsten Funktionen gehören Code Generation, Refactoring, Unit Testing sowie Debugging und Profiling. Vollmundig verspricht Zend, dass es sich hier um die „leistungsstärkste PHP IDE für das Entwickeln umfassender Webapplikationen“ handelt. Die Autoren haben das Zend Studio for Eclipse genauer unter die Lupe genommen und berichten im vorliegenden Artikel von ihren Erkenntnissen.”

Dieser Artikel bietet einen Überblick und Erfahrungsbericht über die Features der neuen Entwicklungsumgebung von Zend. Einige der Schlüsselthemen sind dabei die hervorragende Integration des PHP-Debuggers von Zend in die Eclipse-Umgebung, das Profiling einer PHP-Anwendung, PHP-Unit-Test sowie die exellente PHP-Code-Formatierung und Code- Unterstützung.

Autoren: Carsten Lucke, Matthias Brusdeylins
Sprache: Deutsch
Zeichen: 31377
Links: Mai-Juni-Ausgabe, Zend Studio

Für das Ermitteln unterschiedlicher Kursdaten bietet Yahoo!Finance (auch für Deutschland) verschiedene CSV-Export-Services an. CSV steht für “Comma Separated Values” und bedeutet hier nichts anderes, als dass die ganzen Kennzahlen (wie z.B. Schluss-Kurs oder Volumen) in reiner Textform mit Kommas und Zeilenumbrüchen getrennt ausgeliefert werden. Daten in solch einem Format kann ein Computerprogramm für Analysezwecke leicht verarbeiten. Im Folgenden werden die bekannten Schnittstellen genauer erläutert und dazu passende Beispiele und PHP-Scripte präsentiert. Da mir keine offizielle API von Yahoo!Finance bekannt ist und ich die hier beschriebene Schnittstelle durch Ausprobieren und Studium ermittelt habe, kann ich für eine Vollständigkeit des aufgezeigten Funktionsumfanges nicht garantieren. Für Hinweise bin ich daher sehr dankbar. Verwendet ein Entwickler die Services von Yahoo!Finance, so sollte er sich vorher die Nutzungsbedingungen (siehe auch) genau durchlesen.

Aktuelle Kursdaten ermitteln

Ganz ehrlich, “aktuell” bedeutet bei der kostenlosen Yahoo!Finance-Schnittstelle leider eine Verzögerung von 15 Minuten für NASDAQ Werte, bis hin zu 60 Minuten für andere Börsenplätze (näheres auf Yahoo!Finance). Doch für die meisten Verwendungszwecken bzw. westlichen Börsenkurse dürfte diese Verzögerung kein Problem darstellen. Yahoo! bietet Kurse aus den unterschiedlichsten Börsenplätzen an. Die Selektion des entsprechenden Handelsplatzes findet in der URL selbst, sowie in einem Anhang (Suffix) an der Symbolangabe statt. Im Kapitel “Länderunterschiede” werden die Unterschiede aufgelistet. Zum besseren Verständnis zeige ich hier nur die Basis-URL, welche vor allem für die US-Börsenkurse gültig ist. Das Ergebnis ist eine Werteliste, die durch Kommas getrennt präsentiert wird. Die Serviceadressen für aktuelle Kursinformationen lautet http://finance.yahoo.com/d/quotes.csv? und nimmt die folgenden drei bekannten Parameter entgegen:

Das folgende Beispiel ermittelt von Apple und Microsoft das Symbol, den Firmen-Namen, den aktuellen Anfrage-Kurs und die dazu gehörige Zeit ab. Dabei sind Zeit und Kurswert immer länderspezifisch zu verstehen (US-Zeit und Dollar). Wenn Sie diese URL in den Browser eingeben, können Sie das Ergebnis abspeichern. Danach können Sie die Rohdaten in einem Texteditor öffnen und betrachten (nicht mit Excel öffnen, da hier die Formatierung nicht ersichtlich wird).

http://finance.yahoo.com/d/quotes.csv?s=AAPL+MSFT&f=snat1
---
"AAPL","APPLE INC",151.47,"3:31pm"
"MSFT","MICROSOFT CP",29.09,"3:31pm"

Ein Programm kann nun diese Daten in einem mehrdimensionalen Array ablegen. Dabei enthalten die Spalten die Inhalte der Werte, welche durch die Format-Codes angefordert wurden. Die Zeilen bilden jeweils das Zahlentupel eines Wertpapiers ab. Eine PHP-Funktion zur Ermittlung der Kursdaten könnte somit folgendermaßen aussehen:

<?php
    /*
     * Getting current quotes:
     * Reading multible lines of values into an array depending on the given symbols and function tags.
     * Each line holds the values of one symbol. In the argument, symbols are separated by "+".
     *
     * (c) Matthias Brusdeylins, 2008
     * License: CC-GNU GPL (http://creativecommons.org/licenses/GPL/2.0/)
     */    

    define ("QUOTES_URL", "http://finance.yahoo.com/d/quotes.csv?");
    function loadYahooQuotes ($symbol,
                              $tags)
    {
        $lineCount = 0;
        $stocks = array();

        // load the stock quotes: we are opening it for reading
        // http://finance.yahoo.com/d/quotes.csv?s=  STOCK SYMBOLS  &f=  FORMAT TAGS
        $URL = QUOTES_URL."s=$symbol&f=$tags&e=.csv";
        $fileHandle = fopen ($URL,"r");

        if ($fileHandle) {
            // use the fgetcsv function to store quote values into an array $lineValues
            // one symbol in one line
            do {
                $stockValues = fgetcsv ($fileHandle, 999999, ",");
                if ($stockValues) {
                    $lineCount++;
                    $stocks[$lineCount] = $stockValues;
                }
            } while ($stockValues);

        fclose ($fileHandle);
        } else {
            // ERROR-Message in the array
            $stocks[0][0] = "ERROR";
            $stocks[0][1] = "No data found.";
        }

        return $stocks;
    }
?>

Devisen

Sie können nicht nur einzelne Aktienkurse erfragen, sondern auch Devisenkurse. Dazu müssen Sie an der oben vorgestellten Adresse als Symbol-Parameter ein spezielles Konstrukt der Form AB=X übermitteln. Hier steht der Buchstabe A für die erste zu vergleichende Währung und der Buchstabe B dann natürlich für die zweite Währung. X steht wohl für Exchange und wird nicht ersetzt. Wollen Sie mehrere Währungen abfragen, können mehrere Konstrukte mittels dem Pluszeichen “+” aneinander gehängt werden. Folgendes Beispiel soll dies verdeutlichen:

http://quote.yahoo.com/d/quotes.csv?s=USDCAD=X+JPYUSD=X&f=nl1d1t1
---
"USD to CAD",1.0088,"4/4/2008","5:02pm"
"JPY to USD",0.0098,"4/4/2008","5:26pm"

Die Kürzel der Währungen bestehen aus drei Buchstaben und werden hier aufgelistet:

Die Format-Codes

Für den Parameter der Formate-Codes (”f”) stehen eine ganze Reihe akzeptierter Format-Tags zur Verfügung. Viele sind dabei wohl redundant und werden hier einfach zusammengefasst (z.B. “a” und “b2″ für Anfrage-Kurs). Die folgende Tabelle listet alle bekannten Codes auf.

Achtung: In einigen Fällen liefert Yahoo!Finance mehrstellige Werte zurück, die ebenfalls mit Kommas getrennt dargestellt werden. Dies ist an sich ungeschickt, da es für Sie als Programmierer schwierig wird, die Kommas zwischen den einzelnen Werten von den Kommas in einem Wert zu unterscheiden. Hier empfehle ich, diese Parameter getrennt abzufragen.

Höhere Indexwerte führen nur noch zu einer Wiederholung der Inhalte. Vermutlich sollen die Codes zweistellig sein (Buchstabe + Zahl). Fällt die Zahl weg, so wir automatisch der Index 0 angenommen.

Daytrading-Daten

Leider bietet Yahoo!Finance nur die letzten 100 Tages-Kurswerte zum Ermittlungszeitpunkt an. Auch hier wirkt die Verzögerung von 15-60 Minuten, wie im Abschnitt “Aktuelle Kursdaten” beschrieben. Die Serviceadresse für die Daytrading-Daten lautet http://logtrade.finance.vip.ukl.yahoo.com/lastTrades? und nimmt folgende drei bekannte Parameter entgegen:

Das Ergebnis einer solchen Abfrage liefert eine Liste mit Wertegruppen – eine Gruppe für jeden Trade. Ein solches Tupel enthält den Trading-Zeitpunkt, den Kurswert und die Volumina des Trades.

Historische Kursdaten

Für ein Wertpapier stehen bei Yahoo ebenfalls historische Daten zur Verfügung. Die Service-URL hierfür lautet http://ichart.finance.yahoo.com/table.csv? und besitzt Parameter für das Symbol, sowie für das Zeitintervall, innerhalb ein Entwickler die täglichen bzw. wöchentlichen Kursdaten ermitteln will:

Das Ergebnis besteht aus einer Liste täglicher, wöchentlicher oder monatlicher Werte zu dem übermittelten Zeitraum. Die erste Zeile enthält die Überschrift der einzelnen Spaltenwerte. In allen weiteren Zeilen liefert Yahoo!Finance danach das Datum, den Eröffnungskurs, den höchsten und tiefsten Kurswert, sowie den Tagesschlusskurs und das Handelsvolumen für jeden einzelnen Tag. Da diese Werte gegenüber Splits und Dividenden unbereinigt sind, liefert Yahoo! in der letzten Spalte “Adj. Close” noch bereinigte Schlusskurse. Ein bisschen anders sieht das Ergebnis aus, wenn als Chart-Abstufung der Wert “v” für die Dividendenausschüttungen angegeben wird. Dann werden nur noch zwei Spalten mit einem Datum sowie dem Wert selbst zurückgeliefert. Hier noch zwei Beispiele mit den ersten paar Zeilen der Ergebnisse:

http://ichart.finance.yahoo.com/table.csv?s=AAPL&d=3&e=3&f=2008&g=d&a=8&b=7&c=1984&ignore=.cvs
---
Date,Open,High,Low,Close,Volume,Adj Close
2008-04-02,148.78,151.20,145.85,147.49,37253700,147.49
2008-04-01,146.30,149.66,143.61,149.53,36846400,149.53
2008-03-31,143.27,145.71,142.52,143.50,27418300,143.50
2008-03-28,141.80,144.65,141.60,143.01,25521800,143.01
...

http://itable.finance.yahoo.com/table.csv?s=AAPL&d=3&e=3&f=2008&g=v&a=8&b=7&c=1984&ignore=.cvs
---
Date,Dividends
1995-11-21,0.030000
1995-08-16,0.030000
1995-05-26,0.030000
...

Für die programmatische Auswertung dieser Daten bietet sich auch hier das Array als Ergebnisträger an. In jeder Zeile können so die Werte eines Tages (bzw. einer Woche, eines Monats oder der Dividenden) abgelegt werden. Folgende PHP-Funktion soll dies verdeutlichen:

<?php
    /*
     * Getting historical quotes in a given time period
     * Parameters:
     * $symbol:                             symbol
     * $startDay, $startMonth, $startYear:  the first day for the historical quotes
     * $endDay, $endMonth, $endYear:        the last day for the historical quotes
     * $step  (d/w/m/v):                    d=daily, w=weekly, m=monthly, v=dividends
     *
     * (c) Matthias Brusdeylins, 2008
     * License: CC-GNU GPL (http://creativecommons.org/licenses/GPL/2.0/)
     */
    define ("HISTORY_QUOTES_URL", "http://ichart.yahoo.com/table.csv?");
    function loadHistoricalYahooQuotes ($symbol,
                                        $startDay,
                                        $startMonth,
                                        $startYear,
                                        $endDay,
                                        $endMonth,
                                        $endYear,
                                        $step)
    {
        $lineCount = 0;
        $days = array();

        // modify parameters
        $sM=$startMonth-1;
        $eM=$endMonth-1;

        // load the historical stock quotes: we are opening it for reading
        // http://ichart.yahoo.com/table.csv?s=  SYMBOL.COUNTRY  &a,b,c START $d,e,f ENDE $g d=daily/w=weekly/m=monthly/v=dividends
        $URL = HISTORY_QUOTES_URL."s=$symbol&a=$sM&b=$startDay&c=$startYear&d=$eM&e=$endDay&f=$endYear&g=$step&y=0&ignore=.cvs";
        $fileHandle = fopen ($URL,"r");

        if ($fileHandle) {
            // use the fgetcsv function to store quote values into a array $lineValues
            // store one symbol in one line
            do {
                $stockValues = fgetcsv ($fileHandle, 999999, ",");
                if ($stockValues) {
                    $lineCount++;
                    $days[$lineCount] = $stockValues;
                }
            } while ($stockValues);

            // close handle
            fclose ($fileHandle);
        } else {
            $days[0][0] = "ERROR";
            $days[0][1] = "No data found.";
        }        

        return $days;
    }
?>

Länderunterschiede

An der Börse werden nicht nur Aktien in unterschiedlichen Währungen gehandelt, sondern auch Nebenwerte wie beispielsweise Optionsscheine. Der Handel solcher Wertpapiere ist meist auf ein Land bzw. Börsenplatz beschränkt. Aus diesem Grund bietet Yashoo!Finance auch unterschiedliche Serviceadressen an. In diesem Artikel wurden bisher nur die Adressen für US-Börsendaten aufgezeigt. So kann unter der URL http://finance.yahoo.com/d/quotes.csv? der aktuelle Kurs einer Aktie in US-Dollars ermittelt werden. Wollen Sie hingegen einen Kurs aus dem deutschen Raum ermitteln, steht Ihnen die URL http://de.finance.yahoo.com/d/quotes.csv? zur Verfügung.

Die folgende Tabelle zeigt die Adressen (URL) zum Yahoo!Finance-Service für aktuelle Börsenkurse. In der ersten Spalte werden auch die Symbol-Suffixe aufgelistet, welche für eine aktive Börsenplatz-Wahl an die Symbolangabe gehängt werden können (z.B. “AAPL.DE” für den XETRA-Kurs des Apple-Aktie). Ein Besuch auf die Webseite von Yahoo! Finance hilft hier bei der Auswahl der richtigen Symbolbezeichnung.

Download

Die Klasse Finance_API_Yahoo bietet einen einfachen Zugriff auf die hier beschriebene Schnittstelle. Mit ihr lassen sich aktuelle, sowie historische Kursdaten ermitteln. Das Ergebnis wird in einem zweidimensionalen Array zurückgeliefert (siehe Beispiele im Text). Für die Package-Struktur diente das Zend-Framework als Vorlage. Somit ist eine einfache Integration in dieses gewährleistet.

Yahoo! Finance API, Version 1.0

Change-Log

Diese Software und die hier gezeigten Codestücke fallen unter den Lizenzvertrag CC-GNU GPL.

(Gelöst mit WordPress 2.6.1 – Details weiter unten…)
PHP könnte direkt mit gettext-Support kompiliert werden. Dadurch stünden entsprechende Funktionen direkt zur Verfügung. Doch würde solch ein Programm nicht auf einem Rechner ohne entsprechende Unterstützung laufen. Aus diesem Grund wurde in WordPress das Projekt PHP gettext integriert. Die Implementierung liegt in den Dateien “gettext.php” und “streams.php” im “wp-includes”-Verzeichnis. WordPress erhält dadurch die Fähigkeit diese MO-Dateien einzulesen. Doch genau hier entstanden ab und zu Probleme.

Betrachtung des Problems

Die oben dargestellte Fehlermeldung kam bei mir sporadisch. Und ich kenne die Fehlerstelle genau. Sie befindet sich in der Datei “streams.php” in der Klasse StringReader. Und dort in der Funktion read($bytes). Hier lieferte die Zeile $data = substr($this->_str, $this->_pos, $bytes); nicht immer den richtigen Teilstring zurück. Manchmal war der Inhalt genau um ein Byte verschoben. Dadurch wurden in der Datei “gettext.php” in der Funktion gettext_reader(…) Strukturinformationen einer MO-Datei falsch interpretiert, was wiederum dazu führte, dass Mengenangaben komplett falsch eingelesen wurden. In solch einem Fehlerfall wurde die seekto() Funktion mit einem großen negativen Wert aufgerufen, was dazu führte, dass der Stream-Positionszeiger an das Ende der Daten gesetzt wurde. Dadurch lieferte jeder weitere Aufruf der Lesemethode einen Leerstring zurück. Und genau solch ein Leerstring wurde der Methode unpack() in der Datei “gettext.php” in der Zeile 85 übergeben, was zu der oben besagten Meldung führte.

Es ist zwar nicht wirklich eine Lösung, doch hatte ich die oben benannte Codezeile temporär mit folgenden Kommandos ausgetauscht:

Alter Code:

$data = substr($this->_str, $this->_pos, $bytes);

Neuer Code, der immer den richtigen Teilstring ermittelt:

$data = "";
for ($i=0; $i<$bytes; $i++) {
    $data .= $this->_str[$this->_pos+$i];
};

Gibt man hier noch eine Meldung aus, sobald die beiden ermittelten Teilstrings unterschiedlich sind, dann merkte man, dass diese gleichzeitig mit dem hier beschriebenen Fehler auftauchte. Verglich man die Inhalte, sah man, dass bei einer Startposition > 0 der Teilstring aus substr() um ein Zeichen/Byte verschoben war. Statt z.B. den Inhalt von Index 4-7 zu ermitteln, lieferte diese Methode dann die Zeichen 5-8. Wohl bemerkt, dies aber nur sehr sporadisch!

Eigentlich eine fatale Sache, wenn ein regulärer PHP-Befehl Probleme verursacht. Dieser Befehl, der Teile aus gegebenen Texten extrahiert, kommt in WordPress häufiger zum Einsatz. Am sichtbarsten ist er in Kombination mit der Datei “gettext.php”, da hier ein Fehler geworfen wird. Aber mir ist ebenfalls aufgefallen, dass es auch Probleme mit dem Abspeichern geschriebener Inhalte gab. Hier kam es vor, dass an Stellen eingebundener Steuercodes (Links, Code-Tags) Teile des Inhaltes verschwanden. Man bemerkte die Fehlersituation, da der berühmte gettext-Fehler auftrat. Aus diesem Grund ließ ich die oben beschriebenen neuen Codezeilen auch nicht in meiner Installation. Mir sind mit diesem Code schon Inhalte verschwunden, ohne dass ich dies sofort bemerkte.

Lösungswege

Auf jeden Fall musste die Problemursache an einer Server-Konfiguration oder –Komponente liegen. Ich verwalte noch eine weitere WordPress-Webseite und dort bekam ich noch keine Fehler. Zu erwähnen ist auch, das beide Seiten beim gleichen Provider gehostet werden, die gleiche PHP-Version installiert war und inzwischen bei beiden WordPress in der Version 2.3 vorlag.

Meine temporäre Lösung bestand darin, dass ich auf meiner Seite die originale englische Version von WordPress installierte. Somit trat der Fehler seltener auf, da eine Sprachdatei weniger eingelesen werden musste. Er verschwand aber nicht komplett, weil noch PlugIns mit Sprachdateien installiert waren. Dies machte sich dann aber eher im Admin-Bereich, vor allem beim Speichern der Beiträge bemerkbar.

Dank dem schnellen und motivierten Support meines Providers All-Inkl.de dachten wir zuerst, dass wir den Fehler eindämmen konnten. Der erste Versuch bestand darin, den ZEND-Optimizer zu installieren und weitere PHP-Parameter an den Parametern des Servers meiner anderen WordPress-Präsenz anzupassen. Leider ohne dem gewünschten Ergebnis. Ein Update der PHP-Installation von der Version 5.2.3 auf 5.2.4, sowie die Aktualisierung der Apache-Installation von der Version 2.2.4 auf 2.2.6 ließen den nervigen Fehler dann kurzzeitig doch verschwinden. Vermutlich besitzt substr() in PHP 5.2.3 nicht die erhoffte Stabilität.

Update 24.10.07:
Das Problem tritt seit heute leider wieder auf! Womöglich lag es doch nicht an der alten PHP-Version. Ich verfolge das weiter…

Update 30.10.07:
Das ist schade, aber auch das Update auf Wordpress 2.3.1 DE brachte nicht den erhofften Erfolg. Wir sind leider so langsam am Ende mit dem Suchen, auch mit der Geduld. Der nächste Schritt besteht wohl darin, meinen Webspace innerhalb meines Providers auf einen anderen Server zu verschieben. Zur Zeit habe ich die Datei “/wp-includes/languages/de_DE.mo” entfernt, damit der Fehler nicht mehr so häufig auftritt.

Update 03.11.07:
Mein Provider All-Inkl hat nun meine Webseite auf einen anderen Server installiert. Seit dem scheint die Webseite ohne Probleme zu funktionieren. Schade ist nur, dass wir nun nicht genau wissen, welche Server-Einstellung / Hardware-Kombination hier wohl Probleme mit der Funktion substr() aus PHP 5 verursacht.

Update:
Der Fehler taucht wieder auf…

Update 15.11.07:
Heute wurde PHP 5.2.5 auf dem Webserver installiert. Laut All-Inkl bin ich der Erste, der diese Installation testen darf. Ich laufe nun auch wieder auf der originalen deutschen Version. Bis jetzt sind mir noch keine Probleme begegnet. Die Zeit wird zeigen, ob das die Lösung war…

Update 26.02.08:
Im Kommentar Nr. 48 berichtet Niko_K, dass das Problem wohl durch nicht übereinstimmende Spracheinstellungen zwischen der WordPress-Configuration und dem Linux-System (Variable LANG) auftritt. Danke!

Ich vermute stark, dass PHP-String-Funktionen wie das substr() wohl abhängig von den Systemeinstellungen sind und somit mit den richtigen Daten befüttert werden müssen.

Update 25.04.08:
Im Kommentar Nr. 60 berichtet Kretzschmar darüber, dass der Fehler unter PHP 4 nicht mehr auftaucht. Die Umstellung von PHP 5 auf PHP 4 kann beim Provider All-Inkl wohl selbst vorgenommen werden.

Ubdate 24.06.08:
Der Bug ist inzwischen schon bei Wordpress registriert (Bug 5599 – danke an Codestyler für den Hinweis). Hier wird aktuell eine Alternative zu substr() eingesetzt. Diese Lösung ist eleganter als die oben beschriebene. Leider ist die korrigierte Stelle nicht die einzige mit dem Befehl substr(), weswegen man trotzdem ein Fehlverhalten bzw. Datenverlust in der Anwendung erwarten kann.

Update 15.08.08:
Endlich! Wordpress 2.6.1 liefert nun ein Bugfix zu diesem Problem. Der Fehler tritt auf, sobald man in der php.ini den Eintrag mbstring.func_overload auf einen anderen Wert als 0 stellt. Meist erlauben die Provider es, diesen Wert für die eigene Web-Präsenz zu ändern. Ein Bug im Apache-Modul mod_php sorgt allerdings bei dieser Art der Umstellung dafür, dass sie für alle V-Hosts des Servers gilt! Sobald also ein User des gleichen V-Hosts an dieser Einstellung dreht, erscheinen bei den anderen WordPress-Präsenzen auf dem Server wohl diese Fehler, zumindes bis eine andere Präsenz diesen Wert wieder auf 0 stellt. Näheres hierzu unter code-styling.de.

Native Lösung

Es lief einige Tage gut, nun sind seit heute (06.11.2007) alle WordPress-Seiten auf dem neuen Server wohl auch betroffen…

Im deutschsprachigen WordPress-Forum bin ich nun auf eine weitere Lösung gestoßen: Einsatz des originalen gettext() Kommandos. Diese Lösung kann leider nur dann angewendet werden, wenn gettext auf dem entsprechenden Server installiert ist. Ein Blick in die PHP-Info liefert hierzu Informationen:
GetText Support enabled

Worin besteht die Lösung? In der WordPress-Datei /wp-includes/l10n.php wird die WordPress-Version von gettext() aufgerufen. Der Code wird nun so geändert, dass die installierte Funktion gettext() anstelle der problematischen gettext-Vertretung aufgerufen wird. Dazu muss die Sprachdatei /wp-includes/languages/de_DE.mo zu wordpress.mo umbenannt und in ein neues Verzeichnis kopiert werden. Der Name des Verzeichnisses ist abhängig von der eingestellten Codierung in der Datei wp-config.php:

Eine Sprachdefinition define (’WPLANG’, ‘de_DE.UTF-8′); benötigt das Verzeichnis wp-includes/locale/de_DE.UTF-8/LC_MESSAGES/.

Lautet die Sprachdefinition define (’WPLANG’, ‘de_DE’); muss das Verzeichnis den Namen wp-includes/locale/de_DE/LC_MESSAGES/ tragen.

Wenn man will, kann man in der Datei wp-settings.php die Zeilen
include_once(ABSPATH . WPINC . ‘/gettext.php’);
include_once(ABSPATH . WPINC . '/streams.php');
auskommentieren und die Dateien gettext.php und streams.php löschen.

Damit die Umstellung schnell vollzogen werden kann, hab ich für WordPress 2.3.1 Deutsch ein kleines ZIP-File mit allen nötigen Änderungen erstellt:

Native_gettext_WordPress_2.3.1.zip

ACHTUNG:
hier bitte auf die richtige Codierung achten, damit beim Posten keine Inhalte verloren gehen. Am Besten vorher ein Backup der Datenbank anlegen. Wenn eine andere Wordpress-Version unterstützt werden soll, dann einfach die Sprachdateien aus dem ZIP-File entsprechend der obigen Anleitung selbst generieren.

Und nicht vergessen: somit ist das Anzeige-Problem gelöst, der Fehler taucht nicht mehr auf, aber es gibt noch viele andere substr()-Aufrufe, welche schief laufen können. Auffällig ist dabei Datenverlust an den Steuer-Tags aus der Code-Ansicht.

Damit solche Metadaten für einzelne WordPress-Beiträge individuell angegeben werden können, wird ein sogenanntes WordPress-Plugin benötigt. Ich will hier meine kleine Erweiterung “Easy-HTML-Metadata” vorstellen. Sie reagiert auf zuvor definierte “Benutzerdefinierte Felder” eines Beitrags bzw. einer Seite und gibt dessen Inhalte als Metadaten aus.

Installation

Nach dem Herunterladen der aktuellsten Version dieses Plugins (siehe unten) muss die PHP-Datei aus dem Zip-File in das WordPress-Plugin-Verzeichnis (dies ist meist /wp-content/plugins/) kopiert werden. Hier kann man ggf. auch ein Unterverzeichnis anlegen, um so mehr Überblick über alle Plugins in seiner WordPress-Installation zu erlangen. Danach muss dieses Plugin in der Adminkonsole aktiviert werden.

Einsatz

Jetzt steht dem User unter den Einstellungen ein neuer Menüpunkt “HTML-Metadata” zur Verfügung,  in dem die Standard-Sprache sowie die Namen der benutzerdefinierten Felder definiert werden können (siehe Bild oben rechts). In der Regel bleiben die Feldnamen unverändert. Nun kann man zu jedem Beitrag solche benutzerdefinierten Felder mit angeben. Als Schlüssel werden die zuvor definierten Namen eingesetzt, der Wert ist dann der Inhalt des zugeordneten Meta-Data-Elementes. Im Beispiel links sind die Meta-Angaben dieses Artikels (zum Zeitpunkt der Erstellung) sichtbar. Das Ergebnis der Version 1.2 im HTML-Kopf dieser hier sichtbaren Seite sieht dazu folgendermaßen aus:

<meta name="MBEasyHTMLMetadata" content="1.0" />
<meta name="language" content="de" />
<meta name="content-language" content="de" />
<meta name="description" content="Wordpress-Plugin für inhaltliche HTML-Metaangaben." />
<meta name="keywords" content="Wordpress, Plugin, Metadata, Metadaten, Description, Beschreibung, Keywords, Schlüsselwörter" />
<meta name="author" content="Matthias Brusdeylins" />
<meta name="copyright" content="Copyright by Matthias Brusdeylins. Creative Commons 3.0 license - Some rights reserved." />

Hier ist auch erkennbar, dass automatisch der volle Name des registrierten Autors mit ausgegeben wird. Das Plugin benötigt keine Änderungen an dem installierten WordPress-Theme.

Download

Easy-HTML-Metadata, Version 1.2

Change-Log

Diese Software fällt unter den Lizenzvertrag CC-GNU GPL.