Handleiding: Het tonen van het aantal “nuttig”-stemmen bij een BetterDocs-artikel

Met deze handleiding toon je in elk (BetterDocs) artikel het dynamische aantal positieve beoordelingen (upvotes) met een nette Nederlandstalige tekst. De telling wordt automatisch opgehaald uit de BetterDocs-database.

Achtergrondinformatie #

BetterDocs slaat per Knowledge Base-artikel bij hoeveel gebruikers het artikel als nuttig (“happy” of positieve stem) is beoordeeld. Dit gebeurt in de database-tabel wp_betterdocs_analytics, kolom happy.

Shortcode toevoegen (éénmalig in functions.php of met een plugin) #

Voeg onderstaande PHP-code toe aan je thema’s functions.php bestand, óf gebruik een plugin zoals “Code Snippets” om de code veilig toe te voegen:

function betterdocs_show_upvotes_database() {
global $post, $wpdb;
if (!isset($post->ID)) {
return 'Geen geldig document gevonden.';
}
$table = $wpdb->prefix . 'betterdocs_analytics';
$post_id = (int)$post->ID;

$upvotes = $wpdb->get_var(
    $wpdb->prepare("SELECT happy FROM $table WHERE post_id = %d", $post_id)
);
$upvotes = $upvotes ? (int)$upvotes : 0;

// Tekst afhankelijk van het aantal stemmen
if ($upvotes === 1) {
    $tekst = "1 gebruiker vond dit artikel nuttig (1 Stem)";
} else {
    $tekst = $upvotes . " gebruikers vonden dit artikel nuttig (" . $upvotes . " Stemmen)";
}

return '<div class="betterdocs-upvotes">' . $tekst . '</div>';

}
add_shortcode('betterdocs_upvotes_real', 'betterdocs_show_upvotes_database');

Gebruik de shortcode in je artikelen #

Plaats de shortcode ergens in de tekst van je (BetterDocs-)artikel of in een widget:

Verwijder # uit onderstaande shortcode om de shortcode te activeren

[#betterdocs_upvotes_real] 

De upvote-telling wordt dan weergegeven als bijvoorbeeld:

“2 gebruikers vonden dit artikel nuttig (2 Stemmen)”

Aanpassen of uitbreiden? #

Wil je ook het aantal “niet nuttig” (downvotes) of neutrale stemmen tonen? Pas dan de PHP-code aan en lees ook de kolommen sad en normal uit dezelfde database-tabel.

Problemen oplossen #

• Krijg je altijd “0 gebruikers”, check dan of er in de tabel wp_betterdocs_analytics daadwerkelijk een waarde bij happy staat voor het juiste artikel.
• Controleer of de juiste code in een actief (child)thema of werkende snippet-plugin staat.