Codering en registratie van uw WordPress Widget

Dit is het tweede deel van een serie waarin u wordt uitgelegd hoe u uw eerste WordPress-widget maakt. In het eerste deel hoorde je over de Widgets API en de WP_Widget klasse. In dit deel leer je hoe je het proces van het bouwen van je widget kunt starten door de klasse te maken die je widget vasthoudt en registreert.

In zijn geheel bestaat deze serie uit vijf delen:

• Inleiding tot widgets en de widget-API
• Codering en registratie van uw widget
• Je widget maken
• Het formulier voor uw widget bouwen
• Uw widget weergeven in het juiste widgetgebied

Wat je nodig hebt

Als je deze serie wilt volgen, heb je het volgende nodig:

• Een ontwikkelingsinstallatie van WordPress
• Een code-editor

De plug-in instellen

Eerst moet je je plug-in instellen. Maak een nieuw bestand in uw wp-content / plugins directory. Ik heb de mijne gebeld tutsplus-list-subpagina-widget.php.

Voeg het volgende toe aan het bestand:

Uiteraard wil je de naam en url van de auteur veranderen, maar dit geeft WordPress wat het nodig heeft om de plug-in in het Plug-ins scherm weer te geven.

Sla je plugin-bestand op.

Widgetklasse maken

De volgende stap is om een ​​nieuwe klasse te maken om het bestand uit te breiden WP_Widget klasse.

Type deze code in uw plugin-bestand:

Laten we eens kijken naar waar die klasse uit bestaat:

• de __construct functie zal doen wat je verwacht - het zal de functie construeren. Binnen die functie definieer je dingen als de ID van de widget, de titel en beschrijving.
• de het formulier functie maakt het formulier in het Widgets-scherm waarmee gebruikers de widget kunnen aanpassen of activeren.
• de bijwerken functie zorgt ervoor dat WordPress alle instellingen bijwerkt die gebruikers invoeren in het Widgets-scherm.
• de widget functie definieert wat wordt uitgevoerd door de widget aan de voorkant van de site.

De laatste drie hiervan hebben parameters die ik in meer detail zal toelichten in de relevante tutorials.

De widget registreren

Je widget zal niet werken tenzij je hem registreert bij WordPress. Onder je klas, voeg de functie toe en haak dit om dit te doen:

De register_widget () functie is een WordPress-functie waarvan de enkele parameter de naam is van de klasse die u zojuist hebt gemaakt.

Vervolgens koppelt u uw functie aan de widgets_init haak om ervoor te zorgen dat het wordt opgehaald door WordPress.

Opmerking: je widget werkt nog niet en wordt niet weergegeven op het Widgets-scherm, dus maak je geen zorgen over het activeren van de plug-in. U moet alle stappen in deze serie voltooien voordat deze werkt.

Samenvatting

U bent nu begonnen met het maken van uw eerste WordPress-widget. U hebt een plug-in voor de widget gemaakt, een klas gemaakt om de widget te construeren en deze te registreren.

In de volgende tutorial leer je hoe je de widget construeert met jouw __construct functie.