README

WP即时文章

在您的WordPress网站上启用Facebook即时文章。

插件活动

描述

此插件添加了对Facebook即时文章的支持，这是一种新的方式，允许发布者在Facebook上快速、互动地分发故事。即时文章在Facebook移动应用中预先加载，因此可以立即加载。

插件激活后，您将看到一个新菜单，用于连接您的Facebook页面并开始发布您的即时文章。您还可以在您的帖子编辑页面上查看每篇即时文章提交的状态。

该插件会尽力从您的帖子内容/元数据中生成有效的即时文章标记，并将其发布到Facebook。该插件知道如何将您的帖子标记从一组规则转换为在您的源标记中的元素与有效的即时文章组件之间的映射。我们将这两个之间的“粘合剂”称为转换规则。

插件内置了许多预定义的转换规则，旨在覆盖标准的WordPress安装。如果您的WordPress内容包含不受内置规则集覆盖的元素，您可以在本插件的设置中定义自己的附加规则来扩展或覆盖默认值，在：插件配置 > 发布设置 > 自定义转换规则。

访问即时文章

访问即时文章的当前标准是

您的Facebook页面必须至少有90天的建立存在
您的内容遵守即时文章政策

在您的即时文章可以在Facebook上发布之前，您的源必须经过初步审查和批准。Facebook要求您的源中至少有10篇文章才有资格进行审查。审查过程检查您的草稿即时文章是否格式正确，与它们的移动网页版本内容一致，并遵守社区标准和内容政策。

需要注意的是，如果您使用元字段添加额外的文本、图像或视频到您的帖子，Facebook将希望您将这些内容添加到您的即时文章输出中。此插件包含钩子来帮助您做到这一点。

请参阅Facebook的文档以获取提交过程的完整详情。

一旦您的源获得批准，新的帖子将自动在即时文章中发布，现有的帖子在您更新它们后将发布。为了保持在即时文章计划中，您必须通过创建新内容并保持最小读者群来保持活跃。

安装

在插件文件夹的根目录运行 composer install。确保您已安装 Composer。
将文件夹上传到 /wp-content/plugins/ 目录
通过WordPress中的“插件”菜单激活插件

常见问题解答

为什么在我的即时文章中缺少了帖子内容？

很可能是由于您的帖子正文中存在未映射到已识别即时文章组件的标记。在您的帖子“编辑帖子”屏幕上，查找有关屏幕底部“Facebook即时文章”模块内显示的转换输出的附加信息。

为什么我的帖子没有出现在发布者工具的即时文章列表中？ 当您的帖子首次在Facebook上分享时，您的帖子就会被导入到您的库中。

或者，您可以在我们的分享调试器上粘贴您的URL来手动抓取。

只有具有您已声明域名的URL的即时文章会在发布工具部分显示。 在我的帖子的即时文章模块中，“此帖子已转换为包含一些警告的即时文章”信息是什么意思？

当将您的帖子转换为即时文章时，如果遇到在发布到Facebook时可能无效的内容，此插件将显示警告。当您看到此信息时，建议您逐个解决每个警告。

“在____的上下文中没有为____定义规则”的警告是什么意思？

此插件通过将您的内容中的标记与即时文章标记中可用的组件进行匹配来将您的帖子转换为即时文章。虽然此插件包含许多内置规则以处理常见情况，但您的帖子中可能存在这些现有规则无法识别的标记。在这种情况下，您可能需要定义一些自己的规则。下面提供更多有关如何定义和放置的详细信息。

如何定义自己的转换规则，以便在即时文章中正确渲染站点的内容？

您可以在本插件的设置中的“插件配置” > “发布设置” > “自定义转换规则”下定义自定义规则。有关所有可用选项的更详细说明，请参阅Facebook即时文章SDK的自定义转换规则部分。

我知道一个在社区中相当常见的自定义转换规则。如何将其默认包含在插件中？

您可以通过在GitHub上提出建议来提议将流行的转换规则包含在插件中。

插件安装后，我如何将文章发布到即时文章中？

要导入您的帖子到Facebook上的即时文章库中，您需要首先连接您的网站。然后，要么在您的页面上分享您的帖子，要么使用分享调试器来抓取它们。当您有10篇文章导入后，您将能够提交它们进行审查。

如果您正在使用RSS集成，我如何更改feed slug/URL？

要更改feed slug，将常量INSTANT_ARTICLES_SLUG设置为所需的任何值。如果您这样做，请记住之后刷新重写规则。默认设置为instant-articles，这通常会给您一个设置为/feed/instant-articles的feed URL。

如何在修改feed别名后刷新重写规则？

通常情况下，只需访问WordPress仪表盘中的固定链接设置页面即可（/wp-admin/options-permalink.php）

开发环境

我们非常欢迎您帮助我们使此插件更加完善！

设置SDK和WP以使用GitHub代码

大多数开发和调试我们使用master分支或任何功能分支来开发WP插件。有时需要特定或最新版本的SDK以匹配所有新发布的SDK和WP插件的新特性。

SDK也在GitHub上开发中：https://github.com/facebook/facebook-instant-articles-sdk-php

先决条件

已安装PHP（您可以使用homebrew进行安装）
已安装Web服务器（您可以使用MAMP）
已安装WP（从wordpress.org下载）

设置

将两个存储库克隆到您的开发者文件夹中（例如：~/instant-articles）。

git clone git@github.com:Automattic/facebook-instant-articles-wp.git
git clone git@github.com:facebook/facebook-instant-articles-sdk-php.git

构建两个源文件夹

cd facebook-instant-articles-sdk-php
composer install

cd ../facebook-instant-articles-wp
composer install

现在从WordPress中删除构建内容，以便它包含您刚刚构建的代码。

rm -rf vendor/facebook/facebook-instant-articles-sdk-php
ln -s ~/facebook-instant-articles-sdk-php vendor/facebook/facebook-instant-articles-sdk-php

现在您可以在/wp-content/plugins内部创建指向您的文件夹的链接

ln -s ~/facebook-instant-articles-wp wp-content/plugins/facebook-instant-articles-wp

humanmade / facebook-instant-articles-wp

维护者

详细信息