collective.simplesocial 1.8

先决条件

要将点赞按钮添加到您的网站，首先遵循上述创建Facebook应用的说明。

添加点赞按钮

1. 转到站点设置。

2. 单击Facebook设置。

3. 如果您尚未这样做，请使用提供的按钮登录Facebook。

4. 在点赞按钮标签页上，确保已勾选“在此网站上显示点赞按钮”。

5. 选择您想要点赞按钮默认显示的内容类型。

6. 设置您的点赞按钮的显示选项。

7. 保存您的设置。

启用和禁用点赞按钮

除了选择点赞按钮将显示的内容类型外，您还可以针对特定内容项打开或关闭点赞按钮。要这样做，浏览到内容项，并从操作菜单中选择“显示点赞按钮”或“隐藏点赞按钮”。

自定义Open Graph元数据

要了解正在点赞的内容，Facebook将从页面标题中的Open Graph标签读取元数据。默认情况下，Simple Social根据以下字段提供元数据

• 内容项的标题

• 内容项的URL

• 如果提供，则内容项的描述

• 如果提供，则内容项的预览图像或网站标志

• 站点名称

• Facebook应用ID

除了网站主页以外的所有内容项均列为“文章”类型。网站主页列为“网站”类型。

可以针对每个内容类型自定义Open Graph元数据，通过为内容类型的接口注册一个提供collective.simplesocial.likebutton.interfaces.IOpenGraphProvider的适配器。如果多个内容类型提供相同的接口，则适配器可以被命名为与所需门户类型匹配。例如，请参阅collective.simplesocial.likebutton.opengraph.DefaultOpenGraphProvider中的默认实现。

先决条件

要使用“赞盒”组件，您必须完成《创建 Facebook 应用》部分的步骤。创建 Facebook 应用。您还需要一个 Facebook 页面。注意页面的 URL，并在创建组件时输入。

添加赞盒

1. 导航到您想添加组件的网站位置。

2. 点击“管理组件”。

3. 点击下拉菜单，将组件添加到您希望赞盒显示的列中，并选择“Facebook 赞盒”。

4. 粘贴您想推广的 Facebook 页面的 URL。

5. 您可以选择是否显示活动流，显示的粉丝连接数以及赞盒的宽度。

6. 点击保存并返回您分配组件的位置查看赞盒。

先决条件

要使用订阅表单组件，您必须首先完成《创建 Facebook 应用》部分的步骤。

添加订阅表单

1. 导航到您想添加组件的网站位置。

2. 点击“管理组件”。

3. 点击下拉菜单，将组件添加到您希望订阅表单显示的列中，并选择“Facebook 订阅表单”。

4. 按提示编辑设置。完成后，点击保存。

5. 返回您分配组件的位置查看订阅表单。

如果访问带有订阅表单的页面的访客未登录 Facebook，则订阅表单不会自动显示。相反，将显示一条消息以及一个 Facebook 登录按钮。点击此按钮将允许访客登录 Facebook，之后订阅表单将显示。

自定义订阅附件

当用户提交订阅表单时，collective.simplesocial 会将有关在显示订阅表单的内容项的信息作为附件发送到 Facebook。默认情况下，此附件包含以下信息

• 内容项的标题

• 内容项的URL

• 如果提供，则内容项的描述

• 如果内容项提供了标题图像，则为该内容项的标题图像，或为网站标志

这些默认值由 DefaultFeedFormDataProvider 适配器提供。可以通过注册一个提供 IFeedFormDataProvider 接口的适配器来全局或针对特定内容类型覆盖默认值。此接口提供获取当前上下文附件的方法以及覆盖组件分配中指定的设置的方法。有关更多信息，请参阅 collective.simplesocial.feedform.facebookfeedform.IFeedFormDataProvider 以及 stream.publish 方法和 stream attachment 对象的文档。

先决条件

要使用“发布到 Facebook 粉丝页面”功能，您必须首先完成《创建 Facebook 应用》部分的步骤。

配置“发布到粉丝页面”功能

1. 转到站点设置。

2. 单击Facebook设置。

3. 如果您尚未这样做，请使用提供的按钮登录Facebook。

4. 在“发布到页面”选项卡上，请确保已勾选“允许网站管理员向 Facebook 页面发布更新”。

5. 选择您想要发布到的Facebook页面。点击保存。

现在，在您登录后，应该会显示“发布到粉丝页面”链接。要发布到Facebook，请点击该链接。您将需要确认要发布的信息。

其他技巧

• TAL解析器喜欢在使用具有“fb”XML命名空间的标签时抱怨标签不匹配。您可能需要转义这些标签，并使用tal:replace包含它们，或者将它们放入单独的文件中，并通过读取该文件的浏览器视图方法包含它们。

• Facebookjavascript库是异步加载的，这意味着在页面加载时不能立即调用Facebook API。为了解决这个问题，SimpleSocialjavascript库实现了一个队列，用于存储依赖于Facebook API的函数，直到API完全加载。然后按插入顺序执行队列中的所有函数。在Facebook API加载后传递到队列中的函数将立即执行。

  SimpleSocial.queue的行为类似于javascript数组。要将函数添加到队列中，请使用push方法

  SimpleSocial.queue.push(function () {
    // Do something using the Facebook API.
  });

• 使用以下逻辑根据用户是否已登录Facebook并连接到您的应用程序做不同的事情

  SimpleSocial.queue.push(function () {
    FB.getLoginStatus(function (response) {
      if (response.session) {
        // The user is logged in and connected.
      } else {
        // The user is not logged in or is not connected
        // to your application.
      }
    });
  });

  有关更多信息，请参阅FB.getLoginStatus的文档。

其他Facebook API资源

• Facebook开发者文档

• Facebook JavaScript SDK

• 社交插件

• XFBML

1.8 (2013-11-12)

• 使用getSite的新首选位置[encolpe]

• Plone4.3更改[sureshvv]

• 添加了频道文件并更新了SDK初始化。[yomatters]

• 修复了启用和禁用“赞”按钮时的权限错误。[yomatters]

1.7 (2011-12-12)

• 使用OAuth 2.0进行身份验证。[yomatters]

• 通过正确转义initjavascript解决了Chameleon错误。[yomatters]

• 使用社交媒体跟踪在Google Analytics中跟踪赞和取消赞。[yomatters]

• 将javascript生成从fb_init.pt移动到视图，以解决Chameleon警告[swampmonkey]

1.6 (2011-05-31)

• 为collective.googleanalytics添加了赞和取消赞跟踪插件。[yomatters]

1.5 (2011-05-06)

• 更新了创建Facebook应用的说明。[yomatters]

• 添加了在“赞”框中切换显示或隐藏个人照片的功能。[yomatters]

1.5b2（2011-04-13）

• 修复了“赞”按钮的问题，防止内容复制和粘贴。[yomatters]

• 使用simplejson/json解决JSON转义问题。[yomatters]

1.5b1（2011-02-23）

• 隐藏了“赞”框小部件的标题。[yomatters]

• 添加了一个查找发送到Facebook的图片的适配器，使其更容易定制。[yomatters]

• 为“赞”按钮添加了ref属性。[yomatters]

• 添加了对“赞”按钮和Open Graph元标签的支持。[yomatters]

• 合并配置文件以简化升级。[yomatters]

• 将控制面板表单更改为使用z3c.form。[yomatters]

• 为“赞”箱小部件添加了高度选项。[yomatters]

• 由于Facebook不再强制执行，已移除“赞”箱的宽度限制。[yomatters]

• 更新“赞”箱小部件选项以匹配Facebook的选项。[yomatters]

• 为PloneFormGen的感谢页面添加了数据提供程序，该程序从表单中拉取附件数据。[yomatters]

• 修复了与缺失操作链接相关的错误。[yomatters]

• 修复了使用Sunburst主题的IE7中模态对话框的位置。[yomatters]

1.4 (2010-09-21)

• 由于Facebook不再支持，已从源表单中删除用户消息选项。[yomatters]

• 由于Facebook不再支持，已停止支持Internet Explorer 6。[yomatters]

• 修复了源表单小部件操作标题中的转义错误。[yomatters]

• 用“赞”箱替换了粉丝箱。由于“赞”箱小部件使用XFBML渲染，因此基本Facebook支持配置文件现在是依赖项。[yomatters]

• 利用了Facebook的新JavaScript SDK。[yomatters]

• 为粉丝箱小部件提供默认值，从而使得使用portlets.xml GS文件分配成为可能。[piv]

1.3 (2010-06-02)

• 在尝试查找“image_tile”时也捕获了NotFound。[davisagli]

• 为collective.googleanalytics添加了源表单跟踪插件。[yomatters]

• 添加了在保存后仅显示源表单的选项。[yomatters]

• 将Facebook粉丝箱小部件的HTML更改为符合Plone标准，修复了#1。[jaroel]

1.2 (2010-04-06)

• 在JSON序列化器中修复了Unicode解码错误。[yomatters]

1.1 (2010-03-26)

• 添加了“发布到粉丝页面”功能。[davisagli]

• 从默认源表单适配器中的描述中删除了换行符，以避免破坏JavaScript。[yomatters]

• 添加了一个视图，用于将网站标志调整为Facebook所需的大小。[yomatters]

• 添加了一个适配器接口，这样我们就可以根据网站或内容类型覆盖源表单小部件和附件设置。[yomatters]

1.0 (2009-12-22)

• 添加z3c.autoinclude Plone插件入口点。[davisagli]

• 修复了控制面板认证器以在Plone 4中工作。[davisagli]

• 在功能加载器初始化调用中添加了jq()包装器，这样它就不会在DOM完全加载之前发生。[yomatters]

• 删除了粉丝箱配置文件对基本Facebook Connect集成配置文件的虚假依赖。[davisagli]

1.0b1 (2009-08-13)

• 首次发布。[davisagli]