Pełny przewodnik po tworzeniu wtyczek WordPress: od zera do zaawansowanej konstrukcji potężnych, spersonalizowanych wtyczek.

Środowisko do rozwoju pluginów dla WordPressa i przygotowania niezbędne do ich tworzenia

Przed rozpoczęciem pisania jakiegoś kodu pierwszym krokiem do sukcesu jest stworzenie profesjonalnego i wydajnego środowiska rozwoju. To nie tylko poprawi twoją efektywność pracy, ale także zapewni wysoką jakość i łatwość utrzymania kodu.

Ustawienie środowiska rozwoju lokalnego

Zaleca się korzystanie z lokalnego środowiska serwerowego, np. Local by Flywheel, XAMPP lub Laragon. Dzięki nim można szybko uruchomić na komputerze lokalnym środowisko do działania WordPressu, w którym znajdują się Apache/Nginx, MySQL oraz PHP. Takie rozwiązanie ma następujące zalety: pozwala swobodnie testować i debugować aplikację w izolowanym, bezpiecznym środowisku, bez obawy o wpływ na witrynę internetową działającą w sieci.

Niezbędne narzędzia do rozwoju pluginów

Poza środowiskiem serwerowym potrzebny jest ci również szereg narzędzi. Kluczowym elementem jest mocny edytor kodu lub środowisko integracyjne (IDE), np. Visual Studio Code lub PhpStorm, które oferują wyróżnianie syntaksy, sugestie kodu oraz funkcje debugowania. Ponadto znajomość i stosowanie systemów kontroli wersji, takich jak Git, jest niezbędna do zarządzania zmianami w kodzie i współpracy zespołu. Na koniec upewnij się, że twoja lokalna wersja PHP jest zgodna z wersją w środowisku produkcyjnym, aby uniknąć problemów z kompatybilnością spowodowanych różnicami w wersjach.

Polecamy lekturę. Pełny przewodnik po tworzeniu pluginów dla WordPressa: stworzenie swojego pierwszego funkcjonalnego pluginu od zera。

Zrozumienie podstawowej struktury pluginu

Standardowy plugin WordPress posiada jasną strukturę organizacji plików i kodu. Posłuchanie tej struktury nie tylko umożliwi prawidłowe rozpoznanie i załadowanie twojego pluginu przez core WordPress, ale także jest wymogiem koniecznym przy publikacji w oficjalnym katalogu pluginó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

Skład głównego pliku pluginu

Każdy plugin musi mieć główny plik. Ten plik zwykle nosi nazwę pluginu. my-awesome-plugin.phpNa początku tego pliku musi znajdować się specjalny blok z informacjami o pluginie, który służy do opisania twojego pluginu dla WordPress.

/**
 * Plugin Name:       我的强大插件
 * Plugin URI:        https://example.com/my-awesome-plugin
 * Description:       这是一个用于演示插件开发指南的强大定制插件。
 * Version:           1.0.0
 * Author:            你的名字
 * License:           GPL v2 or later
 * Text Domain:       my-awesome-plugin
 */

Po tym bloku informacyjnym możesz zacząć pisanie głównego kodu pluginu. Wszystkie kluczowe funkcje można umieścić bezpośrednio w tym pliku, ale w przypadku złożonych pluginów zaleca się modularizację kodu.

Organizacja kodu i modularizacja

Aby uzyskać lepszą łatwość utrzymania kodu, należy stosować zasady modularizacji. Poza głównym plikiem, katalog z pluginami może zawierać również następujące elementy:
* includes/ Katalog: Służy do przechowywania plików zawierających klasy lub funkcje realizujące kluczowe funkcje programu.
* admin/ Katalog: przeznaczony wyłącznie do przechowywania kodu związanego z interfejsem administracyjnym w tle aplikacji.
* public/ Katalog: zawiera kod odpowiadający za obsługę logiki frontendu witryny internetowej.
* assets/ Katalog: Służy do umieszczania statycznych zasobów, takich jak JavaScript, CSS oraz zdjęcia.
* languages/ Katalog: zawiera pliki z tłumaczeń międzynarodowych (.po/.mo).
Taka struktura sprawia, że kod jest jasno zorganizowany, co ułatwia długoterminową konserwację oraz rozszerzanie jego funkcji.

Core development: Hooki i API

Podstawa filozofii rozwoju pluginów dla WordPress jest “hooki” (ang. Hooks), które umożliwiają łączenie Twojego kodu z core’em WordPress w określonych momencach, aby zmienić lub dodać nowe funkcje. To właśnie stanowi fundament sprawiający, że WordPress jest tak elastyczny i rozszerzalny.

Polecamy lekturę. Kompletny przewodnik po tworzeniu wtyczek WordPress: od zera do wysokiej jakości rozszerzeń WordPress.。

Używanie aktywnych háków (action hooks)

Aktywne haczyki (Action Hooks) umożliwiają uruchomienie Twojego kodu w określonych momencach podczas działania WordPress. Na przykład, gdy publikuje się artykuł lub gdy menu w panelu administracyjnym jest inicjalizowane. Możesz je wykorzystać do realizacji różnych zadań, np. automatycznego wysyłania wiadomości, aktualizowania danych w bazie danych itd. add_action() Funkcja służy do montażu własnej funkcji na określony „hak akcji” (action hook).

function myplugin_send_notification_on_publish( $post_id ) {
    // 获取文章信息
    $post = get_post( $post_id );
    // 模拟发送邮件通知
    wp_mail( '[email protected]', '新文章已发布！', '文章标题：' . $post->post_title );
}
// 将函数挂载到 `publish_post` 这个动作钩子
add_action( 'publish_post', 'myplugin_send_notification_on_publish' );

Używanie filtrów hooków

Filtry hooki (Filter Hooks) służą do modyfikacji danych. Przed tym, jak dane zostaną użyte (na przykład zapisane w bazie danych lub wyświetlone użytkownikowi), można zmienić ich wartości za pomocą filtrów. add_filter() Implementowane jest to za pomocą funkcji.

function myplugin_modify_excerpt_length( $length ) {
    // 将文章摘要的默认字数从55改为30
    return 30;
}
add_filter( 'excerpt_length', 'myplugin_modify_excerpt_length' );

Ważne funkcje globalnej API

Poza funkcjami typu „hooki” WordPress oferuje wiele przydatnych funkcji API, np. do manipulacji z bazą danych. wpdb Klasa, opcje obsługi… get_option() 和 update_option()„Create a custom data table.” dbDelta() Funkcje itd. Biegłe korzystanie z tych API jest kluczowym elementem skutecznego rozwoju oprogramowania.

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

Rozwinąć pełną funkcjonalność dodatku (pluginu).

Zobaczmy, jak można połączyć powyżej opisane informacje w praktycznym przykładzie i stworzyć prosty plugin do wyliczania czasu potrzebnego na przeczytanie artykułu. Ten plugin będzie wyświetlać przybliżony czas czytania przed samym tekstem artykułu.

Stworzenie ramy dla pluginów oraz głównego pliku

Najpierw… /wp-content/plugins/ Utworz nowy folder w katalogu i nazwij go… post-reading-timeW tej folderze utwórz plik główny. post-reading-time.phpWypełnij także standardowe informacje o nagłówku pliku rozszerzenia.

Podstawowa funkcja do obliczania i wyświetlania czasu potrzebnego na przeczytanie tekstu

Następnie dodajemy kluczowe funkcje do głównego pliku pluginu. potrzebny nam jest funkcja do obliczenia czasu potrzebnego na przeczytanie tekstu, a potem tę funkcję musimy „przypiąć” (ang. „mount”) do odpowiednich elementów interfejsu użytkownika. the_content Należy to umieścić na filtrze, aby nasze informacje mogły zostać włączone przed wyświetleniem treści artykułu.

Polecamy lekturę. Pełny przewodnik po rozwoju pluginów dla WordPress: od poznania podstaw do tworzenia profesjonalnych rozszerzeń。

function prt_calculate_reading_time( $content ) {
    // 1. 只有在单篇文章页面才生效
    if ( ! is_single() ) {
        return $content;
    }

// 2. 获取文章内容，去除短代码和HTML标签，计算字数
    $text_content = strip_shortcodes( wp_strip_all_tags( $content ) );
    $word_count   = str_word_count( $text_content );

// 3. 假设平均阅读速度为每分钟200字
    $reading_time = ceil( $word_count / 200 );

// 4. 生成显示HTML
    $reading_time_html = sprintf(
        '<div class="post-reading-time"><p><strong>Oczekiwany czas czytania:</strong>Około 1 minut 30 sekund.</p></div>',
        $reading_time
    );

// 5. 将阅读时间信息放在文章内容之前
    return $reading_time_html . $content;
}
add_filter( 'the_content', 'prt_calculate_reading_time' );

Dodaj prosty styl do pluginu.

Aby ulepszyć wygląd witryny, możemy dodać kilka zapisów w języku CSS. Dobrą praktyką jest kolejne ładowanie stylów (tj. ich dodawanie po kolei). wp_enqueue_style() Ta funkcja gwarantuje, że arkusz stylów zostanie poprawnie załadowany i nie dojdzie do konfliktów z innymi wtyczkami.

function prt_enqueue_styles() {
    wp_enqueue_style(
        'prt-style',
        plugin_dir_url( __FILE__ ) . 'assets/css/prt-style.css', // 假设CSS文件路径
        array(), // 依赖
        '1.0.0' // 版本号
    );
}
add_action( 'wp_enqueue_scripts', 'prt_enqueue_styles' );

A potem… assets/css/prt-style.css Dodanie prostych stylów do pliku:

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

.post-reading-time {
    background-color: #f0f8ff;
    border-left: 4px solid #3498db;
    padding: 10px 15px;
    margin-bottom: 20px;
    font-size: 0.95em;
}

Takim sposobem został stworzony kompletny plugin z podstawowymi funkcjami. Możesz go aktywować i sprawdzić, czy na górnym margynie strony pojednego artykułu pojawiła się estetyczna informacja o czasie czytania.

Podsumowanie.

Rozwoj pluginów dla WordPress to proces przekształcania kreatywnych idei w potężne funkcje. Poprzez przygotowanie profesjonalnego środowiska, zrozumienie standardowej struktury pluginów, dogłębne poznanie mechanizmów hooków oraz API core’u uzyskasz podstawowe umiejętności do tworzenia różnych, dostosowanych pluginów. Ten tekst pokazuje ci jasną drogę nauki – od przygotowania środowiska po strukturę kodu, od zasad teoretycznych po praktyczne przykłady. Kluczowe jest angażowanie się w praktykę: zacznij od realizacji prostych funkcji, np. “czasu czytania”, pozwól sobie stopniowo zwiększać złożoność, a w końcu będziesz mogł z poważaniem tworzyć pluginy WordPress, które spełniają konkretne wymagania użytkowników.

FAQ – najczęściej zadawane pytania.

Czy do tworzenia dodatków (pluginów) konieczne jest doskonałe opanowanie PHP?

Tak, solidne znajomości PHP są konieczne do rozwoju dodatków (pluginów) dla WordPress. A to dlatego, że sam core WordPress, jego dodatki oraz tematy (templates) są w większości przypadków napisane w języku PHP. Aby stworzyć bezpieczny i wydajny kod dodatków, musisz znać podstawy PHP, takie jak zmienne, funkcje, klasy, tablice, cykły, warunki oraz zasady programowania obiektowego (OOP).

Jak zapewnić, że plugin, który rozwijam, jest bezpieczny?

Aby zapewnić bezpieczeństwo pluginów, konieczne są różnorakie działania. Najpierw należy dokonać surowej weryfikacji, oczyszczenia i escapeowania wszystkich danych wprowadzanych przez użytkowników. Do tego celu można wykorzystać funkcje dostępne w WordPress. sanitize_text_field(), esc_html(), wp_kses_post() Następnie, przy wykonywaniu operacji na bazie danych, koniecznie używaj odpowiednich zasad i procedur bezpieczeństwa. $wpdb Metody klasy… prepare() Zastosuj zasady bezpieczeństwa, aby zapobiecć atakom typu SQL injection. Na koniec postępuj zgodnie z zasadą „maksymalnego ograniczenia uprawnień” (principle of least privilege) – daj pluginom tylko te uprawnienia, które są niezbędne do wykonywania ich funkcji.

Można wgrać moje dodatkowe moduły (pluginy) do oficjalnego katalogu WordPress?

Możliwe, ale należy spełnić szereg surowych wymagań. Kód twojego pluginu musi być zgodny z standardami kodowania WordPress, musi być objęty licencją GNU GPL w wersji 2 lub wyższej, a nie powinien zawierać żadnego złośliwego kodu, linków płatnych ani elementów naruszających zasady organizacji katalogów pluginów. Przed złożeniem pliku do WordPress należy dokładnie przeczytać oficjalne dokumentacje dotyczące rozwoju pluginów oraz instrukcje dotyczące ich publikacji, a także przeprowadzić gruntowną samodzielną kontrolę i testy.

Jak dodać stronę z ustawieniami do mojego pluginu?

Dodawanie strony konfiguracji do pluginu często wymaga użycia API do tworzenia stron menu w WordPress. Możesz to zrobić za pomocą… add_menu_page() Funkcja służy do tworzenia elementów menu najwyższego poziomu. add_submenu_page() Utworzyć podstronę w ramach istniejącego menu (na przykład “Ustawienia”). W funkcji powrotnej (callback) strony ustawień należy wyświetlić formularz HTML i wykorzystać dane z tego formularza. settings APIwłącznie z register_setting, add_settings_section, add_settings_field Funkcje takie jak (…) umożliwiają bezpieczne i wygodne zarządzanie rejestracją, zapisem oraz wyświetlaniem opcji.