Budowanie własnej wtyczki do WordPressa to doskonały sposób na rozszerzenie możliwości strony oraz na zdobycie praktycznych umiejętności programistycznych. W poniższym artykule przedstawiony zostanie kompletny proces tworzenia od przygotowania środowiska, przez strukturę i rejestrację wtyczki, aż po implementację przykładowej funkcjonalności i debugowanie. Każdy etap wprowadzi Cię krok po kroku w zawiłości **PHP**, **hooków**, **API** WordPressa i najlepszych praktyk.
Przygotowanie środowiska deweloperskiego
Wygodne i stabilne środowisko to podstawa efektywnej pracy nad wtyczką. Przed przystąpieniem do kodowania warto zadbać o następujące elementy:
- Serwer lokalny z obsługą PHP i MySQL (XAMPP, MAMP, Laragon).
- Edytor kodu z obsługą podświetlania składni (VS Code, PHPStorm).
- Klient FTP lub dostęp SSH do środowiska testowego.
- System kontroli wersji Git, umożliwiający śledzenie zmian.
- Debugowanie błędów – wtyczka Query Monitor lub WP_DEBUG w pliku wp-config.php.
Instalując WordPress lokalnie, upewnij się, że katalog wp-content/plugins jest dostępny do zapisu. Warto zastosować także kontrolę błędów poprzez WP_DEBUG_LOG, która zapisuje wszystkie ostrzeżenia i błędy w pliku debug.log.
Struktura plików i podstawowa konfiguracja
Wtyczka WordPressa to zestaw plików PHP, CSS, JS oraz ewentualnie plików językowych. Zalecana struktura to:
- folder główny wtyczki (np. my-plugin)
- plik główny my-plugin.php
- podfolder assets (CSS, JS, obrazy)
- podfolder includes (pliki klas, helpery)
- podfolder languages (plik .pot dla tłumaczeń)
my-plugin.php – nagłówek i rejestracja
Pierwszy plik wtyczki musi zawierać komentarz nagłówkowy rozpoznawany przez WordPress:
<?php
/*
Plugin Name: Moja Wtyczka
Description: Dodaje nową funkcjonalność do witryny.
Version: 1.0.0
Author: Twoje Imię
Domain Path: /languages/
Text Domain: my-plugin
*/
Po zamieszczeniu i aktywacji wtyczki w panelu administratora, WordPress załaduje ten plik jako punkt wejścia.
Rejestracja wtyczki i mechanizm działania
Aby wtyczka działała poprawnie, należy zarejestrować najważniejsze elementy: akcje, filtry i zasoby (skrypty, style).
Dodawanie akcji i filtrów
Hooki umożliwiają podpinanie własnych funkcji:
add_action(’init’, 'my_plugin_register_post_type’);
add_filter(’the_content’, 'my_plugin_modify_content’);
- init – rejestracja typów wpisów, taksonomii.
- wp_enqueue_scripts – deklarowanie stylów i skryptów.
- admin_menu – dodawanie stron w panelu administratora.
Ładowanie zasobów (CSS/JS)
W folderze assets utwórz pliki style.css i script.js, następnie w funkcji:
function my_plugin_enqueue_assets() {
wp_enqueue_style(’my-plugin-style’, plugins_url(’assets/style.css’, __FILE__));
wp_enqueue_script(’my-plugin-script’, plugins_url(’assets/script.js’, __FILE__), array(’jquery’), false, true);
}
add_action(’wp_enqueue_scripts’, 'my_plugin_enqueue_assets’);
Dzięki temu zasoby załadują się tylko na front-endzie. W przypadku panelu administratora użyj hooka admin_enqueue_scripts.
Tworzenie funkcjonalności: przykładowy moduł
Jako przykład rozbudujmy wtyczkę o możliwość wyświetlania karuzeli najnowszych postów. Wykorzystamy do tego JavaScript oraz krótki kod (shortcode).
1. Rejestracja shortcode
W pliku includes/shortcodes.php dodaj funkcję:
function my_plugin_posts_carousel() {
$args = array(’posts_per_page’ => 5);
$posts = get_posts($args);
$output = ’
foreach($posts as $post) {
setup_postdata($post);
$output .= ’
’;
}
wp_reset_postdata();
$output .= ’
’;
return $output;
}
add_shortcode(’posts_carousel’, 'my_plugin_posts_carousel’);
2. Stylizacja karuzeli
W assets/style.css:
.my-carousel {
display: flex;
overflow: hidden;
}
.slide {
min-width: 200px;
margin-right: 20px;
}
3. Inicjalizacja JavaScript
W assets/script.js:
jQuery(document).ready(function($){
$(’.my-carousel’).slick({
infinite: true,
slidesToShow: 3,
slidesToScroll: 1
});
});
Pamiętaj, aby dołączyć bibliotekę Slick lub inną karuzelę w dependencies w enqueue.
Testowanie i debugowanie
Po implementacji funkcjonalności warto przeprowadzić dokładne testy, aby upewnić się, że wtyczka działa w różnych konfiguracjach:
- Sprawdź kompatybilność z różnymi motywami (szablonów), zwłaszcza przy nadrukowywaniu styli.
- Testuj na różnych wersjach PHP (7.x, 8.x) i WordPressa.
- Użyj narzędzi takich jak Xdebug do śledzenia błędów i profilowania.
- Weryfikuj wydajność zapytań SQL – Query Monitor ujawni ewentualne problemy z bazą.
- Sprawdź działanie przez wyłączenie innych wtyczek, aby znaleźć konflikty.
Dzięki systematycznemu testowaniu i optymalizacji możesz dostarczyć stabilne i bezpieczne rozwiązanie. Pamiętaj o aktualizacji numeru wersji oraz przygotowaniu pliku .pot w celu późniejszego tłumaczenia.
