Rozwoj pluginów dla WordPress: od podstaw do zaawansowanych technik i praktycznych porad

Podstawy rozwoju pluginów dla WordPressa oraz przygotowanie środowiska do ich tworzenia

Dodatki do WordPressa to niezależne pakety kodu, które rozszerzają funkcje podstawowego systemu WordPress. Aby zacząć ich tworzenie, najpierw konieczne jest stworzenie profesjonalnego środowiska rozwoju lokalnego. To zwykle obejmuje instalację oprogramowania do obsługi serwerów lokalnych (np. XAMPP, MAMP lub Local by Flywheel), edytora kodu (np. VS Code lub PhpStorm) oraz instalacji WordPressa przeznaczonej do testów. Korzystanie z takiego środowiska umożliwia uniknięcie ryzyk, które mogą wyniknąć z eksperymentalnych zmian w witrynie internetowej publikowanej w sieci.

Po przygotowaniu stworzenie pierwszego pluginu jest bardzo proste. Wystarczy tylko skorzystać z narzędzi dostępnych w WordPress.wp-content/pluginsUtworz nowy folder w katalogu, na przykład…my-first-pluginNastępnie w tym folderze utwórz główny plik PHP, którego nazwa zwykle jest identyczna z nazwą foldera. Na początku tego pliku muszą znajdować się standardowe komentarze opisujące strukturę pliku (tzw. „plugin header”), które są kluczowe dla rozpoznawania pluginów przez WordPress.

Konieczna struktura pliku zawierającego plugin:

Główny plik pluginu stanowi punkt wejścia do jego działania, a blok komentarzy umieszczone na jego początku zawiera szereg metadanych.Plugin NameTo jedyny obowiązkowy element – będzie wyświetlony w liście pluginów w panelu administracyjnym WordPressa. Najprostszzy plugin może składać się wyłącznie z tego nagłówka, bez żadnego kodu, który faktycznie byłby wykonywany.

Polecamy lekturę. Pełny przewodnik po rozwoju pluginów dla WordPressa: od podstaw po zaawansowane techniki i praktyczne poradы。

Poniżej znajduje się przykład najprostszego kodu pliku rozszerzenia (pluginu):

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

Po zapisaniu powyższego kodu loguj się do panelu administracyjnego WordPress i przejdź na stronę “Dodatki” (Plugins). Tam ujdziesz na listę dostępnych dodatków i zobaczysz ten nowy. Możesz go aktywować. Choć na razie nie wykonywa żadnych funkcji, to oznacza oficjalne rozpoczęcie procesu rozwoju tego dodatku.

Podstawowe mechanizmy: haczyki akcji (action hooks) i filtry (filters)

Podstawa filozofii rozwoju pluginów dla WordPress jest związana z zasadą zwanej “hookami” (ang. hooks), która umożliwia łączenie Twojego kodu z core’em WordPress w określonych momencach lub w związku z określonymi danymi. Hooki są podzielone na dwie główne kategorie: akcje (Actions) i filtry (Filters).

Aktywnie działające “haki” (ang. action hooks) wykonywają Twoje własne funkcje w momencie wydarzenia określonego – na przykład po opublikowaniu artykułu lub podczas ładowania skryptów w nagłówku strony. Są używane do wykonywania określonych działań.add_action()Funkcja umożliwia przyłączenie Twojej funkcji do określonego „hooka akcji” (action hook).

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

Na przykład, jeśli chcesz dodać własny tekst do nagłówka strony na swoim witrynie, możesz to zrobić za pomocą odpowiednich narzędzi lub kodu.wp_footerTen „hook” do działań: najpierw musisz napisać własną funkcję w pliku głównego pluginu, a potem ją użyć.add_action()Przypnij to do háka.

Polecamy lekturę. Opanuję rozwój dodatków (pluginów) dla WordPressa: stworz swoj pierwszy własny dodatek od zera.。

Poniżej znajduje się przykład implementacji:

Funkcja myplugin_add_footer_text() {
    echo '<p style="text-align:center;">Dziękujemy, że korzystasz z tej witryny!</p>';
}
add_action( 'wp_footer', 'myplugin_add_footer_text' );

Gdy WordPress wykonuje…wp_footerGdy zostanie użyty „hook”, to zostanie automatycznie wywołane.myplugin_add_footer_text()Funkcja, która wyświetla tekst, który ustaliliśmy.

Modyfikacja danych za pomocą hooków filtrów

Filtry hooki są używane do modyfikacji danych. Przetwarzają je przed tym, jak zostaną wykorzystane (na przykład zapisane w bazie danych lub wyświetlone w przeglądarcu). Służą do wprowadzania zmian w dane.add_filter()Można stworzyć funkcję do aplikowania filtrów. Na przykład, jeśli chcesz zmienić wszystkie nagłówki artykułów, możesz dodać do nich prefiks przed ich wyświetleniem.

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

Ten kod pokazuje, jak dodać prefiks “[Rekomendowane]” do nagłówków wszystkich artykułów:

function myplugin_modify_title( $title ) {
    if ( is_single() ) {
        $title = '[推荐] ' . $title;
    }
    return $title;
}
add_filter( 'the_title', 'myplugin_modify_title' );

Tworzenie strony administracyjnej dla pluginów

Wiele wtyczek wymaga dostarczenia użytkownikom opcji konfiguracji, co wymaga stworzenia menu administracyjnego oraz stron z ustawieniami w backendzie WordPressa. WordPress oferuje szereg funkcji do dodawania elementów menu głównego lub podmenu.

Dodaj menu zarządzania na najwyższym poziomie.

Możesz użyćadd_menu_page()Funkcja tworzy niezależny menu w tle dla twojego pluginu. Ta funkcja wymaga kilku parametrów, w tym nagłówka strony, nagłówka menu, upoważnienia użytkownika, aliasu menu oraz funkcji obsługującej generowanie treści strony.

Polecamy lekturę. Nauczymy cię, jak od zera rozwijać pluginy dla WordPress.。

Tu znajduje się funkcja wywoływana w odpowiedzi (callback function).myplugin_settings_page_htmlZadanie polega na generowaniu treści HTML dla strony konfiguracji.

Kod dodawania menu zwykle musi zostać umieszczony w odpowiednim miejscu w kodzie źródłowym aplikacji.admin_menuTen „hak akcji” jest potrzebny, aby zapewnić wykonywanie danej operacji podczas inicjalizacji interfejsu administracyjnego.

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

Tworzenie strony z ustawieniami oraz formularza bezpieczeństwa

W funkcji callback na stronie konfiguracji należy wyświetlić formularz oraz obsługić jego wysłanie. WordPress oferuje API do konfiguracji, które ułatwia ten proces, umożliwiając bezpieczne rejestrację, zapisywanie i wyświetlanie opcji. Aby zrozumieć jednak zasady działania, możemy najpierw przyjrzeć się prostemu przykładowi ręcznej obsługi wysyłania formularza.

Następny kod pokazuje, jak tworzyć prostą stronę ustawień zawierającą pola wejściowe oraz jak bezpiecznie zapisywać wprowadzone dane:

function myplugin_settings_page_html() {
    // 检查用户权限
    if ( ! current_user_can( 'manage_options' ) ) {
        return;
    }
    // 处理表单提交
    if ( isset( $_POST['myplugin_option'] ) ) {
        // 安全检查：验证随机数
        check_admin_referer( 'myplugin_save_settings' );
        // 清理并保存数据
        $option_value = sanitize_text_field( $_POST['myplugin_option'] );
        update_option( 'myplugin_custom_option', $option_value );
        echo '<div class="notice notice-success"><p>Ustawienia zostały zapisane!</p></div>';
    }
    // 获取已保存的值
    $saved_value = get_option( 'myplugin_custom_option', '默认值' );
    ?&gt;
    <div class="wrap">
        <h1>Ustawienia mojej wtyczki.</h1>
        <form method="post" action="">
            <?php wp_nonce_field( 'myplugin_save_settings' ); ?>
            <label for="myplugin_option">Opcje:</label>
            <input type="text" id="myplugin_option" name="myplugin_option" value="<?php echo esc_attr( $saved_value ); ?>" />
            <?php submit_button( '保存更改' ); ?>
        <input type="hidden" name="trp-form-language" value="pl"/></form>
    </div>
    &lt;?php
}

Rozwój zaawansowany i publikacja wtyczek

Gdy funkcje wtyczek stają się coraz bardziej złożone, ważna jest dobrza organizacja kodu. Zaleca się stosowanie programowania obiektowego (OOP), aby funkcje wtyczek były umieszczone w klasach. To pomaga uniknąć konfliktów nazw funkcji oraz sprawia, że struktura kodu jest bardziej jasna i łatwiejsza w utrzymaniu.

Internacjalizacja pluginów jest kluczową drogą do osiągnięcia sukcesu na świecie.__()和_e()Funkcje takie jak „wrap” otaczają cały tekst przeznaczony dla użytkowników i przekazują go dalej w odpowiednim formacie.load_plugin_textdomain()Funkcja jest odpowiedzialna za ładowanie plików z tłumaczeń. Należy poprawnie ustawić odpowiednie informacje w komentarzach na początku pliku rozszerzenia.Text DomainTo również konieczne.

Przygotowania przed publikacją wtyczki

Przed wprowadzeniem pluginu do oficjalnego katalogu lub rozpowszechnieniem należy go dokładnie przetestować. To obejmuje sprawdzenie kompatybilności z różnymi wersjami PHP, WordPressa, a także z różnymi kombinacjami tematów i pluginów. Kód musi spełniać standardy programowania WordPressa oraz obejmować odpowiednie zabezpieczenia – należy weryfikować, filtrować i unikatyzować wszystkie dane wprowadzane przez użytkowników.

Należy napisać jasną instrukcję dotyczącą wtyczki.README.txtW pliku opisziesz funkcje pluginu, sposób jego instalacji, najczęściej występujące problemy itd. Na koniec pakuj kod w plik ZIP i możesz go złożyć do katalogu pluginów na stronie WordPress.org lub rozdawać na swoim własnym blogu.

Podsumowanie.

Rozwoj pluginów dla WordPress polega na zrozumieniu podstawowych mechanizmów hooków, dalszym pogłębieniu się w temat tworzenia interfejsów administracyjnych oraz organizacji struktury kodu, a na koniec na bezpiecznym opublikowaniu pluginu. Kluczowym elementem jest opanowanie sposobów używania akcji (actions) i filtrów (filters) – są one „mostami” łączącymi plugin z systemem WordPress. Bez względu na to, czy chcesz dodać prostą funkcję, czy stworzyć złożony komercyjny plugin, stosowanie standardów bezpiecznego programowania, dokładne testowanie oraz uwzględnienie aspektów internationalizacji są kluczowymi elementami do osiągnięcia sukcesu. Poprzez ciągłe ćwiczenia będziesz mogł tworzyć mocne, stabilne i popularne pluginy dla WordPress.

FAQ – najczęściej zadawane pytania.

Czy konieczne jest nauki PHP, zanim zacznę rozwijać dodatki (plugi)?

Tak, posiadanie solidnych podstaw w języku PHP jest konieczne do tworzenia dodatków (pluginów) dla WordPress. Większość elementów WordPress, włącznie z samym programem, jest napisana w PHP. Aby skutecznie tworzyć i debugować kod dodatków, musisz znać gramatykę PHP, funkcje, zmienne, tablice, a także zasady programowania obiektowego.

Jak uniknąć konfliktów pomiędzy nazwami funkcji w moim pluginie a nazwami funkcji w innych pluginach?

Najlepszą praktyką unikania konfliktów nazw funkcji jest stosowanie programowania obiektowego, w którym wszystkie funkcje są umieszczone w metodach klasy. Jeśli używasz programowania proceduralnego, należy dodać każdej funkcji unikalny prefiks, zwykle powiązany z nazwą twojego pluginu lub jego skróceniem.myplugin_或mp_To może znacząco zmniejszyć prawdopodobieństwo konfliktów wynikających z niejednoznacznych nazw.

Dlaczego ustawienia mojego pluginu giną po odkręceniu strony po zapisaniu?

Zwykle to wynika z niewłaściwego obsługiwania procedury sprawdzania losowych numerów podczas wysyłania formularza. Przed zapisaniem danych z formularza konieczne jest wykonanie tej procedury.check_admin_referer()或wp_verify_nonce()Funkcja służy do weryfikacji losowych numerów, aby upewnić się, że żądanie pochodzi z autentycznego źródła, i zapobiec atakom typu „cross-site request forgery”. Jeśli weryfikacja nie powiedzie się, WordPress blokuje zapisanie danych.

Jak zrobić, aby tekst w moim pluginie mógł zostać przetłumaczony na inne języki?

Musisz zrealizować internacionalizację wszystkich tekstów skierowanych do użytkowników w tym pluginie. Do tego użyj odpowiednich narzędzi lub metod.__()Funkcja umożliwia uzyskanie tłumaczenia danej stringowej wartości lub jej wykorzystanie w odpowiednim celu._e()Funkcja wydaje wynik bezpośrednio. Ponadto konieczne jest uruchomienie tej funkcji podczas inicjalizacji pluginu (na przykład w momencie jego montowania).plugins_loaded(Wywołanie hooka)load_plugin_textdomain()Można stworzyć funkcję do ładowania plików językowych odpowiedniej wymaganej wersji programu. Narzędzia takie jak Poedit mogą pomóc przy tworzeniu tych plików..potPliki szablonów i….po/.moTłumacz dokumentów.