Jak napisać wtyczkę do WordPress + przykład

Pisanie wtyczki do WordPressa może wydawać się czymś skomplikowanym, szczególnie jeśli nigdy wcześniej tego nie robiłeś. Ale spokojnie! To prostsze, niż myślisz, zwłaszcza jeśli zaczniemy od podstaw. W tym artykule pokażę Ci krok po kroku, jak stworzyć prostą wtyczkę WordPress – od pomysłu do gotowego kodu. Na koniec będziesz miał gotową wtyczkę, którą możesz zainstalować na swojej stronie.

Co to jest wtyczka WordPress?

Wtyczka to kawałek kodu, który „rozszerza” możliwości WordPressa. Może to być coś tak prostego jak wyświetlanie dodatkowego komunikatu w stopce, albo coś bardziej skomplikowanego, jak system rezerwacji online.

Na potrzeby tego poradnika stworzymy wtyczkę, która dodaje powitalną wiadomość na górze strony głównej Twojej witryny.

Krok 1: Przygotowanie środowiska

Zanim zaczniemy, upewnij się, że masz:

Zainstalowaną stronę WordPress na swoim serwerze lokalnym lub zdalnym.
Edytor kodu, np. Visual Studio Code, Sublime Text lub nawet zwykły Notatnik.
Podstawową znajomość PHP i struktury WordPressa.

Krok 2: Utwórz folder wtyczki

Każda wtyczka w WordPressie musi znajdować się w swoim folderze w katalogu wp-content/plugins.

Otwórz folder WordPressa, przejdź do wp-content/plugins.
Utwórz nowy folder i nazwij go np. moja-pierwsza-wtyczka.

Krok 3: Stwórz plik główny wtyczki

Wewnątrz folderu moja-pierwsza-wtyczka utwórz nowy plik o nazwie moja-pierwsza-wtyczka.php.

To jest główny plik wtyczki, który WordPress „zobaczy”. Otwórz go w edytorze i wklej poniższy kod:

<?php
/*
Plugin Name: Moja Pierwsza Wtyczka
Plugin URI: https://twojastrona.pl
Description: Prosta wtyczka, która dodaje powitalny komunikat na stronie głównej.
Version: 1.0
Author: Twoje Imię
Author URI: https://twojastrona.pl
*/

// Zabezpieczenie przed bezpośrednim dostępem do pliku
if (!defined('ABSPATH')) {
    exit;
}

// Funkcja dodająca powitalny komunikat
function moja_pierwsza_wtyczka_powitanie() {
    if (is_front_page()) {
        echo '<div style="padding: 20px; background: #f0f0f0; text-align: center;">';
        echo '<h2>Witaj na mojej stronie!</h2>';
        echo '</div>';
    }
}

// Hook do akcji wp_head
add_action('wp_head', 'moja_pierwsza_wtyczka_powitanie');

Wyjaśnienie kodu:

Komentarz na początku pliku – To tzw. nagłówek wtyczki. WordPress używa tych informacji, by wyświetlić nazwę i szczegóły wtyczki w panelu admina.
Zabezpieczenie przed bezpośrednim dostępem – Sprawdzamy, czy stała ABSPATH jest zdefiniowana, aby nikt nie uruchomił pliku bezpośrednio.
Funkcja moja_pierwsza_wtyczka_powitanie – To serce wtyczki. Dodaje komunikat, który pojawia się na stronie głównej.
Hook wp_head – Używamy go, by „wstrzyknąć” nasz kod do nagłówka strony.

Krok 4: Aktywacja wtyczki

Zaloguj się do panelu WordPressa.
Przejdź do Wtyczki > Zainstalowane wtyczki.
Znajdź swoją wtyczkę „Moja Pierwsza Wtyczka” i kliknij Aktywuj.

Jeśli wszystko zrobiliśmy poprawnie, na stronie głównej Twojej witryny powinien pojawić się komunikat powitalny.

Krok 5: Ulepszenie wtyczki (opcja dodatkowa)

Chcesz dodać możliwość edycji powitalnej wiadomości z poziomu panelu admina? Możemy do tego użyć opcji WordPressa.

Dodaj ustawienia wtyczki:

Edytuj plik moja-pierwsza-wtyczka.php i dodaj następujący kod:

// Dodaj opcję do panelu admina
function moja_pierwsza_wtyczka_menu() {
    add_options_page(
        'Moja Pierwsza Wtyczka',
        'Moja Wtyczka',
        'manage_options',
        'moja-pierwsza-wtyczka',
        'moja_pierwsza_wtyczka_ustawienia'
    );
}
add_action('admin_menu', 'moja_pierwsza_wtyczka_menu');

// Funkcja wyświetlająca formularz ustawień
function moja_pierwsza_wtyczka_ustawienia() {
    if (isset($_POST['powitanie'])) {
        update_option('moja_wtyczka_powitanie', sanitize_text_field($_POST['powitanie']));
        echo '<div class="updated"><p>Ustawienia zapisane!</p></div>';
    }

    $powitanie = get_option('moja_wtyczka_powitanie', 'Witaj na mojej stronie!');

    echo '<div class="wrap">';
    echo '<h1>Ustawienia Mojej Wtyczki</h1>';
    echo '<form method="post">';
    echo '<label for="powitanie">Powitalny komunikat:</label>';
    echo '<input type="text" name="powitanie" id="powitanie" value="' . esc_attr($powitanie) . '" style="width: 100%;">';
    echo '<br><br>';
    echo '<input type="submit" class="button button-primary" value="Zapisz">';
    echo '</form>';
    echo '</div>';
}

// Wyświetlaj powitanie z ustawień
function moja_pierwsza_wtyczka_powitanie() {
    if (is_front_page()) {
        $powitanie = get_option('moja_wtyczka_powitanie', 'Witaj na mojej stronie!');
        echo '<div style="padding: 20px; background: #f0f0f0; text-align: center;">';
        echo '<h2>' . esc_html($powitanie) . '</h2>';
        echo '</div>';
    }
}

Wyjaśnienie nowego kodu:

add_options_page – Tworzy nową stronę ustawień w menu „Ustawienia” w panelu WordPressa.
Formularz ustawień – Pozwala na edytowanie komunikatu powitalnego.
Funkcja get_option i update_option – Używamy ich, by przechowywać i pobierać ustawienia wtyczki z bazy danych.

Krok 6: Sprawdzenie wtyczki

Przejdź do Ustawienia > Moja Wtyczka w panelu WordPressa. Zmień treść powitania, zapisz ustawienia i sprawdź swoją stronę główną. Powitalny komunikat powinien zostać zaktualizowany.

Podsumowanie

Brawo! Właśnie stworzyłeś swoją pierwszą wtyczkę do WordPressa. Dzięki niej nauczyłeś się, jak:

Tworzyć folder i plik wtyczki.
Pisać kod PHP, który integruje się z WordPressem.
Dodawać funkcje do panelu admina.

Pamiętaj, że to dopiero początek. Możliwości wtyczek WordPressa są niemal nieograniczone. Możesz tworzyć bardziej zaawansowane funkcje, korzystać z API WordPressa czy nawet publikować swoje wtyczki w oficjalnym repozytorium.