Cuadro de diálogo de contenido compartido

El cuadro de diálogo de contenido compartido ofrece a los usuarios la posibilidad de publicar una historia en su biografía, la biografía de un amigo, un grupo o un mensaje privado de Messenger. No se necesitan el inicio de sesión con Facebook ni permisos ampliados, por lo que se trata de la forma más sencilla de activar el uso compartido en la web.

Si las personas están usando un navegador que no tiene la sesión iniciada con la cookie, no se muestra la lista desplegable para elegir el público del contenido compartido. Sucede lo mismo si la app usa el cuadro de diálogo de noticias en lugar del cuadro de diálogo de contenido compartido o si la app emplea una vista web con iframe.

Para implementar el cuadro de diálogo de contenido compartido en apps para celulares nativas, consulta nuestras guías para iOS y Android.

Integración

El cuadro de diálogo de contenido compartido está disponible en el SDK de Facebook para JavaScript. Puedes utilizar el siguiente fragmento de código para desencadenar el cuadro de diálogo de contenido compartido. También puedes utilizar un redireccionamiento a una URL. Para obtener información detallada, consulta la sección Temas avanzados.

SDK de Facebook para JavaScript

Si quieres compartir un enlace, para desencadenar el cuadro de diálogo de contenido compartido, utiliza la función FB.ui con el parámetro de método share.

Para compartir un enlace:

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

Incluye metaetiquetas de Open Graph en la página en esta URL, con el fin de personalizar la historia que se comparte en Facebook.

Ten en cuenta que response.error_message solo aparecerá si alguien que utiliza tu aplicación la autenticó mediante el inicio de sesión con Facebook.

Parámetros

Parámetros comunes

El SDK para JavaScript proporcionará estos parámetros automáticamente.

Parámetro Descripción

app_id

Identificador único de tu aplicación. Obligatorio.

redirect_uri

URL a la que se redirigirá cuando una persona haga clic en un botón del cuadro de diálogo. Obligatorio si se utiliza el redireccionamiento de URL.

display

Determina cómo se muestra el cuadro de diálogo.

  • Si utilizas la implementación del cuadro de diálogo de redireccionamiento de URL, se mostrará a página completa, dentro de Facebook.com. Este tipo de visualización se denomina page.
  • Si utilizas para invocar el cuadro de diálogo uno de nuestros SDK para iOS o Android, se detecta automáticamente y elige el tipo de visualización adecuado para el dispositivo.
  • Si utilizas el SDK de Facebook para JavaScript, se adoptará de forma predeterminada el tipo iframe modal en el caso de las personas que inicien sesión en tu aplicación o async cuando se utilice dentro de un juego en Facebook.com, y una ventana popup para todos los demás casos. Si es necesario, también puedes forzar el tipo popup cuando utilices el SDK de Facebook para JavaScript.
  • Las aplicaciones web para celulares toman siempre como valor predeterminado el tipo de visualización touch.

Parámetros share

Parámetro Descripción Valor predeterminado

href

Enlace adjunto a la publicación. Obligatorio si se utiliza el método share. Incluye metaetiquetas de Open Graph en la página en esta URL, con el fin de personalizar la historia que se comparte.

La URL actual

hashtag

Hashtag especificado por el desarrollador, que se agrega al contenido compartido. Se puede eliminar en el cuadro de diálogo. El hashtag debe incluir el símbolo de número, por ejemplo #facebook.

null

quote

Cita que se comparte junto con el enlace, ya sea destacada por el usuario o predefinida por el desarrollador (por ejemplo, una cita destacada en un artículo).
Este parámetro no está disponible para las URL de Facebook.

null

mobile_iframe

Obsoleto

Si se establece en true, el botón "Compartir" abrirá el cuadro de diálogo de contenido compartido en un iframe encima de tu sitio web. (Para obtener más información, consulta Cuadro de diálogo de contenido compartido para web móvil). Esta opción solo está disponible para dispositivos móviles, no para computadoras.false

Datos de respuesta

Parámetro Descripción

error_message

Solo está disponible si el usuario accede a tu aplicación mediante el inicio de sesión con Facebook.

Temas avanzados

También puedes utilizar las siguientes funciones avanzadas.

Redireccionamiento de URL

Para compartir un enlace:

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: Cuando pruebes este código, elimina los saltos de línea. de lo contrario, se producirá un error.