Pełny przewodnik po tworzeniu pluginów dla WordPressa: jak stworzyć swój pierwszy plugin od zera

Przygotowanie środowiska do rozwoju wtyczek dla WordPress

Przed rozpoczęciem pisania kodu istotne jest stworzenie stabilnego i wydajnego lokalnego środowiska rozwoju. To nie tylko umożliwi bezpieczne testowanie, ale także odwzorowanie rzeczywistych konfiguracji serwerów. Jeśli chodzi o rozwój wtyczek dla WordPress, mocno zalecamy używanie programów do obsługi lokalnych serwerów, takich jak XAMPP, MAMP lub Local by Flywheel. Te programy umożliwiają łatwe uruchomienie na twoim komputerze środowiska zawierającego Apache, PHP i MySQL.

Następnie potrzebny będzie edytor kodu. Visual Studio Code, PhpStorm lub Sublime Text to doskonałe wybory – oferują wyróżnianie syntaxu, sugestie kodu oraz funkcje debugowania, co znacząco poprawia efektywność rozwoju aplikacji. Po instalacji i konfiguracji tych narzędzi pobierz najnowszą wersję plików źródłowych WordPress i zainstaluj je na swoim lokalnym serwerze.

Ponadto zaleca się uruchomić system kontroli wersji, np. Git, w katalogu głównym twojego projektu dodatkowego.git initKomenda służy do tworzenia nowego repozytorium, co ułatwia monitorowanie zmian w kodzie, odwoływanie błędów oraz współpracę zespołu w przyszłości. Pomyśl również o włączeniu trybu debugowania w WordPressie.wp-config.phpW pliku znajduje się…WP_DEBUGKonstanta ustawiona jest na…trueTo umożliwi wyświetlanie błędów i ostrzeżzeń PHP podczas procesu rozwoju, co pomoże szybko zlokalizować problemy.

Polecamy lekturę. Pełny przewodnik po tworzeniu pluginów dla WordPress: jak stworzyć swoj własny plugin od zera。

Stworzenie pierwszej struktury podstawowej dla twojego pluginu

Standardowy plugin do WordPressa posiada określony katalog i strukturę plików. Najpierw wejdź do katalogu zainstalowanego WordPressa.wp-content/pluginsfolder. Tu stworzysz nowy folder dla pluginu, który przygotowujesz do implementacji. Nazwa foldera powinna być krótka, unikalna i odzwiercać funkcję pluginu. Na przykład:my-first-plugin。

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

Pisanie głównego pliku pluginu

W tym folderze utwórz plik o nazwie….phpPliki o określonym rozszerzeniu, które są głównymi plikami wtyczek, zwykle noszą taką samą nazwę jak folder, w którym znajdują się.my-first-plugin.phpTen plik stanowi wejście do pluginu, a komentarze umieszczone na jego początku (tzw. „plugin header comments”) są konieczne, ponieważ zawierają metadane o pluginie, które są przekazywane do WordPress.

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

W tym komentarzu…Plugin NameTo jedyny obowiązkowy element, natomiast inne informacje pomogą użytkownikom w identyfikacji twojego pluginu w środowisku administracyjnym WordPress. Po ukończeniu tego kroku faktycznie stworzyłeś plugin, który można aktywować. Zaloguj się do panelu administracyjnego WordPress, wejdź do menu “Pluginy” i powinien pojawić się tekst “Moje pierwsze pluginie”, chociaż na razie nie posiada on żadnych funkcji.

Tworzenie funkcji wtyczek oraz zamykania klas

Aby kod był jasny i łatwy w utrzymaniu, zaleca się organizować go za pomocą podejścia obiektowego. W głównym pliku lub w osobnym pliku należy definiować klasę, która zawierać będzie wszystkie funkcje pluginu.

if ( ! class_exists( 'My_First_Plugin' ) ) {
    class My_First_Plugin {
        public function __construct() {
            // 构造函数，用于初始化动作和过滤器
            add_action( 'init', array( $this, 'init' ) );
        }

public function init() {
            // 插件初始化时执行的操作
            // 例如：注册短代码、自定义文章类型等
        }
    }

// 实例化插件类
    new My_First_Plugin();
}

Taka struktura organizuje Twoje funkcje w osobnym przestrzeni nazw (namespace), co zapobiega konfliktom z nazwami funkcji innych pluginów lub tematów.

Polecamy lekturę. Rozwoj pluginów dla WordPress: budowanie własnych modułów funkcjonalnych od zera。

Rozwijanie kluczowych funkcji: działań i filtrów

Silna strona pluginów WordPress polega na ich systemie hooków, w tym na akcjach (Actions) i filtrach (Filters). Zrozumienie i skuteczne wykorzystanie tych elementów stanowi klucz do tworzenia skutecznych pluginów.

Dodawanie funkcji za pomocą aktywnych háków (action hooks)

Aktywnie działające „hooki” (ang. action hooks) umożliwiają wstawianie własnego kodu w określonych momentach wykonywania WordPressa. Na przykład, jeśli chcesz automatycznie dodać tekst po treści artykułu, możesz to zrobić za pomocą odpowiedniego „hooka”.the_contentFiltr (to specjalna “akcja”). Typowe akcje to…wp_footerWykorzystuje się do dodawania treści na dno strony.

public function __construct() {
    add_action( 'wp_footer', array( $this, 'add_custom_footer_text' ) );
}

public function add_custom_footer_text() {
    echo '<p style="text-align: center;">Dziękujemy za czytanie! Ten tekst został wygenerowany przez moje pierwsze dodatkowe oprogramowanie (plugin).</p>';
}

W tym przykładzie…add_custom_footer_textMetoda będzie wykonywana w nagłówku każdej strony i wyświetli tekst ustawiony przez użytkownika.

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 są używane do modyfikacji danych przed ich wysłaniem do bazy danych lub do przeglądarki. Popularnym przykładem jest zmiana nagłówka artykułu. Możemy to zrobić za pomocą filtrów hooków.the_titleFiltry.

public function __construct() {
    add_filter( 'the_title', array( $this, 'customize_title' ) );
}

public function customize_title( $title ) {
    // 只在主循环中且不是后台管理界面时修改
    if ( ! is_admin() && in_the_loop() ) {
        return '📖 ' . $title;
    }
    return $title;
}

Ta funkcja filtru przyjmuje oryginalny nagłótek jako parametr i powraca zmieniony nagłótek. Logika polega na dodaniu symbolu książki przed nagłówkiem artykułu wyświetlanego na stronie frontowej.

Internacjonalizacja wtyczek oraz konfigurowalne opcje

Aby plugin był dostępny dla użytkowników z całego świata, internacionalizacja (ang. i18n) jest niezbędnym krokiem. Ponadto udostępnienie użytkownikom strony konfiguracji w panelu administracyjnym pozwala znacząco zwiększyć poziom profesjonalizacji samego pluginu.

Polecamy lekturę. Przewodnik dla początkujących w rozwoju pluginów dla WordPress: jak stworzyć swój pierwszy funkcjonalny plugin od zera。

Rozwijanie funkcji tłumaczenia tekstu

WordPress wykorzystuje technologię GNU gettext do realizacji funkcji internacionalizacji. Wszystkie teksty, które wyświetlają się użytkownikowi w interfejsie frontend lub backend w ramach pluginów, muszą zostać umieszczone w specjalnych obiektach definiowanych przez określone funkcje.

Najpierw, w nagłówku pliku głównego, definiowaliśmy już…Text Domain和Domain PathNastępnie, w funkcji inicjalizacji należy załadować tekstowe pole.

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

public function init() {
    load_plugin_textdomain(
        'my-first-plugin',
        false,
        dirname( plugin_basename( __FILE__ ) ) . '/languages/'
    );
}

Następnie, w kodzie w miejscach, gdzie wyświetla się tekst, należy użyć funkcji tłumaczeniowej. Na przykład, w wcześniejszym tekście na dole strony:

Echo '<p style="text-align: center;">' . esc_html__( '感谢阅读！本内容由我的第一个插件生成。', 'my-first-plugin' ) . '</p>';

esc_html__()Funkcja przekłada tekst i wykonywa na niego operacje escape w formacie HTML, aby zapewnić bezpieczeństwo. Tłumacze mogą ją wykorzystywać..po和.moPomocnicze pliki umożliwiają dostosowanie twojego pluginu do różnych języków.

Stworzenie strony z ustawieniami w tle (backend settings page).

Można skorzystać z API ustawień w WordPress, aby stworzyć standardową i bezpieczną stronę ustawień dla swojego pluginu. To zwykle wymaga kilku kroków: rejestracji ustawień, dodawania obszarów i polów ustawień, a także tworzenia strony menu.

public function __construct() {
    add_action( 'admin_menu', array( $this, 'add_admin_menu' ) );
    add_action( 'admin_init', array( $this, 'settings_init' ) );
}

public function add_admin_menu() {
    add_options_page(
        '我的第一个插件设置', // 页面标题
        '我的插件', // 菜单标题
        'manage_options', // 权限
        'my-first-plugin', // 菜单slug
        array( $this, 'settings_page_html' ) // 回调函数，用于输出页面HTML
    );
}

public function settings_init() {
    register_setting( 'my_first_plugin_settings', 'my_first_plugin_options' ); // 注册一组设置

add_settings_section(
        'my_first_plugin_section',
        __( '基本设置', 'my-first-plugin' ),
        null,
        'my-first-plugin'
    );

add_settings_field(
        'footer_text',
        __( '自定义页脚文本', 'my-first-plugin' ),
        array( $this, 'footer_text_field_html' ),
        'my-first-plugin',
        'my_first_plugin_section'
    );
}

public function footer_text_field_html() {
    $options = get_option( 'my_first_plugin_options' );
    ?>
    <input type='text' name='my_first_plugin_options[footer_text]' value='<?php echo esc_attr( $options['footer_text'] ?? '' ); ?>'>
    <?php
}

public function settings_page_html() {
    if ( ! current_user_can( 'manage_options' ) ) {
        return;
    }
    ?>
    <div class="wrap">
        <h1><?php echo esc_html( get_admin_page_title() ); ?></h1>
        <form action="/pl/options.php/" method="post" data-trp-original-action="options.php">
            <?php
            settings_fields( 'my_first_plugin_settings' );
            do_settings_sections( 'my-first-plugin' );
            submit_button();
            ?>
        <input type="hidden" name="trp-form-language" value="pl"/></form>
    </div>
    &lt;?php
}

Teraz użytkownicy mogą konfigurować tekst na dole strony (“footer”) na stronie “Ustawienia” -> „Moje dodatki”.add_custom_footer_textMożna zmienić sposób działania pluginu tak, aby przyjmował wartości z tej opcji, co ułatwi jego konfigurację.

Podsumowanie.

Przez ten przewodnik przeszliśmy przez główny proces rozwoju pluginów dla WordPress: od przygotowania lokalnego środowiska i stworzenia podstawowej struktury plików po organizację kodu za pomocą metod obiektowych. Dokładnie zapoznaliśmy się z kluczowymi mechanizmami rozszerzalności WordPress – hookami akcji i filtrów – i zrealizowaliśmy przydatne funkcje, takie jak dodawanie treści do nagłówka strony i modyfikacja nagłówków artykułów. Na koniec poprawiliśmy profesjonalność i używalność pluginu, umożliwiliśmy jego dostępność dla użytkowników z całego świata dzięki tłumaczeniom (internacjonalizacji) oraz stworzyliśmy bezpieczny interfejs konfiguracji w tle za pomocą API Settings. Rozwój pluginów to proces ciągłego uczenia się i doskonalania. Po opanowaniu tych podstawowych znań możesz dalej eksplorować zaawansowane tematy, takie jak tworzenie własnych typów artykułów, interakcje AJAX, integracja z API REST, i stworzyć wydajne, elegancko napisane pluginy dla WordPress.

FAQ – najczęściej zadawane pytania.

Czy do tworzenia wtyczek (pluginów) konieczne jest stosowanie programowania obiektowego?

Nie jest to obowiązkowe, ale mocnie zaleca się to robić. Programowanie proceduralne (z użyciem zbioru funkcji) może szybko umożliwić realizację wymaganych funkcji, ale wraz z rosnącą liczbą dodatkowych modułów (pluginów) kod staje się trudniejszy do zarządzania i utrzymania, a także mogą wystąpić konflikty nazw funkcji z innymi modułami. Programowanie obiektowe umożliwia zabezpieczenie kodu poprzez użycie klas, co ułatwia jego organizację i rozszerzanie w przyszłości.$thisUżywanie zmiennych i przestrzeni nazw (w nowszych wersjach PHP) umożliwia lepszą organizację kodu i stanowi najlepszą praktykę w branży budowy dużych i złożonych modułów.

Jak bezpiecznie obsługiwać dane wprowadzone przez użytkowników lub pochodzące z bazy danych?

Zawsze, gdy wyświetla się jakaś zmienna na stronie, konieczne jest jej ucieleśnienie (escape). WordPress oferuje kilka pomocniczych funkcji do tego celu. Do wyboru jest kilka różnych funkcji, zależnie od kontekstu – jeśli chodzi o wyświetlenie w tagach HTML lub atrybutach, należy użyć odpowiedniej funkcji.esc_html()或esc_attr()\n; Aby wyświetlić wynik w zmiennej JavaScript, użyjwp_json_encode()或esc_js()W URL-u należy to wyświetlić w następujący sposób:esc_url()Nigdy nie wierzyć w dane wprowadzone przez użytkowników ani w nieprzetworzone dane – escape (uwzględnienie specjalnych znaków) jest kluczowym elementem zapobiegania atakom typu XSS (Cross-Site Scripting).

Aby plugin został dodany do oficjalnego katalogu WordPress, musi spełniać określone wymogi. Najważniejsze z nich to:

Aplikacje, które są wysyłane do katalogu dodatków na stronie WordPress.org, muszą spełniać szereg surowych wymagań. Głównie obejmują one następujące zasady: kod dodatku musi być zgodny z licencją GPL; nie wolno zawierać żadnych elementów chroniących przed nieuprawnionym dostępem (takich jak „paywalls”), kodu szyfrowanego ani zaszyfrowanego; musi być dostępna pełna funkcjonalność dotycząca obsługi różnych języków; należy stosować standardy kodowania i normy dokumentacji WordPress; dodatki nie wolno wykonywać żadnych złośliwych działań, np. identyfikacji numerów telefonów lub wykorzystywania do minowania kryptowalut. Ponadto plik główny aplikacji musi zawierać standardowe informacje o jej strukturze, a także musi być dostępna pełna dokumentacja.readme.txtDokumenty.

Jak powinienem debugować kod mojej wtyczki?

Najpierw upewnij się, że w środowisku rozwoju wszystko jest włączone.WP_DEBUGDla bardziej złożonego debugowania można użyć…error_log()Funkcja zapisuje informacje do logu błędów na serwerze albo je używa w inny sposób.var_dump()和wp_die()Aby sprawdzić wartość zmiennej (tylko w środowisku rozwojowym), można to zrobić bezpośrednio w kodzie. Jednak bardziej efektywnym sposobem jest używanie narzędzia Xdebug wchodzącego w skład integrowanego środowiska rozwojowego, np. PhpStorm, do realizacji kroku po kroku debugowania. Ponadto w przypadku WordPress…WP_DEBUG_LOG和WP_DEBUG_DISPLAYKonstanty umożliwiają kontrolę nad tym, czy błędy mają być zapisywane do plików logów czy wyświetlone na ekranie.