{"id":418,"date":"2017-05-08T14:01:20","date_gmt":"2017-05-08T12:01:20","guid":{"rendered":"http:\/\/evileu.de\/zum-schwarzen-pinguin\/?p=418"},"modified":"2017-05-08T14:01:20","modified_gmt":"2017-05-08T12:01:20","slug":"unser-erstes-plugin-setzecode","status":"publish","type":"post","link":"https:\/\/evileu.de\/zum-schwarzen-pinguin\/2017\/05\/08\/unser-erstes-plugin-setzecode\/","title":{"rendered":"Unser erstes Plugin: SetzeCode 1, die Plugin-Definition"},"content":{"rendered":"

Was ist eigentlich ein Plugin?<\/h2>\n

Ganz vereinfacht gesagt: ein Plugin ist eine Funktionserweiterung des Admin Panels. Es bekommt einen eigenen Men\u00fceintrag (kann man nach Belieben definieren, sp\u00e4ter mehr dazu), und man kann eine Funktion hinterlegen, die bei Aufruf des Men\u00fceintrags ausgef\u00fchrt wird.<\/p>\n

Was soll unser Plugin k\u00f6nnen?<\/h2>\n

Wir wollen den Wert einer Option in der Tabelle wp_options setzen bzw. \u00e4ndern. Daf\u00fcr brauchen wir ein Eingabefeld, in das der Benutzer seinen Optionswert eintragen kann, und einen „Abschicken“-Button, der den Neueintrag setzt. Das wars eigentlich schon, und wir l\u00f6sen das nat\u00fcrlich mit einem kleinen Formular, aber dazu sp\u00e4ter mehr. Jetzt gehts erstmal darum:<\/p>\n

Wie definiere ich ein Plugin?<\/h2>\n

Daf\u00fcr legt man sich eine PHP-Datei an, die bestimmten Anforderungen entsprechen muss (gleich mehr). Dieser Datei gibt man einen aussagekr\u00e4ftigen Namen, in unserem Fall z.B. setze_code.php. Dann legt man sich unterhalb des WordPress-Verzeichnisses …wp-content\/plugins<\/strong> ein eigenes neues Verzeichnis f\u00fcr das Plugin an und benennt es entsprechend, also z. B. …wp-content\/plugins\/setze-code<\/strong>. In dieses Verzeichnis schieben wir sp\u00e4ter unsere PHP-Datei rein, aber jetzt f\u00fcllen wir sie erstmal mit Funktionalit\u00e4t.<\/p>\n

Der Header des Plugin-Skripts<\/h2>\n

WordPress liest aus dem Header die relevanten Plugin-Informationen zur Darstellung im Plugins-Men\u00fc, der muss also bestimmten Anforderungen gen\u00fcgen. Das sieht beispielsweise so aus:<\/p>\n

\/*<\/em><\/strong>
\nPlugin Name:<\/strong> SetzeCode<\/em>
\nPlugin URI:<\/strong> http:\/\/localhost\/wordpress\/wp-content\/plugins\/SetzeCode<\/em>
\nDescription:<\/strong> Setzt eine Option f\u00fcr einen benutzerdefinierten Code<\/em>
\nVersion:<\/strong> 1.0<\/em>
\nAuthor:<\/strong> Evi Leu<\/em>
\nAuthor URI:<\/strong> http:\/\/www.evileu.de<\/em>
\n*\/<\/em><\/strong><\/p>\n

Die fett<\/strong> markierten Schl\u00fcsselw\u00f6rter m\u00fcssen ganz genau so geschrieben werden wie sie hier zu sehen sind, inklusive der Kommentar-Tags (\/*). Die hinter den Schl\u00fcsselw\u00f6rtern hinterlegten Informationen kann man frei formulieren, aber es sollten schon sinnvolle Informationen sein, die man hier eintr\u00e4gt, die tauchen dann n\u00e4mlich im Plugins Men\u00fc auf:<\/p>\n

\"pluginscreen\"

pluginscreen<\/p><\/div>\n

Alles klar soweit mit dem Header? Dann gehts weiter mit dem:<\/p>\n

Eintrag im Admin-Panel<\/h2>\n

Mit der Funktion add_action() wird WordPress angewiesen, eine neue Funktionalit\u00e4t hinzuzuf\u00fcgen. Wir wollen das im Admin Panel tun, also kriegt der erste Parameter den Wert „admin_menu“ mit. Der zweite Parameter benennt die Funktion, die bei Aufruf des Men\u00fceintrags ausgef\u00fchrt werden soll.<\/p>\n

add_action(‚admin_menu‘, ‚basicPluginMenu‘);<\/em><\/p>\n

Die Funktion ‚basicPluginMenu‘<\/em> sieht f\u00fcr unser Plugin folgendermassen aus:<\/p>\n

function basicPluginMenu() {<\/em>
\n$appName = ‚SetzeCode‘;<\/em>
\n$appID = ’setze-code‘;<\/em>
\nadd_menu_page($appName, $appName, ‚administrator‘, $appID, ‚pluginAdminScreen‘);<\/em>
\n}<\/em><\/p>\n

Mehr zur Funktion add_menu_page() im Codex<\/a>, ich machs hier mal kurz, als Parameter werden hier als absolutes Minimum mitgegeben:<\/p>\n