English version of this post

Dopo aver rilasciato la versione per Wordpress nei giorni scorsi, è ora disponibile il componente (widget^W) Feedburner Stat anche per BlogEngine.NET. Inizialmente ne avevo pianificato la pubblicazione di concerto con il rilascio della versione 1.4 di BE (che supporterà anche i widget): poichè tale data sembra però ancora abbastanza lontana, ho deciso di condividerne da subito almeno la versione di tipo "componente". Per maggiori dettagli su funzionalità e vantaggi dell'oggetto in questione consiglio naturalmente la lettura del corrispondente articolo relativo alla versione per Wordpress.

In sintesi è possibile:

• Mostrare i dati giornalieri relativi al numero dei feedreader (circularity), degli hits e delle reach relativi al proprio feed Feedburner.
• Personalizzare in ogni minimo dettaglio l'aspetto grafico dei dati mostrati semplicemente andando a modificare gli stili CSS associati ad ogni singolo elemento testuale, permettendo di combinare a piacere testo e grafica a seconda dei propri gusti ed in tono con il layout associato al proprio sito.
• Impostare un livello di aggiornamento personalizzato per ridurre al minimo l'impegno di banda dovuto alle richieste di informazioni da inoltrare alle API di Feedburner. 

Non essendo un estensione, non è sufficiente 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 FeedburnerStats.zip (2,56 kb) (rel: 1.0.0), quindi:

1. Decomprimere il file
2. Copiare il file FeedburnerStats.cs nella cartella /App_Code/Controls/
3. 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:

Configurazione

Il componente è completamente configurabile valorizzando i seguenti attributi del tag specifico:

• FeedburnerUrl: imposta l'indirizzo del feed Feedburner che, generalmente è nella forma
  
  http://feeds.feedburner.com/{nomedelfeed}
  (Default = il valore assegnato all'indirizzo del feed Feedburner dal Pannello di Controllo di BlogEngine, se presente)
• Refresh: imposta la frequenza di aggiornamento (in ore) dei dati del feed (Default: 6)
• HeaderMessage: imposta l'header anteposto ai dati statistici (Default: Statistiche feedburner del).
• CirculationLabel: imposta l'etichetta relativa ai feedreader o circulation (Default: readers).
• HitsLabel: imposta l'etichetta relativa alle hits (Default: hits).
• ReachLabel: imposta l'etichetta relativa ai reach (Default: reach).
• Separator: imposta il carattere di separazione tra i dati numerici mostrati (Default: ~).
• NoDataMessage: imposta il messaggio di errore se il campo FeedburnerUrl non è stato valorizzato (Default: Nessun feed alternativo definito)

A titolo di esempio, ecco il codice utilizzato per visualizzare il relativo widget nella sidebar di questo blog:

Personalizzazione

I dati mostrati sono rappresentati unicamente in forma testuale. Tuttavia, essendo associate delle classi CSS specifiche a ciascun elemento, le possibilità di personalizzazione del loro aspetto sono pressocchè illimitate.

In dettaglio:

• L'header è racchiuso nel tag:
  <span class="feed_header"> ... </span>
• Il numero relativo alla Circulation è racchiuso nel tag:
  <span class="feed_circulation"> ... </span>
• Il numero relativo agli Hits è racchiuso nel tag:
  <span class="feed_hits"> ... </span>
• Il numero relativo ai Reach è racchiuso nel tag:
  <span class="feed_reach"> ... </span>
• La data ed i singoli valori numerici sono in grassetto e quindi racchiusi nel tag:
  <b> ... </b>

Altre estensioni ...

Feedburner Stats component for BlogEngine.NET

Feedburner Stats is a new BlogEngine.NET component that displays the number of subscribers (AKA: circulation), hits and reach to your feedburner feed (you can see it in action in the sidebar of my blog, of course)

Installation

Download the compressed file FeedburnerStats.zip (2,56 kb) (rel: 1.0.0), then:

1. Extract files.
2. Copy FeedburnerStats.cs into /App_Code/Controls/ folder
3. 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:

Configuration

The component is completely configurable valuing the following attributes:

• FeedburnerUrl: set the Feedburner address url, like
  
  http://feeds.feedburner.com/{nomedelfeed}
  (Default = BlogSettings.Instance.AlternateFeedUrl)
• Refresh: set the time interval (hours) to update the statistics (Default: 6)
• HeaderMessage: set the header message(Default: Statistiche feedburner del).
• CirculationLabel: set the circulation label value (Default: readers).
• HitsLabel: set the hits label value (Default: hits).
• ReachLabel: set the reach label value (Default: reach).
• Separator: set the separator character between labels (Default: ~).
• NoDataMessage: Sets the error message if it's not present the Feedburner feed (Default: Nessun feed alternativo definito)

Example: the used code in order to visualize the widget here in the sidebar of this blog

Customization

The widget data are simply represented in text form. However, being associated CSS class specific to each item, the ability to customize their appearance is almost unlimited.

In detail:

• The header is enclosed in:
  <span class="feed_header"> ... </span>
• The Circulation data is enclosed in:
  <span class="feed_circulation"> ... </span>
• The Hits data is enclosed in:
  <span class="feed_hits"> ... </span>
• The Reach data is enclosed in:
  <span class="feed_reach"> ... </span>
• The date and individual numerical values are enclosed in:
  <b> ... </b>

You can leave comments in English ...

More extensions ...

P.S.: i'm sorry for my poor english