WordPress: So nutzt du ein eigenes Plugin statt der functions.php

Jeder, der län­ge­re Zeit eine WordPress-Website betreibt, kennt das Problem. Für alle mög­li­chen Funktionen braucht man klei­ne Code-Schnipsel, die man in die functions.php des akti­vier­ten Themes ein­fügt. Wenn die Website nur eini­ge weni­ge die­ser Code-Snippets benö­tigt, ist das grund­sätz­lich kein Problem. Doch eine Website, die bereits seit Jahren online ist, hat even­tu­ell schon sehr vie­le Code-Schnipsel ange­sam­melt. So ver­liert man ers­tens schnell den Überblick und zwei­tens sind die Änderungen bei einem Theme-Wechsel oder einem Update des Themes ver­schwun­den. Ich zei­ge dir heu­te einen bes­se­ren Weg.

Nachteile von Code-Schnipseln in der functions.php

Nach und nach sam­meln sich vie­le Code-Snippets in der functions.php-Datei eines WordPress-Themes an. Die Übersicht lei­det schon extrem, auch weil zumeist nicht nur Schnipsel ihre Heimat in der Datei fin­den, son­dern auch noch Theme-Funktionen dar­in unter­ge­bracht sein kön­nen, wie es bei den Standard-Themes von WordPress und eini­gen ande­ren Themes der Fall ist. Bei einem Theme-Update sind zudem noch alle Code-Schnipsel wie­der ver­schwun­den und man muss sein hof­fent­lich getä­tig­tes Backup der Datei wie­der ein­spie­len. Nachteile über Nachteile.

Der Mensch ist ein Herdentier und hin­ter­fragt vie­le Dinge nicht – auch nicht die Dinge, die bis­her nicht wirk­lich gut funk­tio­nier­ten. Alle Verwender einer WordPress-Website hand­ha­ben es so, daher wird es eben­so gehand­habt. Auch mir ist das jah­re­lang so gegan­gen. Ich ken­ne alle Nachteile zur Genüge und habe trotz­dem nicht nach einer Lösung gesucht, obwohl die­se so nah ist.

Ein seitenspezifisches Plugin anlegen, statt die functions.php zu nutzen

Die Idee ist nahe­lie­gend und wesent­lich funk­tio­nel­ler, als die unsäg­li­che functions.php zu nut­zen. Wir erstel­len ein­fach ein eige­nes Plugin für die Website. Alle Code-Schnipsel kom­men nur noch in die­ses Plugin hin­ein, alte Schnipsel zie­hen ein­fach um. Das hat zudem den gro­ßen Vorteil, dass nach einem Theme-Update oder einem Theme-Wechsel alle Code-Fragmente noch vor­han­den sind. Die Lösung ist also zukunfts­si­cher und ein­fach zu hand­ha­ben.

Doch bevor wir an die Arbeit gehen, fer­ti­gen Sie bit­te ein Backup ihrer functions.php Datei an.

So erstellst du ein eigenes Plugin für deine Website

Vielleicht denkst du jetzt, dass es echt kom­pli­ziert ist, ein eige­nes Plugin zu erstel­len. Doch das ist es nicht. Im Gegenteil, es ist sogar rich­tig ein­fach. Erstelle zuerst einen neu­en Ordner auf dei­nem Desktop und nen­ne ihn web­site­na­me-plugin. Beispiel: drweb-plugin. In die­sen Ordner fügst du eine lee­re Datei ein, die du mit Notepad (Windows) oder TextEdit (Mac) erstel­len kannst. Nenne die Datei websitename-plugin.php.

Öffne die Datei nun mit einem Texteditor oder einer Entwicklungsumgebung wie zum Beispiel Atom, Brackets oder ähn­li­chen. Kopiere fol­gen­des hin­ein:

Ein Klick öff­net das Gist bei GitHub

Nun kannst du in die­se Datei dei­ne Code-Schnipsel aus der functions.php-Datei ein­fü­gen. Nachdem das gesche­hen ist, lädst du den Ordner mit dei­nem Plugin in das Plugin-Verzeichnis von WordPress per (S)FTP hoch. Der kor­rek­te Pfad lau­tet: wp-con­ten­t/p­lug­in­s/.

Im Anschluss musst du dich in dein WordPress ein­log­gen und das Plugin noch akti­vie­ren.

Fazit

Mit nur wenig Aufwand haben wir eine bes­se­re und vor allem zumeist über­sicht­li­che­re Lösung für das Problem mit den Code-Schnipseln gefun­den. Endlich sind unse­re Sonderfunktionen bei Theme-Wechseln und Updates sicher. Das ist ziem­lich smart. Wenn du Schnipsel zum Auslagern suchst, schau mal in die­sen Beitrag. Da haben wir ein paar nütz­li­che Code-Snippets gesam­melt.

(dpe)