Przewodnik po tworzeniu pluginów dla WordPress: jak stworzyć swój pierwszy własny plugin od zera

Środowisko rozwoju i przygotowania podstawowe

Przed rozpoczęciem pisania kodu niezbędne jest posiadanie stabilnego i wydajnego środowiska lokalnego do rozwoju. Do tworzenia wtyczek dla WordPress rekomendujemy użycie zintegrowanych środowisk takich jak XAMPP, MAMP lub Local by Flywheel, które umożliwiają jednorazową instalację Apache, MySQL i PHP, eliminując konieczność skomplikowanych procedur konfiguracji. Upewnij się, że twoja wersja PHP jest najnowsza – co najmniej 7.4, a wersja MySQL – co najmniej 5.6, aby spełniać wymagania oficjalnych dokumentacji WordPress.

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, co znacząco poprawia efektywność rozwoju aplikacji. Ponadto konieczne jest instalowanie narzędzia do zarządzania wersjami kodu, np. Git, aby móc kontrolować historię zmian w kodzie. To standardowa praktyka w dzisiejszym rozwoju oprogramowania.

Zrozumienie podstawowej struktury pluginów WordPress jest pierwszym krokiem. Najprostszzy plugin składa się przynajmniej z jednego głównego pliku PHP, w którym znajdują się komentarze w nagłówku pliku – te komentarze stanowią “dowód tożsamości” pluginu i służą do podania informacji o nim do systemu WordPress. Ten plik może istnieć samodzielnie lub może być punktem wejścia do bardziej złożonego katalogu z pluginami.

Polecamy lekturę. Rozwój pluginów dla WordPress: od poznania podstaw do osiągnięcia biegłości – stworzenie twojego pierwszego własnego pluginu。

Stworz swoj pierwszy plik z rozszerzeniem (plugin).

Zacznijmy od stworzenia najprostszego pluginu. Najpierw wejdź do katalogu z lokalną instalacją WordPress.wp-content/pluginsfolder. Tutaj stworz nowy folder i nazwij go…my-first-pluginWszystkie pliki związane z dodatkami (plug-inami) będą umieszczone w tym katalogu.

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 główny plik PHP o nazwie na przykład „main.php”.my-first-plugin.phpNa początku tego pliku musi znajdować się blok z komentarzami zawierającymi informacje o konkretnych wtyczkach (plug-inach). Poniżej jest standardowy przykład:

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

W tym komentarzu “Nazwa pluginu” jest obowiązkowym elementem – WordPress używa jej do identyfikacji i wyświetlania twojego pluginu w liście pluginów w tle. Inne informacje, takie jak wersja, autor itd., pomagają użytkownikom lepiej zrozumieć szczegóły pluginu. Po zapisaniu pliku loguj się do panelu administracyjnego WordPress, wejdź na stronę “Pluginy” i powinien pojawić się tam twój plugin o nazwie “Moje pierwsze plugin”. Możesz go aktywować lub dezaktywować. Na razie nie ma on żadnych funkcji, ale udało ci się stworzyć legalny framework dla pluginów.

Dodanie kluczowych funkcji do pluginu

Aktywny plugin musi wykonywać swoje funkcje za pomocą mechanizmu hooków w WordPress. Hooki są podzielone na dwa typy: hooki akcji (Action Hooks) i hooki filtrów (Filter Hooks). Hooki akcji umożliwiają wstawienie kodu w określonych momencach, aby zrealizować określone funkcje, natomiast hooki filtrów pozwalają modyfikować dane przekazywane w trakcie wykonywania procesów.

Użyj haków akcji (action hooks) do dodania menu zarządzania.

Aby użytkownicy mogli interagować z pluginem, zwykle konieczne jest dodanie strony konfiguracji w panelu administracyjnym WordPress. Można to zrobić poprzez…add_action()Funkcja została zmontowana („mounted”).admin_menuTę funkcję realizuje hook akcji.

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

Najpierw w głównym pliku pluginu definiujemy funkcję, która służy do wyświetlania zawartości HTML strony konfiguracji. Tę funkcję można nazwać…mfp_settings_page_htmlA potem tworzymy kolejną funkcję, na przykład…mfp_add_admin_menuW tym przypadku używa się WordPress.add_menu_page()Funkcja służy do rejestracji nowego elementu menu najwyższego poziomu. Na koniec, użyj…add_action('admin_menu', 'mfp_add_admin_menu')Zmontuj funkcję rejestracji w systemie.

Użyj hooków filtrów do modyfikacji treści artykułu.

Poza funkcjami backendowe, pluginy są często używane do modyfikacji treści wyświetlanych na stronie internetowej (tzw. frontendu). Na przykład można automatycznie dodawać informacje o prawach autorskich na końcu każdego artykułu. Do tego potrzebny jest odpowiedni plugin.the_contentTen filtr hook.

Definiujemy funkcję, na przykład nazwaną…mfp_add_copyright_to_contentPrzyjmuje jeden parametr (tj. oryginalny tekst artykułu) i do jego końca dodaje własny tekst w formacie HTML. Następnie…add_filter('the_content', 'mfp_add_copyright_to_content')Zarejestruj tę funkcję jako filtr. W ten sposób każdy raz, gdy WordPress wywoła treść artykułu, ona zostanie najpierw przetworzona przez naszą funkcję – doprowadzona do stanu, w którym zawiera informacje o autorskich prawach – a dopiero potem wyświetlona.

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

Bezpieczeństwo, optymalizacja i publikacja pluginów

Rozwoj nowych funkcji to tylko pierwszy krok; równie ważne jest zapewnienie bezpieczeństwa i wydajności pluginu. Każdy dane wprowadzony przez użytkownika musi zostać dokładnie sprawdzony, przetworzony i oczyszczony, zanim trafi do bazy danych lub zostanie wyświetlony na stronie. WordPress oferuje wiele funkcji bezpieczeństwa, które pomagają w zabezpieczeniu aplikacji.sanitize_text_field()(Cleaning the text)esc_html()(Utworzenie escape-u dla HTML) iwp_kses()(Dozvolone określone tagi HTML); koniecznie używaj ich w odpowiednich miejscach.

Aby poprawić łatwość konserwacji i wydajność pluginu, zaleca się organizować kod według zasad programowania obiektowego (OOP), czyli pakować różne funkcje w klasach. Ponadto warto skutecznie wykorzystywać API do tworzenia tymczasowych zapisów w WordPress (Transients API) do zapisywania wyników czasochłonnych operacji lub danych pochodzących z odległych źródeł, aby uniknąć powtarzanych obliczeń przy każdym otwarciu strony.

Gdy funkcje twojego pluginu zostaną doprowadzone do perfekcji i przekroczą testy, możesz zastanowić się nad jego publikacją. Musisz przygotować jasny…readme.txtPliki muszą spełniać wymogi witryny WordPress.org, jeśli chodzi o formatowanie. Są potrzebne do opisania funkcji pluginu, metody instalacji, logów aktualizacji oraz najczęściej występujących problemów. Jeśli chcesz złożyć plugin do oficjalnego katalogu pluginów WordPress, musisz stworzyć repozytorium typu SVN i stosować się do ustalonych standardów kodu oraz instrukcji dotyczących wprowadzania zmian. W przypadku komercyjnych pluginów konieczne jest uruchomienie własnego serwera do sprzedaży i aktualizacji pluginów.

Polecamy lekturę. Poznaj w pełni rozwój wtyczek WordPress: twórz niestandardowe funkcje od podstaw.。

Podsumowanie.

Przez ten przewodnik prześcigliśmy kluczowe etapy rozwoju pluginów dla WordPress: od przygotowania środowiska i stworzenia podstawowej struktury plików, przez użycie akcji (actions) i hooków (filters) do dodania funkcjonalności pluginu, aż po dbałość o bezpieczeństwo, optymalizację i przygotowanie do publikacji. Istotą rozwoju pluginów jest rozszerzanie standardowych funkcji WordPress, a mechanizm hooków stanowi most łączący twój kod z całą platformą WordPress. Po opanowaniu tych podstaw możesz korzystać z oficjalnych dokumentacji i źródłowego kodu WordPress, by odkrywać nowe, złożone możliwości API i tworzyć silne, bezpieczne oraz popularne pluginy.

FAQ – najczęściej zadawane pytania.

Jakie pliki muszą być zawarte w dodatku (pluginie)?

Najprostszym pluginem może być plik PHP zawierający tylko jedną zgodną z wymaganiami notację na początku pliku („header”). Jednak wraz z rosnącą złożonością funkcji plugin często składa się z kilku plików PHP, JavaScript, CSS, zasobów w formie obrazów oraz innych elementów.readme.txtPlik wyjaśniający. Podstawowy plik PHP jest konieczny.

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

Jak uniknąć konfliktów pomiędzy moim pluginem a innymi pluginami?

Dodawanie unikalnego prefiksu do nazw wszystkich funkcji, klas, stałych oraz zmiennych globalnych jest najlepszą praktyką, aby uniknąć konfliktów nazw. Najczęściej do prefiksu używają się skróty lub nazwy dostępnych w bibliotekach lub narzędziach.mfp_或my_plugin_Dodatkowo umieszczenie koda w klasach pomaga skutecznie izolować jego zasięg (scope).

Jak dodać do pluginu konfigurowalne opcje ustawień?

Zaleca się używać API WordPress Settings do tworzenia bezpiecznych, standardowych stron konfiguracji. Dostępne są funkcje do rejestracji ustawień, dodawania pol i sekcji, a także automatycznego obsługiwania procesów zapisywania, weryfikacji oraz weryfikacji typu nonce. To znacznie ułatwia i usprawdza pracę w porównaniu z obsługą tych procesów w sposób ręczny.$_POSTDane muszą być znacznie bezpieczniejsze i łatwiejsze w obsłudze.

Jak debugować błędy w pluginie podczas rozwoju?

Najpierw upewnij się, że…wp-config.phpW pliku włączony został tryb debugowania WordPress.WP_DEBUGKonstanta ustawiona jest na…trueW tym samym czasie można zainstalować i włączyć profesjonalne narzędzia do debugowania, takie jak Query Monitor, które pomagają w oglądaniu zapytań do bazy danych, wykonywania hooków, błędów w PHP oraz identyfikacji ograniczeń w wydajności aplikacji. To niezbędne narzędzia w procesie rozwoju.