Documentazione Pulsante Condividi

Aspetti generali


Questa documentazione è per gli sviluppatori che vogliono controllare il modo in cui il contenuto del proprio blog viene mostrato nei post Tumblr creati con il widget del pulsante condividi installato nella loro pagina.

Per avere pulsanti condividi nel tuo sito, creane uno con il nostro generatore di pulsanti condividi.

Pulsante base


Nelle pagine che includono il nostro pulsante di condivisione JavaScript (sotto), il pulsante di condivisione è solo un tag ancora di classe tumblr-share-button:

<a class="tumblr-share-button" href="https://www.tumblr.com/share"></a>
<script id="tumblr-js" async src="https://assets.tumblr.com/share-button.js"></script>

Nota: se hai più di un pulsante per la condivisione sulla tua pagina, devi includere lo JavaScript una volta sola, meglio se appena prima del tag di chiusura del </body>codice.

Contenuti del post di default

Di default, il pulsante condividi creerà un Post di Foto o un Post di Link a diversa di quale meta tag Open Graph trova nella tua pagina, ma può essere configurato per usare qualsiasi tipo di post vuoi (vedi le istruzioni qui sotto). Queste sono le opzioni di default:

  • Post di Foto.  Il pulsante condividi creerà un Post di Foto se trova una tag og:image con un'immagine larga almeno 500 px, con una proporzione minore di 3:1. Userà la og:description per la descrizione del post.
  • Post di Link. Il pulsante condividi creerà un Post di Link se non trova un'immagine appropriata per un Post di Foto. og:title verrà usato per il titolo, og:description per la descrizione, e l'URL canonico verrà usato come URL del post di link.

Configurazione contenuto del post


Se vuoi che il pulsante condividi crei un particolare tipo di post, puoi farlo con le seguenti opzioni. Queste opzioni possono essere impostate come dati attribuiti nell'ancoraggio del pulsante o come parametri della stringa query nell'URL nell'attributo href del pulsante.

OpzioneDescrizioneAttributo datiParametro stringa query
Tipo di post Tipi di post Tumblr. Opzioni valide sono: testo, foto, link, citazione, chat o video data-posttype posttype
Tag Una lista di tag separate da virgola data-tags tags
Titolo Usato nei post di Testo, di Link e di Chat data-title titolo
Contenuto Il contenuto del post varia a diversa del tipo di post che stai usando. Per un post di Foto, sarà un URL della foto. Per un post di Citazione, sarà la citazione.

Vedi Contenuto del Post per Tipo qui sotto per dettagli.
data-content content
Titolo Usato in post di Foto, Link, Video e Citazioni. data-caption caption
Mostra attribuzione Decide se includere o meno un attribuzione nel corpo del post che legge, "via " data-show-via show-via

Contenuto del post per tipo


Testo
data-title: Titolo del post di Testo
data-content: Corpo del post di Testo

Foto
data-content: L'URL di una singola foto o una lista di URL di foto separati da virgola per un fotoset.
data-caption: Didascalia post di foto.

Citazione
data-content: La citazione.
data-caption: La fonte della citazione (speaker and citation).

Link
data-title: Titolo del post di Link.
data-content: L'URL del link target.
data-caption: Una descrizione del link.

Chat
data-title: Titolo del post di Chat.
data-content: Il corpo della chat (quello che dicono i protagonisti).

Video
data-content: URL del video o codice da incorporare.
data-caption: Descrizione del post di Video.

Configurazione stile del pulsante


Puoi configurare lo stile del pulsante condividi con questi attributi dei dati nel pulsante tag di ancoraggio:

OpzioneValori PossibiliDefault
data-color blue
black
white
blue
data-notes top
right
none
none

URL canonico


Per mostrare il conteggio delle note e perché venga incrementato nel modo giusto, devi fornire l'URL della pagina. Il pulsante condividi lo cercherà in questi posti e in quest'ordine:

PrioritàFonte Dati
1 attributo data-href nella tag di ancoraggio del pulsante
2 Elemento link canonico
3 og:url meta elemento
4 L'URL della pagina

Se stai costruendo un pulsante personalizzato (vedi sotto), devi passare l'URL canonico nella stringa del quesito, in aggiunta a qualsiasi contenuto di post. Per esempio:

http://tumblr.com/widgets/share/tool?canonicalUrl=http://cats.com

Costruisci il tuo pulsante


Se vuoi personalizzare completamente il design del tuo pulsante per il tuo sito, puoi costruirne uno tuo. Fai aprire al tuo pulsante personalizzato una finestra pop up con questo URL https://www.tumblr.com/widgets/share/tool e passa tutte le informazioni del contenuto del post come parametri della stringa query, come descritto sopra. Lo strumento di condivisione si ridimensionerà in maniera compatibile con il contenuto del post, ma ti raccomandiamo di aprire la pagina a 540x600 pixel.

Conteggio note

Puoi anche mostrare il conteggio delle note sul tuo pulsante personalizzato. Puoi passare l'URL della tua pagina alla nostra API condividi statistiche e riportare il conteggio delle note, così:

http://api.tumblr.com/v2/share/stats?url=https://www.tumblr.com/buttons

Assicurati di avere messo in cache la risposta e aggiorna solo dopo circa dieci minuti. Tumblr mette in cache per dieci minuti il conteggio delle note degli URL condivisi.

Lingua pulsante


Puoi localizzare il tuo pulsante con l'attributo data-locale nella tag d'ancoraggio del pulsante. Tumblr supporta le seguenti lingue:

LinguaValore Locale
Inglese en_US
Tedesco de_DE
Francese fr_FR
Italiano it_IT
Giapponese ja_JP
Turco tr_TR
Spagnolo es_ES
Russo ru_RU
Polacco pl_PL
Portoghese pt_PT
Portoghese pt_BR
Olandese nl_NL
Coreano ko_KR
Cinese (Semplificato) zh_CN
Cinese (Tradizionale) zh_TW