17 marzo 2008  2

Feedburner Stats component per BlogEngine.NET

English version of this post

FeedBurner Stats Package BE Dopo aver rilasciato la versione per Wordpress nei giorni scorsi, è ora disponibile il componente (widgetW) 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

Syndication

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:


<blog:FeedburnerStats runat="server" />

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:


<blog:FeedburnerStats ID="FeedburnerStats1" HeaderMessage="Feedburner stats al" CirculationLabel="lettori" runat="server" />

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)

Syndication

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:


<blog:FeedburnerStats runat="server" />

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


<blog:FeedburnerStats ID="FeedburnerStats1" HeaderMessage="Feedburner stats al" CirculationLabel="lettori" runat="server" />

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

Esprimi il tuo giudizio

Commenti (2) -

Al Nyveldt
Al Nyveldt
25 mar 2008 alle 03:22  01
Wow.  I never knew Feedburner had an API and I've never been a fan of their generic feedburner buttons.  This is a very cool alternative.

Thanks for sharing it.
Cristiano
Cristiano
25 mar 2008 alle 10:40  02
Al Nyveldt ha scritto:
I've never been a fan of their generic feedburner buttons.

Me too Wink

Thanks for sharing it.
Smile

Pingbacks and trackbacks (1)+

Aggiungi Commento

biucitecode
  • Commento
  • Anteprima
Loading


| |   |  

Codice QR

Codice QR - cristianofino.net

Ultimi Commenti