collective.simplesocial 1.8

先决条件

要将 Like 按钮添加到您的站点，请首先按照上面创建 Facebook 应用程序的说明进行操作。

添加赞按钮

1. 转到站点设置。

2. 单击 Facebook 设置。

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

4. 在 Like Button 选项卡上，确保选中“Display Like button on this site”。

5. 选择您希望喜欢按钮默认显示的内容类型。

6. 设置喜欢按钮的显示选项。

7. 保存您的设置。

启用和禁用点赞按钮

除了选择将显示“赞”按钮的内容类型外，您还可以为特定内容打开或关闭“赞”按钮。为此，请浏览到内容项，然后从“操作”菜单中选择“显示赞按钮”或“隐藏赞按钮”。

自定义开放图元数据

为了了解被喜欢的内容，Facebook 从页面顶部的 Open Graph 标签中读取元数据。默认情况下，Simple Social 提供基于以下字段的元数据：

• 内容项的标题

• 内容项的 URL

• 内容项的描述，如果它提供了一个

• 内容项的预览图像（如果提供）或站点徽标

• 站点名称

• Facebook 应用程序 ID

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

Open Graph 元数据可以通过注册一个为内容类型的接口提供collective.simplesocial.likebutton.interfaces.IOpenGraphProvider 的适配器，在每个内容类型的基础上进行定制。在不止一种内容类型提供相同接口的情况下，可以命名适配器以匹配所需的门户类型。例如，请参阅collective.simplesocial.likebutton.opengraph.DefaultOpenGraphProvider 中的默认实现。

先决条件

要使用 Like Box portlet，您必须完成 创建 Facebook 应用程序部分中的步骤。您还需要一个 Facebook 页面。记下页面的 URL，并在创建 portlet 时输入。

添加一个赞框

1. 导航到站点中要添加 portlet 的位置。

2. 单击“管理 portlet”。

3. 单击下拉菜单以将 portlet 添加到您希望出现点赞框的列中，然后选择“Facebook 点赞框”。

4. 粘贴您要推广的 Facebook 主页的 URL。

5. 您可以配置是否显示活动流、要显示的粉丝连接数以及点赞框的宽度。

6. 单击保存并返回到您分配portlet 的位置以查看Like 框。

先决条件

要使用 Feed 表单 portlet，您必须首先完成创建 Facebook 应用程序部分中的步骤。

添加提要表单

1. 导航到站点中要添加 portlet 的位置。

2. 单击“管理 portlet”。

3. 单击下拉列表将 portlet 添加到您希望显示提要表单的列中，然后选择“Facebook 提要表单”。

4. 根据提示编辑设置。完成后，单击保存。

5. 返回到您分配 portlet 的位置以查看提要表单。

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

自定义提要附件

当用户提交提要表单时，collective.simplesocial 会向 Facebook 发送一个附件，其中包含有关显示提要表单的内容项的信息。默认情况下，此附件包含以下信息：

• 内容项的标题

• 内容项的 URL

• 内容项的描述，如果它提供了一个

• 内容项的平铺图像（如果提供）或站点徽标

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

先决条件

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

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

1. 转到站点设置。

2. 单击 Facebook 设置。

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

4. 在“发布到页面”选项卡上，确保选中“允许站点管理员将更新发布到 Facebook 页面”。

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

现在，当您登录时，“发布到粉丝专页”链接应该会显示出来。要发布到 Facebook，请单击该链接。系统将提示您确认将发布的消息。

杂项提示

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

• Facebook javascript 库是异步加载的，这意味着在加载页面时无法立即进行 Facebook API 调用。为了解决这个问题，SimpleSocial javascript 库实现了一个队列，该队列存储依赖于 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 初始化。[约马]

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

1.7 (2011-12-12)

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

• 通过正确转义 init javascript 解决了 Chameleon 错误。[约马]

• 使用社交媒体跟踪在 Google Analytics 中跟踪喜欢和不喜欢的人。[约马]

• 将 javascript 生成从 fb_init.pt 移至视图以修复变色龙警告 [swampmonkey]

1.6 (2011-05-31)

• 为collective.googleanalytics 添加了一个喜欢和不同的跟踪插件。[约马]

1.5 (2011-05-06)

• 更新了创建 Facebook 应用程序的说明。[约马]

• 添加了在“赞”框中打开和关闭个人资料图片显示的功能。[约马]

1.5b2 (2011-04-13)

• 修复了“赞”按钮阻止复制和粘贴内容的问题。[约马]

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

1.5b1 (2011-02-23)

• 隐藏 Like 框 portlet 的 portlet 标题。[约马]

• 添加了一个适配器，用于查找发送到 Facebook 的图像，使其更易于定制。[约马]

• 为 Like 按钮添加了 ref 属性。[约马]

• 添加了对 Like 按钮和 Open Graph 元标记的支持。[约马]

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

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

• 为 Like box portlet 添加了 height 选项。[约马]

• 删除了“赞”框的宽度限制，因为 Facebook 不再强制执行它。[约马]

• 更新了 Like 框 portlet 选项以匹配 Facebook 的选项。[约马]

• 为 PloneFormGen 添加了一个数据提供程序，感谢您从表单中提取附件数据的页面。[约马]

• 修复了与缺少操作链接相关的错误。[约马]

• 修复了带有 Sunburst 主题的 IE7 中模式对话框的位置。[约马]

1.4 (2010-09-21)

• 从提要表单中删除了用户消息选项，因为 Facebook 不再支持它。[约马]

• 放弃对 Internet Explorer 6 的支持，因为 Facebook 不再支持它。[约马]

• 修复了提要表单 portlet 的操作标题中的转义错误。[约马]

• 将风扇盒更换为类似的盒子。类似框 portlet 是使用 XFBML 呈现的，因此基本的 Facebook 支持配置文件现在是一个依赖项。[约马]

• 利用 Facebook 的新 Javascript SDK。[约马]

• 为 fanbox portlet 提供了默认值，因此可以使用 portlets.xml GS 文件对其进行分配。[piv]

1.3 (2010-06-02)

• 尝试查找“image_tile”时也会捕获 NotFound。[达维萨利]

• 为collective.googleanalytics 添加了一个feed 表单跟踪插件。[约马]

• 添加了仅在保存后显示提要表单的选项。[约马]

• 更改了 Facebook fanbox portlet HTML 以满足 Plone 标准，修复 #1。[贾罗尔]

1.2 (2010-04-06)

• 修复了 JSON 序列化程序中的 unicode 解码错误。[约马]

1.1 (2010-03-26)

• 添加了“发布到粉丝页面”功能。[达维萨利]

• 从默认提要表单适配器中的描述中删除换行符以避免破坏 javascript。[约马]

• 添加了一个视图以将站点徽标调整为 Facebook 所需的大小。[约马]

• 添加了一个适配器接口，以便我们可以基于每个站点或每个内容类型覆盖提要表单 portlet 和附件设置。[约马]

1.0 (2009-12-22)

• 添加 z3c.autoinclude Plone 插件入口点。[达维萨利]

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

• 在功能加载器初始化调用中添加了 jq() 包装器，以便在 DOM 完全加载之前不会发生。[约马]

• 删除了 Fan Box 配置文件对基本 Facebook Connect 集成配置文件的虚假依赖。[达维萨利]

1.0b1 (2009-08-13)

• 初始发行。[达维萨利]