#4 Tworzenie wtyczki WordPress. Widżety


12 marca 2016 / Michał Kortas


To tylko jeden wpis z serii Tworzenie wtyczki WordPress. Obecne i przyszłe artykuły dostępne będą pod specjalnym tagiem Wtyczka WordPress.

Znasz już podstawy tworzenia wtyczek dla WordPressa. Poznałeś już haki filtrów i akcji, potrafisz stworzyć prosty panel ustawień pluginu. Ale czy wiesz, że każda wtyczka może dołączać do strony własne widżety? Dzisiaj pokażę Ci, jak przygotować taki projekt.

Projekt na GitHub Zapytaj na forum

Kursy wideo WordPress

Podstawowy szkielet wtyczki

Zacznij standardowo od przygotowania znanego Ci już dobrze opisu, na samym początku pliku wtyczki. W moim przykładzie plugin będzie nosił nazwę wbrd_book.

Następnie utwórz nową klasę, która dziedziczyła będzie po WP_Widget.

Zawartość widżetu

Pierwszą, z czterech metod, które zaraz utworzysz będzie widget().

W przekazywanej do niej tablicy args[]  zawarte są podstawowe elementy budowanego widżetu, których nie należy zmieniać, jeśli chcesz zachować zgodność wizualną z większością szablonów.

Tablica instance[] przechowuje natomiast zawartość samego widżetu – w tym przypadku tytuł, wpisywany jego ustawieniach.

Formularz ustawień

Być może widżet ten nie wymaga budowania mikro-panelu ustawień, jednak spróbuj go wykonać dla samej praktyki, wykorzystując metodę form().

Z instancji widżetu pobierz tytuł i wyświetl niewielką część formularza (jedną etykietę i należące do niej pole teksotwe). Klasa CSS .widefat sprawi, że input rozciągnie się na 100% panelu ustawień.

Aktualizacja ustawień widżetu

Metoda update(), jak sama nazwa wskazuje, podmieni ustawienia Twojego widżetu (tytuł z poprzedniego listingu) i zwróci nową wartość.

Rejestracja widżetu w WordPressie

Pozostała Ci jeszcze do wykonania metoda rejestracji widżetu w WordPressie, którą w kolejnym kroku wywołasz w konstruktorze klasy wbrd_book.

Wywoływanie obiektu

Utwórz konstruktor z następującą zawartością…

… i poza klasą wywołaj obiekt tej klasy.

Przegląd gotowego widżetu

Na sam koniec sprawdź jeszcze, co wyszło z Twojej dzisiejszej pracy. Czy efekt jest zadowalający? ;-)

Lista wtyczek

Wtyczka

Lista widżetów

Widżet na liście

Ustawienia widżetu

Ustawienia widżetu

Widżet umieszczony na stronie WordPress

Widżet na stronie WordPress

Podsumowanie

Dobrnąłeś do końca czwartego etapu cyklu Tworzenie wtyczki WordPress. Wiesz już naprawdę duzo! W kolejnej, piątej części, w której omówię własne taksonomie i typy wpisów.

Jak zwykle cały kod dostępny jest na GitHub.

Projekt na GitHub Zapytaj na forum


Tagi:


Jedna odpowiedź do “#4 Tworzenie wtyczki WordPress. Widżety”

  1. OOo. Świetny temat, będę śledził za wpisami :)

Dodaj komentarz

Twój adres email nie zostanie opublikowany. Pola, których wypełnienie jest wymagane, są oznaczone symbolem *