Plugins erstellen für den WordPress Admin Bereich

In diesem Gastartikel beschreibt Stefan Wienströer von SteviesWebsite Blog die Erstellung eines einfachen Plugins für WordPress. Auf seinem Blog schreibt er über viele Programmierthemen.

Oft kann es ganz hilfreich sein, sich seine eigenen Plugins für den WordPress Adminbereich zu schreiben. Denn jeder Blog ist anders und es gibt wahrscheinlich kein Plugin, was perfekt für jeden ist.

Ich möchte euch heute eine kleine Starthilfe geben und vielleicht entscheidet ihr euch ja dazu, selbst mal ein Plugin zu entwickeln.

Für das Entwickeln von Plugins sollte man allerdings Grundkenntnisse in PHP besitzen. Wer diese noch nicht hat, sollte sich am besten ein entsprechendes Buch dafür besorgen.

Das Beispiel

Werbung

Wir erstellen heute ein Plugin, mit welchem man seine Profile bei Blogverzeichnissen anzeigen lassen kann.

Es ist sehr simpel aufgebaut, damit man schnell verstehen kann, wie man anfängt.

Basisdaten

Wenn ihr mal in die WordPress Plugin-Verwaltung schaut, werdet ihr sehen, dass jedes Plugin folgende Eigenschaften hat:

• Name
• Plugin Url
• Beschreibung
• Autor
• Version
• Autoren Url

Diese Daten stehen im PHP-Kommentar in der jeweiligen Basisdatei des Plugins. Für unser Profil-Plugin sieht das dann zum Beispiel so aus:

<?php
/*
Plugin Name: Profile
Plugin URI: http://blog.stevieswebsite.de
Description: Dieses Plugin zeigt die Profile f&uuml;r Blogverzeichnisse an.
Author: SteviesWebsite
Version: 1.0
Author URI: http://blog.stevieswebsite.de

?>

Der Code muss dann dort gespeichert werden:
/wp-content/plugins/{pluginname}/{pluginname}.php

In unseren Fall ist das dann der folgende Dateiname:
/wp-content/plugins/profile/profile.php

Wenn das ganze jetzt hochgeladen ist, kann man die Beschreibung bei den Plugins sehen.

Dafür muss man auf Plugins->Verwalten->Inaktive gehen. Hier wird dann auch unser Plugin angezeigt:

Nach der Aktivierung des Plugins werdet ihr noch nicht viel sehen können, weil wir ja schließlich auch noch nicht wirklich etwas erstellt habe. Das wird sich jetzt ändern.

Im nächsten Schritt werden wir folgendes Menü erstellen:

Admin Menü registrieren

In WordPress muss man sein Admin-Menü registrieren. Das Erstellen der Menüeinträge erfolgt in einer eigenen Funktion. Diese wird mit add_action registriert und das Funktioniert so:

add_action('admin_menu', 'profileAddMenu');

Nun wird beim Aufbau des Admin-Menüs die Funktion profileAddMenu aufgerufen, welche wir jetzt erstellen:

function profileAddMenu() {
  add_menu_page('Profile', 'Profile', 10, __FILE__, 'profile');
  add_submenu_page(__FILE__, 'Bloggerei', 'Bloggerei', 10, 'bloggerei', 'bloggerei');
  add_submenu_page(__FILE__, 'Blogoscoop', 'Blogoscoop', 10, 'blogoscoop', 'blogoscoop');
  add_submenu_page(__FILE__, 'Top Blogs', 'Top Blogs', 10, 'topblogs', 'topblogs');
}

Und zwar wird hier mit add_menu_page der Eintrag im Hauptmenü erstellt. Dieser ist später immer zu sehen. Die Funktion hat die folgenden Parameter:

• Seitentitel: Dieser Seitentitel wird später im <title>-Element beim Aufruf der Seite eingefügt.
• Menütext: Das ist der Text, der im Menü angezeigt wird.
• Zugriffslevel: Das Menü wird nur angezeigt, wenn der Benutzer einen bestimmten Rang hat. In unseren Fall ist es 10 für den Admin. Weitere Ränge kann man hier nachlesen..
• Datei: Die Datei, in der die Funktion ist, welche den Inhalt ausgibt. __FILE__ heißt, dass die Datei sich in der selben Datei befindet.
• Funktion: Der Name der Funktion die aufgerufen werden soll.
• Icon: Hier kann man die Icon-Url angeben. Wird sie weggelassen, wird ein Zahnrad angezeigt.

Untermenüs erstellen

Bei den Untermenüs könnt ihr eure Profile auflisten. Ich hab jetzt mal Bloggerei, Blogoscoop und Top Blogs genommen.
Die Funktion add_submenu_page hat dabei folgende Parameter. Ich hab jetzt mal nur eine Beschreibung erstellt, wenn die Beschreibung anders ist als bei add_menu_page:

• Parent: Dort muss die Hauptdatei des Admin-Plugins angegeben werden. In diesem Fall ist das die gleiche Datei, also können wir hier __FILE__ nehmen.
• Seitentitel
• Menütext
• Zugriffslevel
• Datei
• Funktion

Jetzt haben wir es auch schon fast geschafft. Wir müssen nur noch die Funktionenn erstellen, die den Inhalt ausgeben. Hier kann einfach mit echo oder Ähnlichen der Inhalt ausgegeben.

Ich habe jetzt mal mit IFrames die jeweiligen Profile angezeigt. Außerdem werden diese auch noch auf der Profile-Seite aufgelistet. So sieht nun die fertige Datei aus:

<?php
/*
Plugin Name: Profile
Plugin URI: http://blog.stevieswebsite.de
Description: Dieses Plugin zeigt die Profile f&uuml;r Blogverzeichnisse an.
Author: SteviesWebsite
Version: 1.0
Author URI: http://blog.stevieswebsite.de

function profile() {
  ?>
    <h1>Profile</h1>
    <a href="/wp-admin/admin.php?page=bloggerei">Bloggerei</a><br />
    <a href="/wp-admin/admin.php?page=blogoscoop">Blogoscoop</a><br />
    <a href="/wp-admin/admin.php?page=topblogs">Top Blogs</a><br />
  <?PHP
}

function bloggerei() {
  echo "<iframe style=\"width:100%;height:600px\" 
src=\"http://www.bloggerei.de/blog/9176/stevieswebsite-blog\"></iframe>";
}

function blogoscoop() {
  echo "<iframe style=\"width:100%;height:600px\" 
src=\"http://www.blogoscoop.net/blog/blog.stevieswebsite.de\"></iframe>";
}

function topblogs() {
  echo "<iframe style=\"width:100%;height:600px\" 
src=\"http://www.topblogs.de/blog-5901.html\"></iframe>";
}


function profileAddMenu() {
  add_menu_page('Profile', 'Profile', 10, __FILE__, 'profile');
  add_submenu_page(__FILE__, 'Bloggerei', 'Bloggerei', 10, 'bloggerei', 'bloggerei');
  add_submenu_page(__FILE__, 'Blogoscoop', 'Blogoscoop', 10, 'blogoscoop', 'blogoscoop');
  add_submenu_page(__FILE__, 'Top Blogs', 'Top Blogs', 10, 'topblogs', 'topblogs');
}
 
add_action('admin_menu', 'profileAddMenu');
?>

Wie geht es weiter?

Das kann natürlich nur ein erster Einblick in die Erstellung von WordPress-Plugins sein. Wer mehr wissen will, der sollte in Zukunft wieder hier vorbeischauen, da ich meine Erfahrungen bei der Erstellung eigener Plugin sicher hier weitergeben werde.

Im neuen WordPress Buch * von Frank Bültge und Thomas Boley wird unter anderem die Entwicklung von WordPress-Plugins behandelt. Ein sehr empfehlenswertes Buch.

Werbung