Codificarea și înregistrarea widgetului dvs. WordPress

Aceasta este a doua parte dintr-o serie care vă arată cum să creați primul dvs. widget WordPress. În prima parte ați aflat despre API-urile Widgets și WP_Widget clasă. În această parte veți învăța cum să începeți procesul de construire a widget-ului creând o clasă care să o țină și să o înregistreze.

În total, această serie cuprinde cinci părți:

  • 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

Ce ai nevoie

Pentru a urmări această serie, veți avea nevoie de:

  • O instalare de dezvoltare a WordPress
  • Un editor de cod

Configurarea pluginului

Mai întâi trebuie să configurați pluginul. Creați un fișier nou în dvs. wp-content / plugins director. Am sunat pe a mea tutsplus-list-subpagini-widget.php.

Adăugați următoarele în fișier:

Evident, veți dori să schimbați numele autorului și url, dar acest lucru îi oferă WordPress ce are nevoie pentru a afișa pluginul în ecranul Pluginuri.

Salvați fișierul pluginului.

Crearea clasei Widget

Următorul pas este să creați o clasă nouă pentru a extinde WP_Widget clasă.

Introduceți acest cod în fișierul plugin:

Să aruncăm o privire la ce constă clasa:

  • __construi funcția va face ceea ce vă așteptați - va construi funcția. În cadrul acestei funcții veți defini lucruri precum ID-ul widgetului, titlul și descrierea acestuia.
  • formă funcția va crea formularul din ecranul Widgets, care permite utilizatorilor să personalizeze sau să activeze widgetul.
  • Actualizați asigură că WordPress actualizează orice setări pe care utilizatorii le introduc în ecranul Widgets.
  • widget funcția definește ce este afișat de widget-ul de pe capătul din față al site-ului.

Ultimii trei dintre aceștia au parametri pe care îi voi explica în detaliu în tutorialele relevante.

Înregistrarea widgetului

Widgetul dvs. nu va funcționa decât dacă îl înregistrați în WordPress. Sub clasa dvs., adăugați funcția și cârligul pentru a face acest lucru:

register_widget () este o funcție WordPress a cărei parametru unic este numele clasei pe care tocmai ați creat-o.

Apoi, închideți funcția la widgets_init cârlig pentru a se asigura că este preluat de WordPress.

Notă: widgetul dvs. nu va funcționa încă și nu va fi afișat pe ecranul Widgets, deci nu vă faceți griji cu privire la activarea plugin-ului încă. Va trebui să finalizați toți pașii din această serie pentru a funcționa.

rezumat

Acum ați început procesul de construire a primului dvs. widget WordPress. Ați creat un plugin pentru widget, ați creat o clasă pentru a construi widget-ul și l-ați înregistrat.

În următorul tutorial veți învăța cum să construiți widget-ul cu ajutorul dvs. __construi funcţie.

Cod