Od zera do jednego: pełny przewodnik po stopniowym tworzeniu twojego pierwszego dodatku dla WordPress

Przygotowanie środowiska do rozwoju wtyczek dla WordPress

Przed rozpoczęciem pisania kodu istotne jest stworzenie stabilnego, izolowanego od systemu operacyjnego środowiska rozwoju. To nie tylko zapewni bezpieczeństwo twojej witryny internetowej, ale także umożliwi swobodne testy i debugowanie.

Efektywny środowisko rozwoju składa się zwykle z trzech kluczowych elementów. Pierwszym jest oprogramowanie serwera webowego, np. Apache lub Nginx. Drugim jest środowisko uruchomienia PHP, w wersji kompatybilnej z wersją WordPress, którą chcesz zainstalować. Trzecim jest baza danych MySQL lub MariaDB. Choć można te programy instalować pojedynczo, gorąco zalecamy korzystanie z zintegrowanych rozwiązań typu lokalnego serwera.

Na rynku dostępne są różne wyjątkowe narzędzia do środowisk integracyjnych, np. Local by Flywheel, XAMPP, MAMP lub DevKinsta. Te narzędzia pakują wspomniane komponenty w jedno całość i oferują możliwość łatwej instalacji i uruchomienia w kilku krokach. Zwykle zawierają również funkcje przyjazne dla programistów, takie jak przekierowywanie wiadomości e-mail, klonowanie witryn internetowych oraz konfiguracja SSL w jednym kliknięciu, co znacząco poprawia efektywność rozwoju aplikacji.

Polecamy lekturę. Światowy przewodnik po tworzeniu pluginów dla WordPressa: jak stworzyć pierwszy własny plugin od zera。

Poza środowiskiem serwerowym potrzebny jest też editor kodu. Możesz wybrać wyposażone w wiele funkcji środowisko rozwoju integracyjnego (np. PhpStorm) lub łagodniejszy, ale rozszerzalny editor (np. Visual Studio Code). Jeśli chodzi o rozwój dodatków (pluginów), zaleca się, aby pluginy miały przynajmniej funkcje podpowiedzi przy pisaniu kodu w PHP, wyróżniania gramatycznego błędów oraz zarządzania plikami. Instalowanie odpowiednich dodatków w editorze tekstowym (np. fragmentów kodu dotyczących WordPressa, PHP Intelephense itd.) ułatwi proces programowania.

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

Zrozumienie struktury kluczowych plików wtyczki

WordPress plugin to w istocie zbiór jednego lub kilku plików w formacie PHP, które spełniają określone wymogi strukturalne i standardy, aby system WordPress mógł je rozpoznać i załadować.

Każdy plugin rozpoczyna się od jednego głównego pliku. Ten plik stanowi “punkt wejścia” do pluginu i musi zawierać określony komentarz na początku (tzw. nagłówek pliku). Nagłówek pliku to blok komentarzy składający się z kilku linii, zawierający metadane pluginu, takie jak nazwa pluginu, opis, wersja, autor itd. WordPress korzysta z tych informacji, by wyświetlić twój plugin w interfejsie administracyjnym. Nazwę głównego pliku można zmienić według potrzeb, ale zwykle jest ona standardowa. plugin-name.php Taki format.

Poniżej znajduje się przykład standardowego nagłówka pliku zawierającego informacje o pluginie:

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

Gdy główny plik zostanie przygotowany, należy go umieścić we właściwe miejsce. Podstawowy plik wtyczki musi znajdować się w określonym folderze lub miejscu w systemie. /wp-content/plugins/ W folderze znajdującym się w katalogu. Nazwa foldera musi być krótka, unikalna i składać się wyłącznie z małych liter oraz znaków spójników. Na przykład, nasz plugin może zostać umieszczony w folderze o nazwie „my-plugin”. /wp-content/plugins/my-first-plugin/ W tym folderze znajdują się inne pliki, a plik główny (main file) jest jednym z nich. my-first-plugin.php Po prostu umieść to w folderze w katalogu głównym.

Polecamy lekturę. Analiza tworzenia wtyczek WordPress: kompletny przewodnik po budowaniu niestandardowych modułów funkcjonalnych od podstaw.。

Napisz swoją pierwszą funkcję.

Teraz dodajmy pierwszą interaktywną funkcję do tego pluginu. WordPress umożliwia pluginom modyfikację lub dodawanie funkcji w określonych momencach za pomocą mechanizmu zwanego “hooki” („hooks”). Hooki są podzielone na dwie główne kategorie: hooki akcji (Action Hooks) i hooki filtrów (Filter Hooks).

Aktywnie działające „haki” (ang. action hooks) umożliwiają wykonywanie własnego kodu w określonych momencach podczas działania WordPressa – na przykład przy publikacji artykułu lub przy ładowaniu strony. Najczęściej używany przykład to dodawanie własnych informacji do nagłówka strony (footer). Możemy to zrobić za pomocą aktywnych „haków”. wp_footer Tę funkcję realizuje hook akcji.

Musimy napisać własną funkcję i powiedzieć WordPressowi, jak ją używać. wp_footer Wykonuje się to w momencie aktywacji. Ten proces nazywany jest “montażem” funkcji lub metody na hooku. Poniżej jest przykład implementacji:

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

// 在主文件中添加以下代码
function my_first_plugin_display_footer_text() {
    echo ‘<p style="text-align: center; color: #666;">Prezentuję to dla ciebie za pomocą mojego pierwszego dodatku.</p>’;
}
add_action( ‘wp_footer’， ‘my_first_plugin_display_footer_text’ );

add_action() To jest kluczowa funkcja odpowiedzialna za proces montażu („mounting”). Po wykonaniu powyżej opisanych kroków należy usunąć cache witryny i odnowić jej frontendowe elementy. Wtedy powinno być widoczne tekstowe elementy dodane przez plugin w nagłówku strony („footer”).

Dalej zajmijmy się hookami filtrów. Hooki filtrów umożliwiają modyfikację danych przekazywanych do nich. Na przykład, chcemy zmienić treść nagłówka artykułu. Można to zrobić za pomocą hooków filtrów. the_title Filtry. Niżej podany kod pokazuje, jak dodać prefiks do nagłówków wszystkich artykułów:

function my_first_plugin_prefix_title( $title ) {
    // 检查是否在主循环中且不是管理后台，避免影响后台标题显示
    if ( ! is_admin() && in_the_loop() ) {
        $title = ‘[插件前缀] ’ . $title;
    }
    return $title;
}
add_filter( ‘the_title’， ‘my_first_plugin_prefix_title’ );

Udoskonać dodatek: dodać menu zarządzania oraz stronę ustawień.

Dostosowany pod potrzeby użytkownika plugin często wymaga interakcji z administratorem, co wymaga dodania własnych pozycji w menu oraz stron konfiguracji. Dzięki temu użytkownicy mogą skonfigurować plugin bez konieczności pisania kodu.

Polecamy lekturę. Zaczynamy od zera: kompletny przewodnik i praktyczny samouczek dotyczący tworzenia wtyczek do WordPressa.。

Aby dodać nowy element menu najwyższego poziomu do menu zarządzania po lewej stronie w panelu administracyjnym WordPressa, należy użyć odpowiednich narzędzi dostępnych w tym panelu. Konkretnie należy skorzystać z funkcji do tworzenia i edycji menu, aby stworzyć nowy element menu i ustawić jego właściwości. add_menu_page() Funkcja. Ta funkcja wymaga kilku parametrów, by określić nagłówek menu, uprawnienia, unikalny identyfikator oraz funkcję obsługiwaną przez callback. Musisz to zrobić we właściwym momencie (zwykle…) admin_menu Akcja hooka) powinna go wywołać.

Poniżej znajduje się przykład strony, na której można stworzyć prosty menu najwyższego poziomu oraz ustawić jego właściwoś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

function my_first_plugin_add_admin_menu() {
    add_menu_page(
        ‘我的第一个插件设置’， // 页面标题
        ‘我的插件’，           // 菜单标题
        ‘manage_options’，     // 所需权限（管理员）
        ‘my-first-plugin-settings’， // 菜单slug
        ‘my_first_plugin_render_settings_page’， // 渲染页面的回调函数
        ‘dashicons-admin-plugins’， // 图标（Dashicons）
        100                     // 菜单位置
    );
}
add_action( ‘admin_menu’， ‘my_first_plugin_add_admin_menu’ );

Następnie musisz definiować funkcję wywoływaną w nagraniu (callback function). my_first_plugin_render_settings_page() Nie mogę wygenerować kodu HTML dla tej strony konfiguracji, ponieważ nie posiadam dostępu do informacji potrzebnych do jej stworzenia, takich jak elementy formularza, dane, które należy zbierać, ani zasady obsługi wysyłania tych danych (w szczególności bez wiedzy o technologii Ajax). Jeśli potrzebujesz pomocy przy tworzeniu tej strony, proszę podać więcej szczegółów lub informacji, aby mogłem zapewnić odpowiednią pomoc

Aby bezpiecznie przechowywać i uzyskiwać ustawienia pluginów, należy używać API opcji WordPress. Możesz to zrobić… add_option()、get_option()、update_option() 和 delete_option() Funkcje takie jak „wait” są używane do operowania obiektami o nazwie… my_first_plugin_options Dane opcji. W formularzu należy użyć funkcji wbudowanych w WordPress. settings_fields() 和 do_settings_sections() Można skorzystać z funkcji do bezpiecznego wyświetlania ustawionych polów, ale to zwykle jest wykorzystywane w połączeniu z bardziej formalnymi “API do konfiguracji”. W przypadku prostych stron do konfiguracji często wystarcza ręczne obsługiwanie wysyłania formularzy, a także sprawdzanie i przygotowywanie danych przed ich wysłaniem.

Podsumowanie.

Rozwoj twojego pierwszego plugina dla WordPress jest procesem uczenia się, który wymaga systematycznego podejścia. Zaczęłeś od przygotowania bezpiecznego środowiska lokalnego do rozwoju, poznając podstawową strukturę plików oraz zasady nazewania elementów w pluginach. Następnie opanowałeś kluczową cechę rozszerzalności pluginów – mechanizm hooków – i udało ci się wyświetlić treść za pomocą hooków akcji, a także modyfikować dane za pomocą hooków filtrów. Aby ułatwić zarządzanie pluginem, nauczyłeś się tworzyć menu administracyjne oraz strony konfiguracji, a także interagować z API opcji WordPress, aby zapewnić bezpieczne przechowywanie danych.

Poprzez wykonanie tych kroków nie tylko udało ci się stworzyć funkcjonalny plugin, ale co więcej – zbudowałe również rozszerzalną podstawę. Na tej podstawie możesz dalej rozwijać swój plugin, dodając nowe funkcje, np. eksplorując inne „hooki” (elementy interfejsu), pogłębiając swoje znajomości JavaScript (zwłaszcza techniki Ajax), tworząc własne tabele w bazie danych lub pisząc krótki, wydajny kod. Dzięki temu twoje rozwiązanie będzie coraz bardziej zaawansowane i skuteczne.

FAQ – najczęściej zadawane pytania.

Czy można rozwijać pliki rozszerzające (plugi) dla WordPressa, gdy nie ma doświadczenia w programowaniu, np. przy kodzie typu ###?
Choć znajomość podstaw PHP, HTML oraz ograniczonej ilości CSS może ułatwić pracę, można zacząć od zera. Kluczowe jest postępowanie krok po kroku – zacznieć od modyfikacji i naśladowania kodu prostych dostępnych wtyczek, poznawania coreowych funkcji i „hooków” dostępnych w WordPress, a także korzystania z obszernych oficjalnych dokumentacji oraz praktyki.

Czemu mój plugin nie może zostać aktywowany w tle (w trybie offline)?

Awaria w aktywacji pluginu ma zwykle kilka przyczyn. Najczęściej problem wynika z niewłaściwego formatu informacji w nagłówku pliku głównego lub braku obowiązkowych poli (np. „Plugin Name”). Możliwe również są błędy gramatyczne w kodzie PHP, które można zlokalizować, sprawdzając logi błędów serwera internetowego. Ponadto nazwa folderu z pluginem lub pliku głównego może się składać z identycznych znaków z nazwami innych już zainstalowanych pluginów, lub wymagana wersja PHP jest wyższa niż ta, która jest dostępna w twoim obecnym środowisku serwerowego.

Jak rozdzielić zaawansowane ustawienia pluginu na kilka kartek?

Możesz to zrobić poprzez kilka kolejnych wywołań. add_menu_page() Można stworzyć osobne, najwyższe menu, ale to może sprawić, że interfejs użytkownika (UI) wygląda niezorganizowanie. Lepszym rozwiązaniem jest użycie… add_submenu_page() Funkcja umożliwia dodanie dodatkowej strony z ustawieniami jako elementu menu podstawowego. Podczas tworzenia menu podstawowego pierwszy parametr (slug menu rodziców) musi być ustawiony na slug twojego najwyższego menu, a kolejne parametry służą do określenia nagłówka i funkcji menu podstawowego.

Jak bezpiecznie opublikować dodatek po jego opracowaniu?

Przed opublikowaniem pliku w katalogu dodatków do WordPressa istotne jest sprawdzenie bezpieczeństwa kodu. Konieczne jest surowe sprawdzenie i escape wszystkich wprowadzanych przez użytkowników danych. Zaleca się używać funkcji dostępnych w WordPressie. sanitize_text_field()、wp_kses() 和 esc_html()W tym samym czasie wszystkie operacje na bazie danych wykonywane bezpośrednio powinny używać… $wpdb Klasa oferuje metody zapobiegające atakom typu SQL injection. Przed publikacją należy także przeprowadzić proces internationalizacji pluginu oraz przygotować pliki z tłumaczeniami dla wszystkich tekstów widzialnych przez użytkowników.