Przewodnik dla początkujących do rozwoju wtyczki WordPress

WordPress CMS zmienił oblicze naszego Internetu i pozwolił na rozwój nowych pomysłów, a jego ruch open source ma silną obecność zakorzenioną w oprogramowaniu i tworzeniu stron internetowych. WordPress to platforma blogowa, która ma możliwość uruchamiania wielu innych skryptów, takich jak fora internetowe, tablice ogłoszeń, a nawet klasyczna strona Content Management System.

Przejdziemy przez kilka sposobów, aby rozpocząć tworzenie wtyczek dla WordPress. Kroki są dość proste i nie wymagają dużego zaangażowania w naukę. Podstawowa znajomość PHP byłaby przydatna nawet przy podstawowej znajomości struktury plików WordPress i panelu administracyjnego.

W tym krótkim samouczku omówimy podstawowe kroki wymagane do utworzenia prostej wtyczki WordPress. Funkcjonalność będzie używana do tworzenia dynamicznych fragmentów na podstawie liczby przekazanej do naszego wywołania funkcji. Musisz załadować plik wtyczki i aktywować go w panelu administracyjnym, a następnie zadzwonić do naszej funkcji z dowolnej strony, na której ma się pojawić fragment. Linki do ukończonego kodu źródłowego wtyczki zostały już dodane później w tym artykule :)

Dlaczego warto opracować dla WordPress?

Wtyczki to świetny sposób na zwiększenie funkcjonalności bloga poprzez dodanie dodatkowych funkcji. Można je umieścić w dowolnym miejscu szablonu za pomocą haków funkcyjnych. Z czasem rozszerzalność systemu wtyczek WordPress pozwoliła na ogromny rozwój i setki programów dostarczanych przez programistów.

WordPress oferuje takie zaawansowane funkcje w swoim CMS, że unikalne wtyczki są nieliczne. Jako programista masz pełną kontrolę nad specyfiką zaplecza swojego bloga. Zatrudnienie programisty PHP do stworzenia wtyczki systemowej kosztowałoby znacznie więcej, niż można sobie wyobrazić, a interfejs API jest dość łatwy do pracy i sam się uczy.

Jako argument dodatkowy, rozwijanie w WordPress jest świetną praktyką do dostrajania się do innych obszarów. Budowanie mniejszych wtyczek i widżetów bocznych w WordPressie pomoże ci zrozumieć, jak naprawdę działa system zaplecza. To nie ogranicza się tylko do WordPress, ponieważ zyskasz głębsze zrozumienie ogromnej większości systemów zawartości.

1. Struktura folderów WP

Wprowadzenie do struktury folderów WordPress pokaże podstawowe katalogi aplikacji. Wewnątrz zawartości wp znajdziesz wtyczki informator. W tym miejscu znajdują się wszystkie twoje indywidualne wtyczki, pojedyncze pliki lub odpowiednio nazwane podkatalogi.

W przypadku mniejszych wtyczek, które wymagają tylko jednego pliku .php, masz możliwość umieszczenia tego bezpośrednio w katalogu wtyczek / katalogu. Jednak gdy zaczniesz tworzyć bardziej skomplikowane aplikacje, znacznie bardziej przydatne będzie utworzenie podkatalogu o nazwie zgodnej z wtyczką. Wewnątrz możesz przechowywać JavaScript, CSS, a HTML zawiera wraz z funkcjami PHP.

ZA readme.txt plik może być również przydatny, jeśli planujesz udostępnić wtyczkę do pobrania. Ten plik powinien zawierać twoje imię i co robi wtyczka. Jako autor możesz również rozważyć dołączenie szczegółowych informacji na temat każdej wersji i wydanych aktualizacji.

2. Uruchamianie pliku PHP

Podczas tworzenia nowej wtyczki musisz zacząć od prostego pliku PHP. Może to być dowolna nazwa, ale ogólnie powinna odzwierciedlać oficjalną nazwę wtyczki. Na przykład stworzyłem nasz kod podstawowy i nazwałem mój plik hongkiat-excerpt.phps.

Pierwsze linie wtyczki musi bądź komentarzem do silnika parsującego. Jest to niezwykle ważne, ponieważ WordPress nie będzie w stanie przetworzyć Twojego pliku bez. Poniżej znajduje się przykładowy fragment kodu, który można kopiować i formować w kierunku własnego.

Nazwa wtyczki pojawi się na panelu administracyjnym, gdy przejdziesz do aktywacji. To samo z identyfikatorem URI, który zostanie umieszczony w okienku szczegółów wewnątrz panelu wtyczek. Chociaż nie jest wymagane dołączanie wersji lub opisu, to sprawia, że ​​wtyczka wygląda bardziej profesjonalnie.

3. Konwencje nazewnictwa WordPress i najlepsze praktyki

Istnieje kilka sposobów, aby faktycznie skonfigurować wtyczkę. Wielokrotnie programiści PHP tworzą cały system klas, aby uniknąć kolizji z funkcjami i nazwami zmiennych. Jeśli nie znasz zaawansowanej funkcjonalności OOP PHP, najlepiej jest napisać swój kod w przykładowych funkcjach.

Dla naszego przykładowego kodu napiszemy jedną funkcję do przechowywania naszych danych. Musimy także zdefiniować kilka zmiennych, które są kluczowe do zaimplementowania w naszych plikach szablonów. Poniżej znajduje się przykładowy fragment kodu pobranego z naszego pliku wtyczki z usuniętą podstawową logiką.

Pisząc przykładowy kod, najlepiej postępować zgodnie z przepisami i przewodnikami stworzonymi przez WordPress. Ponieważ jest już tak wiele zdefiniowanych funkcji wewnętrznych, można uniknąć duplikatów, dodając etykietę do wszystkich zmiennych i nazw funkcji.

W powyższych przykładach poprzedziliśmy wszystkie nasze nazwy ustawień hongkiat. Można go zastąpić dowolnym wybranym słowem kluczowym, zwykle związanym z nazwą wtyczki. Powyższy kod jest po prostu przykładowe ustawienia i nie powinien dotyczyć naszej ostatecznej wtyczki. Jest to tylko po to, aby dać ci wgląd w sposób, w jaki należy zapisywać nazwy zmiennych i wywołania funkcji.

4. Nurkowanie w filtrach i akcjach

Warto jeszcze wspomnieć o innej koncepcji, zanim przejdziemy do naszego surowego kodu. działania i filtry to dwie zupełnie różne koncepcje, które odnoszą się głęboko do sposobów manipulowania danymi wtyczek.

Te dwa bity kodu są standardem w API WordPress. Filtry i działania pozwalają programistom wtyczek na aktualizację bitów kodu w panelu administracyjnym WordPress dotyczącym nowej wtyczki. Oznacza to, że możesz dodać nową kartę na pasku bocznym lub dodatkowe linki ustawień dla opcji wtyczki.

Zrozumienie add_filter ()

ZA filtr jest wykorzystywany na tekście lub danych przekazywanych do WordPress. Z filtrami jesteś całkiem dosłownie w stanie filtrować zawartość poprzez własne, niestandardowe funkcje do zmiany danych w dowolny sposób.

Na przykład możesz utworzyć filtr do zmiany $ the_content która jest zmienną ustawioną przez WordPress zawierającą całą treść postu w artykule WordPress. Za naszą wtyczkę będziemy przyjmować $ the_content i skrócenie długości znaków do fragmentu.

Filtry przydają się, gdy piszesz wtyczki, aby dostosować wygląd swojego bloga. Są one szczególnie popularne podczas pisania widgetów paska bocznego lub mniejszych funkcji, aby zmienić sposób wyświetlania posta. Poniżej znajduje się przykładowy wiersz kodu pokazujący, jak zastosować filtr.

add_filter ('wp_title', 'hongkiat_func');

Tutaj dodajemy filtr do tytułu strony WordPress. Zauważ, że ten kod nie odnosi się do naszej oficjalnej wtyczki i jest tutaj używany tylko jako przykład.

The add_filter Funkcja jest natywna dla WordPressa i służy do dodawania nowego filtra do zmiennej znajdującej się w treści strony. W powyższym wierszu kierujemy reklamy $ wp_title który zawiera tytuł naszej bieżącej strony. Następnie przekazujemy tę zmienną do fałszywej funkcji zatytułowanej hongkiat_func () które mogłyby następnie manipulować i zwracać nowy tag tytułowy w dowolnych celach.

Zrozumienie add_action ()

Akcje są podobne do filtrów, ponieważ nie działają na bitach danych, ale zamiast tego celują w predefiniowane obszary w szablonach i panelu administracyjnym. Jako przykład możesz zastosować akcję za każdym razem, gdy aktualizujesz lub edytujesz zawartość strony. WordPress oferuje obszerną listę działań w dokumentacji API. Poniżej znajduje się mała lista przykładowych działań, dzięki którym można zapoznać się z niektórymi wstępnie zdefiniowanymi obszarami docelowymi.

• poster_post - wywoływane, gdy wiadomość jest publikowana lub gdy status zmienia się na “opublikowany”
• Zapisz Post - wywoływany, gdy poczta / strona jest tworzona od początku lub aktualizowana
• wp_head - wywoływany, gdy szablon jest załadowany i uruchamia wp_head () funkcjonować
• loop_end - wywoływany natychmiast po przetworzeniu ostatniego postu w pętli WordPress
• trackback_post - wywoływane za każdym razem, gdy nowy post jest dodawany do posta

Ponownie możemy zobaczyć, jak prosty jest ten fragment kodu. Jeśli rozumiesz różnicę między działaniami i filtrami, będziesz o wiele bliższy budowaniu wszechstronnych, działających wtyczek WordPress. Poniżej znajduje się kolejna linia kodu inicjująca funkcję akcji na Zapisz Post hak. Aby wyjaśnić to ponownie, nie dotyczy to naszej obecnej wtyczki rozwijającej i jest używana tylko jako przykładowy kod do zrozumienia add_action () funkcjonować.

add_action ('save_post', 'notify');

Widzimy więc podobną konfigurację z wcześniejszą add_filter (). Potrzebujemy 2 zmiennych, pierwsza zawiera nazwę naszego haka, na który celujemy. W tym przypadku Zapisz Post co oznacza, że ​​za każdym razem, gdy zapisywany jest nowy post, wywołamy naszą funkcję zdefiniowaną w drugiej pozycji (notyfikować()). Możesz oczywiście zaktualizować powiadomienie, aby było dowolną nazwą funkcji, którą chcesz uruchomić, jednak nie jest to wymagane dla naszej obecnej przykładowej wtyczki.

Zakończenie naszej logiki wtyczek

Na naszej ścieżce dodamy naszą ostateczną funkcję do naszego pliku wtyczek. Dokumentacja API jest bardzo specyficzna i stanowi doskonałe źródło dla programistów, którzy mogą zadawać zaawansowane pytania. Materiał może wydawać się trudny, jeśli nie jesteś zaznajomiony z PHP, ale nie spiesz się z pojęciami i sprawy zaczną płynąć naturalnie!

Poniższą funkcję należy dodać bezpośrednio po komentarzu do nagłówka wtyczki. Ewentualnie może to być również umieszczone w twoim motywie functions.php plik. Kod służy do tworzenia dynamicznej treści postu w oparciu o ograniczony zakres znaków.

W naszym przykładzie możemy ograniczyć fragmenty opowieści tylko 55 znaków z hk_trim_content () funkcjonować. Możesz łatwo nazwać ten fragment kodu z widgetu paska bocznego lub jednego z plików motywu, aby go zastąpić $ the_content.

= $ limit) array_pop ($ content); $ content = implode („”, $ content). „…”;  else $ content = implode ("", $ content);  $ content = preg_replace ('/\t.+\t/\t, ", $ content); $ content = apply_filters (' the_content ', $ content); return $ content;?> 

Nie należy oczekiwać, że w pełni zrozumiesz wszystkie wewnętrzne zmienne lub funkcje używane tutaj. Już samo zrozumienie tego, jak powinny wyglądać Twoje funkcje i jak wyglądałby przykładowy zestaw, jest bardzo dobrym początkiem.

Możesz także zauważyć, że używamy połączenia do apply_filters która jest kolejną funkcją specyficzną dla WordPress. To kolejny aspekt, którego nie musisz w pełni rozumieć, ale pomaga w przyszłym programowaniu nad WP. Sprawdź stronę referencyjną apply_filters, aby uzyskać więcej szczegółów i najczęściej zadawane pytania na ten temat.

Powyższa podstawowa funkcja została nazwana hk_trim_content (). Wymaga to tylko jednego parametru o nazwie $ limit. Można to również skrócić do $ lim który powinien przechowywać liczbę całkowitą określającą liczbę znaków ograniczających wyciąg. Treść jest wykorzystywana na pełnych stronach postów, a także na stronach statycznych (o nas, kontaktach).

Dlatego, aby wywołać tę funkcję, musielibyśmy dodać parametr do naszych plików szablonów. To zostanie umieszczone gdzieś w twoim index.php lub loop.php plik (i) i najpierw musisz zainstalować wtyczkę. Przykład poniżej:

Instalowanie i uruchamianie wtyczki

Stworzyłem przykładowy plik dla wtyczki do demo, jeśli chcesz pominąć kodowanie. Po prostu pobierz ten plik (zmień jego nazwę na .php) lub skopiuj / wklej kod do nowego dokumentu PHP i prześlij go do swojego / wp-content / plugins informator.

Po zakończeniu będziesz chciał uzyskać dostęp do panelu administracyjnego WordPress i przeglądać swój aktualny zestaw wtyczek dla zainstalowanej wersji demonstracyjnej. Po aktywacji nic się nie stanie, dopóki nie dodamy ręcznie naszego wywołania funkcji. Aby to zrobić, po prostu nawiguj Wygląd -> Edytor i szukaj single.php.

Ten plik zawiera wszystkie szablony HTML / CSS dla podstawowej strony z artykułami. Przewiń w dół, aż znajdziesz Treść() i zastąp powyższym kodem przykładowym. Spowoduje to ograniczenie wszystkich stron artykułów do 55 znaków, niezależnie od tego, jaki widok jest używany. Możesz także dodać tę funkcję do podobnych stron w katalogu szablonów, takich jak search.php lub archive.php.

Wniosek

Oto niektóre z podstaw, dzięki którym zacząłeś pracować nad rozwojem WordPressa. System wtyczek jest ogromny i zawiera wiele wewnętrznych funkcji. Jeśli masz już pomysł na wtyczkę, wypróbuj go na lokalnej instalacji WordPress, aby ćwiczyć te tematy.

Jeśli nadal masz wiele informacji, możesz przejrzeć dokumentację WordPress i wyszukać tam swoją odpowiedź. Społeczność programistów jest pełna pomocnych użytkowników, a fora przechowują archiwa z pytaniami sprzed lat.