Finestra di condivisione

La finestra di condivisione consente agli utenti di pubblicare singole notizie sul proprio diario, su quello di un amico, su un gruppo o in un messaggio privato su Messenger. Non sono necessari Facebook Login o autorizzazioni avanzate, pertanto si tratta del modo più semplice per abilitare la condivisione sul Web.

Se gli utenti usano un browser con i cookie relativi all'accesso disattivati, l'elenco a discesa per la scelta del pubblico del contenuto condiviso non viene visualizzato. Lo stesso accade se l'app usa la finestra di dialogo delle Notizie invece della finestra di condivisione o se l'app usa una visualizzazione Web iframe.

Per implementare la finestra di condivisione nelle app mobili native, consulta le nostre guide per iOS e Android.

Integrazione

La finestra di condivisione è disponibile nell'SDK di Facebook per JavaScript. Per attivarla, puoi usare lo snippet di codice seguente. Puoi usare anche il reindirizzamento a un URL. Per maggiori informazioni, consulta Argomenti avanzati.

SDK di Facebook per JavaScript

Attiva la finestra di condivisione usando la funzione FB.ui con il parametro method share per condividere un link.

Per condividere un link:

FB.ui({
  method: 'share',
  href: 'https://developers.facebook.com/docs/',
}, function(response){});
Prova!

Includi metatag Open Graph nella pagina dell'URL per personalizzare la notizia condivisa su Facebook.

Tieni presente che response.error_message sarà visualizzato solo se chi usa la tua app l'ha autenticata con Facebook Login.

Parametri

Parametri comuni

L'SDK JavaScript include automaticamente i seguenti parametri.

ParametroDescrizione

app_id

L'identificatore univoco della tua app. Obbligatorio.

redirect_uri

L'URL a cui viene reindirizzato l'utente cliccando su un pulsante nella finestra di dialogo. Obbligatorio per il reindirizzamento dell'URL.

display

Determina come sarà visualizzata la finestra di dialogo.

  • Se usi una finestra di dialogo con reindirizzamento dell'URL, sarà una visualizzazione a pieno schermo su Facebook.com. Questo tipo è denominato page.
  • Se usi uno dei nostri SDK per iOS o Android per richiamare la finestra di dialogo, sarà specificato automaticamente, scegliendo il tipo di visualizzazione più adatto al dispositivo.
  • Se usi l'SDK di Facebook per JavaScript, per impostazione predefinita sarà un iframe di tipo modale per gli utenti che hanno effettuato l'accesso alla tua app, un async nei giochi su Facebook.com e una finestra popup negli altri casi. Se necessario, puoi anche forzare il tipo popup quando usi l'SDK di Facebook per JavaScript.
  • Per impostazione predefinita, le app Web mobili usano una visualizzazione di tipo touch.

Parametri share

ParametroDescrizioneValore predefinito

href

Il link allegato al post. Obbligatorio per l'uso del parametro method share. Includi metatag Open Graph nella pagina dell'URL per personalizzare la notizia condivisa.

URL corrente

hashtag

Un hashtag specificato dallo sviluppatore affinché venga aggiunto al contenuto condiviso. Gli utenti avranno comunque la possibilità di rimuovere l'hasthtag nella finestra di dialogo. L'hashtag deve includere il cancelletto, ad es. #facebook.

null

quote

Una citazione da condividere con il link, messa in evidenza dall'utente o predefinita dallo sviluppatore, come una citazione in evidenza in un articolo.

null

mobile_iframe

Se l'impostazione è true, il pulsante Condividi aprirà la finestra di condivisione in un iframe nella parte superiore del sito Web. Per maggiori informazioni, consulta Finestra di condivisione Web mobile. Questa opzione è disponibile solo su mobile e non anche su computer.

false


Dati di risposta

Parametro Descrizione

post_id

Disponibile solo se l'utente ha effettuato l'accesso alla tua app tramite Facebook concedendo publish_actions. Se presente, si tratta dell'ID della notizia Open Graph pubblicata.

error_message

Disponibile solo se l'utente ha effettuato l'accesso alla tua app tramite Facebook Login.

Argomenti avanzati

Puoi anche sfruttare le seguenti funzioni avanzate.

Finestra di condivisione Web mobile

La finestra di condivisione Web mobile consente inoltre la visualizzazione in un iframe nella parte superiore del contenuto. Se un utente completa il flusso di condivisione, la finestra di dialogo verrà chiusa per tornare al contenuto originale e continuare a usarlo.

Esempio di codice

Per consentire la visualizzazione della finestra di condivisione Web mobile in un iframe, imposta l'attributo mobile_iframe su true:

FB.ui({
  method: 'share',
  mobile_iframe: true,
  href: 'https://developers.facebook.com/docs/',
}, function(response){});
Prova!

Reindirizzamento dell'URL

Per condividere un link:

https://www.facebook.com/dialog/share?
  app_id=145634995501895
  &display=popup
  &href=https%3A%2F%2Fdevelopers.facebook.com%2Fdocs%2F
  &redirect_uri=https%3A%2F%2Fdevelopers.facebook.com%2Ftools%2Fexplorer

Nota: rimuovi le interruzioni di linea per testare il codice. In caso contrario visualizzerai un errore.

Azioni Open Graph

Attiva la finestra di condivisione usando la funzione FB.ui con il parametro method share_open_graph per condividere una notizia Open Graph.

Per condividere una notizia Open Graph con la finestra di dialogo:

FB.ui({
  method: 'share_open_graph',
  action_type: 'og.likes',
  action_properties: JSON.stringify({
    object:'https://developers.facebook.com/docs/',
  })
}, function(response){});

Tieni presente che il reindirizzamento dell'URL viene effettuato come nella condivisione di link standard.

Parametri share_open_graph

Usa gli stessi parametri usati per la condivisione di un link standard, aggiungendo i seguenti:

Parametro Descrizione

action_type

Una stringa che specifica il tipo di azione Open Graph da pubblicare, ad es. og.likes per il tipo like integrato. La finestra di dialogo supporta anche tipi personalizzati approvati. Obbligatorio per l'uso del parametro method share_open_graph.

action_properties

Un oggetto JSON con chiavi/valori che specificano i parametri corrispondenti all'action_type usato. Chiavi/valori validi sono gli stessi parametri usati per la pubblicazione di azioni Open Graph tramite l'API. Obbligatorio per l'uso del parametro method share_open_graph.

La finestra di dialogo share_open_graph non supporta mobile_iframe: true.