20 mei 2019
Geen reacties
1949
Dashboard Widgets Maken
Dashboard Widgets

Dashboard Widgets
Niet alleen de blokken (boxen) welke we in Sidebars kunnen plaatsen worden “Widgets” genoemd, ook de blokken welke we zien nadat we ingelogd zijn als “Op dit moment”, “WordPress evenementen en nieuws” en “Eenvoudig een concept maken” worden Widgets genoemd.
Via de scherminstellingen rechts bovenin kunnen we de blokken activeren of deactiveren.
Een aantal Widgets welke standaard door WordPress worden geïnstalleerd zetten wij direct uit. Dat zijn de “Welkom” en de “Eenvoudig een concept maken” en de “Activiteiten” -Widgets. Voor ons hebben deze weinig toegevoegde waarde.
Plugins, voegen soms ook hun eigen Dashboard-Widget toe welke ook aan/uit te schakelen zijn.
Nu kunnen er situaties zijn dat we informatie over onze website graag direct zouden willen zien in dit Dashboard gebied.
Voorbeeld:
Om ons “WordPress Woordenboek” te kunnen raadplegen moet je je als bezoeker registreren. Daarna kun je onbeperkt en gratis het woordenboek inzien. We hebben hiervoor een extra gebruikersrol aangemaakt met alleen leesrechten.
Willen we nu weten hoeveel geregistreerde lezers we hebben dienen we via het Gebruikers-menu in het Dashboard het aantal te bekijken. Handiger zou zijn als we een “Dashboard Widget” zouden hebben die ons die informatie verschaft.
Dashboard Widget Maken
De structuur van een Dashboard Widget is relatief eenvoudig en wordt aangemaakt met behulp van de volgende code:
/* QWAIN Custom Dashboard Widget */ add_action( 'wp_dashboard_setup', 'qwain_register_dashboard_widget' ); function qwain_register_dashboard_widget() { wp_add_dashboard_widget( 'wpwb_dashboard_widget', 'WordPress Woordenboek Gebruikers', 'wpwb_dashboard_widget_display' ); }
Om een Dashboard Widgets aan te maken heeft WordPress een tweetal standaard functies beschikbaar gesteld voor thema en plugin -ontwikkelaars: “wp_dashboard_setup” en “wp_add_dashboard_widget”.
De functie “wp_add_dashboard_widget” verlangd drie parameters:
- Widget Slug;
- Widget Titel;
- Widget Functie.
Deze zie je in ons voorbeeld hiervoor terug op regel 5,6 en 7.
Via de “Widget Functie” welke wij benoemd hebben op regel 7 regelen we dan wat er in de Widget getoond moet worden.
Als voorbeeld tonen we een eenvoudig stukje tekst met behulp van de Widget-Functie welke we aanroepen op regel 7 hiervoor:
/* QWAIN Dashboard Widget Informatie Functie */ function wpwb_dashboard_widget_display() { echo 'Hier komt dan informatie (code) welke we in de Dashboard Widget willen laten zien.'; }
Zowel de code om de Widget aan te maken als deze code plaatsen we in het functions.php bestand van ons Child-Thema.
(bekijk evt. het volgende artikel hoe je code-snippets dient te gebruiken: WordPress Code Snippets)
Na het toevoegen van deze twee stukjes code, zien we de Widget in het “Dashboard Home” verschijnen:

Nieuw ‘Eigen’ Dashboard Widget
Net als alle andere Dashboard Widgets is ook deze te verplaatsen en evt. via de scherminstellingen in of uit te schakelen.
Door nu de Widget-Functie aan te passen met eigen code kunnen we de Widget vullen met de informatie die we zelf graag willen zien.
We hebben, deze naar eigen wens deze aangevuld en zien dan voor ons interessante informatie direct in het Dashboard terug:

Widget Functie Uitgebreid
Dashboard Widget Plugin
In dit voorbeeld hebben we de Dashboard Widget aangemaakt en toegevoegd aan het functions.php bestand van het Child-Thema. Het is altijd raadzaam om alle aanpassingen welke we verrichten aan het thema of de functies welke we toevoegen via het functions.php bestand goed te documenteren zodat we later eenvoudig kunnen terug lezen wat we allemaal hebben aangepast of toegevoegd.
Wisselen we van thema, dan is het functions.php bestand waarmee we deze Dashboard Widget hebben geactiveerd niet meer aanwezig. Het functions.php bestand wordt namelijk vervangen door het nieuwe thema.
In dat geval is het handiger om de code waarmee we de Dashboard Widget hebben gemaakt te plaatsen in een “eigen plugin”.
Hoe je een eigen plugin maakt hebben we beschreven in dit artikel: Eigen Plugin Maken.
Vragen & Info
Heb je vragen naar aanleiding van dit artikel, stuur ons dan een mail op: info@qwain.nl of geef een reactie via onderstaand reactie-formulier.
Wil je een eigen code-snippet (functie) laten maken, dan kunnen wij dat ook verzorgen. Neem dan contact met ons op via voorgaand e-mailadres. Ook geven we trainingen speciaal gericht op het aanpassen en fine-tunen van het WordPress Thema. Meer informatie over deze training vindt je hier: WordPress Design.
Op de hoogte blijven van alle WordPress Nieuwtjes, Tips & Tricks… schrijf je dan in voor onze Nieuwsbrief en volg ons Facebook .
Overige Artikelen