Introducere în crearea primului dvs. WidPress Widget

Pentru non-coderii care creează un site WordPress, widget-urile sunt minunate. Ele vă permit să adăugați meniuri, liste, fluxuri, text și mult mai mult pentru zone widget care nu trebuie să fie limitate la bara laterală. Multe teme au în prezent zone de widget în subsolul lor, iar cadrele tematice mari au adesea zone widget în mai multe locații, cum ar fi antetul și înainte și după conținut.

În această serie de cinci părți vă voi face pașii necesari pentru a crea primul dvs. widget. Seria va cuprinde:

• Introducere în widget-uri și API-uri Widgets
• Codificarea și înregistrarea widgetului
• Construirea widget-ului
• Construirea formularului pentru widget-ul dvs.
• Afișarea widget-ului dvs. în zona widget-ului corect

În această parte voi introduce widget-uri și widget-ul API.

Crearea de widgeturi

Pentru a crea un widget, extindeți WP_Widget clasa, care include o serie de funcții:

• o funcție de procesare a widget-ului
• o funcție de afișare a unui formular pentru widget în ecranul tabloului de bord pentru widgeturi
• o funcție care permite actualizarea setărilor widget-urilor de către utilizatori
• o funcție de ieșire a widget-ului în orice zonă widget în care este adăugată.

În plus, utilizați register_widget () pentru a înregistra widgetul pe care l-ați creat.

Puteți pune tot ceea ce doriți într-un widget - textul static, ieșirea dintr-o interogare de bază de date, un feed de la un alt site și multe altele. Cu toate acestea, este important să rețineți că utilizatorii vor aștepta ca widget-urile să se potrivească într-o zonă definită din pagină, astfel că ieșirea widget-ului dvs. nu ar trebui să fie prea mare.

WordPress vine cu o serie de widget-uri încorporate, așa că, înainte de a începe să codificați propriul dvs., verificați dacă acesta nu este deja în WordPress core.

În această serie voi crea un widget dintr-un plugin pe care l-am dezvoltat pentru un tutorial mai devreme, pe crearea navigării în bara laterală sensibilă la context. În acest tutorial am dezvoltat o funcție pe care utilizatorii cu anumite cunoștințe de cod ar putea să le creeze în tema lor sau să se atașeze la un cârlig, dar ar fi mai ușor pentru utilizatori dacă ar putea adăuga navigarea prin intermediul unui widget.

API Widgets

API-ul Widgets include funcțiile de care aveți nevoie pentru a crea widgetul. Să aruncăm o privire la fiecare dintre ele.

În primul rând, există patru funcții widget:

• is_active_widget (): o etichetă condiționată care verifică dacă un widget individual este activ. Nu te confunda cu is_active_sidebar (), care verifică dacă widget-urile au fost adăugate la o anumită zonă widget.
• the_widget (): o etichetă șablon care afișează un widget în afara zonelor widget.
• register_widget (): funcția de a înregistra un widget, pe care o voi folosi mai târziu în această serie.
• unregister_widget (): anulează un widget, ceea ce înseamnă că nu mai este disponibil pentru utilizatori prin intermediul ecranului Widgets.

Există, de asemenea, cinci funcții interne:

• wp_register_widget_control (): creează comenzile de pe ecranul Widgets, astfel încât utilizatorii să poată modifica setările widgetului.
• wp_unregister_widget_control (): înregistrează controlul widgetului care a fost înregistrat prin wp_register_widget_control ().
• wp_convert_widget_settings (): aceasta convertește setările widget-ului dintr-o singură instanță în multi-widget.
• wp_get_widget_defaults (): funcția de bază, care nu va fi utilizată de dezvoltatorii de plugin sau de temă
• wp_widget_description (): creează o descriere widget care va fi afișată pe ecranul Widgets.

Pentru a accesa aceste funcții interne, veți folosi WP_Widget clasă. Aceasta este o clasă constructor, pe care o puteți extinde pentru a crea widget-uri suplimentare.

rezumat

 Acest tutorial introductiv a sperat că ți-a adus apetitul pentru crearea propriilor dvs. widget-uri. În următorul tutorial vă voi arăta cum să codificați widget-ul și să îl înregistrați.