Koding og registrering av WordPress Widget

Dette er den andre delen i en serie som viser deg hvordan du lager din første WordPress-widget. I den første delen lærte du om Widgets API og WP_Widget klasse. I denne delen lærer du hvordan du starter prosessen med å bygge din widget ved å opprette klassen for å holde den og registrere den.

I sin helhet består denne serien av fem deler:

• Introduksjon til widgets og Widgets API
• Koding og registrering av widgeten din
• Konstruerer widgeten din
• Bygg skjemaet for widgeten din
• Viser widgeten din i riktig widget-område

Hva du trenger

For å følge denne serien trenger du:

• En utviklingsinstallasjon av WordPress
• En kodeditor

Sette opp pluggen

Først må du konfigurere pluginet ditt. Lag en ny fil i din wp-innhold / tillegg katalogen. Jeg har kalt min tutsplus-liste-undersider-widget.php.

Legg til følgende i filen:

Åpenbart vil du endre forfatternavnet og nettadressen, men dette gir WordPress det du trenger for å vise pluginet på Plugins-skjermbildet.

Lagre pluginfilen din.

Opprette Widget Class

Det neste trinnet er å opprette en ny klasse for å utvide WP_Widget klasse.

Skriv inn denne koden i plugin-filen din:

La oss se på hva denne klassen består av:

• de __construct funksjonen vil gjøre det du forventer - det vil konstruere funksjonen. Innenfor den funksjonen definerer du ting som widgetens ID, tittel og beskrivelse.
• de skjema funksjonen vil opprette skjemaet i Widgets-skjermen som lar brukerne tilpasse eller aktivere widgeten.
• de Oppdater funksjonen sikrer at WordPress oppdaterer alle innstillinger som brukerne skriver inn i Widgets-skjermen.
• de widget funksjon definerer hva som er utdata av widgeten på forsiden av nettstedet.

De siste tre av disse har parametere som jeg vil forklare nærmere i de aktuelle opplæringsprogrammene.

Registrering av widgeten

Din widget vil ikke fungere med mindre du registrerer den med WordPress. Under din klasse legger du til funksjonen og krog for å gjøre dette:

De register_widget () funksjon er en WordPress-funksjon hvis enkelt parameter er navnet på den klassen du nettopp har opprettet.

Du kobler deretter din funksjon til widgets_init krok for å sikre at den hentes av WordPress.

Merk: Din widget vil ikke fungere enda, og vil ikke bli vist på Widgets-skjermbildet, så vær så bekymret for å aktivere pluginet ennå. Du må fullføre alle trinnene i denne serien for at den skal fungere.

Sammendrag

Du har nå startet prosessen med å bygge din første WordPress-widget. Du har opprettet et plugin for widgeten, opprettet en klasse for å konstruere widgeten og registrert den.

I den neste opplæringen lærer du hvordan du konstruerer widgeten ved hjelp av din __construct funksjon.