Simple Blog Stats

Installatie

Hoe te installeren

1. Upload de plugin naar je blog en activeer dan
2. Ga naar de instellingen om je opties te configureren

Meer informatie over het installeren van WP plugins

Hoe te gebruiken

Ga naar de pagina met plugin instellingen om je shortcodes te configureren. Kopieer/plak vervolgens de shortcodes in een bericht, pagina of widget om je statistieken weer te geven. Als je je statistieken overal in je thema template wilt weergeven, ga je naar het gedeelte ‘Template tags’ van de instellingenpagina.

Maak kennis met de shortcodes

Bezoek de pagina met instellingen voor plugins voor een volledige lijst met shortcodes. Daar kan je de uitvoer van elke shortcode aanpassen. Hier is een lijst van alle SBS shortcodes:

[sbs_posts]                = number of posts *
[sbs_posts_alt]            = number of posts *
[sbs_pages]                = number of pages
[sbs_drafts]               = number of drafts
[sbs_comments]             = number of comments *
[sbs_moderated]            = moderated comments
[sbs_approved]             = approved comments *
[sbs_users]                = number of users
[sbs_cats]                 = number of categories
[sbs_tags]                 = number of tags *
[sbs_tax tax="tax_name"]   = number of taxonomy terms
[sbs_tax_posts ...]        = number of posts for tax term(s) *
[sbs_word_count]           = number of words in post *
[sbs_word_count_all]       = number of words in all posts (all post types) *
[sbs_word_count_custom]    = number of words in custom field *
[sbs_updated]              = site last updated *
[sbs_latest_posts]         = displays recent posts
[sbs_latest_comments]      = displays recent comments
[sbs_roles]                = number of users per role *
[sbs_cpts_count]           = list of CPT counts
[sbs_cpt_count cpt="post"] = number of any post type
[sbs_blog_stats]           = displays list of blog stats
[sbs_logged_users]         = number of logged-in users *
[sbs_media_count]          = number of media files *
[sbs_reading_time]         = estimated reading time

* See notes below.

[sbs_posts]

De [sbs_posts] shortcode accepteert verschillende attributen die kunnen worden gebruikt om je bericht statistieken aan te passen:

cat           - limit by category    (default: empty = all cats)
tag           - limit by tag         (default: empty = all tags)
type          - limit by post type   (default: empty = post)
status        - limit by post status (default: empty = publish)
exclude       - exclude post IDs     (comma separated list of post IDs)
exclude_cat   - exclude categories   (comma separated list of category IDs)
number_format - thousands separator  (default: comma, like 1,234)

Dus standaard zal [sbs_posts] zonder attributen het totale aantal gepubliceerde berichten in elke categorie of tag weergeven.

Hier is een voorbeeld dat gebruik maakt van de attributen:

[sbs_posts cat="sci-fi" tag="sequel" type="movie" status="draft"]

Dit toont alle concepten van het extra berichttype “film” die zich in de categorie “sci-fi” bevinden en zijn getagd als “vervolg”.

Om het aantal berichten voor meerdere categorieën te tonen, scheid categorie slugs met komma’s, zoals [sbs_posts cat="cat-1,cat-2,cat-3"].

Meer informatie over de mogelijke waarden voor deze attributen:

• cat
• tag
• type
• status

[sbs_posts_alt]

De [sbs_posts_alt] shortcode is voor sites met VEEL berichten (zoals 10.000+). Het is niet zo flexibel als [sbs_posts], maar biedt wel verschillende attributen:

[sbs_posts_alt type="page" status="draft" number_format=","]

Je kunt het type en de status van de berichten die geteld moeten worden wijzigen. De number_format attribuut bepaalt het scheidingsteken voor grote getallen. Deze shortcode moet alleen worden gebruikt voor sites met extreme aantallen berichten.

[sbs_updated]

De [sbs_updated] shortcode geeft de datum en tijd van het laatste bericht weer. Het accepteert twee attributen, format_date en format_time, waarmee je het formaat van respectievelijk de uitvoerdatum en -tijd kunt aanpassen. Hier zijn enkele voorbeelden om te laten zien hoe het werkt:

[sbs_updated format_date="Y/m/d"] = custom format for date, default format for time
[sbs_updated format_time="H:i:s"] = custom format for time, default format for date

[sbs_updated format_date="Y/m/d" format_time="disable"] = custom format for date, disable time output
[sbs_updated format_date="Y/m/d" format_time="H:i:s"]   = custom format for both date and time

Voor de attribuutwaarden kan je elke geldige PHP datum/tijd notatie gebruiken. Bekijk de PHP-documenten voor een volledige lijst met beschikbare formaten.

[sbs_comments]

Standaard geeft de [sbs_comments] shortcode het totale aantal reacties weer voor alle berichten op je site. Als je het aantal reacties alleen voor een specifieke categorie wilt weergeven, voeg je het kenmerk kat toe, zoals:

[sbs_comments cat="1"]

Je kunt de categorie ID wijzigen om het aantal opmerkingen voor elke categorie weer te geven.

[sbs_approved]

Standaard toont de [sbs_approved] shortcode het totale aantal reacties dat is toegestaan/gepubliceerd. Deze shortcode biedt een optioneel attribuut om het aantal format te specificeren:

[sbs_approved number_format=","]

Je kunt het aantal format wijzigen naar wat logisch is voor je site.

[sbs_tags]

Standaard toont de [sbs_tags] shortcode het totale aantal tags dat is aangemaakt. Deze shortcode biedt een optioneel attribuut om het aantal format te specificeren:

[sbs_tags number_format=","]

Je kunt het aantal format wijzigen naar wat logisch is voor je site.

[sbs_tax_posts]

De [sbs_tax_posts] shortcode geeft het aantal berichten weer dat bij een specifiek berichttype hoort en taxonomieterm(en). Hier is een voorbeeld:

[sbs_tax_posts tax="taxonomy" terms="term-1, term-2, term-3" type="custom-post-type"]

Wijzig vervolgens de kenmerkwaarden zodat ze overeenkomen met respectievelijk je taxonomie, termen en berichttype.

[sbs_word_count]

De [sbs_word_count] shortcode geeft het aantal woorden in de inhoud van een bericht weer. Standaard wordt het aantal woorden in het huidige bericht weergegeven. Of je kunt een willekeurige bericht ID opgeven:

[sbs_word_count]         // displays word count of current post
[sbs_word_count id="1"]  // displays word count of post with ID = 1

Gebruik de shortcode [sbs_word_count_all] om het aantal woorden voor alle berichten (elk berichttype) weer te geven. Bekijk de veelgestelde vragen om het berichttype voor deze shortcode aan te passen.

[sbs_word_count_custom]

De [sbs_word_count_custom] shortcode geeft het aantal woorden in elk aangepast veld weer. Het vereist een post-ID en de naam van een aangepast veld. Hier is een voorbeeld:

[sbs_word_count_custom post_id="12" key="author-bio"]

Dus als post-ID = 12 een aangepast veld met de naam “auteur-bio” heeft, retourneert deze shortcode het aantal woorden in het aangepaste veld (niet het bericht).

[sbs_roles]

De [sbs_roles] shortcode geeft een lijst weer van alle gebruikersrollen en het bijbehorende aantal gebruikers. Voeg het kenmerk rol toe om het aantal gebruikers voor een specifieke rol weer te geven. Voorbeelden:

[sbs_roles]                // displays list of roles and number of users
[sbs_roles role="author"]  // displays number of users for specified role
[sbs_roles role="all"]     // displays list of roles and number of users

Het kenmerk role accepteert een waarde van all of een geldige gebruikersrol.

[sbs_cpt_count]

De [sbs_cpt_count] shortcode toont het aantal berichten voor het opgegeven berichttype. Bijvoorbeeld, als je het aantal berichten voor een berichttype genaamd food wilt tonen, zou het er zo uitzien:

[sbs_cpt_count cpt="food"]

Het standaard berichttype voor deze shortcode is bericht. De [sbs_cpt_count] shortcode accepteert drie attributen die kunnen worden gebruikt om aan te passen:

cpt           - specifies the post type
txt           - specifies custom label/name
number_format - thousands separator  (default: comma, like 1,234)

Standaard zal [sbs_cpt_count] zonder attributen het totale aantal gepubliceerde berichten tonen.

[sbs_logged_users]

De [sbs_logged_users] shortcode kan worden gebruikt om het aantal momenteel ingelogde gebruikers weer te geven. Deze shortcode heeft geen attributen, maar biedt wel een widget die het huidige aantal ingelogde gebruikers weergeeft op het WP Dashboard.

[sbs_media_count]

De [sbs_media_count] shortcode kan statistieken weergeven voor elk(e) mediatype(s). Hier zijn enkele voorbeelden:

[sbs_media_count type="all"]          = displays number of all media files
[sbs_media_count type="image"]        = displays number of image files
[sbs_media_count type="video"]        = displays number of video files
[sbs_media_count type="pdf,doc,docx"] = displays number of PDF, DOC, and DOCX files
[sbs_media_count type="mp3"]          = displays number of MP3 files
[sbs_media_count]                     = displays number of all media files

Uitvoer aanpassen

De meeste shortcodes geven alleen een nummer weer. Ga naar de instellingen van de plugin om het nummer met je eigen tekst aan te passen. Daar kan je elke tekst of markering toevoegen die voor/na elke shortcode moet worden weergegeven.

Er zijn drie shortcodes die wat standaardtekst uitvoeren samen met het stats nummer:

[sbs_roles]
[sbs_cpt_count]
[sbs_media_count]

Dus om de tekst voor deze shortcodes aan te passen, kun je een txt attribuut toevoegen en de waarde instellen op wat je maar wilt, bijvoorbeeld:

[sbs_roles txt="Whatever you want"]
[sbs_cpt_count txt="Whatever you want"]
[sbs_media_count txt="Whatever you want"]

Of als je alleen de extra tekst wilt uitschakelen en alleen het nummer wilt weergeven, stel je het attribute txt in op null, zoals:

[sbs_roles txt="null"]
[sbs_cpt_count txt="null"]
[sbs_media_count txt="null"]

Op die manier wordt alleen het nummer weergegeven zonder enige andere tekst.

Bevalt de plugin?

Als je van eenvoudige blogstatistieken houdt, neem dan even de tijd om een 5-sterren waardering te geven. Het helpt om de ontwikkeling en ondersteuning sterk te houden. Bedankt!

Upgrades

Om SBS te upgraden, verwijder je de oude versie en vervang je deze door de nieuwe versie. Of klik gewoon op “Update” in het scherm Plugins en laat WordPress het automatisch voor je doen.

Standaardopties herstellen

Om de standaard plugin opties te herstellen, moet je de plugin verwijderen/opnieuw installeren of de plugin instellingen > Standaardopties herstellen.

Verwijderen

Eenvoudige blogstatistieken ruimt zichzelf op. Alle plugin instellingen worden uit je database verwijderd wanneer de plugin wordt verwijderd via het scherm Plugins. Alle shortcodes die je aan je berichten en pagina’s hebt toegevoegd, worden niet verwijderd. Evenzo worden eventuele template tags die aan je thema template zijn toegevoegd, niet verwijderd.