Poznaj w pełni rozwój wtyczek WordPress: twórz niestandardowe funkcje od podstaw.

Czemu warto rozwijać dodatki (plugi) do WordPress?

WordPress, jako najpopularniejszy na świecie system do zarządzania treścią, dzięki swojej wielkiej rozszerzalności jest w stanie dostosować się do potrzeb użytkowników. Możliwość tworzenia własnych pluginów daje programistom możliwość wykraczać poza ograniczenia dostępnych tematów i dodawać do witryny wszystkie niezbędne funkcje, bez konieczności modyfikacji core’owych plików. To gwarantuje niezależność i łatwość konserwacji tych funkcji, a także ułatwia ich przenoszenie i powtórną używalność na innych stronach internetowych.

Dobrze zaprojektowany plugin musi być kompatybilny z aktualizacjami core’a WordPressa oraz stosować jego standardy kodowania i zalecenia dotyczące najlepszych praktyk programistycznych. To nie tylko poprawia bezpieczeństwo witryny, ale także stanowi solidną podstawę dla dalszych rozwojów i dodawania nowych funkcji. Bez znajomości technik programowania pluginów rozwójakom WordPressa nie uda się postępować na kolejnym poziomie – niezależnie od tego, czy chodzi o zaspokojenie specyficznych wymagań biznesowych, rozwiązanie problemów, z którymi nie mogą sobie poradzić dostępne pluginy, czy o publikację produktu komercyjnego.

Stworzenie twojego pierwszego pluginu: podstawa struktury

Aby stworzyć plugin dla WordPress, należy najpierw zrozumieć jego podstawową strukturę. Każdy plugin musi mieć co najmniej jedno główne plik, które zwykle nosi nazwę pluginu. my-first-plugin.phpKomentarze umieszczone na początku pliku, zawierające informacje o pluginie, są niezbędne, ponieważ udostępniają systemowi WordPress podstawowe dane o tym pluginie.

Polecamy lekturę. Naucz się tworzyć wtyczki do WordPressa: stwórz swój pierwszy niestandardowy moduł funkcjonalny od podstaw.。

Tworzenie głównego pliku pluginu

Główny plik pluginu stanowi punkt wejścia do samego pluginu. Należy dodać do jego nagłówka standardowy blok komentarzy zawierający informacje o pluginie. Poniżej znajduje się przykład najprostszego kodu:

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:       这是一个用于学习WordPress插件开发的示例插件。
 * Version:           1.0.0
 * Author:            你的名字
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 */

Zapisz ten kod w plik z rozszerzeniem `.php` i umieść go w odpowiedniej lokalizacji na serwerze. /wp-content/plugins/ Nowy folder w katalogu (na przykład…) my-first-pluginNastępnie możesz go zobaczyć i aktywować na stronie “Dodatki” w panelu administracyjnym WordPress. Choć w tym momencie dodatek nie posiada żadnych funkcji, to jest już legalnym dodatkiem, który jest rozpoznawany przez WordPress.

Zrozumienie struktury katalogu z dodatkami (plug-inów)

Wraz z rozszerzaniem funkcji dodatków (pluginów) istotna staje się rozsądna struktura katalogów, która pomaga w organizacji kodu. Typowy katalog dodatku może zawierać następujące części:
– Plik głównego pluginu (np.) my-first-plugin.phpZnajduje się w katalogu głównym pluginu i zawiera informacje o jego strukturze (header).
- includes/ Katalog: zawiera pliki z klasyfikacją funkcji i metod realizujących kluczowe funkcje programu.
- admin/ Katalog: zawiera kod dotyczący interfejsu administracyjnego w tle (back-end).
- public/ Katalog: zawiera kod dotyczący logiki front-end.
- assets/ Katalog: zawiera pliki z definicjami stylów w formacie CSS, skrypty w języku JavaScript, zdjęcia oraz inne materiały pomocnicze.
- languages/ Katalog: zawiera pliki z tłumaczeń międzynarodowych (.po/.mo).

Taka modułarna struktura sprawia, że kod jest bardziej zrozumiały, co ułatwia współpracę i konserwację pomiędzy członkami zespołu.

Podstawowe koncepty rozwoju oprogramowania: haczyki (hooks) i filtry (filters)

Podstawa filozofii rozwoju pluginów dla WordPress jest związana z “hakami” (Hooks). Haków umożliwiają wstawianie własnego kodu w określone momenty lub w określonych miejscach, aby zmienić lub rozszerzyć standardowe zachowanie WordPress. Haków można podzielić na dwa głównego typy: haków akcji (Action Hooks) i haków filtrów (Filter Hooks).

Polecamy lekturę. Od podstaw do zaawansowanych umiejętności w tworzeniu wtyczek WordPress: praktyczny przewodnik po tworzeniu niestandardowych funkcji.。

Użyj haczyków akcji (action hooks) do wykonywania własnego kodu.

Aktywnie działające “haki” (ang. action hooks) umożliwiają wykonywanie określonych działań w określonych momencach procesu obsługi WordPressa – na przykład wysyłanie powiadomień po opublikowaniu artykułu lub dodawanie kodu do nagłówka strony. add_action() Funkcja umożliwia przypisanie Twojej własnej funkcji do jakiegoś „hooka” (elementu sterującego w ramach procesu wykonywania programu).

Na przykład, utworzymy funkcję, która wyświetla informacje dostosowane w nagłówku strony internetowej. Najpierw musisz określić funkcję typu „callback”, a potem… add_action() Przypnij to do… wp_footer Ten haczyk.

// 定义一个回调函数
function myplugin_add_footer_text() {
    echo '<p style="text-align:center;">Dziękujemy za korzystanie z tego dodatku!</p>';
}
// 将函数挂载到 `wp_footer` 动作钩子
add_action( 'wp_footer', 'myplugin_add_footer_text' );

Gdy WordPress przeprowadza obróbkę treści na stronie, dołącza automatycznie część nagłówka (header) i nagłówka strony (footer). myplugin_add_footer_text() Funkcja ma za zadanie wyświetlić tekst, który określiliśmy.

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

Modyfikacja danych za pomocą hooków filtrów

Filtry hooki umożliwiają modyfikację danych przed ich użyciem lub zapisem. Na przykład można zmienić nagłówek artykułu lub przefiltrować treść komentarzy. add_filter() Funkcja umożliwia przypisanie Twojej własnej funkcji do jakiegoś „hooka” filtrów.

Przyjmiemy, że chcemy automatycznie dodawać znak marki na końcu wszystkich nagłówków artykułów. Możemy przypisać tę funkcję do odpowiedniego elementu interfejsu użytkownika. the_title Filtry.

// 定义一个回调函数，它接收原始标题作为参数
function myplugin_add_trademark_to_title( $title ) {
    // 仅在前端文章列表和单篇文章页面修改，避免影响后台
    if ( ! is_admin() ) {
        $title .= ' ™';
    }
    // 必须返回修改后的值
    return $title;
}
// 将函数挂载到 `the_title` 过滤器钩子
add_filter( 'the_title', 'myplugin_add_trademark_to_title' );

W tym przykładzie…$title Parametrem jest oryginalny tekst nagłówka, a funkcja po jego modyfikacji musi zwrócić nową wartość. To kluczowa różnica pomiędzy filtrami a działaniami: filtry muszą zawsze zwrócić jakiś wynik.

Polecamy lekturę. Przewodnik po rozwoju pluginów dla WordPress: stworzenie twojego pierwszego modułu funkcjonalnego od zera。

Dodać stronę zarządzania i opcje konfiguracji dla pluginu.

Dobrze zaprojektowany plugin musi umożliwić konfigurację w panelu administracyjnym WordPress. Można to osiągnąć poprzez dodanie menu administracyjnego na najwyższym poziomie lub dodatkowego menu konfiguracyjnego. WordPress oferuje bogatą API, które umożliwia tworzenie takich stron.

Utworzenie opcji menu dla ustawień wtyczki

Użyj add_menu_page() 或 add_submenu_page() Funkcje umożliwiają dodanie menu w tle do twojego pluginu. Zwykle proste pluginy dodają swoje strony ustawień do głównego menu “Ustawienia” jako podmenu.

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

Poniższy kod pokazuje, jak dodać stronę z podmenuem oraz jak definiować funkcję obsługującą jej wyświetlanie.

// 在后台“设置”菜单下添加子菜单
function myplugin_add_settings_page() {
    add_options_page(
        '我的插件设置', // 页面标题
        '我的插件',     // 菜单标题
        'manage_options', // 权限要求（只有管理员可访问）
        'myplugin-settings', // 菜单slug
        'myplugin_render_settings_page' // 用于显示页面内容的回调函数
    );
}
// 使用 `admin_menu` 动作钩子在后台菜单初始化时执行上述函数
add_action( 'admin_menu', 'myplugin_add_settings_page' );

// 定义渲染设置页面的回调函数
function myplugin_render_settings_page() {
    ?>
    <div class="wrap">
        <h1>Ustawienia mojej wtyczki.</h1>
        <form action="/pl/options.php/" method="post" data-trp-original-action="options.php">
            <?php
            // 输出设置字段、非ce等安全信息
            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
}

Użyj API do konfiguracji opcji rejestracji.

Ręczne obsługiwanie procesów wysyłania i weryfikacji formularzy jest uciążliwe i niebezpieczne. API do konfiguracji w WordPress (Settings API) oferuje nam standardowy, bezpieczny sposób na tworzenie, weryfikację oraz zapisywanie ustawień.

Musisz użyć register_setting(), add_settings_section() 和 add_settings_field() Możesz używać takich funkcji, jak `define`, aby określić swoje ustawienia.

// 在插件初始化时注册设置
function myplugin_register_settings() {
    // 1. 注册一个设置组及其数据
    register_setting(
        'myplugin_settings_group', // 设置组名称，需与 settings_fields() 参数一致
        'myplugin_option_name' // 存储在数据库中的选项名
    );

// 2. 添加一个设置区域（Section）
    add_settings_section(
        'myplugin_section_main', // Section ID
        '主要设置', // 标题
        null, // 可选的描述回调函数
        'myplugin-settings' // 所属的页面slug
    );

// 3. 向该区域添加一个设置字段
    add_settings_field(
        'myplugin_field_text', // 字段ID
        '示例文本输入', // 字段标签
        'myplugin_render_text_field', // 渲染字段HTML的回调函数
        'myplugin-settings', // 页面slug
        'myplugin_section_main' // Section ID
    );
}
add_action( 'admin_init', 'myplugin_register_settings' );

// 渲染文本输入字段的回调函数
function myplugin_render_text_field() {
    $option = get_option( 'myplugin_option_name' );
    $value = isset( $option['text'] ) ? $option['text'] : '';
    echo '<input type="text" name="myplugin_option_name[text]" value="' . esc_attr( $value ) . '" />';
}

Poprzez ustawienie API można kontrolować proces wysyłania formularzy oraz ich weryfikacji (można określić zasady, które muszą zostać spełnione, aby formularz został przyjęty). register_setting Definicja funkcji sprawdzających oraz proces zapisywania danych są automatycznie obsługiwane przez core WordPress, co znacząco poprawia bezpieczeństwo i efektywność rozwoju aplikacji.

Podsumowanie.

Rozwoj pluginów dla WordPress polega na przekształceniu kreatywnych idei w funkcjonalne rozwiązania, a kluczowym elementem tego procesu jest zrozumienie i skuteczne wykorzystanie systemu hooków. Po początku tworzisz prosty plik pluginu, a potem poznajesz, jak za pomocą hooków akcji dodawać nowe funkcje oraz hooków filtrów modyfikować dane. Na końcu budujesz profesjonalne pluginy, które są łatwe w obsłudze i konfiguracji, korzystając z odpowiednich interfejsów i API. Dodawanie standardów kodowania WordPress, modularizacja kodu oraz dbałość o bezpieczeństwo to kluczowe elementy przy tworzeniu wysokiej jakości pluginów. Poprzez stosowanie powyżej opisanych kroków będziesz mogąc stworzyć skuteczne i stabilne rozszerzenia dla każdej witryny internetowej zbudowanej na platformie WordPress.

FAQ – najczęściej zadawane pytania.

Jakie są podstawowe wymagania, by rozwijać dodatki (plugi) do WordPress?

Konieczne jest posiadanie podstawowych znajomości języka programowania PHP, ponieważ większość pluginów jest pisana w tym języku. Podobnie istotne jest znać HTML, CSS i JavaScript – są one kluczowe do tworzenia interfejsów użytkownika i realizacji interakcji na stronie internetowej. Równie ważne jest zrozumienie podstawowych zasad działania bazy danych MySQL (chociaż WordPress oferuje wygodne narzędzia do zarządzania bazą danych) oraz zasad budowy samego WordPress (np. struktury plików tematycznych, zasad pracy pętli itd.).

Jak debugować moje dodatko do WordPress?

Najpierw upewnij się, że na wp-config.php Uwolniono dostęp do pliku. WP_DEBUG 和 WP_DEBUG_LOGTo umożliwi zapisywanie błędów i ostrzeżeń PHP do odpowiedniego pliku. /wp-content/debug.log Materiał znajduje się w pliku, a nie jest wyświetlany na stronie, co zapobiega negatywnemu wpływowi na doświadczenie użytkownika. Ponadto można użyć… error_log() Funkcja wyświetla informacje diagnostyczne w logach. W przypadku złożonej logiki najskuteczniejszym sposobem na debugowanie jest używanie funkcji rozstawiania punktów przerwania w środowisku rozwoju (IDE), np. Xdebug.

Jak moje dodatkowe narzędzie (plugin) będzie kompatybilne z różnymi wersjami WordPress?

Podczas rozwoju należy unikać używania funkcji, które zostały wykreślone z oficjalnej dokumentacji WordPress, a także sprawdzić, w jakiej wersji WordPress zostały wprowadzone. Możesz to zrobić w pliku głównym swojego pluginu. @requires at least 或 @requires PHP Uwzględź wymagania minimalne w komentarzach umieszczonech na początku pliku z pluginem. W samym kodzie można je zrealizować według tych wymagań. function_exists() 或 class_exists() Sprawdź, czy dana funkcja lub klasa jest dostępna, aby zaproponować alternatywę zgodną z zasadami zgodności z wcześniejszymi wersjami oprogramowania („backward compatibility”).

Jak złożyć moje dodatkowe narzędzie (plugin) do oficjalnego katalogu dodatków?

Najpierw musisz upewnić się, że twój plugin w pełni spełnia wymogi oficjalnych przewodników dla rozwoju pluginów oraz standardów kodowania. Następnie zgłoś chęć utworzenia repozytorium typu SVN na stronie WordPress.org. Zatim przekaż kod swojego pluginu (wraz z dokumentacją w formie pliku README.txt oraz głównym plikiem pluginu, który musi spełniać określone wymogi) do tego repozytorium. /trunk Spis treści. Po złożeniu pliku do recenzji, zespół oficjalnych autorów przeprowadzi go sprawdzenie. Jeśli recenzja zostanie przyznana pozytywną, twoje dodatkowe narzędzie (plugin) pojawi się w oficjalnym spisie dostępnych narzędzi, gdzie będzie dostępne do pobrania i instalacji przez użytkowników z całego świata.