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

Czemu warto wybrać rozwój pluginów dla WordPress?

WordPress, jako najpopularniejszy na świecie system do zarządzania treścią, dzięki swej wielkiej rozszerzalności jest w stanie dostosować się do różnych potrzeb użytkowników. Można rozwijać własne pluginy, które umożliwiają dodawanie unikalnych funkcji do platformy bez konieczności modyfikacji plików tematycznych. Dzięki temu Twoje funkcje nie giną po aktualizacji tematów, a same moduły są łatwe do powtórnego użycia na innych stronach internetowych.

Uczenie się tworzenia pluginów nie tylko umożliwia tworzenie produktów, które mogą być używane przez innych, ale także daje lepsze zrozumienie sposobu działania WordPressa, w tym jego systemu hooków, interakcji z bazą danych oraz najlepszych praktyk bezpieczeństwa. To kluczowy krok na drodze od zwykłego użytkownika do doświadczonego programisty.

Stworzenie swojego pierwszego pluginu

Przed rozpoczęciem pisania kodu konieczne jest uruchomienie standardowego środowiska WordPress na lokalnym komputerze lub na serwerze testowym. To podstawa wszystkich prac rozwojowych.

Polecamy lekturę. Naucz się tworzyć wtyczki do WordPressa od podstaw: stwórz swoją pierwszą niestandardową funkcję.。

Tworzenie głównego pliku pluginu

Każdy plugin WordPress musi mieć plik główny, który zwykle nosi nazwę pluginu. Utworzymy plik o nazwie…my-first-pluginDodatków. Najpierw, w katalogu zainstalowanego WordPressa należy…/wp-content/plugins/W folderze utwórz nowy folder o nazwie…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

W tym folderze utwórz plik o nazwiemy-first-plugin.phpTo plik w języku PHP, który stanowi wejście do twojego pluginu. Otwórz go i dodaj następujące komentarze na początku pliku – te informacje są kluczowe dla rozpoznania twojego pluginu przez WordPress.

<?php
/**
 * Plugin Name:       我的第一个插件
 * Plugin URI:        https://yourwebsite.com/my-first-plugin
 * Description:       这是一个学习WordPress插件开发的示例插件，用于在文章底部添加自定义内容。
 * Version:           1.0.0
 * Author:            你的名字
 * Author URI:        https://yourwebsite.com
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 * Domain Path:       /languages
 */

Rozwinięcie pierwszej prostej funkcji

Klasyczna funkcja dla początkujących to automatyczne dodawanie tekstu na dno wszystkich artykułów na stronie internetowej. Będziemy używać tego w WordPress. the_content Realizuj to za pomocą „hooków filtrów”. Pod komentarzem na początku twojego głównego pliku dodaj następującą funkcję:

// 防止直接访问文件
if ( ! defined( 'ABSPATH' ) ) {
    exit;
}

/**
 * 在文章内容末尾添加自定义文本
 *
 * @param string $content 原始的文章内容。
 * @return string 修改后的文章内容。
 */
function mfp_add_footer_text( $content ) {
    // 判断是否是主循环且在单篇文章页面
    if ( is_single() && in_the_loop() && is_main_query() ) {
        $custom_text = '<div class="mfp-footer-note"><p><em>Dziękujemy za czytanie! Ten tekst został przygotowany dla Ciebie przez “Moje pierwsze dodatki” („My First Plugins”).</em></p></div>';
        return $content . $custom_text;
    }
    return $content;
}
// 将函数挂载到 `the_content` 过滤器上
add_filter( 'the_content', 'mfp_add_footer_text' );

Ten kod definiuje funkcję. mfp_add_footer_textPrzyjmuje treść artykułu. $content Jako parametr funkcja najpierw sprawdza, czy obecna sytuacja dotyczy strony pojednego artykułu, głównego cyklu lub głównego zapytania. Celem jest uniknięcie dodawania tekstu w opisach artykułów, wtyczkach (widgets) lub innych miejscach. Jeśli warunki są spełnione, funkcja tworzy segment tekstu w formacie HTML i dodaje go na końcówkę oryginalnego zawartości.

Dokładne poznanie architektury i zabezpieczeń wtyczek

Wraz z rosnącą liczba funkcji wtyczek istotna staje się dobrza organizacja kodu. Ponadto bezpieczeństwo to kluczowy element w każdym projekcie rozwoju na platformie WordPress.

Polecamy lekturę. Opanowanie rozwoju wtyczek dla WordPress: stworzenie swojego pierwszego modułu rozszerzającego od zera。

Zrekonstruuj kod z użyciem programowania obiektowego.

Aby poprawić łatwość utrzymania i rozszerzalność kodu, zaleca się organizację pluginów za pomocą podejścia obiektowego (OOP – Object-Oriented Programming). Ponieważ funkcje opisane powyżej były zbyt złożone, przebudujemy je w formie klas.

// 防止直接访问文件
if ( ! defined( 'ABSPATH' ) ) {
    exit;
}

class My_First_Plugin {
    /**
     * 构造函数，初始化插件钩子。
     */
    public function __construct() {
        // 在构造方法中将方法挂载到钩子上
        add_action( 'init', array( $this, 'load_textdomain' ) );
        add_filter( 'the_content', array( $this, 'add_footer_to_content' ) );
        add_action( 'wp_enqueue_scripts', array( $this, 'enqueue_styles' ) );
    }

/**
     * 加载插件的文本翻译域。
     */
    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() ) {
            $custom_text = '<div class="mfp-footer-note"><p><em>' . esc_html__( '感谢阅读！本文由“我的第一个插件”为您呈现。', 'my-first-plugin' ) . '</em></p></div>';
            return $content . $custom_text;
        }
        return $content;
    }

/**
     * 为插件添加样式。
     */
    public function enqueue_styles() {
        wp_enqueue_style( 'mfp-style', plugins_url( 'assets/css/style.css', __FILE__ ), array(), '1.0.0' );
    }
}

// 实例化插件类
$my_first_plugin_instance = new My_First_Plugin();

Proszę zauważyć, że… add_footer_to_content Metoda wykorzystuje… esc_html__() Funkcja służy do otulania tekstu w specjalne „opakowanie”. Jest to funkcja tłumaczeniowa, która jednocześnie dokonuje odpowiedniego escapeowania wyświetlanego tekstu – co stanowi najlepszą praktykę przy bezpiecznym wyświetlaniu informacji. Dodaliśmy również metodę do ładowania arkuszy stylu (style sheets) oraz wsparcie dla pola tekstowego, co przygotowuje platformę do implementacji funkcji internacionalizacji (i18n) w pluginach.

Zrozumienie i wdrożenie walidacji oraz unikania szkodliwych treści w danych.

Nigdy nie ufaj wprowadzonym przez użytkowników danym ani żadnym innym zewnętrznym informacjom. Podczas odbierania, przetwarzania i wyświetlania danych konieczne jest ich sprawdzenie, przygotowanie (np. usunięcie niepotrzebnych znaków) oraz odpowiednie zabezpieczenie (np. użycie specjalnych znaków escape). Na przykład, jeśli chcesz stworzyć stronę administracyjną z formularzami do wprowadzania danych, koniecznie używaj funkcji dostępnych w WordPress, które sprawdzają uprawnienia użytkowników oraz walidują wprowadzone informacje.

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

Funkcje tego pluginu są względnie proste, ale przy generowaniu pliku HTML już je wykorzystaliśmy. esc_html__() Konieczne jest wykonywanie escapeowania. Jeśli plugin musi obsługiwać dane podane przez użytkownika, na przykład poprzez formularz, to należy użyć odpowiednich metod escapeowania, aby uniknąć problemów z interpretacją tych danych. sanitize_text_field(), wp_kses_post() Wykonaj czyszczenie funkcji typu „wait” i użyj innych odpowiednich narzędzi. wp_verify_nonce() Aby sprawdzić legalność żądania.

Stworzenie strony do zarządzania pluginami

Dojrzały plugin zwykle wymaga strony konfiguracji w backendzie. Nauczymy się, jak używać API ustawień WordPress, aby stworzyć prostą i standardową stronę zarządzania.

Dodać menu ustawień pluginów

Najpierw musimy dodać nową stronę z menu podmenu w panelu ustawień w WordPress. Dodaj nową metodę do twojej klasy i w konstruktorze uruchom jej wykonanie. add_action('admin_menu', ...) Hak wywołuje je.

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

/**
 * 注册插件管理页面。
 */
public function register_admin_menu() {
    add_options_page(
        __( '我的插件设置', 'my-first-plugin' ), // 页面标题
        __( '我的第一个插件', 'my-first-plugin' ), // 菜单标题
        'manage_options', // 所需权限
        'mfp-settings', // 菜单slug
        array( $this, 'display_settings_page' ) // 显示页面的回调函数
    );
}

A potem dodaj to do konstruktora:add_action( 'admin_menu', array( $this, 'register_admin_menu' ) );。

Tworzenie strony konfiguracji i polów

Następnie musimy to definiować. display_settings_page Metoda służy do renderowania zawartości HTML strony konfiguracji oraz do rejestracji pola konfiguracji za pomocą API konfiguracji.

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 display_settings_page() {
    ?>
    <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
            // 输出设置字段、非ce等安全字段
            settings_fields( 'mfp_settings_group' );
            do_settings_sections( 'mfp-settings' );
            submit_button();
            ?>
        <input type="hidden" name="trp-form-language" value="pl"/></form>
    </div>
    <?php
}

/**
 * 初始化插件设置。
 */
public function initialize_settings() {
    // 注册一个设置
    register_setting(
        'mfp_settings_group', // 设置组名
        'mfp_footer_text', // 选项名
        array(
            'type' => 'string',
            'sanitize_callback' =&gt; 'sanitize_text_field', // 清理回调函数
            'default' =&gt; __( '感谢阅读！本文由“我的第一个插件”为您呈现。', 'my-first-plugin' ),
        )
    );

// 添加一个设置区域
    add_settings_section(
        'mfp_main_section',
        __( '主要设置', 'my-first-plugin' ),
        null, // 可选的区域描述回调函数
        'mfp-settings'
    );

// 向区域中添加字段
    add_settings_field(
        'mfp_footer_field',
        __( '页脚文本', 'my-first-plugin' ),
        array( $this, 'render_footer_field' ), // 渲染字段的回调函数
        'mfp-settings',
        'mfp_main_section',
        array( 'label_for' =&gt; 'mfp_footer_text' )
    );
}

Musisz to zdefiniować. render_footer_field Metody do renderowania rzeczywistych polów wpisywania oraz aktualizacji wcześniejszych wyników. add_footer_to_content Metody, aby zrealizować to z opcjami bazy danych get_option('mfp_footer_text') Czytaj tekst z pliku, zamiast używać stałych, ustawionych wcześniej stringów. Na koniec, dodaj to do konstruktora:add_action( 'admin_init', array( $this, 'initialize_settings' ) );。

Podsumowanie.

Podczas tej „podróży” poprzez tekst ten zbudowałeś od zera pełnowartościowy plugin dla WordPressa. Nauczyłeś się, jak tworzyć podstawową strukturę pluginu, jak używać akcji i hooków filtrów do rozszerzania funkcji WordPressa, jak organizować kod w sposób obiektowy dla poprawienia jego jakości, jak stosować zasady bezpieczeństwa przy walidacji i escape’owaniu danych, a także jak wykorzystywać API ustawień WordPressa do stworzenia profesjonalnego interfejsu administracyjnego.

Podstawa rozwoju pluginów polega na zrozumieniu systemu „hooków” i przepływu danych w WordPress. Konsekwentnie się szlifuj, zaczynając od prostych funkcji, po czym stopniowo zwiększaj ich złożoność, a bezwzględnie trzymaj się zasad bezpieczeństwa, wydajności i łatwości konserwacji. Z upływem czasu i dzięki zdobytemu doświadczeniu będziesz mogąć tworzyć mocne, profesjonalne i popularne pluginy dla WordPress.

FAQ – najczęściej zadawane pytania.

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

Konieczne jest, abyś posiadł solidne znajomości programowania w PHP, ponieważ większość pluginów jest pisana w tym języku. Ponadto istotne jest też posiadanie podstawowych znań HTML, CSS i JavaScript, aby móc pracować z wyglądem i interakcją na stronie internetowej. Najważniejsze jest jednak zapoznanie się z core’owymi konceptami WordPressa, takimi jak „haki” (akcje i filtry), cykły, struktura szablonów oraz operacje z bazą danych (za pomocą klas np. WP_Query i WP_User_Query).

Jak debugować i testować moje wtyczki (plugi)?

Najpierw gorąco zalecam rozwijać aplikację w lokalnym środowisku rozwoju (np. Local by Flywheel, XAMPP) lub na testowym serwerze online, aby uniknąć wpływu na witrynę w produkcji. Uwolnij tryb debugowania w WordPressie i…wp-config.phpUstawienia w plikudefine( 'WP_DEBUG', true );To umożliwi wyświetlenie błędów i ostrzeżeń PHP na ekranie.error_log()Funkcja zapisała informacje o debugowaniu do logu błędów na serwerze. Dla bardziej złożonych procedur debugowania można zastanowić się nad użyciem profesjonalnych narzędzi, takich jak Query Monitor lub Debug Bar.

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

Podczas rozwoju należy zwracać uwagę na informacje zawarte w oficjalnych dokumentach WordPress dotyczące wycofanych funkcji. Unikaj używania funkcji, które zostały oznaczone jako “wycofane”. W pliku głównym pluginu można to zrobić poprzez…Requires at least和Tested up toInformacje w nagłówku powinny wskazywać, z jaką wersją WordPressu twoja wtyczka jest kompatybilna. Regularnie testuj swoją wtyczkę na nowszych wersjach WordPressu oraz monitoruj logi aktualizacji jądra systemu, aby w czasie potrzeby móc dostosować kod.

Jak opublikować moją wtyczkę w oficjalnym katalogu wtyczek WordPress?

Najpierw musisz upewnić się, że twoje wtyczki są w pełni zgodne z oficjalnymi normami rozwoju wtyczek oraz instrukcjami dotyczącymi ich publikacji. To obejmuje jakość kodu, bezpieczeństwo, a także wybrany licencjny protokol (musi to być GPL w wersji 2 lub wyższej). Następnie należy zarejestrować repozytorium SVN na stronie WordPress.org i przesłać kod swojej wtyczki do tego repozytorium.trunkZnajduje się w katalogu, a także został stworzony odpowiedni element.readme.txtPlik w określonym formacie. Po przyznaniu twojego pliku jako spełniającego wymogi, twoje wtyczka pojawi się w oficjalnym katalogu.