Dialog Bagikan

Dialog Bagikan memberikan kemampuan bagi orang-orang untuk menerbitkan cerita individual ke kronologinya, kronologi teman, grup, atau pesan pribadi di Messenger. Ini tidak memerlukan Facebook Login atau izin yang diperpanjang, jadi ini merupakan cara paling mudah untuk mengizinkan berbagi di web.

Jika seseorang menggunakan browser yang tidak masuk dengan kuki, maka daftar pilihan guna memilih pemirsa agar berbagi Anda tidak muncul. Hal ini juga benar jika aplikasi tersebut menggunakan dialog kabar alih-alih dialog bagikan atau jika aplikasi menggunakan tampilan web iframe.

Untuk menerapkan Dialog Bagikan di aplikasi seluler native, baca panduan untuk iOS dan Android.

Integrasi

Dialog Bagikan tersedia di SDK Facebook untuk JavaScript. Anda dapat menggunakan snippet kode berikut untuk memicu dialog Bagikan. Anda juga dapat menggunakan pengalihan ke URL. Untuk detail selengkapnya, lihat Topik Lanjutan.

SDK Facebook untuk JavaScript

Picu Dialog Bagikan menggunakan fungsi FB.ui beserta parameter metode share untuk membagikan tautan.

Untuk membagikan tautan:

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

Sertakan tag meta graf terbuka pada halaman di URL ini untuk menyesuaikan cerita yang dibagikan kembali ke Facebook.

Harap diingat bahwa response.error_message akan muncul hanya jika seseorang yang menggunakan aplikasi Anda sudah mengautentikasi aplikasi tersebut dengan Facebook Login.

Parameter

Parameter Umum

SDK JS akan menyediakan parameter berikut secara otomatis.

ParameterKeterangan

app_id

Pengidentifikasi unik aplikasi Anda. Diperlukan.

redirect_uri

URL untuk mengalihkan setelah seseorang mengeklik tombol di dialog. Diperlukan apabila menggunakan pengalihan URL.

display

Menentukan cara dialog di-render.

  • Jika Anda menggunakan penerapan dialog pengalihan URL, maka ini akan berupa tampilan halaman penuh, yang diperlihatkan di dalam Facebook.com. Jenis tampilan ini disebut page.
  • Jika Anda menggunakan salah satu SDK iOS atau Android kami untuk meminta dialog, maka jenis tampilan ini ditentukan secara otomatis dan memilih jenis tampilan yang tepat untuk perangkat yang digunakan.
  • Jika Anda menggunakan SDK Facebook untuk JavaScript, tampilan ini akan diatur default ke jenis iframe modal untuk orang-orang yang masuk ke dalam aplikasi Anda atau async saat menggunakan dalam game di Facebook.com, dan jendela popup untuk orang lainnya. Anda juga dapat mendorong jenis popup ketika Anda menggunakan SDK Facebook untuk JavaScript, jika diperlukan.
  • Aplikasi web seluler akan selalu diatur default ke jenis tampilan touch.

Parameter share

ParameterKeteranganDefault

href

Tautan yang dilampirkan ke kiriman ini. Diperlukan apabila menggunakan metode share. Sertakan tag meta graf terbuka pada halaman di URL ini untuk menyesuaikan cerita yang dibagikan.

URL Saat Ini

hashtag

Tagar ditetapkan oleh pengembang untuk ditambahkan ke konten yang dibagikan. Orang masih memiliki kesempatan untuk menghapus tagar ini di dialog. Tagar harus menyertakan hash tagar, misalnya #facebook.

null

quote

Kutipan yang akan dibagikan bersama dengan tautan, baik yang disorot oleh pengguna maupun yang sudah ditentukan terlebih dahulu oleh pengembang, seperti dalam kutipan menarik di artikel.

null

mobile_iframe

Jika diatur ke true tombol bagikan akan membuka dialog bagikan di iframe bagian atas situs web Anda (Untuk informasi selengkapnya lihat Dialog Bagikan Web Seluler. Opsi ini hanya tersedia di perangkat seluler, bukan desktop.

false


Data Tanggapan

Parameter Keterangan

post_id

Hanya tersedia jika pengguna masuk ke aplikasi Anda dengan menggunakan Facebook dan sudah menjamin publish_actions. Jika ditampilkan, maka ini merupakan ID cerita Graf Terbuka yang diterbitkan.

error_message

Hanya tersedia jika pengguna masuk ke aplikasi Anda dengan menggunakan Facebook Login.

Topik Lanjutan

Anda juga dapat memanfaatkan fitur lanjutan berikut.

Dialog Bagikan Web Seluler

Dialog bagikan web seluler juga memiliki kemampuan untuk ditampilkan di iFrame pada bagian atas konten Anda. Jika seseorang menyelesaikan alur berbagi, dialog akan mengabaikannya dan kembali ke bagian konten semula sehingga dapat terus menggunakannya secara mudah.

Contoh Kode

Untuk mengaktifkan dialog bagikan web seluler di iframe, atur atribut mobile_iframe ke true:

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

Pengalihan URL

Untuk membagikan tautan:

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

Catatan: Saat menguji kode ini, hapus pemisah baris. Jika tidak maka Anda akan mengalami kesalahan.

Tindakan Graf Terbuka

Picu Dialog Bagikan menggunakan FB.ui function dengan parameter metode share_open_graph untuk berbagi cerita Graf Terbuka.

Untuk membagikan cerita Graf Terbuka dengan dialog:

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

Harap diingat bahwa pengalihan bekerja menggunakan cara yang sama dengan berbagi tautan standar.

Parameter share_open_graph

Gunakan parameter yang sama dengan berbagi tautan standar, namun tambahkan hal-hal berikut:

Parameter Keterangan

action_type

String yang menentukan jenis tindakan Graf Terbuka mana yang akan diterbitkan, misalnya og.likes untuk jenis suka bawaan. Dialog juga mendukung jenis khusus yang sudah disetujui. Diperlukan apabila menggunakan metode share_open_graph.

action_properties

Objek JSON dari pasangan kunci/nilai menjelaskan parameter yang berkorespondensi dengan action_type sudah digunakan. Pasangan kunci/nilai yang valid merupakan parameter yang sama yang dapat digunakan saat menerbitkan Tindakan Graf Terbuka menggunakan API. Diperlukan apabila menggunakan metode share_open_graph.

Dialog share_open_graph tidak mendukung mobile_iframe: true.