English version of this post
Top Commenters è un plug-in molto diffuso per la piattaforma WordPress: crea una classifica di nominativi (o meglio nicknameW) calcolata tra tutti gli autori dei commenti di un blog in base alla frequenza con cui questi ultimi lasciano i loro contributi.
La graduatoria è in ordine decrescente, vale a dire che è ordinata in base al numero dei commenti: chi ne lascia una maggiore quantità sale di conseguenza nella stessa. Lo scopo è quello di stimolare i visitatori del proprio blog a commentare, partecipando maggiormente alle discussioni aperte da ciascun post.
Ogni nominativo presente in graduatoria ha naturalmente un collegamento ipertestuale al sito indicato in fase di registrazione del proprio commento (che generalmente corrisponde al blog del commentatore): in definitiva, quindi, la classifica diventa una sorta di BlogrollW di lettori.
Ora è disponibile anche per BlogEngine.NET un estensione, o meglio un componente (widgetW) che consente di replicare non solo le medesime funzionalità del gemello disponibile per WordPress, ma anche arricchendosene di altre.
Non essendo un estensione, non è sufficiente semplicemente copiare il file relativo nella cartella dedicata, ma è necessario anche inserire un'unica istruzione di codice all'interno del template del proprio blog nella posizione in cui si desidera visualizzare l'elenco (localizzata generalmente nella sidebar).
Installazione
Scaricare l'archivio compresso TopCommenters.zip (2,96 kb), quindi:
- Copiare il file TopCommenters.cs nella cartella /App_Code/Controls/
- Se si desidera inserire il widget nella sidebar, aprire il file SidePanel.ascx relativo al tema utilizzato, individuare la posizione desiderata nel codice ed aggiungere il tag:
<blog:TopCommenters runat="server" />
Configurazione
Il componente è completamente configurabile valorizzando i seguenti attributi del tag specifico:
- MaxNumber: imposta il numero massimo di commentatori che devono comparire nella lista (Default = 10)
- GravatarSize: imposta la grandezza in pixel dell'avatar, se attivo (Default: 24 - Valore minimo impostabile: 10)
- Gravatar: imposta o meno la visualizzazione dell'avatar associato al commentatore. Segue le Impostazioni effettuate da Pannello di Controllo relativamente all'aspetto dell'avatar (Default: false)
- Percentage: imposta o meno la visualizzazione in graduatoria per ciascun nome del numero di commenti o della percentuale degli stessi rispetto al loro totale (Default: false)
- NoFollow: imposta l'attributo rel="nofollow" per ciascun collegamento, se presente (Default: true)
- Link: imposta o meno i collegamenti al sito di riferimento per ciascun commentatore (Default: true)
- Summary: Accoda alla lista una riga di statistiche contenenti il numero totale di commentatori e quello dei commenti. Sono naturalmente esclusi dai totali i contributi degli autori dei post (Default: true)
- NoDataMessage: imposta il messaggio da visualizzare nel caso in cui non siano presenti commenti (Default: "Al momento nessun dato disponibile")
A titolo di esempio, ecco il codice utilizzato per visualizzare il widget nella sidebar di questo blog:
<blog:TopCommenters Percentage="true" Gravatar="true" runat="server" />
Personalizzazione
Per modificare l'aspetto del widget è sufficiente agire opportunamente sul foglio di stile associato al tema utilizzato.
La lista puntata prodotta è racchiusa all'interno di una coppia di tag:
<div id="topcommenters"> ... </div>
I dati numerici relativi al numero di commenti (o percentuale relativa degli stessi) effettuati da ciascun commentatore sono racchiusi al'interno di una coppia di tag
<span> ... <span>
Top Commenters extension for BlogEngine.NET
This plugin (like the same one for WordPress) will add a list of the most frequent commenters posting to your blog (highest number of comments at the top). The list items will be links to the comment author’s URL, if provided.
This is supplied like a component (widget) to insert in the sidebar, o where preferred in the master page of your theme.
Installation
Download the compressed file TopCommenters.zip (2,96 kb), then:
- Copy TopCommenters.cs into /App_Code/Controls/ folder
- If it is desired to insert the widget in the sidebar, open SidePanel.ascx located in your theme folder, then add this line of code:
<blog:TopCommenters runat="server" />
Configuration
The component is completely configurable valuing the following attributes:
- MaxNumber: set the max number of commenters to display (Default = 10)
- GravatarSize: set the size of the avatare image in pixels (Default: 24 - Minimum value: 10)
- Gravatar: display or not the avatar image (gravatar, monster or both) (Default: false)
- Percentage: display, for every commenter, the relative percentage of comments regarding their total (Default: false)
- NoFollow: set the rel="nofollow" attribute to every link (Default: true)
- Link: add or not the link to every commenter (Default: true)
- Summary: Append a summary of comments and users statistics to widget (Default: true)
- NoDataMessage: Set the error message if they are not present commenters (Default: "Al momento nessun dato disponibile")
Example: the used code in order to visualize the widget here in the sidebar of this blog
<blog:TopCommenters Percentage="true" Gravatar="true" runat="server" />
Customization
The bulletted list produced is enclosed in:
<div id="topcommenters"> ... </div>
The numerical data of the number of comments (or relative percentage of the same ones) are enclosed in:
<span> ... <span>
P.S.: i'm sorry for my poor english
