Od zera do jednego: Przewodnik po rozwoju pluginów dla WordPressa i najlepszych praktyk

Dlaczego warto zdecydować się na stworzenie własnej wtyczki WordPress?

WordPress stał się najpopularniejszym systemem zarządzania treścią na świecie dzięki swojej wyjątkowej architekturze rozszerzeń (pluginów). Rozszerzenia umożliwiają programistom dodawanie praktycznie dowolnych funkcji do witryny bez konieczności modyfikacji kodu źródłowego. Rozwojem własnych rozszerzeń można zrealizować wysoko dostosowane rozwiązania, odpowiedzić na specyficzne potrzeby biznesowe, poprawić wydajność witryny, a nawet sprzedać te rozwiązania w środowisku społecznościowych lub na rynku. Opanowanie umiejętności tworzenia rozszerzeń daje możliwość głębokiej kontroli nad działaniem WordPressa – pozwala przekształcić się z pasywnego użytkownika tematów (tema) w aktywnego twórcę nowych funkcji.

Zrozumienie architektury pluginów w WordPress jest pierwszym krokiem. Wszystkie pluginy znajdują się w określonym miejscu w systemie./wp-content/plugins/W katalogu każdy plugin posiada swoją własną folderę. WordPress rozpoznaje i ładowa pliki pluginów poprzez skanowanie głównego pliku PHP znajdującego się w tym katalogu. Taki modułowy design gwarantuje izolację funkcji, bezpieczeństwo oraz łatwość konserwacji systemu.

Stworzenie swojego pierwszego plugina dla WordPress

Struktura podstawowych plików dla tworzenia pluginów

Najprostszzy plugin dla WordPress wymaga co najmniej jednego głównego pliku PHP. Najpierw utworzymy plik o nazwie…my-first-pluginfoldera i w nim utworzyć plik główny.my-first-plugin.phpKomentarze w nagłówku tego pliku są niezbędne, ponieważ służą do podania metadanych o pluginie do WordPress.

Polecamy lekturę. Pełny przewodnik po rozwoju pluginów dla WordPressa: budowanie własnych funkcji od zera。

<?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
 */

Wkładź folder zawierający powyżej opisany kod w odpowiednie miejsce./wp-content/plugins/Następnie wejdź na stronę “Dodatki” w panelu administracyjnym WordPress i tam ujrzysz ten dodatek – możesz go aktywować. Choć na razie nie ma żadnych funkcji, to udało ci się stworzyć ramę dla dodatku, która spełnia wymogi standardó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

Dodaj prostą funkcję do tego pluginu.

Dajmy temu pluginowi dodatkową, podstawową funkcję: automatycznego dodawania ustalonego tekstu na końcu treści artykułu. Do tego potrzebne będą „hooki” filtrów w WordPress.the_content。

在my-first-plugin.phpPoniżej komentarza umieszczonego na początku tekstu, dodaj następujący kod:

// 在文章内容后添加自定义文本
function myfp_add_footer_text( $content ) {
    // 确保只在主循环的单篇文章页面添加
    if ( is_single() && in_the_loop() && is_main_query() ) {
        $footer_text = '<p><em>Dziękuję za przeczytanie tego artykułu. Prezentujemy go dzięki uprzejmości “Mojego pierwszego wtyczki”.</em></p>';
        $content .= $footer_text;
    }
    return $content;
}
add_filter( 'the_content', 'myfp_add_footer_text' );

Ten kod definiuje funkcję.myfp_add_footer_textPrzyjmuje treść artykułu.$contentJako parametry. Wewnątrz funkcji są używane warunkowe tagi.is_single()It is necessary to make judgments based on certain criteria to ensure that the text is added only to the page of a single article. Finally, use…add_filter()Funkcja umożliwia montaż naszej własnej funkcji na odpowiedniej pozycji w systemie.the_contentNa tym filtrze, po zapisaniu pliku i sprawdzeniu dowolnego artykułu, zobaczysz, że dodany tekst pojawił się na dole strony.

Dodróżowanie najlepszych praktyk rozwoju pluginów dla WordPress

Upewnij się, że kod jest bezpieczny i dane są prawidłowo sprawdzane.

Gdy obsługujesz dane wprowadzane przez użytkowników lub wyświetlające się w pluginie, bezpieczeństwo jest najważniejszym kryterium. WordPress oferuje wiele funkcji, które pomagają programistom w walidacji danych, ich escape’owaniu oraz czyszczeniu. Zawsze unikaj bezpośredniego używania tych funkcji.$_GET、$_POST或$_REQUESTZmienne w tekście.

Polecamy lekturę. Dokładny przegląd rozwoju pluginów dla WordPress: budowanie własnych funkcji od zera。

Na przykład, jeśli chcesz uzyskać ID z parametrów URL i użyć go w zapytaniu do bazy danych, należy postąpić w następujący sposób:

// 安全地获取并验证一个URL整数参数
$item_id = isset( $_GET['id'] ) ? absint( $_GET['id'] ) : 0;
if ( $item_id > 0 ) {
    // 使用 $item_id 进行安全查询
    global $wpdb;
    $query = $wpdb->prepare( "SELECT * FROM {$wpdb->prefix}my_table WHERE id = %d", $item_id );
    $result = $wpdb->get_row( $query );
}

Tutaj,absint()Funkcja przymusowo konwertuje wejście na nieujemny całkowity liczbowy typ.$wpdb->prepare()Metody te są przeznaczone do bezpiecznego przygotowania zdań SQL, aby zapobiec atakom typu SQL injection. W przypadku wszystkich dynamicznych danych, które są wyświetlane na stronach HTML, należy je używać.esc_html()、esc_attr()或wp_kses_post()Funkcje takie jak escape są używane do przekształcenia specjalnych znaków w zwykłe znaki, aby można było bez problemów przetwarzać dane.

Rozwijanie funkcji tłumaczeń oraz wsparcia dla różnych języków (internacjonalizacja)

Aby twoje wtyczki były dostępne dla użytkowników z całego świata, konieczna jest ich internacjonalizacja (ang. internationalization, lub skrótowo i18n). To oznacza, że wszystkie teksty przeznaczone dla użytkowników muszą zostać przygotowane z użyciem funkcji tłumaczeniowych dostępnych w WordPress.

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

Zmodyfikuj kod, w którym wcześniej dodano tekst, aby obsługiwał tłumaczenie.

function myfp_add_footer_text( $content ) {
    if ( is_single() && in_the_loop() && is_main_query() ) {
        // 使用 __() 函数使字符串可翻译
        $footer_text = sprintf(
            '<p><em>%s</em></p>',
            esc_html__( '感谢阅读本文，由“我的第一个插件”为您呈现。', 'my-first-plugin' )
        );
        $content .= $footer_text;
    }
    return $content;
}

My używamy…esc_html__( ‘字符串’, ‘text-domain’ )„To jest tekst do opakowania. W nim…”my-first-pluginTekst jest definiowany w nagłówku wtyczki („Text Domain”), co zapewnia niezależność tłumaczeń. Następnie tłumacz może go użyć..potPlik zawiera różne wersje twojego pluginu w różnych językach..moTłumacz dokumentów.

Pisanie kodu łatwego w utrzymaniu a użycie programowania obiektowego.

Dla prostych wtyczek może wystarczyć programowanie proceduralne. Jednak w przypadku wtyczek złożonych wdrożenie programowania obiektowego (OOP) pozwala lepiej zorganizować kod, poprawić jego czytelność i łatwość utrzymania.

Polecamy lekturę. Kompletny przewodnik po tworzeniu wtyczek do WordPressa: od podstaw do tworzenia niestandardowych funkcji w praktyce.。

Poniżej jest przykład rekonstrukcji naszego pluginu z użyciem klas:

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

/**
     * 加载插件文本域用于国际化
     */
    public function load_textdomain() {
        load_plugin_textdomain( 'my-first-plugin', false, dirname( plugin_basename( __FILE__ ) ) . '/languages' );
    }

/**
     * 在文章内容后添加文本
     */
    public function add_footer_to_content( $content ) {
        if ( is_single() && in_the_loop() && is_main_query() ) {
            $footer_text = sprintf(
                '<p><em>%s</em></p>',
                esc_html__( '感谢阅读本文，由“我的第一个插件”为您呈现。', 'my-first-plugin' )
            );
            $content .= $footer_text;
        }
        return $content;
    }
}

// 初始化插件类
new My_First_Plugin();

Poprzez pakowanie funkcji…My_First_PluginW klasach struktura kodu jest bardziej jasna, unikaje zanieczyszczenia globalnego przestrzeni nazw funkcjami, a także ułatwia rozszerzanie funkcjonalności.

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

Dodać interfejs administracyjny i opcje konfiguracji dla pluginu

Tworzenie menu zarządzania oraz strony z opcjami

Wiele wtyczek wymaga dostarczenia użytkownikom opcji konfiguracji. WordPress oferuje API, które umożliwia dodawanie menu i podmenu w tle aplikacji. Zaleca się jego używanie.add_options_page()Funkcja dodaje stronę ustawień pluginu do głównego menu “Ustawienia”, co jest zgodne z wymaganiami doświadczenia użytkownika w WordPress.

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

public function add_admin_menu() {
        add_options_page(
            '我的插件设置',          // 页面标题
            '我的第一个插件',        // 菜单标题
            'manage_options',       // 所需权限
            'myfp-settings',        // 菜单slug
            array( $this, 'render_settings_page' ) // 回调函数
        );
    }

public function register_settings() {
        register_setting( 'myfp_settings_group', 'myfp_footer_text' );
        add_settings_section( 'myfp_main_section', '主要设置', null, 'myfp-settings' );
        add_settings_field( 'myfp_text_field', '页脚文本', array( $this, 'render_text_field' ), 'myfp-settings', 'myfp_main_section' );
    }

public function render_text_field() {
        $value = get_option( 'myfp_footer_text', '默认的感谢文本。' );
        echo '<input type="text" name="myfp_footer_text" value="' . esc_attr( $value ) . '" class="regular-text" />';
    }

public function render_settings_page() {
        ?&gt;
        <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( 'myfp_settings_group' );
                do_settings_sections( 'myfp-settings' );
                submit_button();
                ?>
            <input type="hidden" name="trp-form-language" value="pl"/></form>
        </div>
        &lt;?php
    }
}

// 仅在管理后台加载管理类
if ( is_admin() ) {
    new My_First_Plugin_Admin();
}

Umożliwienie powiązania funkcji wtyczki z opcjami ustawień

Po stworzeniu strony konfiguracji musimy zmienić funkcje frontendu, aby używały wartości opcji zapisanych przez użytkownika, zamiast tekstów ustawionych w kodzie źródłowym.

Przed aktualizacjąMy_First_Pluginw klasieadd_footer_to_contentMetoda:

public function add_footer_to_content( $content ) {
    if ( is_single() && in_the_loop() && is_main_query() ) {
        // 从数据库选项获取用户自定义的文本，如果不存在则使用默认翻译
        $saved_text = get_option( 'myfp_footer_text' );
        $footer_text = ! empty( $saved_text ) ? esc_html( $saved_text ) : esc_html__( '感谢阅读本文，由“我的第一个插件”为您呈现。', 'my-first-plugin' );

$content .= sprintf( '<p><em>%s</em></p>', $footer_text );
    }
    return $content;
}

Teraz tekst umieszczone w nagłówku pluginu można dostosować za pomocą strony konfiguracji w backendzie, co umożliwia oddzielenie funkcji od ich ustawień i znacząco zwiększa elastyczność pluginu.

Podsumowanie.

Rozwoj pluginów dla WordPressu polega na zrozumieniu podstawowej architektury systemu, a potem na dalszym pogłębianiu się w tematy związane z bezpieczeństwem, internationalizacją, organizacją kodu oraz interakcją z użytkownikami. Kluczowym elementem jest stosowanie standardów programowania WordPressa oraz najlepszych praktyk stosowanych w jego społeczności – w tym wykorzystanie dostępnych mechanizmów (takich jak „hooki” – Actions i Filters), zabezpieczenie danych, obsługa wielu języków oraz tworzenie jasnego interfejsu administracyjnego. Można nauczyć się całego procesu rozwoju pluginów, zaczynając od stworzenia prostego modułu z jedną funkcją, po dalsze dodawanie opcji konfiguracji oraz przekształcenie kodu na struktury obiektowe. Pamiętaj, że dobry plugin to nie tylko ten, który funkcjonuje poprawnie, ale także taki, który jest bezpieczny, wydajny w obsłudze i przyjazny pod kątem internationalizacji.

FAQ – najczęściej zadawane pytania.

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

Konieczne jest posiadanie solidnych umiejętności programowania w PHP, ponieważ większość pluginów jest pisana w tym języku. Ponadto należy mieć podstawową znajomość HTML, CSS i JavaScript, które są niezbędne do tworzenia interfejsów użytkownika i realizacji interakcji. Rozumienie podstawowych zasad działania WordPress, takich jak tematy, typy artykułów, kategorie, metadane, a także mechanizmy hooków (akcje i filtry), jest kluczowe dla skutecznego rozwoju pluginów. Dobrze znajomość operacji z bazą danych MySQL również pomaga przy obsłudze złożonych danych.

Jak debugować dodatek do WordPressa, który jest w fazie rozwoju?

Najpierw upewnij się, że nawp-config.phpUwolniono 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.logW pliku należy uniknąć wyświetlania błędnych informacji bezpośrednio użytkownikowi. Ponadto można z tego skorzystać…error_log()Funkcja wyświetla informacje diagnostyczne w ustalonym formacie do tego samego pliku logów. Aby sprawdzić wartości zmiennych, używa się…print_r()或var_dump()Funkcja, w połączeniu z…echo ‘’;Wykonuj formatowanie tylko w środowisku rozwojowym. Ponadto używaj paneli Console i Network w narzędziach developerskich przeglądarki (F12) do debugowania kodu JavaScript oraz żądań AJAX.

Jak moja wtyczka może interagować z usługami lub API zewnętrznych dostawców?

Interakcja z APIami stron trzecich jest powszechnym sposobem na rozszerzenie funkcjonalności wtyczek. W WordPressie zaleca się używać wewnętrznej API HTTP.wp_remote_get()， wp_remote_post()Aby wysłać żądanie, należy użyć protokołu HTTPS, ponieważ zajmuje się kwestiami kompatybilności, czasu wykonywania operacji oraz bezpieczeństwa. Podczas przesyłania danych poufnych konieczne jest używanie protokołu HTTPS. Od odpowiedzi API otrzymanej w wyniku żądania zwykle konieczne jestdekodowanie jej w formacie JSON (z użyciem odpowiednich narzędzi lub bibliotek).json_decode()Można używać danych w formacie JSON lub XML, a także należy dobrze obsługiwać przypadki błędów – na przykład sprawdzać kod stanu HTTP oraz kody błędów powrotne od API. Zaleca się przechowywać pouzdane informacje, takie jak klucze API, w ustawieniach pluginu, a nie wklecać je bezpośrednio do plików.

Jak złożyć moje bezpłatne dodatko do oficjalnego katalogu dodatków WordPress?

Najpierw upewnij się, że twoje wtyczki w pełni spełniają wymogi licencji GPL, że ich kod jest wysokiej jakości i że nie zawierają żadnych złośliwych elementów ani linków promocyjnych. Utworź konto na stronie WordPress.org, a potem odwiedź sekcję “Programiści” i złoż swoje wtyczki. Musisz dostarczyć stabilny plik kompresowany w formacie ZIP, zawierający standardowe informacje o wtyczce, a także…readme.txtPlik zawierający opis pluginu w określonym formacie, a także opcjonalne zdjęcia ekranu (screenty) i ikony. Po złożeniu pliku zapisu komanda odpowiedzialna za audyt pluginów przeprowadzi sprawdzenie, która może potrwać kilka tygodni. Po pozytywnym wyniku audytu otrzymasz oficjalny repozytorium SVN, w którym będzie przechowywany kod twojego pluginu. Używcy będą mogli go wyszukać i instalować bezpośrednio z interfejsu administracyjnego WordPress.