Przewodnik po tworzeniu wtyczek WordPress: krok po kroku nauczymy Cię, jak stworzyć swoją własną wtyczkę od podstaw.

Zrozumienie podstaw pluginów oraz budowy środowiska rozwojowego

Przed rozpoczęciem pisania kodu istotne jest poznanie podstawowych zasad działania pluginów WordPress oraz przygotowanie odpowiedniego środowiska lokalnego do rozwoju. Plugin to w istocie katalog zawierający jeden lub kilka plików w formacie PHP, które służą do rozszerzania lub modyfikowania funkcji podstawowego systemu WordPress za pomocą dostępnej w tym systemie sieci hooków (hooks). Pluginy różnią się od tematów (templates) tym, że są skierowane wyłącznie do dodawania nowych funkcji, a nie do zmiany wyglądu witryny; nawet po zmianie tematu funkcje pluginu zwykle pozostają nienaruszone.

Aby zacząć rozwój, najpierw potrzebny jest lokalny środowisko WordPress. Można to łatwo uzyskać za pomocą narzędzi takich jak Local by Flywheel, MAMP, XAMPP lub bezpośrednio za pomocą kontenerów Dockera. Po instalacji WordPressa na lokalnym komputerze należy wejść do jego konfiguracji i przygotować wszystkie niezbędne elementy, aby móc zacząć tworzyć i edytować strony internetowe.wp-content/pluginsKatalog. To jest miejsce, w którym znajdują się wszystkie dodatki (plugi). Stwórz nową folderę, na przykład…my-first-pluginW tym folderze musisz stworzyć główny plik PHP, którego nazwa zwykle pokrywa nazwę foldera. Na przykład:my-first-plugin.phpTen plik główny stanowi punkt wejścia do pluginu i zawiera specjalne informacje w postaci komentarzy, które informują WordPress o nazwie pluginu, opisie, wersji, autorze itd.

Zaleca się włączyć tę funkcję w środowisku rozwoju.WP_DEBUG„Mode”. Odkryj folder znajdujący się w korzeniu katalogu WordPress.wp-config.phpW pliku znajdź lub dodaj następujący tekst:

Polecamy lekturę. Praktyczny przewodnik po tworzeniu wtyczek WordPress: od zera do stworzenia swojej pierwszej wtyczki.。

define( ‘WP_DEBUG’, true );
define( ‘WP_DEBUG_LOG’, true );
define( ‘WP_DEBUG_DISPLAY’, false );

To zapisa błędy i ostrzeżenia do…wp-content/debug.logW pliku znajdują się informacje, które pomogą ci szybko lokalizować problemy podczas procesu rozwoju. Ponadto używanie wydajnego edytora kodu lub środowiska integracyjnego (IDE) takiego jak VS Code lub PhpStorm może znacząco zwiększyć efektywność pracy. Te narzędzia oferują dobrą obsługę gramatyczną języka PHP oraz funkcje podpowiedzi, co ułatwia rozwiązywanie problemów.

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).

Przejdziemy przez cały proces od tworzenia pliku do aktywacji prostego pluginu “Hello World”. Ten plugin wyświetli powitanie na górnym polu interfejsu administracyjnego witryny internetowej.

W katalogu twoich pluginów…my-first-pluginW tym dokumencie opisano procedurę tworzenia głównego pliku.my-first-plugin.phpPodstawowa struktura zawartości pliku musi zaczynać się od komentarzy umieszczonego w nagłówku pliku („plugin header”).

<?php
/**
 * Plugin Name:       我的第一个插件
 * Plugin URI:        https://yourwebsite.com/my-first-plugin
 * Description:       这是一个用于学习插件开发的示例插件，它将在后台显示欢迎信息。
 * Version:           1.0.0
 * Author:            开发者姓名
 * Author URI:        https://yourwebsite.com
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 * Domain Path:       /languages
 */

Te nagłówki komentarzy są obowiązkowe; WordPress korzysta z nich, by identyfikować i wyświetlać twoje pluginy na stronie zarządzania pluginami.Text DomainZastosowuje się do lokalizacji aplikacji (ang. internationalization, lub I18N).Domain PathZaznaczono katalog, w którym znajdują się pliki językowe (jeśli to konieczne).

Następnie dodamy kluczowe funkcje. W tym przykładzie użyjemy…admin_notices„Hook”. Dodaj następujący kod poniżej komentarza w nagłówku:

Polecamy lekturę. Kompletny przewodnik po tworzeniu wtyczek do WordPressa: praktyczny poradnik od podstaw do zaawansowanych technik.。

// 使用 admin_notices 钩子在管理后台输出提示信息
add_action( ‘admin_notices’, ‘my_first_plugin_display_admin_greeting’ );

/**
 * 在管理后台显示欢迎信息的函数
 * @return void
 */
function my_first_plugin_display_admin_greeting() {
    // 检查当前用户是否有权限，确保只在后台显示
    if ( ! current_user_can( ‘manage_options’ ) ) {
        return;
    }
    ?>
    <div class="notice notice-success is-dismissible">
        <p><?php _e( ‘欢迎使用我的第一个插件！插件开发之旅正式开始！’, ‘my-first-plugin’ ); ?></p>
    </div>
    &lt;?php
}

Po zapisaniu pliku loguj się do panelu administracyjnego swojego witryny WordPress i wejdź na stronę “Dodatki”. Powinien pojawić się dodatek o nazwie “Moje pierwsze dodatko” w liście dostępnych dodatków. Kliknij na przycisk “Uwolnij”. Po włączeniu dodatku odśwież stronę panelu administracyjnego (na przykład panelu kontrolnego) i powinno pojawić się zielone przypomnienie o powodzeniu, zawierające powitanie, które określiliśmy w kodzie. To jest minimalna, ale kompletna implementacja funkcji, która potwierdza, że twoje środowisko rozwoju oraz struktura dodatków są poprawne.

Podstawowe technologie WordPressa: hooki i filtry

Rozumienie i biegłe stosowanie hooków stanowi klucz w rozwoju pluginów dla WordPress. Hooki dzielą się na dwa typy: akcje (Actions) i filtry (Filters). Hooki typu akcja umożliwiają wstawienie i wykonywanie własnego kodu w określonych momencach – na przykład po opublikowaniu artykułu lub przed załadowaniem nagłówka strony. Takie hooki użyliśmy wcześniej.admin_noticesTo po prostu „hook” (zaczepka) do wykonywania określonej akcji. Z kolei „hook” filtrów umożliwia modyfikację danych generowanych lub przekazywanych w trakcie procesu – na przykład zmianę nagłówka artykułu lub wyników wyszukiwania w pluginie.

Jak dodać własną akcję?

Akcja została przeprowadzona z powodzeniem.add_action()Dodanie funkcji. Sintaksa to:add_action( ‘hook_name’, ‘your_function_name’, priority, accepted_args )Priorytet (priority) to liczba całkowita; im mniejsza liczba, tym wcześniej zostanie wykonywane dane zadanie. Wartość podstawowa to 10. Na przykład, jeśli chcesz dodać kilka elementów HTML dostosowanych do potrzeb po treści artykułu:

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

add_action( ‘the_content’, ‘my_custom_content_append’ );
function my_custom_content_append( $content ) {
    // 只在单篇文章主循环内生效
    if ( is_single() && in_the_loop() && is_main_query() ) {
        $extra_content = ‘<div class="“my-custom-box”"><p>To jest treść dostosowana, dodana za pomocą wtyczki.</p></div>’;
        $content .= $extra_content;
    }
    return $content;
}

Uwaga, mimo że…the_contentTo filtr – musi wrócić zmieniony tekst.$contentWordPress również używa tego jako punktu aktywacji dla określonych działań. Lepszym rozwiązaniem jest jednak używanie bardziej standardowych i dokładnych procedur.add_filter。

Jak dodać własny filtr?

Filtr przeszedł sprawdzenie.add_filter()Dodanie funkcji. Sintaksa:add_action()Podobnie. Częstym przykładem jest modyfikacja długości wydarzeń z artykułów:

add_filter( ‘excerpt_length’, ‘my_custom_excerpt_length’, 999 );
function my_custom_excerpt_length( $length ) {
    // 将默认的55个词改为20个词
    return 20;
}

Możesz stworzyć własne „hooki” (zawody), aby twoje rozszerzenie mogło być rozszerzane również przez innych programistów lub twórców tematów (tematów graficznych).do_action()Aby definiować hook akcji, użyj…apply_filters()Aby definiować hooka filtru, to kluczowe jest budowanie modułowych i rozszerzalnych pluginów.

Polecamy lekturę. Kompletny przewodnik po tworzeniu wtyczek WordPress: od podstaw do zaawansowanych technik.。

Rozwój funkcji wtyczek oraz najlepsze praktyki ich stosowania

Gdy funkcje wtyczek stają się coraz bardziej złożone, dobre zorganizowanie kodu, bezpieczeństwo, łatwość utrzymania oraz wydajność nabierają kluczowego znaczenia. Popularnym sposobem organizacji struktury kodu jest programowanie obiektowe (OOP – Object-Oriented Programming), które umożliwia pakowanie powiązanych funkcji i danych w jedną główną klasę.

Zastosowanie programowania obiektowego do zabezpieczenia kodu.

Stworzenie klasy głównej umożliwi lepsze zarządzanie stanem i metodami pluginów, a także uniknięcie konfliktów nazw funkcji. Poniżej znajduje się przykład prostej struktury programu zgodnej z zasadami programowania obiektowego (OOP – Object-Oriented Programming):

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

<?php
/**
 * Plugin Name:       进阶示例插件
 */
if ( ! class_exists( ‘My_Advanced_Plugin’ ) ) {
    class My_Advanced_Plugin {
        /**
         * 构造方法，用于初始化钩子
         */
        public function __construct() {
            add_action( ‘init’, array( $this, ‘register_custom_post_type’ ) );
            add_action( ‘admin_menu’, array( $this, ‘add_admin_menu_page’ ) );
            add_filter( ‘the_title’, array( $this, ‘filter_post_title_prefix’ ), 10, 2 );
        }

/**
         * 注册一个自定义文章类型
         */
        public function register_custom_post_type() {
            $args = array(
                ‘public’ => true,
                ‘label’  => ‘我的产品’,
                ‘supports’ => array( ‘title’, ‘editor’, ‘thumbnail’ ),
                ‘has_archive’ => true,
            );
            register_post_type( ‘my_product’, $args );
        }

/**
         * 在文章标题前添加前缀的过滤器
         * @param string $title 原标题
         * @param int    $id    文章ID
         * @return string 修改后的标题
         */
        public function filter_post_title_prefix( $title, $id = null ) {
            if ( ! is_admin() && in_the_loop() ) {
                $title = ‘[精品] ’ . $title;
            }
            return $title;
        }

// ... 其他方法
    }
    // 实例化插件类
    new My_Advanced_Plugin();
}

Taka struktura umożliwia zorganizowanie powiązanych funkcji w jednym miejscu, co czyni kod bardziej zrozumiałym i łatwiejszym w zarządzaniu.

Zabezpieczenie bezpieczeństwa i wydajności pluginów

Bezpieczeństwo to najważniejszy aspekt przy rozwijaniu dodatków (pluginów). Nigdy nie możesz ufać wprowadzonym przez użytkowników danym. W odniesieniu do wszystkich informacji pochodzących od użytkowników…$_GET、$_POST或$_REQUESTZdobione dane muszą zostać zweryfikowane (validation), oczyszczone (sanitization) i poddane procesowi escape (escaping). WordPress oferuje szereg pomocniczych funkcji do tego celu:
* 验证：check_ajax_referer()， wp_verify_nonce()
* 清理：sanitize_text_field()， sanitize_email()， absint()
* 转义：esc_html()， esc_url()， wp_kses_post()

Przed wyświetleniem jakichkolwiek danych w HTML, atrytach lub URL-ach konieczne jest użycie odpowiednich funkcji escape. Aby poprawić wydajność, rozsądnie używaj hooków i unikaj wykonywania złożonych, wymagających dużo zasobów operacji podczas każdego ładowania strony. Rozważ również możliwość wykorzystania API do zarządzania tymczasowymi danymi (Transients API) w WordPress, aby przechowywać niekluczowe, powtarzalne wyniki zapytań na określony czas.

Implementacja strony konfiguracji pluginu

Większość dodatków wymaga strony konfiguracji, na której użytkownik może dokonać niezbędnych ustawień. To zwykle jest realizowane poprzez…add_options_page()或add_menu_page()Funkcje typu „wait” są montowane (złączane) z odpowiednimi elementami systemu, aby umożliwić ich wykorzystanie w odpowiednim kontekście.admin_menuAby to zrealizować, należy skorzystać z dostępnych „hooków” w WordPress. Ustawienia powinny być bezpiecznie zarejestrowane, zachowane i sprawdzone za pomocą API Settings API. To wymaga stosowania odpowiednich procedur bezpieczeństwa podczas tworzenia, edycji i wykonywania operacji związanych z tymi ustawieniami.register_setting()、add_settings_section()和add_settings_field()Funkcje takie jak… Dzięki temu nie tylko zapewnia się bezpieczeństwo (na przykład poprzez sprawdzanie wartości „nonce”), ale także uzyskuje się jednolity styl interfejsu administracyjnego WordPress.

Podsumowanie.

Rozwoj pluginów dla WordPress polega na przekształceniu kreatywnych idei w funkcjonalne rozwiązania, a proces ten zaczyna się od zrozumienia podstawowej struktury pluginów oraz przygotowania lokalnego środowiska do ich implementacji. Tworząc najprostszego plugina typu “Hello World”, sprawdziliśmy cały proces od stworzenia plików po uruchomienie wymaganych funkcji. Kluczowym elementem rozwoju jest dogłębne zrozumienie i wykorzystanie potężnego systemu hooków w WordPress – akcji (actions) i filtrów (filters) – które stanowią most pomiędzy pluginem a core’em WordPress oraz innymi jego componentami. Wraz z rozszerzaniem funkcjonalności pluginu stosowanie objektywnej programacji, stosowanie standardów bezpiecznego kodowania (weryfikacja, czyszczenie danych, escapeowanie znaków) oraz wykorzystanie API Settings do budowy stron konfiguracji są kluczowymi krokami zapewniającymi stabilność, bezpieczeństwo, łatwość utrzymania i rozszerzalność pluginu. Posługując się tymi poradami i najlepszymi praktykami, będziesz mogł z poważaniem tworzyć wysokiej jakości pluginy dla WordPress, od prostych narzędzi po złożone aplikacje.

FAQ – najczęściej zadawane pytania.

Jakie są wymagane podstawowe znajomości, by rozwijać plagiary do WordPressu typu ###?
Konieczne jest, abyś posiadał podstawowe znajomości języka programowania PHP, ponieważ pluginy są głównie pisane w tym języku. Dodatkowo znajomość HTML, CSS i JavaScriptu pomoże ci stworzyć pluginy z interaktywnym frontendem. Najważniejsze jest, abyś zapoznał się z podstawowymi konceptami WordPressa, takimi jak artykły, strony, kategorie, role użytkowników oraz, co najważniejsze, z systemem hooków.

Jak debugować wdrożony w WordPress plugin w trakcie jego rozwoju?

Należy mocno zalecać włączenie tej funkcji w środowisku rozwoju.WP_DEBUGWzory oraz stosowane ustawienia zostały opisane w części dotyczącej konfiguracji środowiska programu. Dzięki temu błędy, ostrzeżenia i informacje o wydarzeniach w PHP są zapisywane do plików logów. Ponadto możesz używać…error_log()Funkcja lub funkcja pomocnicza, np.var_dump()Współpracawp_die()Aby sprawdzić wartości zmiennych, konieczne jest korzystanie z konsoli (Console) oraz karty „Sieć” (Network) w narzędziach dla deweloperów w przeglądarzu. Te elementy są niezbytne podczas debugowania kodu JavaScript oraz wysyłania i odbierania żądań AJAX.

Jak moja wtyczka będzie kompatybilna z różnymi wersjami WordPress?

W kodzie pluginu należy sprawdzić, czy określone funkcje lub klasy są dostępne w aktualnej wersji WordPress, zanim je użyjesz. Do tego można skorzystać z dostępnych narzędzi i metod.function_exists()或is_admin()Aby dokonać oceny warunków, można skorzystać z komentarzy umieszczonej w nagłówku pliku rozszerzenia.Requires at least:W polu należy określić minimalną wersję WordPressu, która jest wymagana. Regularne testowanie kompatybilności twojego pluginu z najnowszą wersją core’a WordPress jest dobrą praktyką.

Jak zrealizować internacionalizację mojego pluginu, aby obsługiwał kilka języków?

Musisz użyć funkcji tłumaczenia w WordPressie, aby otoczyć wszystkie ciągi tekstowe wymagające tłumaczenia. Na przykład użyj:__( ‘文本’, ‘your-plugin-text-domain’ )Oczywiście! Proszę podać tekst, który chcesz przetłumaczyć z języka chińskiego na polski._e( ‘文本’, ‘your-plugin-text-domain’ )Aby to działało poprawnie, należy właściwie ustawić odpowiednie parametry w komentarzach na początku pliku z pluginem.Text Domain和Domain PathNastępnie, użyj takiego narzędzia jak Poedit do stworzenia….potPliki szablonowe – tłumacze mogą na ich podstawie tworzyć kolejne teksty..po和.moPliki językowe.

Po zakończeniu rozwoju, jak złożyć plugin do oficjalnego katalogu pluginów?

Najpierw musisz zarejestrować konto na oficjalnej stronie WordPress i złożyć swój plugin do sprawdzenia. Twój kod musi spełniać oficjalne standardy i wytyczne dotyczące kodowania, w tym wymogi bezpieczeństwa, braku złośliwego oprogramowania oraz kompatybilności z licencją GPL. Struktura katalogu z plikami twojego pluginu musi zawierać główny plik PHP oraz inne niezbędne pliki.readme.txtPlik (w formacie zgodnym z określonymi standardami), a także opcjonalne zdjęcia ekranu i ikony. Proces sprawdzania może wymagać trochę czasu; zespół sprawdzi twój kod i upewni się, że spełnia wymogi.