Distributor实战案例：如何在企业多站点网络中部署与应用
【免费下载链接】distributorShare content between your websites.项目地址: https://gitcode.com/gh_mirrors/di/distributor
GitHub 加速计划 / di / distributor（简称Distributor）是一款强大的内容分发工具，能够帮助企业在多站点网络中轻松共享和同步内容，实现高效的跨站点内容管理。无论是企业官网、产品子站还是区域分站，Distributor都能让内容分发变得简单而高效。
Distributor内容分发工具
🚀 快速安装Distributor的完整步骤
下载与基本安装
Distributor的安装过程非常简单，即使是新手用户也能轻松完成。首先，你需要获取Distributor插件。对于生产环境，我们建议从官方渠道注册并下载插件，这是完全免费的。你也可以选择从GitCode仓库克隆最新版本：
git clone https://gitcode.com/gh_mirrors/di/distributor下载完成后，你可以通过WordPress仪表板上传并安装插件（插件>添加新插件->上传插件），或者手动将插件文件放置在wp-content/plugins目录中，然后在插件仪表板中激活即可。
注册与密钥配置
为了获得更新通知和一键升级功能，你需要进行简单的注册。注册后，你将收到一个免费的注册密钥。在WordPress仪表板（多站点用户则在网络仪表板）的Distributor设置中输入你的注册邮箱和密钥，即可完成配置。注意，注册邮箱必须与你收到密钥的邮箱一致。
🔗 配置多站点连接的详细指南
外部连接设置步骤
要在企业多站点网络中使用Distributor，你需要在各个站点之间建立连接。以下是详细的步骤：
- 确保要连接的两个站点（我们称之为mainsite.com和remotesite.com）都已激活当前版本的Distributor。
- 在mainsite.com上，导航到
Distributor>External Connections并点击Add New。 - 输入连接标签（例如
remotesite）。 - 在外部站点URL下方输入远程站点的URL（例如
https://remotesite.com），然后按Authorize Connection按钮。 - 系统会提示你输入remotesite.com的管理员用户名和密码（如果你尚未登录remotesite.com），然后重定向到授权应用程序屏幕。
- 在授权应用程序屏幕上，输入主站点的名称，然后按"是的，我批准此连接"按钮。
- 查看
Roles Allowed to Push中选择的角色是否是你想要支持的角色，必要时进行更新，然后按Update Connection按钮。
完成这些步骤后，你的两个站点就成功建立了连接，可以开始共享内容了。
📤 内容推送：一键分发内容到多个站点
如何使用推送功能
Distributor的推送功能让你可以轻松地将内容从一个站点分发到其他连接的站点。发布内容后，WP管理栏中的Distributor菜单将会出现。将鼠标悬停在该菜单项上，会显示推送菜单，左侧显示已连接站点的列表，右侧显示已选择用于推送分发的站点列表，以及一个Distribute按钮，用于将内容分发到这些选定的站点。
Distributor内容推送界面
在WordPress块编辑器中发布内容后，同样可以使用推送菜单和Distributor选项。点击Distribute按钮后，Distributor会将内容推送到选定的连接站点，当这些内容分发完成后，会显示View链接，并在内容成功分发到选定站点后显示"Post successfully distributed."。
Distributor内容推送成功界面
📥 内容拉取：从其他站点获取内容
拉取内容的操作步骤
除了推送内容，Distributor还允许你从已连接的站点拉取内容。在WP管理中导航到Distributor>Pull Content屏幕，会显示一个下拉菜单，用于选择你已连接的任何站点，并显示所有可拉取到当前站点的内容。你可以选择文章、页面和其他自定义文章类型进行筛选；可以使用批量编辑菜单一次拉取或跳过多个内容；还可以使用每个内容行上的单独操作来拉取、查看或跳过每个内容。
🔍 内容管理：跟踪已分发的内容
Distributor提供了方便的内容管理功能，让你可以轻松跟踪已推送或拉取的内容。导航到文章>所有文章表格列表视图，可以通过带有Distributor图标的Distributor列查看所有已推送到当前站点或从其他站点拉取的内容。包含Distributor图标的行将通过该图标链接到内容被推送或拉取的原始站点和文章。
💡 Distributor企业应用最佳实践
处理大型内容和超时问题
在分发包含大量图片（或非常大的文件大小）的文章时，Distributor请求可能会失败。这时，你可以考虑调整超时时间。可以使用dt_push_post_timeout过滤器来过滤推送外部文章的超时时间，以适应你的服务器环境。
处理存储的ID引用
Distributor经常处理存储为ID引用的数据，这在WordPress中很常见，例如块属性、短代码或流行插件（如ACF、Elementor和Gravity Forms）的文章元数据中使用ID。但是，当内容分发到另一个站点时，这些存储的ID可能不匹配，导致数据丢失或意外内容。
为了解决这个问题，Distributor提供了一个辅助函数：distributor_register_data。这个函数允许开发人员注册数据引用，指定数据所在的位置，定义如何提取ID，并注册在源站点和目标站点上处理数据的回调。确保在源站点和目标站点上都添加此数据注册代码，并且两个站点上的Distributor插件版本相同且等于或大于所需版本（2.2.0）。
保持版本一致性
Distributor的不同版本之间可能存在兼容性问题。我们建议外部连接的两端运行相同版本的Distributor。版本2.0.0的Distributor将阻止从运行1.9.x或更低版本Distributor的站点拉取文章。因此，在企业多站点网络中，保持所有站点的Distributor版本一致非常重要。
通过以上步骤和最佳实践，你可以在企业多站点网络中成功部署和应用Distributor，实现高效的内容分发和管理。无论是大型企业还是中小型组织，Distributor都能为你的多站点内容管理带来极大的便利和效率提升。
【免费下载链接】distributorShare content between your websites.项目地址: https://gitcode.com/gh_mirrors/di/distributor
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
