Eigene Funktionen in die functions.php einfügen – WordPress richtig erweitern

Warum die functions.php wichtig ist

Die Datei functions.php ist das Herzstück eines WordPress-Themes. Sie erlaubt es Entwicklern, das Verhalten von WordPress anzupassen, neue Funktionen hinzuzufügen oder bestehende zu erweitern – ganz ohne Plugins.

Viele WordPress-Optimierungen oder kleinere Anpassungen lassen sich mit wenigen Zeilen Code direkt in der functions.php umsetzen. Dazu gehören unter anderem:

• Das Entfernen unnötiger Meta-Daten
• Neue Widgets oder Menüs hinzufügen
• Zusätzliche Funktionen für WooCommerce
• Eigene Shortcodes erstellen
• Anpassungen an Login und Admin-Bereich

Aber Achtung: Die functions.php gehört zum Theme. Änderungen sind nach einem Theme-Wechsel nicht mehr aktiv. Deshalb sollte für dauerhafte Anpassungen oft ein eigenes Plugin genutzt werden (dazu später mehr).

Grundlagen: So fügen Sie eigenen Code in functions.php hinzu

1. Melden Sie sich per FTP oder über den Datei-Manager Ihres Hostings an.
2. Navigieren Sie zu Ihrem aktiven Theme-Verzeichnis unter wp-content/themes/ihr-theme/.
3. Öffnen Sie die Datei functions.php mit einem Editor (z. B. Notepad++, VS Code oder Sublime Text).
4. Fügen Sie Ihren Code am Ende der Datei ein, aber immer mit einer Sicherheitsprüfung.

Beispiel: Eigene Funktion zum Entfernen der WordPress-Version

Viele Hacker suchen gezielt nach WordPress-Versionen mit bekannten Sicherheitslücken. Diese können Sie aus dem Seitenquelltext entfernen:

function remove_wp_version() {
    return '';
}
add_filter('the_generator', 'remove_wp_version');

Nach diesem Code-Snippet wird die WordPress-Versionsnummer nicht mehr im Seitenquelltext angezeigt.

Praktische Code-Snippets für die functions.php

1. Eigene Admin-Leiste anpassen

Falls Sie die WordPress-Admin-Leiste für bestimmte Benutzerrollen ausblenden möchten, können Sie diesen Code verwenden:

function hide_admin_bar() {
    if (!current_user_can('administrator')) {
        show_admin_bar(false);
    }
}
add_action('after_setup_theme', 'hide_admin_bar');

Dieser Code stellt sicher, dass nur Administratoren die Admin-Leiste sehen können.

2. Eigene Shortcodes erstellen

Shortcodes sind eine einfache Möglichkeit, benutzerdefinierte Inhalte per [shortcode] in Beiträge oder Seiten einzufügen.

Beispiel für einen Shortcode, der das aktuelle Jahr ausgibt:

function aktuelles_jahr_shortcode() {
    return date('Y');
}
add_shortcode('aktuelles_jahr', 'aktuelles_jahr_shortcode');

Nach diesem Code können Sie einfach [aktuelles_jahr] in Ihren Beiträgen nutzen, und WordPress setzt das aktuelle Jahr ein.

3. Automatische Beitragsbilder für Artikel ohne Featured Image setzen

Falls ein Beitrag kein Beitragsbild hat, können Sie ein Standardbild automatisch einfügen:

function default_featured_image($html, $post_id, $post_thumbnail_id, $size, $attr) {
    if ($html == '') {
        $default_image = get_template_directory_uri() . '/images/default.jpg';
        return '<img src="' . $default_image . '" alt="Standardbild">';
    }
    return $html;
}
add_filter('post_thumbnail_html', 'default_featured_image', 10, 5);

Tipp: Das Standardbild default.jpg muss sich im images-Ordner Ihres Themes befinden.

Alternativen zur functions.php – Eigene Plugins erstellen

Falls Sie eine Funktion nicht nur für ein einzelnes Theme benötigen, ist ein eigenes Plugin besser. So geht’s:

1. Erstellen Sie im Verzeichnis wp-content/plugins/ einen Ordner, z. B. mein-plugin.
2. Erstellen Sie darin eine Datei mein-plugin.php.
3. Fügen Sie den folgenden Code ein:

<?php
/**
 * Plugin Name: Mein WordPress Plugin
 * Description: Beispiel für eine WordPress-Funktion außerhalb der functions.php
 * Version: 1.0
 * Author: Dein Name
 */

function custom_plugin_function() {
    echo "Hallo, dies ist eine benutzerdefinierte Funktion aus meinem Plugin!";
}
add_shortcode('mein_plugin_shortcode', 'custom_plugin_function');
?>

Nach dem Aktivieren des Plugins können Sie [mein_plugin_shortcode] in einem Beitrag nutzen.

Best Practices für die functions.php

• Keine Änderungen direkt über den WordPress-Editor machen! Falls Ihr Code fehlerhaft ist, könnte WordPress unzugänglich werden. Nutzen Sie stattdessen einen sicheren Editor.
• Keine doppelten Funktionsnamen verwenden! Stellen Sie sicher, dass Ihr Code eindeutige Namen hat, um Konflikte zu vermeiden.
• functions.php nicht für alle Änderungen missbrauchen! Falls Sie viele Funktionen einfügen, sollten Sie lieber eigene Plugin-Dateien erstellen.

Nutzen Sie Code-Kommentare, damit Sie später noch wissen, was Ihr Code tut:

// Entfernt die WordPress-Versionsnummer aus dem Quellcode
function remove_wp_version() {
    return '';
}
add_filter('the_generator', 'remove_wp_version');

Nutzen Sie if (!function_exists()), um Konflikte mit anderen Themes oder Plugins zu vermeiden:

if (!function_exists('custom_function')) {
    function custom_function() {
        // Dein Code
    }
}

Fazit

Die functions.php ist eine mächtige Datei, mit der Sie WordPress flexibel anpassen können. Von einfachen Anpassungen über neue Shortcodes bis hin zur Performance-Optimierung gibt es viele sinnvolle Einsatzmöglichkeiten.

Falls Sie Änderungen machen, die langfristig bestehen sollen, ist die Nutzung eines eigenen Plugins empfehlenswert.

Wir haben diesen Blogbeitrag mit KI-Unterstützung erstellt.