กล่องการแชร์

กล่องการแชร์ช่วยให้ผู้ใช้สามารถเผยแพร่เรื่องราวแต่ละรายการไปยังไทม์ไลน์ของตน ไทม์ไลน์ของเพื่อน กลุ่ม หรือข้อความส่วนตัวใน Messenger ได้ โดยกล่องการแชร์ไม่จำเป็นต้องใช้การเข้าสู่ระบบด้วย Facebook หรือสิทธิ์การอนุญาตเพิ่มเติมใดๆ จึงเป็นวิธีที่ง่ายที่สุดในการเปิดใช้งานการแชร์บนเว็บ

เอกสารประกอบนี้อธิบายวิธีการใช้กล่องการแชร์บนเว็บ หากต้องการใช้กล่องการแชร์ในแอพมือถือ โปรดดูการแชร์บน iOS และการแชร์บน Android

ต่อไปนี้คือตัวอย่างของกล่องการแชร์ที่แชร์ลิงก์ไปยังไทม์ไลน์ของผู้ใช้

ในรูปภาพก่อนหน้า คุณได้เลือก “แชร์บนไทม์ไลน์ของคุณเอง” ไว้ในรายการดร็อปดาวน์สำหรับการเลือกกลุ่มเป้าหมายในการแชร์ รายการดร็อปดาวน์สำหรับการเลือกกลุ่มเป้าหมายในการแชร์จะไม่ปรากฏขึ้นเมื่อผู้ใช้อยู่ในเบราว์เซอร์ที่ไม่ได้เข้าสู่ระบบด้วยคุกกี้ กรณีเช่นนี้ยังเกิดขึ้นหากแอพใช้กล่องการแชร์บนฟีดแทนกล่องการแชร์หรือหากแอพใช้ตัวแสดงหน้าเว็บแบบ iframe ด้วย

หากคุณเป็นเว็บมาสเตอร์สำหรับเพจที่แชร์ไปยัง Facebook ให้ใส่แท็กเมตา Open Graph เพื่อปรับแต่งเรื่องราวที่แชร์กลับไปยัง Facebook คุณจำเป็นต้องมาร์กอัพเว็บไซต์ด้วยแท็ก Open Graph เพื่อควบคุมลักษณะที่เนื้อหาของคุณจะปรากฏบน Facebook โปรดดูข้อมูลเพิ่มเติมที่คู่มือการแชร์สำหรับเว็บมาสเตอร์

แชร์โดยใช้การเปลี่ยนเส้นทาง URL

หากต้องการแชร์ลิงก์โดยใช้การเปลี่ยนเส้นทาง URL ให้ใช้โค้ดดังต่อไปนี้ ใส่ตัวแบ่งบรรทัดเพื่อให้อ่านง่าย ลบตัวแบ่งบรรทัดออกเมื่อคุณใช้โค้ดนี้

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

แชร์โดยใช้ Facebook SDK สำหรับ JavaScript

กล่องการแชร์มีให้ใช้งานใน Facebook SDK สำหรับ JavaScript โดยใช้ฟังก์ชั่น FB.ui ที่มีพารามิเตอร์เมธอด share ใช้ส่วนย่อยของโค้ดต่อไปนี้เพื่อเปิดกล่องการแชร์

FB.ui({
  method: 'share',
  href: 'https://developers.facebook.com/docs/',
}, function(response){});
ลองใช้เลย!

พารามิเตอร์

ด้านล่างนี้คือพารามิเตอร์สำหรับกล่องการแชร์

พารามิเตอร์คำอธิบายจำเป็นต้องระบุหรือไม่

app_id

ตัวระบุที่ไม่ซ้ำกันสำหรับแอพของคุณ

จำเป็น โดยจะระบุให้โดยอัตโนมัติเมื่อคุณใช้ SDK

display

วิธีการแสดงผลกล่องการแชร์

  • การเปลี่ยนเส้นทาง URL – ค่า display คือ page กล่องการแชร์เป็นแบบเต็มหน้า ซึ่งปรากฏขึ้นภายใน Facebook.com

  • Facebook SDK สำหรับ JavaScript – ค่าที่แสดงจะเป็นค่าใดค่าหนึ่งต่อไปนี้

    • iframe แบบโมดัลสำหรับผู้ใช้ที่เข้าสู่ระบบแอพของคุณ
    • async เมื่อใช้ภายในเกมบน Facebook.com
    • หน้าต่าง popup สำหรับผู้ใช้อื่นๆ

    หากจำเป็น คุณสามารถบังคับให้ใช้ประเภท popup ได้เมื่อใช้ Facebook SDK สำหรับ JavaScript

  • เว็บแอพบนมือถือ – ค่า display จะเป็น touch เสมอ

  • Facebook SDK สำหรับ iOS หรือ Android – SDK จะระบุ display ให้โดยอัตโนมัติและเลือกประเภทการแสดงผลที่เหมาะสมกับอุปกรณ์

จำเป็น โดยจะระบุให้โดยอัตโนมัติเมื่อคุณใช้ SDK

hashtag

แฮชแท็กที่จะเพิ่มไปยังเนื้อหาที่แชร์ ผู้ใช้สามารถลบแฮชแท็กในกล่องการแชร์ออกได้ แฮชแท็กควรมีสัญลักษณ์แฮชด้วย เช่น #facebook ค่าเริ่มต้นคือ null

ไม่จำเป็น

href

ลิงก์ที่จะแชร์ ค่าเริ่มต้นคือ URL ปัจจุบัน

จำเป็นต้องระบุเมื่อคุณใช้ SDK

redirect_uri

เลิกใช้แล้ว

URL ที่จะเปลี่ยนเส้นทางหลังจากผู้ใช้คลิกปุ่มบนกล่องการแชร์จำเป็น โดยจะระบุให้โดยอัตโนมัติเมื่อคุณใช้ SDK
mobile_iframe

เลิกใช้แล้ว

true เพื่อเปิดกล่องการแชร์ใน iframe ที่ด้านบนของเว็บไซต์ ตัวเลือกนี้มีให้ใช้งานบนมือถือเท่านั้น เดสก์ท็อปไม่สามารถใช้งานได้false

ข้อมูลการตอบกลับ

การตอบกลับจะเกิดขึ้นก็ต่อเมื่อผู้ใช้เข้าสู่ระบบแอพของคุณโดยใช้การเข้าสู่ระบบด้วย Facebook เท่านั้น

พารามิเตอร์คำอธิบาย

error_message

ข้อความแสดงข้อผิดพลาด