Strona główna/Wiedza/WordPress/Szczegóły dotyczące treści

Rozwój pluginów dla WordPress: pełny przewodnik od poznania podstaw do osiągnięcia biegłości w tworzeniu własnych funkcji

2 minuty czytania
2026-03-15
2026-06-03
2,064
Zarabiam prowizję, gdy robisz zakupy poprzez poniższe linki, bez żadnych dodatkowych kosztów dla Ciebie.

Ustawienie środowiska do rozwoju pluginów dla WordPress

Przed rozpoczęciem pisania kodu kluczowym jest stabilne i wydajne środowisko rozwoju. To nie tylko poprawia efektywność pracy, ale także gwarantuje kompatybilność pluginów w różnych środowiskach. Najpierw należy uruchomić środowisko WordPress na swoim lokalnym komputerze. Zaleca się używać zintegrowanych pakietów do obsługi lokalnego serwera, takich jak XAMPP, MAMP lub Local by Flywheel, które umożliwiają jednorazową instalację Apache, MySQL i PHP.

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. Upewnij się, że twoja wersja PHP jest zgodna z wymaganiami środowiska WordPress; zwykle producenci WordPress rekomendują stabilną wersję PHP.

Podstawowym przygotowaniem do rozwoju jest stworzenie podstawowej struktury pluginu. W katalogu instalacji WordPress należy…wp-content/pluginsW folderze utwórz nowy folder specjalny dla swojego pluginu, na przykład:my-first-pluginW tym folderze musisz stworzyć plik z głównym pluginem, który zwykle nosi nazwę pluginu.my-first-plugin.phpTen plik stanowi punkt wejścia do Twojego pluginu, a informacje umieszczone w komentarzach na jego początku są niezbyt ważne. WordPress korzysta z tych danych, by rozpoznać i wyświetlić Twój plugin.

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

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

Ten komentarz definiuje informacje, które będą wyświetlone w interfejsie administracyjnym WordPressa dotyczące włączonego pluginu. Po ukończeniu tego kroku będzieś mógł zobaczyć swój plugin na stronie “Pluginy” w panelu administracyjnym WordPressa i aktywować go, chociaż na razie nie będzie mieć żadnych funkcji.

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.
LOGO UltaHost strona dostępu

Zrozumienie kluczowych zasad działania pluginów w WordPressie

Silna strona WordPressa polega na jego wyjątkowo rozszerzalnej architekturze, która jest realizowana przede wszystkim za pomocą mechanizmu zwanych “hookami” (hooks). Zrozumienie funkcji hooków jest kluczowe do skutecznego rozwoju dodatków (pluginów). Hooki dzielą się na dwa głównego typy: hooki akcji (Action Hooks) i hooki filtrów (Filter Hooks).

Aktywnie działające “haki” (ang. action hooks) umożliwiają wstawienie i wykonywanie własnego kodu w określonych momencach. Na przykład, gdy publikuje się artykuł lub użytkownik odwiedza główną stronę witryny, WordPress uruchomi odpowiednie aktywnie działające haki. Możesz je wykorzystać do realizacji różnych zadań, np. automatycznego wysyłania wiadomości, aktualizowania danych na stronie itd.add_action()Funkcja umożliwia “przypięcie” Twojej własnej funkcji do tych „haków” (hooków).

function my_custom_function() {
    // 你的代码逻辑
}
add_action( 'wp_head', 'my_custom_function' );

Wyszczęty kod zostanie umieszczony na stronie internetowej.<head>Częściowe wykonaniemy_custom_functionFunkcja.

Filtry hooki są przeznaczone do modyfikacji danych. Pozwalają ci na ich edycję przed tym, jak zostaną użyte – na przykład zapisane do bazy danych lub wyświetlone na stronie. Możesz je wykorzystać według potrzeb.add_filter()Funkcja służy do aplikowania filtrów. Funkcja filtru musi przyjąć wejściowe wartości i zwrócić zmienione wartości.

Polecamy lekturę. Praktyczny kurs dla początkujących: krok po kroku nauczymy Cię tworzyć wtyczki do WordPressa.。

function modify_content( $content ) {
    $new_content = $content . “<p>Ten tekst został dodany przez moje wtyczki (pluginy).</p>”;
    return $new_content;
}
add_filter( 'the_content', 'modify_content' );

Ten kod dodaje tekst wybrany przez użytkownika na końcu każdego artykułu.

Kolejnym kluczowym mechanizmem jest shortcode (skrótowy kod). Shortcode umożliwia użytkownikom wykonywanie różnych działań za pomocą prostych znaków lub tagów.[my_shortcode]W artykule lub na stronie można włączyć dynamiczny zawór. Do tego można użyć różnych technik, np. JavaScriptu lub HTML5.add_shortcode()Funkcja służy do rejestracji funkcji obsługującej krótkie kody (shortcodes).

Stworzenie kompletnego przykładu pliku rozszerzającego (pluginu)

Teraz połączmy powyżej opisane informacje, aby stworzyć prosty plugin do wyliczania czasu potrzebnego na przeczytanie artykułu. Ten plugin automatycznie obliczy czas potrzebny do przeczytania tekstu i wyświetli go przed samym treścią.

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%
hosting.com LOGO strona dostępu

Najpierw, w głównym pliku pluginu, tworzymy funkcję do obliczenia czasu potrzebnego na przeczytanie tekstu. Założymy, że średnia szybkość czytania wynosi 200 słów na minutę.

function calculate_reading_time( $content ) {
    // 去除HTML标签，只计算纯文字
    $text = strip_tags( $content );
    // 计算单词数
    $word_count = str_word_count( $text );
    // 计算阅读分钟数（向上取整）
    $reading_time = ceil( $word_count / 200 );

// 创建显示信息
    $reading_time_html = ‘<div class="“reading-time”">Oczekiwany czas czytania: ’ . $reading_time . ‘ minut</div>’;

// 将阅读时间信息附加到文章内容之前
    return $reading_time_html . $content;
}
// 使用过滤器将函数应用到文章内容
add_filter( ‘the_content’, ‘calculate_reading_time’ );

Jednak nie chcemy, aby czas odczytania tekstu był wyświetlany we wszystkich miejscach (np. w opisach artykułów, na źródłach RSS). Możemy to zoptymalizować poprzez dodanie warunków decydujących o tym, w których przypadkach ten czas ma być wyświetlany.

function calculate_reading_time( $content ) {
    // 仅在主循环的单篇文章页面显示
    if ( is_single() &amp;&amp; in_the_loop() &amp;&amp; is_main_query() ) {
        $text = strip_tags( $content );
        $word_count = str_word_count( $text );
        $reading_time = ceil( $word_count / 200 );

$reading_time_html = ‘<div class="“reading-time”"><strong>📖 Czas czytania:</strong>Ponad 1 minut.</div>’;
        return $reading_time_html . $content;
    }
    // 如果不是单篇文章，返回原内容
    return $content;
}
add_filter( ‘the_content’, ‘calculate_reading_time’ );

Aby styl wyglądał ładniej, możemy dodać jeszcze trochę CSS. Możemy to zrobić…wp_enqueue_style()Funkcja służy do bezpiecznego ładowania plików z definicjami stylów. Najpierw należy stworzyć taką plikę w folderze z pluginami.style.cssPierw otwierasz plik, a potem za pomocą „hooków akcji” dodajesz go do kolejki.

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

function my_plugin_styles() {
    wp_enqueue_style(
        ‘my-plugin-style’,
        plugin_dir_url( __FILE__ ) . ‘style.css’,
        array(),
        ‘1.0.0’
    );
}
add_action( ‘wp_enqueue_scripts’, ‘my_plugin_styles’ );

Najlepsze praktyki internacionalizacji i bezpieczeństwa w przypadku dodatków (plug-inów)

Profesjonalny plugin przeznaczony dla użytkowników z całego świata musi obsługiwać funkcję internationalizacji (i18n), aby mógł zostać przetłumaczony na inne języki. Aby to osiągnąć, konieczne jest wykorzystanie funkcji dostępnych w WordPress. Najpierw należy poprawnie ustawić odpowiednie informacje w komentarzach na początku pliku pluginu.Text DomainJak ustaliliśmy wcześniej…my-first-plugin。

W kodzie należy używać tych zasad dla wszystkich tekstów, które wymagają tłumaczenia.()、_e()或esc_html()Funkcje takie jak „wait” są pakowane w specjalne obiekty lub klasy, aby ułatwić ich używanie i zabezpieczyć ich interoperacyjność z innymi elementami systemu.

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.
LOGO InterServer strona dostępu 
$reading_time_html = ‘<div class="“reading-time”"><strong>’
    . esc_html__( ‘📖 Reading Time:’, ‘my-first-plugin’ )
    . ‘</strong>’
    . sprintf(
        esc_html__( ‘about %d minutes’, ‘my-first-plugin’ ),
        $reading_time
    )
    . ‘</div>’;

Następnie należy użyć narzędzia (np. Poedit) do generowania wymaganych plików..potPliki szablonów – na ich podstawie można tworzyć kolejne elementy strony internetowej..po和.moTe pliki powinny zostać umieszczone w folderze z pluginami.languagesW folderze.

Bezpieczeństwo to kluczowy element w rozwoju dodatków (plug-inów). Konieczne jest stosowanie następujących zasad bezpieczeństwa:
1. 数据验证：对所有来自用户或外部来源的输入数据进行严格检查。使用函数如sanitize_text_field()、absint()Pojedźmy i przygotujmy dane do dalszego wykorzystania.
2. 数据转义：在将任何数据输出到HTML、JavaScript或URL之前，必须进行转义。使用esc_html()、esc_attr()、esc_url()和wp_kses_post()Funkcje takie jak…
3. 非ce验证：对于涉及数据更改（如表单提交、AJAX请求）的操作，必须使用wp_nonce(Cyfrowy token jednorazowego użycia) służy do weryfikacji legalności i intencji żądania, aby zapobiec atakom typu CSRF.
4. 能力检查：在执行管理操作前，使用current_user_can()Funkcja sprawdza, czy aktualny użytkownik posiada wystarczające upoważnienia (np. do wykonywania danej operacji).‘manage_options’）。

Podsumowanie.

Rozwoj pluginów dla WordPress polega na przekształceniu kreatywnych idei w funkcjonalne rozwiązania, a kluczowym elementem tego procesu jest głębokie zrozumienie i wykorzystanie mechanizmu hooków. Po przygotowaniu środowiska i stworzeniu podstawowych plików można zaawansować do interakcji z core’em WordPressa za pomocą akcji (actions) i filtrów (filters), tworząc w ten sposób użyteczne moduły funkcjonalne. Dobrej jakości plugin musi mieć kompletną funkcjonalność, a także spełniać wysokie standardy internacjonalizacji i bezpieczeństwa, aby był stabilny, bezpieczny i dostępny dla użytkowników z całego świata. Poprzez ciągłe ćwiczenia i naukę możesz przechodzić od tworzenia prostych pluginów do budowy złożonych, komercyjnych rozszerzeń dla WordPressa.

FAQ – najczęściej zadawane pytania.

Czy do tworzenia wtyczek WordPressowych konieczna jest biegła znajomość PHP?

Tak, doskonałe znajomości PHP są podstawą do tworzenia dodatków (pluginów) dla WordPress. Samo serce WordPress jest napisane w PHP, a logika wszystkich dodatków i tematów (templates) bazuje na tym języku programowania. Musisz znać gramatykę PHP, funkcje, programowanie obiektowe oraz sposoby interakcji z bazą danych MySQL. Ponadto dobrze zrozumienie HTML, CSS i JavaScript jest niezbędne do tworzenia interaktywnych elementów na stronie internetowej.

Jak debugować plugin WordPress, który sam napisałem?

WordPress oferuje wiele narzędzi do debugowania. Najpierw możesz…wp-config.phpWłącz tryb debugowania w pliku.WP_DEBUGKonstanta ustawiona jest na…trueTo wyświetli błędy, ostrzeżenia i powiadomienia PHP na stronie. Do bardziej złożonego debugowania można użyć…error_log()Funkcja zapisuje informacje do logu błędów na serwerze lub wykorzystuje profesjonalne narzędzia do debugowania, takie jak Query Monitor, aby uzyskać szczegóły dotyczące zapytań do bazy danych, wykonywania hooków, ładowania skryptów itd.

Jak mogę opublikować moje stworzone wtyczki w oficjalnym katalogu wtyczek WordPress?

Aby opublikować plugin w oficjalnym katalogu WordPress.org, musisz najpierw utworzyć konto na stronie WordPress.org i złożyć plugin. Twój plugin musi spełniać oficjalne standardy i wymogi kodu, w tym używać licencji zgodnej z GPLv2 lub wyższej wersji, stosować najlepsze praktyki bezpieczeństwa oraz zawierać dokładne informacje o dokumentacji. Po złożeniu pliku do recenzji, zespół specjalizowany w sprawach pluginów przeprowadzi jego sprawdzenie. Jeśli zostanie przyznany jako dostępny do publikacji, będzie dostępny dla użytkowników, którzy mogą go wyszukać, instalować i aktualizować w swoim panelu administracyjnym WordPress.

Jak stworzyć stronę z ustawieniami dla mojego dodatku?

Możesz użyć “Settings API” w WordPress, aby stworzyć standardowe i bezpieczne strony zarządzania. Głównymi krokami są:add_menu_page()或add_submenu_page()Funkcja rejestruje nową stronę menu, a potem… (The function registers a new menu page, and then…)add_settings_section()和add_settings_field()Aby określić obszar ustawień oraz pola, na koniec należy użyć…register_setting()Zarejestruj się, ustawisz odpowiednie parametry i włącz automatyczne zapisywanie oraz weryfikację danych. Ten proces gwarantuje bezpieczeństwo witryny konfiguracyjnej oraz zgodność z interfejsem administracyjnym WordPress.

Następny krok, co dalej?

Jeśli budujesz lub optymalizujesz witrynę WordPress, zalecamy, abyś zapoznał się z dalszymi informacjami na temat optymalizacji wydajności, konfiguracji wtyczek i dostosowywania motywów.

Dalsze lektury i praktyczna wiedza.

Poniższe treści są powiązane z tematem tego artykułu i warto je przeczytać. Zwykle lepiej zacząć od artykułu, który najbardziej odpowiada aktualnemu problemowi, a potem stopniowo przechodzić do tematów pokrewnych.

Etykiety: