WordPress - Code Snippets

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.

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