Kompletny przewodnik po tworzeniu wtyczek WordPress: Budowanie niestandardowej funkcjonalności od początku do końca

Czemu warto rozwijać dodatki (plugi) do WordPress?

WordPress, jako najpopularniejszy na świecie system do zarządzania treścią, dzięki swej wielkiej rozszerzalności jest w stanie dostosować się do różnych potrzeb użytkowników. Możliwość tworzenia własnych wtyczek (pluginów) daje programistom możliwość dodawania dowolnych funkcji do witryny bez konieczności modyfikacji kodu źródłowego, co gwarantuje bezpieczeństwo aktualizacji oraz niezależność funkcji witryny. Rozwoj wtyczek jest niezwykle cenną umiejętnością – zarówno jeśli chodzi o zaspokojenie specyficznych wymagań biznesowych, optymalizację procesów pracy, jak i o stworzenie nowych produktów w ramach ogromnej ekosystemu WordPress.

W odróżnieniu od przypadków, gdy temat jest modyfikowany bezpośrednio…functions.phpW porównaniu z tradycyjnymi plikami, pluginy pakują logikę funkcji w odrębne moduły. Dzięki temu funkcje dostępne w pluginie działają bez problemu, nawet gdy zmieni się temat witryny. Ponadto dobrze zorganizowany plugin można łatwo przenieść i powtórnie użyć na innych stronach internetowych, co znacząco poprawia efektywność rozwoju aplikacji.

Stwórz swój pierwszy plugin.

Pierwszy krok w rozwoju pluginu to zrozumienie jego najbardziej podstawowej struktury. Wszystkie pluginy do WordPressa są przechowywane w określonym miejscu w systemie./wp-content/plugins/W katalogu każdy plugin posiada swoją własną folderę.

Polecamy lekturę. Przewodnik po rozwoju pluginów dla WordPressa: Stworzenie swojego pierwszego pluginu od zera。

Tworzenie głównego pliku pluginu

Śródkowym elementem tego pluginu jest główny plik w języku PHP. Musisz stworzyć nową folderę, na przykład…my-first-pluginI w tym folderze utwórz plik PHP o tej samej nazwie co folder.my-first-plugin.phpKomentarze umieszczone na początku tego pliku są niezbyt ważne, ale odgrywają kluczową rolę, gdyż udostępniają WordPress metadane o pluginie.

UltaHost – hostingu dla stron WordPress

Gwarancja zwrotu pieniędzy w ciągu 30 dni, nieograniczony przepustowość sieci i dostęp do bazy danych, bezpłatna ochrona przed atakami typu DDoS. Promocja: 50% przy zakupie na 3 lata.

strona dostępu

<?php
/**
 * Plugin Name:       我的第一个插件
 * Plugin URI:        https://example.com/my-first-plugin
 * Description:       这是一个用于学习插件开发的示例插件。
 * Version:           1.0.0
 * Author:            你的名字
 * Author URI:        https://example.com
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 * Domain Path:       /languages
 */

Po zapisaniu tego pliku będziesz mogł go zobaczyć i aktywować na stronie “Dodatki” w panelu administracyjnym WordPressa. Choć na razie nie ma on żadnych funkcji, udało ci się stworzyć legalny framework dla dodatków.

Dodanie podstawowych funkcji do pluginu

Po aktywacji wtyczki możemy zacząć dodawać do niej proste funkcje. Jednym z popularnych przykładów na początek jest dodanie linii tekstu dostosowanego na dole strony internetowej. To można zrealizować za pomocą…wp_footerTę funkcję realizuje „hook akcji” (Action Hook).

W głównym pliku pluginu dodaj następujący kod:

// 在网站页脚输出自定义信息
function my_first_plugin_footer_text() {
    echo '<p style="text-align: center;">Dziękujemy za korzystanie z rozszerzeń, które są wspierane przez moje pierwsze pluginy!</p>';
}
add_action( 'wp_footer', 'my_first_plugin_footer_text' );

W tym miejscu definiujemy jedną funkcję.my_first_plugin_footer_text()A następnie użyjadd_action()Funkcja umożliwia jej montaż (zainstalowanie) w odpowiednim miejscu.wp_footerNa haczu. Gdy WordPress przeprowadza proces generowania części nagłówka strony (“footer”), automatycznie wywołuje naszą funkcję, która wyświetla zaprogramowaną zawartość w formie HTML. To pokazuje podstawowe zasady działania mechanizmu „haków i nawrotów” („hooks and callbacks”) w WordPress.

Polecamy lekturę. Przewodnik po rozwoju pluginów dla WordPress: jak stworzyć swój pierwszy funkcjonalny plugin z niczego。

W głąb tematu: haczyki (hooks) i filtry

Podstawa filozofii rozwoju pluginów dla WordPressu opiera się na zasadach działania “haków” (Hooks). Istnieją dwa typy haków: haków akcji (Action Hooks) i haków filtrów (Filter Hooks). Zrozumienie ich jest kluczowym krokiem na drodze od poznania podstaw do osiągnięcia biegłości w programowaniu na tym platformie.

Zrozumienie hooków akcji

Aktywnie działające „hooki” (ang. action hooks) umożliwiają wstawianie własnego kodu w określonych momencach wykonywania WordPressa. Jak w przykładzie powyżej…wp_footerAkcja ta jest uruchamiana podczas generowania kodu HTML w nagłówku strony (footer). Innym popularnym hookiem do obsługi działań jest…initWykonywa się po zakończeniu podstawowego ładowania WordPressa, ale przed obsługą żadnych żądań (prośb). Najczęściej jest używane do inicjalizacji ustawień wtyczek lub do rejestracji własnych typów artykułów.

// 在初始化时执行一些操作
function my_plugin_init_action() {
    // 例如，在这里可以注册一个自定义文章类型
    // if ( ! post_type_exists( 'book' ) ) { ... }
}
add_action( 'init', '_plugin_init_action' );

Opanowanie hooków filtrów

W odróżnieniu od aktywnych hooków (action hooks), filtry służą do modyfikacji danych. Przyjmują dane wejściowe, umożliwiają ich zmianę i po tym zwracają wynikową wartość. Typowy przykład to…the_contentFiltry umożliwiają modyfikację głównego zawartości artykułów lub stron.

hosting.com Hosting współdzielony

Wysoka wydajność dzięki procesorom AMD EPYC, pamięci masowej NVMe SSD i LiteSpeed, wewnętrzne wsparcie ekspertów 24/7, zaawansowane środki bezpieczeństwa, w tym SSL, brute force, ochrona przed złośliwym oprogramowaniem i DDoS, oszczędność do 73%

strona dostępu

// 在文章内容末尾自动添加一段提示文字
function my_plugin_content_filter( $content ) {
    if ( is_single() ) {
        $extra_text = '<div class="my-plugin-note">Treść tego tekstu została wygenerowana za pomocą mojego pluginu.</div>';
        $content .= $extra_text;
    }
    return $content;
}
add_filter( 'the_content', 'my_plugin_content_filter' );

W tym przykładzie funkcja…my_plugin_content_filter()Przyjmuj oryginał.$contentSprawdź, czy jest to strona jednego artykułu, a potem dodaj do niej kolejny fragment HTML. Na koniec powróć zmieniony tekst. WordPress użyje tego powrotowego wyniku zamiast oryginalnego treści do wyświetlenia.

Stworzenie konfigurowalnych wtyczek

Profesjonalny plugin musi mieć interfejs administracyjny, który umożliwia użytkownikom konfigurację. To wymaga tworzenia stron z ustawieniami w backendzie WordPress, obsługi danych z formularzy oraz bezpiecznego ich zapisu.

Tworzenie menu i stron zarządzania

Użyjadd_menu_page()或add_options_page()Funkcja umożliwia dodanie elementu menu oraz strony konfiguracji dla twojego pluginu w tle aplikacji. To zwykle jest realizowane w ramach procesu rozwoju lub aktualizacji pluginu.admin_menuDziałanie zostało zrealizowane w ramach „hooków akcji” (action hooks).

Polecamy lekturę. Przewodnik po rozwoju pluginów dla WordPress: od zera do mistrzostwa w tworzeniu własnych funkcji。

// 添加插件管理菜单
function my_plugin_add_admin_menu() {
    add_options_page(
        '我的插件设置',          // 页面标题
        '我的插件',             // 菜单标题
        'manage_options',       // 所需权限
        'my-plugin-settings',   // 菜单slug
        'my_plugin_settings_page' // 显示页面的回调函数
    );
}
add_action( 'admin_menu', 'my_plugin_add_admin_menu' );

// 设置页面的HTML内容
function my_plugin_settings_page() {
    ?>
    <div class="wrap">
        <h1>Ustawienia mojej wtyczki.</h1>
        <form method="post" action="/pl/options.php/" data-trp-original-action="options.php">
            <?php
            settings_fields( 'my_plugin_settings_group' );
            do_settings_sections( 'my-plugin-settings' );
            submit_button();
            ?>
        <input type="hidden" name="trp-form-language" value="pl"/></form>
    </div>
    &lt;?php
}

Ustawienia rejestracji, pola oraz zasady bezpieczeństwa

Następnie należy użyć API ustaw WordPress do rejestracji ustawień, pol i obsługi zapisu danych. To zapewnia bezpieczeństwo poprzez weryfikację danych, sprawdzenie upoważnień oraz serializację informacji przechowywanych w bazie.

// 初始化插件设置
function my_plugin_settings_init() {
    // 注册一个新的设置项到“my_plugin_settings_group”
    register_setting( 'my_plugin_settings_group', 'my_plugin_options' );

// 在设置页面添加一个区域
    add_settings_section(
        'my_plugin_section_id',
        '基础配置',
        null,
        'my-plugin-settings'
    );

// 向该区域添加一个字段
    add_settings_field(
        'my_plugin_text_field',
        '提示文本',
        'my_plugin_text_field_render',
        'my-plugin-settings',
        'my_plugin_section_id'
    );
}
add_action( 'admin_init', 'my_plugin_settings_init' );

// 渲染文本框字段
function my_plugin_text_field_render() {
    $options = get_option( 'my_plugin_options' );
    ?>
    <input type='text' name='my_plugin_options[text_field]' value='<?php echo esc_attr( $options['text_field'] ?? '' ); ?>'>
    <p class="description">Tekst wprowadzony tutaj będzie wyświetlony na stronie internetowej.</p>
    &lt;?php
}

W taki sposób dane wprowadzone przez użytkownika w interfejsie frontend są poddawane zabezpieczającym procedurom, w tym m.in. bezpiecznemu formatowaniu (non-cescape) i sprawdzaniu autentyczności, a następnie są zapisywane w postaci arrayu.wp_optionsW tabeli. Kód twojego pluginu można uzyskać poprzez…get_option( ‘my_plugin_options’ )Udostępnij te wartości w bezpieczny sposób.

Hosting współdzielony InterServer

Hosting współdzielony $2.50 USD miesięcznie, pierwszy miesiąc $0.1 USD kod promocyjny tryinterserver, 461 skryptów aplikacji w chmurze, instalacja jednym kliknięciem.

strona dostępu

Dodróżowanie najlepszych praktyk oraz przygotowanie publikacji

Aby stworzyć wysokiej jakości, łatwy w utrzymaniu i bezpieczny plugin, należy stosować określone zasady i najlepsze praktyki programistyczne.

Organizacja kodu i bezpieczeństwo

Nigdy nie wierzyć w dane wprowadzone przez użytkowników. Wszystko, co pochodzi od użytkowników, należy sprawdzić i zweryfikować.$_GET、$_POSTDane pochodzące z bazy danych lub przygotowane do wyświetlenia muszą zostać poddane procesowi escape lub sprawdzenia za pomocą funkcji dostępnych w WordPress.esc_html()、esc_attr()、sanitize_text_field()、wp_kses()i inne. Użyjwp_enqueue_script()和wp_enqueue_style()Aby skutecznie załadować skrypty i style, a także zarządzić zależnościami oraz kontrolą wersji, należy uważnie przygotować kod. W przypadku złożonych pluginów warto zastosować programowanie obiektowe (OOP), aby zorganizować kod i umieścić funkcje w klasach. To zapewni lepszą modułarność i powtarzalność kodu.

Internacjonalizacja i lokalizacja

Aby twoje wtyczki były dostępne dla użytkowników z całego świata, internacionalizacja (ang. i18n) jest konieczna. To oznacza, że musisz przygotować je w taki sposób, aby mogły być używane w różnych językach.__()或_e()Funkcje typu „wait” obejmują wszystkie teksty przeznaczone dla użytkowników. Są definiowane w komentarzach na początku pliku rozszerzenia (pluginu).Text Domain(Na przykład)my-first-pluginMusi być zgodne z tekstem używanym w tym polu tekstowym.

// 错误示例
echo “Settings Saved”;

// 正确示例
echo esc_html__( 'Settings Saved', 'my-first-plugin' );

Następnie możesz użyć narzędzia takiego jak Poedit, aby wybrać te ciągi tekstu i wygenerować z nich odpowiednie wyniki..potPliki szablonów – na ich podstawie można tworzyć treści w różnych językach.zh_CN.poDokumenty do tłumaczenia. Przetłumacz te.moPliki skompilowane znajdują się w katalogu z pluginami./languages/W folderze WordPress automatycznie załaduje tłumaczenia odpowiednie dla języka witryny.

Gotowe do opublikowania w oficjalnym katalogu.

Jeśli planujesz złożyć plik rozszerzenia do oficjalnego katalogu rozszerzeń WordPress.org, musisz upewnić się, że kod spełnia określone wymogi. To obejmuje przygotowanie dokładnego opisu pliku rozszerzenia, zawierającego informacje o jego funkcjach, wymaganiach systemowych oraz instrukcje dotyczące instalacji i konfiguracji.readme.txtPlugin jest opisany w specjalnym formacie, zawierają się w nim screenshotty, instrukcje instalacji, odpowiedzi na często zadawane pytania (FAQ) oraz logi aktualizacji. Plagin jest dostępny pod licencją GPL, a kod jest publikowany w oficjalnym repozytorium Subversion (SVN). Przed opublikowaniem pliku konieczne jest dokładne sprawdzenie jego kompatybilności z różnymi wersjami WordPress, PHP, popularnymi tematami oraz innymi pluginami.

Podsumowanie.

Rozwój pluginów dla WordPress jest procesem stopniowego, który obejmuje od zakończenia prostych funkcji do budowy złożonych aplikacji. Zaczyna się od pliku PHP zawierającego poprawne komentarze w nagłówku, a kluczowym elementem jest biegłe korzystanie z „hooków akcji” (action hooks) i „hooków filtrów” (filter hooks) do interakcji z core’em WordPress. Tworzenie interfejsu administracyjnego w tle za pomocą API Settings API sprawia, że plugin staje się łatwiejszy w obsłudze przez użytkowników. Dodatkowo stosowanie najlepszych praktyk bezpieczeństwa, implementacja funkcji internationalizacji oraz dobrze zorganizowany kod stanowią fundamenty przy tworzeniu profesjonalnych pluginów. Niezależnie od tego, czy chcesz zrealizować wymagania swoich osobistych projektów, czy chcesz przyczynić się do rozwoju społeczności open source, opanowanie tego procesu rozwoju otworzy przed tobą drogę do potężnych możliwości dostosowywania funkcji WordPress.

FAQ – najczęściej zadawane pytania.

Jakie są wymagane przedstawione wiedze, by rozwijać dodatki (plugi)?

Konieczne są podstawowe znajomości programowania w PHP, zrozumienie zasad HTML i CSS, a także ograniczona znajomość funkcji i konceptów stosowanych w WordPress (takich jak artykuły, strony, dodatki). Może być przydatne też zapoznanie się z podstawowymi zasadami działania bazy danych MySQL, chociaż nie jest to wymagane, ponieważ WordPress oferuje wygodne funkcje do zarządzania bazą danych.WP_Query、wpdbKlasa).

W jaki sposób różnią się pliki functions.php w pluginach i tematach?

Umieść kod w sekcji poświęconej tematowi.functions.phpW pliku znajduje się sposób na szybkie dodawanie nowych funkcji, ale te funkcje są powiązane z konkretnym tematem. Gdy zmienisz temat, te funkcje zostaną utracone. Natomiast pluginy są modułami niezależnymi od tematu – działają niezależnie od tego, jaki temat używasz, o ile są aktywne. Dlatego dla funkcji, które planujesz używać w długim terminie lub które potrzebujesz powtórnie wdrożyć na kilku stronach internetowych, lepszym rozwiązaniem jest stworzenie z nich pluginów.

Jak debugować kod mojego pluginu?

WordPress oferuje wiele narzędzi do debugowania. Najpierw możesz…wp-config.phpUwolniono dostęp do pliku.WP_DEBUG„Model, następnie…”define( 'WP_DEBUG', true );To wyświetli na ekranie wszystkie błędy, ostrzeżenia i powiadomienia PHP. Bezpieczniejszym sposobem jest ustawienie tego parametru w taki sposób, aby oba elementy zostały aktywowane jednocześnie.WP_DEBUG_LOG为trueZapisuj błędy do…/wp-content/debug.logW pliku. Ponadto, użyj…error_log()Można skuteczniej monitorować zmienne oraz zapytania do bazy danych, korzystając z funkcji lub profesjonalnych narzędzi do debugowania, takich jak Query Monitor.

Jak moja wtyczka będzie kompatybilna z wyższymi wersjami PHP?

Aby upewnić się, że plugin będzie dobrze funkcjonować w przyszłych wersjach PHP, należy unikać używania funkcji i zasad gramatycznych, które zostały wykreślone lub zastąpione. W środowisku lokalnego rozwoju należy testować plugin w środowisku odpowiadającym celowej wersji PHP (np. PHP 8.x). Konieczne jest też śledzenie oficjalnych ogłoszeń o aktualizacjach WordPress i PHP, a w logach aktualizacji pluginu należy podawać informacje o kompatybilnych wersjach PHP, aby użytkownicy mogli dokonać prawidłowego wyboru środowiska.