Od zera: Pełny przewodnik i praktyczne poradzenie dotyczące rozwoju pluginów dla WordPress

Czemu warto uczyć się programowania wtyczek dla WordPressa?

WordPress, jako najpopularniejszy na świecie system do zarządzania treścią, charakteryzuje się wielką rozszerzalnością, która jest w dużej mierze zależna od ekosystemu dostępnych wtyczek. Uczenie się tworzenia wtyczek do WordPress pozwala nie tylko dostosować funkcje witryny według indywidualnych potrzeb biznesowych, ale także przekształcić swoje kreatywne pomysły w sprzedawane produkty na rynku o ogromnym potencjale. W porównaniu z użyciem wtyczek dostępnych od innych dostawców, samodzielne ich tworzenie gwarantuje bardziej wydajny kod, wyższy poziom bezpieczeństwa oraz lepszą optymalizację wydajności, ponieważ masz pełną kontrolę nad każdym elementem funkcjonalności witryny.

Ponadto posiadanie tej umiejętności znacząco zwiększa wartość osoby pracującej jako developer. Bez względu na to, czy tworzy się rozwiązania dostosowane do potrzeb klientów, czy rozwija się własne narzędzia, znajomość podstawowej architektury WordPressa oraz standardów rozwoju wtyczek stanowi kluczową przewagę. Dzięki temu przechodzi się z roli prostego użytkownika do roli twórcy, który potrafi zrozumieć i skorzystać z możliwości, które oferuje WordPress.hookAby stworzyć wytrzymałe aplikacje, należy korzystać z systemów, metod operacji nad danymi oraz mechanizmów bezpieczeństwa.

Ustawienie środowiska do rozwoju dodatków (plug-inów) i budowa ich podstawowej struktury

Przed rozpoczęciem pisania kodu niezbędne jest posiadanie profesjonalnego środowiska do lokalnego rozwoju. Rekomendujemy użyć narzędzi takich jak Local, DevKinsta lub Docker, aby szybko przygotować środowisko zawierające PHP, MySQL oraz serwer web. Upewnij się, że twoja wersja PHP (zaleca się wersja 7.4 lub wyższa) jest kompatybilna z wybraną wersją WordPress, a także włącz funkcję raportowania błędów – to ułatwi debugowanie.

Polecamy lekturę. Jak zacząć od zera: stworzenie swojego pierwszego plugina dla WordPressa。

Najprostszą strukturą pluginu dla WordPressu stanowi jedna główna plik. Ta plik musi zawierać określone komentarze na początku, aby WordPress mógł ją rozpoznać.

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

Stworz swoj pierwszy plik z rozszerzeniem (plugin).

Główny plik pluginu zwykle nosi nazwę tego samego pluginu, na przykład: my-first-plugin.phpMusisz umieścić ten plik w następującym miejscu: /wp-content/plugins/ W osobnym folderze znajdującym się w katalogu. Poniżej przedstawiona jest najprostszawa struktura kodu tego pliku:

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

Po zapisaniu pliku będziesz mógł go zobaczyć na stronie “Dodatki” w panelu administracyjnym WordPress i aktywować. Choć na razie nie ma żadnych funkcji, udało ci się stworzyć dodatek, który jest rozpoznawany przez WordPress.

Zrozumienie i wykorzystanie kluczowych mechanizmów WordPressa: hooków

Podstawa filozofii rozwoju pluginów dla WordPress jest “hooki” (ang. Hooks), które umożliwiają włączenie Twojego kodu do standardowego procesu wykonywania funkcji w WordPress w określonych momencach, bez konieczności modyfikacji źródłowych plików platformy. Hooki są głównie podzielone na dwa typy: akcje (Actions) i filtry (Filters).

Wykonuj zadań za pomocą aktywnych hooków.

Aktywnie działające „haki” (ang. action hooks) umożliwiają wykonywanie własnych funkcji w momencie wystąpienia określonych zdarzeń. Na przykład, po opublikowaniu artykułu możesz chcieć wysłać wiadomość e-mail, by o tym powiadomić kogoś.publish_post To typowy „hook” akcyjny (action hook). Możesz go użyć w swoim kodzie, aby zrealizować określone działanie w momencie wykonywania danej akcji. add_action() Funkcja przypisuje twoją własną funkcję do tego „haka” (hooka).

Polecamy lekturę. Głębokie rozumienie: Podstawowa architektura WordPressa i praktyczny przewodnik po tworzeniu nowych tematów。

Modyfikacja danych za pomocą hooków filtrów

Filtry hooki umożliwiają modyfikację danych przekazywanych przez WordPress w trakcie procesu obróbki. Na przykład, możesz chcieć zmienić treść nagłówka artykułu.the_title To jest hook filtru. Możesz go używać do realizacji określonych zadań w ramach procesu filtracji danych. add_filter() Funkcja służy do przypisania twojej funkcji obsługującej dane wejściowe; ta funkcja przyjmuje dane w oryginalnym formacie i musi zwrócić dane po zmianach.

Poniżej jest przykład wykorzystania zarówno działań (actions), jak i filtrów:

// 1. 定义一个在文章发布时执行的动作函数
function myplugin_on_post_publish( $post_id ) {
    // 获取文章对象
    $post = get_post( $post_id );
    // 记录日志或执行其他操作
    error_log( "文章《{$post->post_title}》已发布，ID: {$post_id}" );
}
// 将上述函数挂接到 ‘publish_post’ 动作钩子
add_action( 'publish_post', 'myplugin_on_post_publish' );

// 2. 定义一个修改文章标题末尾内容的过滤器函数
function myplugin_add_to_title( $title ) {
    // 仅在主循环的文章标题中生效
    if ( is_single() && in_the_loop() ) {
        return $title . ' - [推荐阅读]';
    }
    return $title;
}
// 将上述函数挂接到 ‘the_title’ 过滤器钩子
add_filter( 'the_title', 'myplugin_add_to_title' );

Praktyka: Tworzenie własnego pluginu z witryną administracyjną

Praktyczny plugin zwykle wymaga dostępnej strony konfiguracji w panelu administracyjnym WordPressa. Stworzymy przykład takiego pluginu, który dodaje podmenu do menu “Ustawienia” w panelu administracyjnym i umożliwia zapisywanie oraz odczytywanie określonych ustawień.

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

Tworzenie menu i stron zarządzania w tle (w środowisku backend)

Najpierw musimy użyć… add_action('admin_menu', ...) Hakowanie umożliwia zarejestrowanie naszych własnych elementów menu podczas inicjalizacji menu administracyjnego. Korzystamy z tego mechanizmu, aby… add_options_page() Funkcja służy do dodania podstrony w menu “Ustawienia”.

Obsługa danych z formularzy oraz sprawdzenie ich bezpieczeństwa

Na stronie zarządzania zwykle znajduje się formularz, który umożliwia użytkownikowi dokonanie ustawień. Podczas obsługi wysyłania formularza konieczne jest przeprowadzenie procedur bezpieczeństwa, w tym sprawdzenie upoważnień użytkownika, użycie tokenów typu nonce w celu zapobiegania falsyfikacji żądań między witrynami (CSRF – Cross-Site Request Forgery), a także oczyszczenie i sprawdzenie wprowadzonych danych.

Poniżej znajduje się przykład kodu, który umożliwia realizację tej funkcji:

Polecamy lekturę. Tutorial dotyczący tworzenia wtyczek WordPress: od zera do stworzenia swojej pierwszej wtyczki.。

// 钩入 admin_menu 来添加菜单
function myplugin_add_admin_menu() {
    add_options_page(
        '我的插件设置',          // 页面标题
        '我的插件',             // 菜单标题
        'manage_options',       // 所需权限（管理员）
        'myplugin-settings',    // 菜单 slug
        'myplugin_render_settings_page' // 渲染页面的回调函数
    );
}
add_action( 'admin_menu', 'myplugin_add_admin_menu' );

// 渲染设置页面的回调函数
function myplugin_render_settings_page() {
    // 检查用户权限
    if ( !current_user_can( 'manage_options' ) ) {
        wp_die( '权限不足。' );
    }
    ?>
    <div class="wrap">
        <h1>Ustawienia mojej wtyczki.</h1>
        <form method="post" action="/pl/options.php/" data-trp-original-action="options.php">
            <?php
            // 输出必要的设置字段和 nonce 字段
            settings_fields( 'myplugin_settings_group' );
            do_settings_sections( 'myplugin-settings' );
            submit_button();
            ?>
        <input type="hidden" name="trp-form-language" value="pl"/></form>
    </div>
    &lt;?php
}

// 初始化插件设置，注册配置项
function myplugin_settings_init() {
    // 注册一个新的设置组‘myplugin_settings_group’和页面‘myplugin-settings’
    register_setting( &#039;myplugin_settings_group&#039;, &#039;myplugin_custom_message&#039; );

// 在页面‘myplugin-settings’上添加一个新的设置区域
    add_settings_section(
        &#039;myplugin_section&#039;,
        &#039;自定义消息设置&#039;,
        null,
        &#039;myplugin-settings&#039;
    );

// 向该区域添加一个字段
    add_settings_field(
        &#039;myplugin_field&#039;,
        &#039;欢迎消息&#039;,
        &#039;myplugin_field_render&#039;,
        &#039;myplugin-settings&#039;,
        &#039;myplugin_section&#039;
    );
}
add_action( &#039;admin_init&#039;, &#039;myplugin_settings_init&#039; );

// 渲染设置字段的函数
function myplugin_field_render() {
    $option = get_option( &#039;myplugin_custom_message&#039;, &#039;你好，访客！&#039; );
    echo &quot;<input type='text' name='myplugin_custom_message' value='" . esc_attr( $option ) . "' />";
}

// 在前端使用保存的选项
function myplugin_display_message() {
    $message = get_option( 'myplugin_custom_message', '你好，访客！' );
    echo '<p class="myplugin-message">'`.esc_html($message)`.'</p>';
}
// 你可以将此函数通过短码或钩子在前端调用，例如：
add_action( 'wp_footer', 'myplugin_display_message' );

Bezpieczeństwo pluginów, ich internationalizacja oraz przygotowanie do publikacji

Dodatek, po ukończeniu jego rozwoju, musi przejść przez surowe procedury sprawdzania bezpieczeństwa, dostosowania do różnych języków (internacjonalizacji) oraz pakowania, zanim zostanie udostępniony użytkownikom.

Bezpieczeństwo jest najważniejszym aspektem. Wszkie dane pochodzące z wpisów użytkowników (np. $_GET, $_POST, $_REQUEST) muszą zostać sprawdzone i oczyszczone. WordPress oferuje wiele funkcji, które pomagają w tym procesie. sanitize_text_field(), esc_html(), esc_url() 和 wp_strip_all_tags() Wykorzystuje się do escapeowania danych przed ich wyświetleniem. Nigdy nie wierzyć w dane wprowadzone przez użytkownika.

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

Aby plugin był dostępny dla użytkowników z całego świata, konieczne jest przygotowanie go do obsługi różnych języków (tzw. internacionalizacja, ang. internationalization lub i18n). To oznacza, że wszystkie tekstowe wyrazy wyświetlające się w pluginie muszą zostać przekładzone na odpowiednie języki. __() 或 _e() Funkcje takie jak tłumaczenie tekstów powinny zostać „zapakowane” (zawierone w odpowiedniej strukturze) i ustawione odpowiednio, w szczególności należy określić domenę tekstową (Text Domain). Dzięki temu tłumacze będą mogli używać plików w formatach .po/.mo do tłumaczenia twojego pluginu.

Na koniec należy uważnie przygotować plik readme.txt, którego format musi spełniać wymogi WordPress.org. Upewnij się, że kod twojego pluginu jest zgodny z standardami kodowania WordPress, usunij wszystkie elementy kodu służące do debugowania i skompresuj plik w formacie zip. Możesz zdecydować się o publikacji pluginu w oficjalnym katalogu pluginów WordPress lub o jego rozdawaniu na swoim osobistym blogu / stronie internetowej.

Podsumowanie.

Rozwoj pluginów dla WordPress jest procesem łączenia kreatywności z potężną platformą. Zaczęliśmy od zrozumienia ich znaczenia, po czym stopniowo przygotowaliśmy środowisko do pracy i stworzyliśmy podstawowe pliki potrzebne do budowy pluginów. Poprzez dogłębne studium i praktykę dwóch kluczowych mechanizmów – akcji (actions) i filtrów (filters) – opanowaliśmy sposoby interakcji z WordPress. Następnie, w praktyce, stworzyliśmy kompletny plugin z możliwością zarządzania w tle, obejmujący cały proces dodawania menu, ustawiania rejestracji użytkowników, bezpiecznego obsługi danych oraz prezentacji na stronie frontowej. Na koniec rozpatrziliśmy kluczowe aspekty, które wpływają na jakość i łatwość rozpowszechniania pluginów: zasady bezpieczeństwa, przygotowanie do internationalizacji oraz pakowanie pluginu do publikacji. Dodróżując tych kroków i stosując najlepsze praktyki, będziesz w stanie tworzyć profesjonalne pluginy dla WordPress, które są funkcjonalne, bezpieczne, niezawodne i łatwe w dystrybucji, a tym samym w pełni wykorzystać potencjal tej platformy.

FAQ – najczęściej zadawane pytania.

Jakie są wymagane przedstawione wiedze, by rozwijać dodatki do WordPress?

Konieczne jest posiadanie podstawowych znajomości języka programowania PHP, ponieważ serce WordPressa oraz jego pluginy są napisane w tym języku. Ponadto istotne jest znać HTML, CSS i JavaScript, które są używane do tworzenia interfejsów użytkownika i zarządzania interakcją z użytkownikiem. Wiedza o podstawach baz danych MySQL (takich jak wykonywanie zapytań, dodawanie, edytowanie i wyświetlanie danych) również będzie przydatna, ponieważ WordPress wykorzystuje tę bazę do przechowywania informacji.

Czy plik główny pluginu musi mieć określone nazwę?

Nie, plik główny pluginu może mieć dowolną nazwę, ale ze względu na jasność i standardy zaleca się używanie nazwy w języku angielskim lub w formie pinyin, która odzwiernia nazwę pluginu. Jedyym wymogiem jest to, aby ten plik PHP zawierał poprawne informacje o nagłówku pluginu (header comments). WordPress identyfikuje i ładowa pluginy właśnie na podstawie tych komentarzy.

Jaka jest istotna różnica między aktywnymi hookami (action hooks) a filtrowymi hookami (filter hooks)?

Hooki akcyjne są używane do wykonywania określonego fragmentu kodu w momencie wystąpienia określonego wydarzenia; nie wymagają żadnego wyniku z powrotu funkcji, ich celem jest wykonywanie jakiegoś zadania lub operacji. Hooki filtracyjne są przeznaczone do modyfikacji danych; wymagają, aby funkcja przyjęła dane wejściowe i muszą zwrócić zmodyfikowane dane wejściowe. Prostymi słowami: akcja polega na “wykonaniu czegoś”, a filtracja polega na “zmianie czegoś”.

Jak zapewnić, że mój plugin nie będzie konfliktować z innymi pluginami?

Dodawanie unikalnego prefiksu do nazw wszystkich funkcji, klas, stałych (constantów) oraz opcji jest najlepszą praktyką, aby uniknąć konfliktów. Na przykład, nie należy używać…get_data()Takie ogólne nazwy funkcji należy zastąpić bardziej specyficznymi i jasno określonymi.myplugin_get_data()Dodatkowo, pakowanie kodu w klasy lub przestrzenie nazw umożliwia skuteczniejsze oddzielenie zmiennych i funkcji.