Die Vielfalt an Plugins für WordPress ist enorm. Leider sind unter diesen tausenden von Plugins auch solche, die zu Problemen führen können, da sie schlecht programmiert sind. Ich bin mal ganz ehrlich: Den Fehler, den ich in diesem Post beschreibe, habe auch ich bei meinem ersten Plugin gemacht, einfach aus dem Grund, dass ich mich nicht genügend in die Materie der Hooks eingelesen habe.

Die Ursache für JavaScript Probleme im Backend

Viele Plugins benötigen JavaScript und die Dateien werden über die Funktion wp_enqueue_script() eingebunden. Was man allerdings beachten muss ist der Hook, den man verwendet, um diese Funktion auszuführen. Viele Plugins, die ich gesehen habe, nehmen hier leider den falschen Hook. So sehe ich oft diese Einbindung:

function pluginname_enqueue_script() {
	wp_enqueue_script( 'pluginname_js', plugins_url( '/script.js' , __FILE__ ) );
}
add_action( 'init', 'pluginname_enqueue_script' );

Mit dem Hook init wird die JavaScript-Datei also auf allen Seiten der WordPress Installation eingebunden und somit auch im Backend. Dies ist bei den meisten Plugins aber nicht nötig und bei einigen kann es zu Konflikten mit den JavaScript Funktionen des Backends kommen.

Mögliche Lösungswege für das Problem

Wenn man auf ein solches Problem stößt, hat man verschiedene Möglichkeiten es zu lösen. Für einige braucht man aber zumindest grundlegende Programmierkenntnisse oder muss zumindest den PHP Quellcode lesen können.

1. Den richtigen Hook selbst eintragen

Das ist wohl die einfachste Variante das Problem zu lösen, aber leider auch die am wenigsten sinnvolle. Denn für den Moment ist das Problem gelöst, aber schon mit dem nächsten Update des Plugins ist der Fehler wieder da und man muss ihn erneut beheben.

2. Den falschen Hook entfernen und den richtigen setzen – in einer eigenen Datei

Genau so einfach, wie man einen Filter setzen kann, kann man ihn auch wieder entfernen. Ein Lösungsweg ist daher, den falschen Hook einfach zu entfernen, um ihn dann direkt mit dem richtigen hinzuzufügen. Oder aber man entfernt nur die JavaScript Datei, falls die Funktion, die das JavaScript hinzufügt, auch sinnvolle Aufgaben erfüllt. Das könnte dann wie folgt aussehen:

function remove_bad_enqueued_script() {
	wp_dequeue_script( 'pluginname_js' );
}
add_action( 'init', 'remove_bad_enqueued_script', 11 );

Ich verwende hier auch wieder den init Hook mit einer Priorität von 11 (Standard ist 10), um das falsch hinzugefügte JavaScript zu entfernen. Anschließend fügen wir es dann wieder mit dem passenden richtigen Hook hinzu. Zum Beispiel wie folgt:

function correct_pluginname_enqueue_script() {
	wp_enqueue_script( 'pluginname_js', plugins_url( '/script.js' , __FILE__ ) );
}
add_action( 'wp_enqueue_scripts', 'correct_pluginname_enqueue_script' );

Das sieht jetzt auf den ersten Blick aus wie zuvor, der Trick ist hier aber, dass wie den Hook wp_enqueue_scripts verwenden und nicht die ähnlich lautende Funktion innerhalb des init Hooks. Es gibt drei solcher Hooks, die für die Bereiche Frontend, Backend und Login verwendet werden sollte. Andrew Nacin, der Lead-Developer von WordPress, erklärt die Verwendung der drei Hooks in einem Beitrag auf make.wordpress.org und wofür welcher eingesetzt wird.

Diese beiden Anpassungen kommen nun entweder in die Datei functions.php oder aber in ein Mini-Plugin (oder ein Modul für die Toolbox). Somit geht diese Anpassung bei einem Updates des Plugins auch nicht verloren.

3. Den Plugin-Entwickler auf den Fehler aufmerksam machen

Die allerbeste Lösung ist es aber immer, dem Plugin-Entwickler seinen Fehler zu schildern, und wie er ihn lösen sollte. Dann bekommen alle Nutzer des Plugins mit dem nächsten Update eine stabile Version. Bis der Entwickler das Problem gelöst hat, könnt ihr natürlich eine der ersten beiden Möglichkeiten zur schnellen Lösung des Problems anwenden, damit ihr das Plugin weiterhin verwenden könnt.

Fazit

Auch durch kleine Fehler, die durch Unkenntnis des Entwicklers entstanden sind, kann es in eurem Blog zu Problemen kommen. Wenn ihr den Fehler gefunden habt, solltet ihr am besten immer direkt dem Entwickler diesen Fehler mitteilen. Ihr werdet euch wundern, wie schnell diese oft reagieren. Wenn ihr es euch zutraut, könnt ihr den Fehler in der Zwischenzeit aber auch selbst beheben.