插件依赖项：添加过滤器以在插件激活后恢复自动重定向

[hellofrom托尼亚]

为了解决这些问题（见下文），同时将次要风险降至最低，此问题建议为插件添加一个机制（即过滤器），以注册其登录|设置|配置Core的URL，以处理激活后的自动重定向。该过滤器在设计上是向前兼容的，作为入职框架的入口点（参见#61040).

@costdev@jorbin是该提案的合作伙伴，在与@beaulebens@adrianduffell@nerrad@illuminea@smub进行讨论并收集数据后，他们将更好地了解影响和用户见解。

问题陈述：

插件公司及其用户（也是该项目的用户）受到了显著影响。

目前还不知道大多数用户想要还是不想要自动重定向。

现在我们知道，受影响插件的用户确实需要此功能。他们用户群的规模是表明影响重要性的数据。

一个新的入职框架需要主要发布周期的好处，以了解影响、形成范围、进行实验，然后完成产品|增强阶段。

更多背景：

从WP 6.5.0开始，用户不再能够快速从安装转到登录|设置|配置。插件公司受到了显著影响，报告称用户进入下一步的数量减少了18-30%（这有助于用户使用插件）。6.5.3新的“立即刷新”用户操作（一个额外的用户操作）似乎减少了影响，但仍然很重要。

对于探索入职培训框架（请参阅#61040).

插件依赖性（又名PD）功能为其工作流程做出了技术和设计决策。在与@costdev的对话中，该功能并没有禁止激活后的重定向@jorbin将该功能的问题陈述总结为：

PD要解决的问题是，当一个插件依赖于另一个插件时，用户只能使用他们的设备，这会导致不一致的用户体验，并可能通过停用依赖的插件而破坏网站

请注意，问题陈述没有提及或包括重定向或入职。自动加载登录的硬删除似乎是已确定工作流的副产品。

请注意，这个决定是经过深思熟虑后做出的。在要求测试和6.5 alpha、beta和RC周期期间，没有问题报告或反馈，似乎没有问题。

快进到今天，已经分享了反馈，表明该决定正在产生重大影响。

现在回想起来，新入职框架和PD功能应该一起提供。

建议书

根据这一新的理解，本票据建议：

• 在6.5.x次要版本中，为插件提供一种机制（过滤器）来注册其URL，以便Core处理重定向。为了将次要风险降至最低，范围本质上是一个“选择退出”，使用的过滤器将成为入职框架的一部分。

• 在6.6+专业中，该机制成为入职框架的入口点。

• 然后在主要版本中处理可能的新入职框架和/或工作流的范围和影响，即为讨论、考虑、实验、反馈、采纳等留出时间。

标书技术细节

• 在6.5.4中：
  • 添加新筛选器插件配置数据{$slug}对于登录/配置URL，初始参数值为数组（“url”=>“”）.
  • 如果过滤，它会在激活后自动重定向到该URL。
• 在6.6+中：
  • 过滤器是入职框架的入口点。
  • 过滤器的数组被扩展以满足入职框架的需要。
  • 在Plugins>Add New Plugin屏幕上评估组合Install/Activate，以缓解新按钮创建的三次单击方法。

赞成的意见🟢 和缺点🔴 总结

• 🟢 暂时恢复触发未成年人自动上车的方式（无需回复）。
• 🟢 AJAX是保留的，因此在激活不使用过滤器的插件时不会影响用户或插件作者。
• 🟢 影响了大多数激活插件的用户，这些用户是PD的早期采用者，因为大多数早期采用者需要旗舰插件，这些插件的用户基数很大，需要用户设置才能使用。
• ⚪️ 在设计上是向前兼容的，具有明确的未来方向。
• 🟢 较小的风险较小，而将设计决策转向较大的风险。
• 🟢 在次要方面不太固执己见，将设计决策转移到主要方面。
• 🔴 为插件提供了一种阻止用户完成用户预期操作的方法

为什么不恢复呢？

好问题，一个经过深思熟虑和认真考虑的问题。

插件依赖项（PD）功能的完全恢复可能会导致向后兼容（BC）中断。为什么？它提供了可用于调用和扩展插件的公共函数、类等。如果任何插件当前正在调用或扩展，用户将遇到致命错误。

AJAX的部分恢复将影响用户使用采用该功能的插件。

因此，恢复也会影响用户。

相比之下，该票据建议添加过滤器是一种实用的、向前兼容的方法，以造福用户（包括扩展器）。

工具书类

后续行动：

• #60992 [58081] [58083](6.5.3)
• #22316 [57545](6.5.0).

与相关#61040.

[阿夫拉根]

深思熟虑，有理有据。该提案应要求对现有插件进行最少的更新，以利用并返回其先前的工作流。

插件开发人员需要记住在登录过程尚未完成时有条件地激活此新过滤器。

• 添加新的插件配置数据{$slug}筛选插件以注册其URL。
• 添加重定向控制。对于6.5.4，重定向将在插件激活后发生。

道具@costdev@aaronjorbin

Trac票：https://core.trac.wordpress.org/ticket/61269

[约宾]

这对于沟通来说很重要，所以要记下将有一个开发注释。我开始起草。

[hellofrom托尼亚]

好主意@jorbin。谢谢：）

添加测试关键字。明天，我将提供测试说明，开始用不同的插件测试补丁，并为每个插件测试提供测试前/测试后报告。与WooCommerce、Elementor、Awesome Motive和其他插件合作进行测试和反馈。

#测试报告

使用此PR测试WooCommerce，并在插件中添加示例代码。

##环境

• 操作系统：macOS
• Web服务器：nginx
• 菲律宾比索：8.3
• 应用此PR的6.5.3
• 浏览器：Firefox 126.0
• 主题：默认
• 插件：WooCommerce 8.9.1

##说明

设置：

1. 安装但不要激活WooCommerce，因为需要添加代码。
2. 正常开放插件/woocommerce/woocermerce.php文件。
3. 复制并粘贴以下代码defined（'ABSPATH'）||退出；:

add_filter（'plugin_configuration_data_woocommerce'，静态函数（）{返回数组(“url”=>admin_url（“admin.php？page=wc-admin”），);} );

###在添加插件UI中进行测试：

1. 导航到插件>添加新插件。
2. 在插件搜索框中，键入woocommerce公司。插件卡将出现，包括WooCommerce插件。
3. 在WooCommerce卡中，按“激活”按钮。

预期结果：
激活后，网站应该重定向到Woo的登录向导。

###在“更多详细信息”模式中进行测试：

1. 首先停用WooCommerce。
2. 导航到插件>添加新插件。
3. 在插件搜索框中，键入woocommerce公司。插件卡将出现，其中包括WooCommerce插件。
4. 在WooCommerce卡中，单击“激活”按钮下方的“更多详细信息”链接。
5. 按下“Activate”（激活）按钮（可能需要向下滚动至该按钮）。

预期结果：
激活后，网站应该重定向到Woo的登录向导。

##实际结果

###在添加插件UI中进行测试：
激活后，登机向导会自动重新定向✅

“立即刷新”管理通知和按钮在“插件激活”到触发重定向之间可见。这可能会混淆用户。将其标记为意外❌.

###在“更多详细信息”模式中进行测试：
激活后，登机向导会自动重新定向✅

模式页脚的“立即刷新”管理通知和按钮在“插件激活”到重定向触发之间的时间内可见。这可能会混淆用户。将其标记为意外❌.

###观察结果

“立即刷新”按钮和通知可见❌ （如测试结果所示）。

它在返回后消失了（这是意料之中的✅ ).

#测试报告

使用此PR测试WooCommerce（包括不显示“立即刷新”的修复）​https://github.com/WordPress/WordPress-develop/pull/666/commits/dc013d3e1abbf3a826c02794d7e0c6b006d268ab)以及添加到插件中的示例代码。

##环境

• 操作系统：macOS
• Web服务器：nginx
• 菲律宾比索：8.3
• WordPress：6.5.3应用此PR
• 浏览器：Firefox 126.0
• 主题：默认
• 插件：WooCommerce 8.9.1

##说明

设置：

1. 安装但不要激活WooCommerce，因为需要添加代码。
2. 正常开放插件/woocommerce/woocermerce.php文件。
3. 复制并粘贴以下代码defined（'ABSPATH'）||退出；:

add_filter（'plugin_configuration_data_woocommerce'，静态函数（）{返回数组(“url”=>admin_url（“admin.php？page=wc-admin”），);} );

###在添加插件UI中进行测试：

1. 导航到插件>添加新插件。
2. 在插件搜索框中，键入woocommerce公司。插件卡将出现，包括WooCommerce插件。
3. 在WooCommerce卡中，按“激活”按钮。

预期结果：
激活后：

• “立即刷新”管理通知和按钮不应出现。
• 网站应该重定向到Woo的登录向导。

###在“更多详细信息”模式中进行测试：

1. 首先停用WooCommerce。
2. 导航到插件>添加新插件。
3. 在插件搜索框中，键入woocommerce公司。插件卡将出现，包括WooCommerce插件。
4. 在WooCommerce卡中，单击“激活”按钮下方的“更多详细信息”链接。
5. 按下“Activate”（激活）按钮（可能需要向下滚动至该按钮）。

预期结果：
激活后：

• 在模式的底部，“立即刷新”管理通知和按钮不应出现。
• 网站应该重定向到Woo的登录向导。

##实际结果

###在添加插件UI中进行测试：
激活后：

• “立即刷新”管理通知和按钮未出现✅
• 登录向导自动重新定向✅

###在“更多详细信息”模式中进行测试：
激活后：

• 模态中的“立即刷新”页脚区域不会出现✅
• 登录向导自动重新定向✅

###观察结果
按预期工作✅

[瓦兰尼9099]

你好@hellofromTonya，

要在WordPress中激活插件后恢复自动重定向，可以使用过滤器挂钩。WordPress提供activate_plugin动作挂钩，可以在插件激活后立即使用它添加自定义功能。

以下是您通常会添加到插件主文件中的完整代码片段：

<?php（电话）
功能 我的插件_直接() {
    如果 (发行($_GET（获取）[“激活”]) && $_GET（获取）[“激活”] == “true”) {
        //激活后重定向到特定页面        wp_直接(管理员url('管理员.php？page=my-plugin-settings'));
        出口;
    }
}
添加操作（_A）('管理员_输入', “my_plugin_redirect”);

确保重定向到的页面（admin.php？page=my-plugin-settings）存在，并且在插件中正确注册。

通过添加此代码，您可以确保在激活插件后，用户将自动重定向到指定的设置页面，通过引导他们进入插件的配置区域来增强用户体验。

[hellofrom托尼亚]

你好，@valani9099，

我想你可能错过了上下文。让我解释一下。

在6.5.0中，通过#22316 [57545].

刚刚在Plugins>AddPluginsUI中测试了示例代码。激活后不会进行重定向。

重新打开票据。

[hellofrom托尼亚]

测试说明

这些步骤定义了如何重现问题，并指示预期的行为。

补丁：​https://github.com/WordPress/WordPress-develop/pull/6606

设置

补丁：​https://github.com/WordPress/WordPress-develop/pull/6606
注：应用补丁后，需要构建（即构建JS及其缩小版），由以下人员完成：

npm安装npm运行构建：dev

WP 6.5.0之前激活后自动重定向的插件|设置|配置体验（例如Elementary、WooCommerce、BuddyPress、bbPress、OptinMonster、WPForms等）：

1. 安装插件，但不要激活它。
2. 打开其主插件PHP文件。
3. 在插件头DocBlock之后和之后defined（'ABSPATH'）||退出；（如果存在），复制并粘贴以下代码：

add_filter（'plugin_configuration_data_{the-plugin-slug}'，静态函数（）{返回数组(“url”=>admin_url（“从url到redirect-to”），);} );

例如，如果测试WooCommerce：

• 正常开放插件/woocommerce/woocermerce.php文件。
• 复制并粘贴以下代码defined（'ABSPATH'）||退出；:

add_filter（'plugin_configuration_data_woocommerce'，静态函数（）{返回数组(“url”=>admin_url（“admin.php？page=wc-admin”），);} );

在添加插件UI中进行测试的步骤：

1. 导航到插件>添加新插件。
2. 在插件搜索框中，键入正在测试的插件的名称（例如。woocommerce公司)然后按enter键。UI应该填充该插件和相关的插件。
3. 在插件卡中，按下“激活”按钮。

预期结果：
激活后：

• “立即刷新”管理通知和按钮不应出现。
• 网站应该重定向到插件的登录向导设置或配置页面。

在“更多详细信息”模式中进行测试的步骤：

注意：首先停用插件。

1. 导航到插件>添加新插件。
2. 在插件搜索框中，键入正在测试的插件的名称（例如。woocommerce公司)然后按回车键。UI应该填充该插件和相关插件。
3. 在插件卡中，单击“激活”按钮下方的“更多详细信息”链接。
4. 按下“Activate”（激活）按钮（可能需要向下滚动至该按钮）。

预期结果：
激活后：

• 在模式的底部，“立即刷新”管理通知和按钮不应出现。
• 网站应该重定向到“登录向导设置或配置”页面。

测试另一个需要测试插件的插件的步骤

注意：首先停用插件。

示例：搜索要添加的WooCommerce插件时，请注意有几个依赖于WooCommer的插件，例如WooCommerte Stripe Payment Gateway。

这些指示将用于WooCommerce。但对于Elementor等其他人来说，这是相同的步骤。

1. 导航到插件>添加新插件。
2. 在插件搜索框中，键入woocommerce公司然后按enter键。UI应该填充该插件和相关插件。
3. 在插件卡中，单击“激活”按钮下方的“更多详细信息”链接。
4. 对于其中一个需要WooCommerce的插件（如WooCommer Stripe Payment Gateway）：4.1按下“立即安装”按钮。4.2安装后，请注意无法激活插件。这是经过设计的，因为它需要WooCommerce。4.3在“需要其他插件”部分，单击WooCommerce的“更多详细信息”链接。4.4在模式中，按下“激活”按钮。预期：应加载WooCommerce的登录向导。4.5在浏览器中，单击按钮导航回“添加插件”UI。预期：WooCommerce Stripe支付网关插件现在可以激活。4.6激活插件。

预期结果：
激活WooCommerce后：

• 在模式的底部，“立即刷新”管理通知和按钮不应出现。
• 网站应该重定向到“登录向导设置或配置”页面。

导航回Add Plugins UI后，需要WooCommerce的插件现在可以激活了。

[hellofrom托尼亚]

WooCommerce测试报告

补丁已测试​https://github.com/WordPress/WordPress-develop/pull/6606截至​本次承诺

环境

• 操作系统：macOS
• Web服务器：nginx
• 菲律宾比索：8.3
• 应用此PR的6.5.3
• 浏览器：Firefox 126.0
• 主题：默认
• 插件：添加了示例代码的WooCommerce 8.9.1。

添加插件UI中的实际测试结果：

激活后：

• ✅ “立即刷新”管理通知和按钮不会出现。
• ✅ 自动重定向到WooCommerce的登录向导。

更多详细信息模式下的实际测试结果：

激活后：

• ✅ 在模式的底部，“立即刷新”管理通知和按钮没有出现。
• ✅ 自动重定向到WooCommerce的登录向导。

测试的实际结果另一个插件需要您测试的插件

激活WooCommerce后：

• ✅ 在模式的底部，“立即刷新”管理通知和按钮没有出现。
• ✅ 自动重定向到WooCommerce的登录向导。

导航回“添加插件”UI后：

• ✅ 能够激活需要WooCommerce的插件。

[hellofrom托尼亚]

Elementor测试报告

补丁测试​https://github.com/WordPress/WordPress-develop/pull/6606截至​本次承诺

环境

• 操作系统：macOS
• Web服务器：nginx
• 菲律宾比索：8.3
• 应用此PR的6.5.3
• 浏览器：Firefox 126.0
• 主题：默认
• 插件：Elementor 3.21.7，添加了示例代码：

add_filter（'插件配置数据元素'，静态函数（）{返回数组(“url”=>admin_url（“admin.php？page=elementor-app#onboarding”），);} );

添加插件UI中的实际测试结果：

激活后：

• ✅ “立即刷新”管理通知和按钮不会出现。
• ✅ 自动重定向到Elementor的入职向导。

更多详细信息模式下的实际测试结果：

激活后：

• ✅ 在模式的底部，“立即刷新”管理通知和按钮没有出现。
• ✅ 自动重定向到Elementor的入职向导。

测试的实际结果另一个插件需要您测试的插件

Elementor激活后：

• ✅ 在模式的底部，“立即刷新”管理通知和按钮没有出现。
• ✅ 自动重定向到Elementor的入职向导。

导航回“添加插件”UI后：

• ✅ 能够激活需要Elementor的插件。

该PR已准备好进行审查和测试。测试说明见说明和票证。

[hellofrom托尼亚]

OptinMonster测试报告

补丁测试​https://github.com/WordPress/WordPress-develop/pull/6606截至​本次承诺

插件回购的OptinMonster​https://wordpress.org/plugins/optinmonster（英文）/.

环境

• 操作系统：macOS
• Web服务器：nginx
• 菲律宾比索：8.3
• WordPress：6.5.3应用此PR
• 浏览器：Firefox 126.0
• 主题：默认
• 插件：OptinMonster 2.16.2，添加了示例代码：

add_filter（'插件配置数据选项怪物'，静态函数（）{返回数组(“url”=>admin_url（“admin.php？page=optin-monter-onboarding-wizard”），);} );

添加插件UI中的实际测试结果：

激活后：

• ✅ “立即刷新”管理通知和按钮不会出现。
• ✅ 自动重定向到OptinMonster的入职向导。

更多详细信息模式下的实际测试结果：

激活后：

• ✅ 在模式的底部，“立即刷新”管理通知和按钮没有出现。
• ✅ 自动重定向到OptinMonster的入职向导。

测试的实际结果另一个插件需要您测试的插件

没有测试，因为没有插件需要它。

[hellofrom托尼亚]

BuddyPress测试报告

补丁测试​https://github.com/WordPress/WordPress-develop/pull/6606截至​本次承诺

插件回购中的BuddyPress​https://wordpress.org/plugins/buddypress网站/.

环境

• 操作系统：macOS
• Web服务器：nginx
• PHP代码：8.3
• 应用此PR的6.5.3
• 浏览器：Firefox 126.0
• 主题：默认
• 插件：BuddyPress 12.5.0，添加了示例代码：

add_filter（'插件配置数据缓冲'，静态函数（）{返回数组('url'=>admin_url（'admin.php？hello=buddypress&is_new_install=1'），);} );

添加插件UI中的实际测试结果：

激活后：

• ✅ “立即刷新”管理通知和按钮不会出现。
• ✅ 使用BuddyPress模式覆盖自动重定向到管理仪表板。

更多详细信息模式下的实际测试结果：

激活后：

• ✅ 在模式的底部，“立即刷新”管理通知和按钮没有出现。
• ✅ 使用BuddyPress模式覆盖自动重定向到管理仪表板。

测试另一个需要BuddyPress的插件的实际结果

没有测试，因为没有插件需要它。

[hellofrom托尼亚]

联系人表格7测试报告

补丁测试​https://github.com/WordPress/WordPress-develop/pull/6606截至​本次承诺

插件回购的联系表7​https://wordpress.org/plugins/contact-form-7/.

WP 6.5之前的性能：
激活后：

• 重定向回插件表列表
• 在管理员的主菜单侧栏中添加了“联系人”菜单。

环境

• 操作系统：macOS
• Web服务器：nginx
• 菲律宾比索：8.3
• WordPress：6.5.3应用此PR
• 浏览器：Firefox 126.0
• 主题：默认
• 插件：添加了示例代码的Contact Form 7 v 5.9.5：

add_filter（'插件配置数据接触表单-7'，静态函数（）{返回数组(“url”=>admin_url（“plugins.php”），);} );

添加插件UI中的实际测试结果：

激活后：

• ✅ “立即刷新”管理通知和按钮不会出现。
• ✅ 自动重定向到插件表列表。
• ✅ “联系人”菜单添加到主侧栏中。

更多详细信息模式下的实际测试结果：

激活后：

• ✅ 在模式的底部，“立即刷新”管理通知和按钮没有出现。
• ✅ 自动重定向到插件表列表。
• ✅ “联系人”菜单添加到主侧栏中。

测试另一个需要联系人表单7的插件的实际结果

插件：联系人表单7–动态文本扩展​https://wordpress.org/plugins/contact-form-7-dynamic-text-extension网站/

激活联系表7后：
✅ 在模式的底部，“立即刷新”管理通知和按钮没有出现。

• ✅ 自动重定向到插件表列表。
• ✅ “联系人”菜单添加到主侧栏中。

导航回“添加插件”UI后：
✅ 能够激活需要Contact Form 7–Dynamic Text Extension插件的插件。

[凯文霍夫曼]

• 在6.5.x次要版本中，为插件提供一种机制（过滤器）来注册其URL，以便Core处理重定向。为了将次要风险降至最低，范围本质上是一个“选择退出”，使用的过滤器将成为入职框架的一部分。
• 在6.6+专业中，该机制成为入职框架的入口点。

我了解此修补程序将在6.5.X中恢复激活后重定向。

如果/当过滤器成为6.6+中登录框架的入口点时，是否会取消执行激活后重定向的功能，转而支持用户决定启动登录的新工作流？或者插件会保持强制重定向超过6.6+的能力吗？

如果重定向再次出现，我们将很难说服插件开发人员放弃重定向，转而使用用户领导的工作流。

[hellofrom托尼亚]

回复凯文霍夫曼:

我了解此修补程序将在6.5.X中恢复激活后重定向。

是的，但不同之处在于：重定向被移动到Core中，并赋予Core对什么时候它在工作流中触发。

在Add Plugins UI（包括其“More Details”模式）中，插件不能直接重定向；相反，他们注册自己的URL，Core控制工作流中某个点的重定向。

如果/当过滤器成为6.6+中登录框架的入口点时，是否会取消执行激活后重定向的功能，转而支持用户决定启动登录的新工作流？或者插件会保持强制重定向超过6.6+的能力吗？

这些问题可以在入职培训框架中进行探讨#61040.

[阿夫拉根]

WooCommerce测试报告

描述

此报告验证指示的修补程序是否按预期工作。

补丁测试：​https://github.com/WordPress/WordPress-develop/pull/6606

使用了Docker本地环境。
应用修补程序。
构建并启动Docker环境。

环境

• 新闻稿：6.6-alpha-57778-src
• 菲律宾比索：8.2.19
• 服务器：nginx/1.25.5
• 数据库：mysqli（服务器：8.0.37/客户端：mysqlnd 8.2.19）
• 浏览器：Safari 17.5
• 操作系统：macOS
• 主题：二十二点四分1.1
• MU插件：未激活
• 插件：
  • 测试报告1.1.0
  • WooCommerce 8.9.1版

添加插件UI中测试的实际结果

激活后：

✅ “立即刷新”管理通知和按钮不会出现。
✅ 自动重定向到WooCommerce的登录向导。

模态试验的实际结果

激活后：

✅ 在模式的底部，“立即刷新”管理通知和按钮没有出现。
✅ 自动重定向到WooCommerce的登录向导。

[约宾]

虽然6.5.4中的行为是重定向，但我认为如果此过滤器文档包含关于向后兼容性的特定承诺，那么使用它的人可以清楚地了解哪些内容可以更改（哪些内容不会更改），这将是有益的。我知道有人认为阻止重定向的行为改变是向后兼容性中断，我想在这种行为再次消失时防止这种分歧。

人们对devnote和内联文档中使用的以下语言有何看法：

这个钩子有一个特定的向后兼容性承诺。它所导致的功能不能保证保持一致，但特定参数的行为不会改变。例如，redirect_url参数将不会被重用，但随着插件安装体验的发展，它可能（而且很可能）会被弃用。

这也意味着我们需要将参数重命名为网址到重定向url所以它更具体。它有减少混淆和向前兼容的好处，但它的代价是要求插件开发人员掌握最新变化。我认为这个成本是合理的，因为如果你要发布一个插件，你应该测试它，并为每个主要的WordPress版本更新它。

[hellofrom托尼亚]

例如，不会重用redirect_url参数，但随着插件安装体验的发展，该参数可能会被弃用。

我建议将“不会重用”更改为“可能不会重用”。为什么？关于与安装>激活>配置工作流相关的入职框架可能发生或不可能发生的情况，尚未做出最终决定。

进入这张罚单网址目前正在考虑保留，但可以随着工作流体验的发展而变化。

[hellofrom托尼亚]

回复约宾:

这也意味着我们需要将参数重命名为网址到重定向url所以它更具体。它有减少混淆和向前兼容的好处，但它的代价是要求插件开发人员掌握最新变化。我认为这个成本是合理的，因为如果你要发布一个插件，你应该测试它，并为每个主要的WordPress版本更新它。

我认为该参数不需要重命名。

为什么？

这个网址参数在“配置数据”中。它是用户配置插件的URL。用户通过6.5.4中的重定向以及将来可能通过其他方式（例如通过新的用户操作）访问该URL。因此，它不是重定向url，而是插件的配置网址.

换句话说，未来可能发生的变化是如何触发URL。

我主张将其保留为网址，因为它很好地符合今天和未来的意图（与今天已知的内容）。

[凯文霍夫曼]

我同意@hellofromTonya的观点，我们不应该将怎样用户可以访问URL，该URL可能会更改，但URL的目的不应更改。

然而，为了将来的灵活性，我建议将此参数命名为更具体的名称，例如车载url表示激活后应立即将用户定向到的位置。

在6.5.X中，可以通过重定向完成入职。在6.6+中，可以通过插件卡中的新按钮访问登录。无论是哪种方式，插件开发人员都通过他们过去使用的重定向表明，他们心中有一个单一的URL，他们希望所有用户都能开始体验他们的插件。该参数将满足这一需求。

通过命名参数车载url而不是网址它还为其他类型的URL打开了大门，这些URL可能与入职框架相关且有用。

可通过此筛选器定义的潜在有用URL

• 车载url-这是此票据中描述的URL。这是插件激活时用户被引导到的地方。此URL可以表示用于初始配置的交互式登录向导（例如WooCommerce设置向导），也可以表示更多关于教育而非配置的入门指南。考虑一个插件，它可能没有设置，也没有出现在管理菜单中，但仍然可以从登录体验中受益。通过使用术语“onboarding”，我们明确了它的目的，而没有规定用户如何到达那里（由核心决定）或他们到达那里时做什么（由插件决定）。
• 主url-这可以由登录框架用于确定用户在登录完成后登录的位置。这也是用户通常认为是特定插件的“主页”的地方。这是他们开始使用已经配置好的插件的地方（例如导航到管理菜单中的“WooCommerce”或“ACF”）。
• 配置url-随着时间的推移，用户通常会在这里配置插件（例如WooCommerce设置页面）。考虑一个已经完成登录的用户。WP Admin中可能有一些地方更适合显示此通用配置URL，而不是满足首次使用的入职体验。

以WooCommerce为例

• 车载url-admin.php？页面=wc-admin&path=%2Setup-wizard
• 主url-admin.php？页面=wc-admin
• 配置url-admin.php？页面=wc-设置

明确地说主url或配置url只是需要进一步探讨的想法#61040。我在这里分享这些可能性，以便其他人可以看到命名此参数的价值车载url。我相信我们对其目的有足够的了解，即使我们不知道即将到来的入职培训框架的所有细节，我们也会在今天打电话。

我想知道我们是否应该换一下网址在过滤参数中变成更具体的东西？

我可以想象这个过滤器将来会被扩展为其他参数，也许我们最终会得到一个设置url和a入职_url例如：

• 设置url用于“设置”链接等URL，插件作者通常会使用插件操作链接{$pluginfile}滤波器
• 车载url是一个唯一的URL，可以在插件首次激活时开始登录，就像Yoast SEO一样wp-admin/admin.php？页面=wpseo_installation_successful_free.

[成本开发]

请注意，删除6.5中的重定向不仅会影响登录体验，还会影响未加载的插件菜单项。此票据提到“onboarding|setup|configure”，而不仅仅是onboarting。因此，6.5.4中的这个过滤器可以用于将用户定向到插件的主URL、设置URL、登录URL或任何其他URL。我们只是不知道对于所有插件来说，什么是最合适的URL。

还要注意插件作者可能更改URL取决于他们想在不同的跟踪状态点提供什么。他们甚至可能有这样的状态，即在设置的不同阶段或在后来的不应提供登录的激活（例如调试后重新激活，或更新插件）。

因此，现在为参数选择一个建议的名称意味着只传达一个用例或行为，我认为最好让插件作者决定URL应该是什么以及何时使用。

如果强烈希望更改参数的名称，请在头脑风暴备选名称时记住上述内容。

在沟通方面，我同意我们应该明确表示，随着经验的发展，数组的内容可能会扩展。然而，我们应该相信，在可预见的将来，这个URL参数将与提交时的名称保持不变。如果我们现在对这个名字没有信心，那么我同意我们应该重新命名它——再一次，考虑到以上因素。

[凯文霍夫曼]

票证描述说：

从WP 6.5.0开始，用户不再能够快速从安装转到登录|设置|配置。

如果入职培训的目标是确保用户平稳高效的过渡，减少价值实现的时间，提高用户参与度和保留率，那么可以合理地说，在激活后立即定位时，设置/配置是入职的同义词。因此车载url参数可以满足以上所有要求。

因此，现在为参数选择一个建议的名称意味着只传达一个用例或行为，我认为最好让插件作者决定URL应该是什么以及何时使用。

参数名称应该指出用例或目的，而不是行为。如果我们有一个万能的网址参数并依赖插件从一个用例到另一个用例定义适当的值，然后我们限制WordPress核心、开发人员、用户和主机从一组标准化的参数中获益的可能性，这些参数可以用于特定目的。

例如：

• WordPress核心中的登录框架可能会受益于在登录完成时知道将用户导向何处（例如插件主url)无需依赖特定于插件的逻辑来确定网址.
• 在每个网站上安装WooCommerce的用户或开发人员可能希望通过过滤车载url在不影响其他用例的情况下网址。在这种情况下，用户最好的登录体验是根本不必点击向导。
• 类似地，多站点开发人员可能希望禁用登录向导（请参阅​真实世界示例).
• 拥有电子商务产品的主机可能希望将用户引导到特定于主机的登录版本，以确保他们在该主机上充分利用其电子商务解决方案。

关于AJAX插件激活的讨论(#60992)，迄今为止关于入职培训框架的讨论(#61040)而这整张票都是关于促进以任何形式从一个插件到下一个插件的登录体验的入口点。所有对话的共同点是，我们试图在插件激活后立即改善体验，其中车载url可以根据每个用户的需求、能力和背景进行定义或修改，以提供适合每个用户的入职体验。这些都是已知的入职挑战，有着悠久的cowpath解决方案历史，因此，让我们以一种不限制未来可能实现的方式相应地命名此参数。

[hellofrom托尼亚]

回复凯文霍夫曼:

• WordPress核心中的登录框架可能会受益于在登录完成时知道将用户导向何处（例如插件主url)无需依赖特定于插件的逻辑来确定网址.

凯文，你在设想插件工作流中第四步的可能性吗？
安装>激活>板载|设置|配置>板载后的第四步。

禁用一个或所有插件的登录

我不明白添加单独的配置URL参数是如何实现这一目标的。它将复杂性转移到了Core中，同时也使插件、用户和主机变得更加困难和不可靠。怎么会这样？

我将详细介绍每个场景。

如果目标是为用户、插件、主机等提供一种机制，使其对插件的任何组合或可能所有插件禁用板载，则需要一种不同的方法。例如，可以添加另一个过滤器来禁用或跳过所有过滤器。

• 在每个站点上安装WooCommerce的用户或开发人员可能希望通过筛选车载url在不影响其他用例的情况下网址。在这种情况下，用户最好的登录体验是根本不必点击向导。

注意到过去评论中的示例：

onboarding_url-admin.php？页面=wc-admin&path=%2Setup-wizardmain_url-admin.php？页面=wc-admin配置url-admin.php？page=wc设置

对于某些插件，可能会触发一个或多个特定URL的登录，即直到登录完成或取消。

例如，WooCommerce的车载url和主url两者都启动安装向导。

因此，对于这些插件，用户需要过滤每个URL参数才能禁用向导。此外，不能保证另一个插件的优先级或在优先级队列中的位置在调用堆栈中是否更高/更晚。

• 类似地，多站点开发人员可能希望禁用登录向导（请参阅​真实世界示例).

与上述问题相同。

• 他们需要知道哪些插件的URL参数触发了他们的登录（例如在WooCommerce的情况下车载url和主url触发向导。
• 不能保证插件的过滤被调用到钩子队列的最后一个来禁用它，这使得它不可靠。

主机更改URL以直接访问其体验

• 拥有电子商务产品的主机可能希望将用户引导到特定于主机的登录版本，以确保他们在该主机上充分利用其电子商务解决方案。

类似地，主机可以过滤配置数据网址特定插件更改网址指出他们希望用户登陆的位置。

[hellofrom托尼亚]

虽然我很欣赏这些考虑和用例，但我认为所有呈现的场景（除了可能的第四步）都可以通过一个入口的当前设计实现网址.

然后，如果在未来发现更多需要不同考虑的用例，例如禁用所有入职的能力，可以探索如何实现这些功能，例如添加另一个过滤器。

对于这个阶段，我同意@costdev。他提出的配置数据符合当今和未来的意图和需求。

[hellofrom托尼亚]

回复hellofrom托尼亚:

虽然我很欣赏这些考虑和用例，但我认为所有呈现的场景（除了可能的第四步）都可以通过一个入口的当前设计实现网址.

然后，如果在未来发现更多需要不同考虑的用例，例如禁用所有入职的能力，可以探索如何实现这些功能，例如添加另一个过滤器。

对于这个阶段，我同意@costdev。他提出的配置数据符合当今和未来的意图和需求。

这就是说，如果有一个真实的案例，并且很可能在插件安装>激活>板载工作流中需要第四步，那么这个用例可能是重命名它的原因车载url（即，其中入职=板载|设置|配置。

[hellofrom托尼亚]

Yoast SEO测试报告

补丁测试​https://github.com/WordPress/WordPress-develop/pull/6606截至​本次承诺

插件回购的Yost SEO​https://wordpress.org/plugins/wordpress-seo/.

环境

• 操作系统：macOS
• Web服务器：nginx
• 菲律宾比索：8.3
• 应用此PR的6.5.3
• 浏览器：Firefox 126.0
• 主题：默认
• 插件：添加了示例代码的Yoast SEO 22.7：

add_filter（'plugin_configuration_data_wordpress-seo'，静态函数（）{返回数组(“url”=>admin_url（“admin.php？page=wpseo_installation_successful_free”），);} );

添加插件UI中测试的实际结果

激活后：

• ✅ “立即刷新”管理通知和按钮不会出现。
• ✅ 自动重定向到Yoast SEO的登录向导。

更多细节模式下的实际测试结果

激活后：

• ✅ 在模式的底部，“立即刷新”管理通知和按钮没有出现。
• ✅ 自动重定向到Yoast SEO的登录向导。

测试另一个需要Yoast SEO的插件的实际结果

没有测试，因为没有插件需要它。

[hellofrom托尼亚]

测试报告-相对URL

如果配置了网址是相对URL而不是绝对URL？

使用Yoast SEO测试报告，我修改了插件代码：

add_filter（'plugin_configuration_data_wordpress-seo'，静态函数（）{返回数组(“url”=>“admin.php？”？页面=wpseo_installation_successful_free'，);} );

相同的结果-所有测试仍然通过✅

[约宾]

我的目标是建议使用特定的向后兼容语言并从网址到重定向url当重定向不再是自动的，而是按下按钮或其他方式时，可以减少惊讶。

到时候，我们可以创建一个新的_不推荐的参数如果有人进来就会开枪重定向url不再使用后

我认为，如果决定不应该有一个特定的向后兼容性承诺，即不为任何其他首次引入的参数重复使用参数网址是一个好名字。在这种情况下，我仍然认为最好在过滤器文档中明确说明，用户界面行为不能保证保持不变。因此，我建议大致如下：

由这个钩子中特定值的配置引起的用户界面行为不能保证在WordPress的各个版本之间保持一致。

[hellofrom托尼亚]

回复约宾:

我的目标是建议使用特定的向后兼容语言并从网址到重定向url当重定向不再是自动的，而是按下按钮或其他方式时，可以减少惊讶。

最近你和我分享了UI和工作流不是BC承诺的一部分。过滤器及其参数在BC承诺中@costdev设计了过滤器网址记住这些参数。

插件激活后的自动重定向是UI和工作流的一部分。核心对“如何”和“何时”的控制是UI和工作流的一部分。它对插件注册数据的使用以及插件向Core注册的入口点是面向公众的，也是BC承诺的一部分。Core使用该可配置数据的目的和效果是相同的，也是BC承诺的一部分。

这不是插件激活后自动定向的承诺，也不是工作流或机制的承诺。UI和工作流可能会更改。

如果变成按下按钮或其他方式，效果是一样的->Core提供了加载注册的登录|设置|配置URL的机制，以将用户移动到下一步。

“这有道理吗，”约宾？

过滤器的文档如何？
我同意你的观点，可以说得更清楚。为了帮助减少混乱和以后可能发生的意外，需要注意如何在Make/Core、版本、此票据等中传达此更改。

你怎么认为？

[hellofrom托尼亚]

在与@costdev（他将很快跟进他的想法）交谈后，认为过滤器和工作流行为之间存在混淆。

此过滤器不推动行为。这是Core将使用的配置入口点。

思考核心和用户行为不应成为筛选器的docblock的一部分。相反，过滤器的文档应该关注它的用途以及如何用它注册插件配置数据。

[成本开发]

我同意我们应该考虑在文档块中记录过滤器的行为是否合适。

与所有其他过滤器一样，此过滤器可以在Core中的各种位置和方式使用，但所有使用都将引用同一个docblock。今天它的使用方式可能会改变，这对于所有过滤器来说都是如此，应该是意料之中的。

虽然我理解建议背后的理由，但我会小心使用向后兼容语言，因为UI和工作流不是我个人认为在BC承诺范围内的东西（否则标记、属性、元素标记、元素顺序等可能从未改变——这将是一场噩梦，我相信我们都会同意）。我们对过滤器做出的唯一向后兼容性承诺是，它们的挂钩名称和参数不会更改（除非已弃用），并且即使已弃用，它们仍将可用于扩展器。过滤后的数据会发生什么是另一回事。

我建议我们在docblock中回答“我在过滤什么？”，在6.5.4通信（开发说明、发布公告等）中回答“过滤这个做什么？”那里它的行为方式会随着用户体验的进一步发展而改变，我们强烈建议扩展器与我们合作。如果这似乎不足以防止教程等向扩展器传达错误的信息，我建议我们联系MarComms、Outreach，可能还有项目领导，看看他们是否可以帮助进行这种沟通。

[凯文霍夫曼]

@hellofromTonya@costdev@jorbin感谢您考虑使用多个URL的可能性。我想我已经加入了单URL网址参数，但我确实想提出一个与中围绕入职框架讨论的功能相关的问题#61040.

如果我们想让插件开发人员自定义与登录URL相关的链接文本（例如“Open”、“Start onboarding”），您是否希望在同一个过滤器中将链接文本定义为单独的参数？

我将附上之前共享的模型，以演示链接文本如何最终与网址在此筛选器中定义。

[成本开发]

@凯文霍夫曼虽然我们还为时尚早，但我可以设想，这个过滤器可能会添加额外的参数，这就是为什么它被设计为接受阵列参数，而不仅仅是单个参数（字符串）$url参数。

例如：

<?php（电话）

//请勿使用。这不是在WORDPRESS CORE中实现的。
添加筛选器( '插件配置数据_woocommerce', 'woocommerce_add_config_data' );

功能 woommerce_add_config_data公司( $config_data（配置数据） ) {
    如果 ( $something_saying_onboarding_is_not_completed ) {
        $config_数据[“url”]        = 管理员url( '管理员.php？page=wc-admin&path=%2Setup-wizard' );
        $config_data（配置数据）['标签']      = __( “入门”, “woocommerce” );
        $config_data（配置数据）[“aria_label”] = 把格式数据写成串(
            /*翻译人员：%s:WooCommerce*/
            __( '开始使用%s。' ),
            “WooCommerce”
        );
    } 其他的 {
        $config_data（配置数据）[“url”]        = 管理员url( '管理员.php？page=wc管理员' );
        $config_data（配置数据）['标签']      = __( “打开”, “woocommerce” );
        $config_data（配置数据）[“aria_label”] = 把格式数据写成串(
            /*翻译人员：%s:WooCommerce*/
            __( '打开%s。' ),
            “WooCommerce”
        );
    }

    返回 $config_data（配置数据）;
}

[洛波]

回复hellofrom托尼亚:

Yoast SEO测试报告

补丁测试​https://github.com/WordPress/WordPress-develop/pull/6606截至​本次承诺

插件回购的Yost SEO​https://wordpress.org/plugins/wordpress-seo/.

嘿，@hellofromTonya，我可以确认你的测试：补丁+代码片段肯定会恢复插件激活的预期行为，并确保新站点的正确登录。
我已经在为我们的回购准备公关，我真的希望这可以包括在6.5.4中。

[pooja1210型]

你好，

WooCommerce测试报告

补丁测试： ​https://github.com/WordPress/WordPress-develop/pull/6606

环境
操作系统：macOS
菲律宾比索：8.1
文字出版社：6.6-alpha-20240527.1
浏览器：Chrome 125
主题：默认

插件：添加了示例代码的WooCommerce v8.9.1：

add_filter（'plugin_configuration_data_woocommerce'，静态函数（）{返回数组(“url”=>admin_url（“admin.php？page=wc-admin”），);} );

预期结果：
##在添加插件UI中进行测试：
激活后，站点被重定向到WooCommerce登录向导页面☑️

##在“更多详细信息”模式中进行测试：
在底部，刷新按钮不可见，站点被重定向到WooCommerce登录向导页面☑️

谢谢

感谢您的努力，@hellofromtonya——到目前为止，它在WooCommerce插件中对我的测试很好。

WordPress应该跟踪每个插件是否已完成登录，还是应该将此逻辑卸载到各个插件？🤔

对于WooCommerceadmin.php？页面=wc-admin用于确定配置是否不完整的URL，并且应在主屏幕上显示入职信息。这对于防止“重新激活”时不必要地再次显示登录（即，如果用户执行以下顺序：安装>激活>登录>取消激活>激活）是必要的。然而，让WordPress知道完成状态可能是值得的，这样可以将此逻辑直接构建到WordPres中。如果是这样的话，可能还有一个额外的完整的在数组上键入插件以声明配置是否已完成：

add_filter（'plugin_configuration_data_woocommerce'，静态函数（）{返回数组(“url”=>admin_url（“admin.php？page=wc-admin”），“已完成”=>some_function_returning_true_or_false（），);} );

[路易斯沃尔94]

Elementor您好，

感谢各位领导这项倡议，我们非常感谢。

我很高兴地向大家报告，这对我们来说也起到了预期的作用。

与@adrianduffel的评论类似，我们宁愿重定向到另一个内部URL，而不是直接登录URL，这样我们就不会在重新激活时重新运行登录。

回复hellofrom托尼亚:

Elementor测试报告

补丁测试​https://github.com/WordPress/WordPress-develop/pull/6606截至​本次承诺

环境

• 操作系统：macOS
• Web服务器：nginx
• 菲律宾比索：8.3
• 应用此PR的6.5.3
• 浏览器：Firefox 126.0
• 主题：默认
• 插件：Elementor 3.21.7，添加了示例代码：

add_filter（'插件配置数据元素'，静态函数（）{返回数组(“url”=>admin_url（“admin.php？page=elementor-app#onboarding”），);} );

添加插件UI中的实际测试结果：

激活后：

• ✅ “立即刷新”管理通知和按钮不会出现。
• ✅ 自动重定向到Elementor的入职向导。

更多详细信息模式下的实际测试结果：

激活后：

• ✅ 在模式的底部，“立即刷新”管理通知和按钮没有出现。
• ✅ 自动重定向到Elementor的入职向导。

测试的实际结果另一个插件需要您测试的插件

Elementor激活后：

• ✅ 在模态的底部，“立即刷新”管理通知和按钮不会出现。
• ✅ 自动重定向到Elementor的入职向导。

导航回“添加插件”UI后：

• ✅ 能够激活需要Elementor的插件。

感谢您测试@adrianduffell。

WordPress应该跟踪每个插件是否已完成登录，还是应该将此逻辑卸载到各个插件？

这是一个有趣的问题。如果/当登录被集成到工作流中时，很可能是Core需要跟踪的状态，即为链中的下一个插件带来体验和/或改变当前状态的用户。

我认为现在把它引入这个未成年人的工作范围还为时过早。

为什么？它需要讨论和考虑它和入职一般如何适合用户+插件链工作流。IMO最好在登机框架Trac票.

你介意在那张票上分享一下你的想法吗？

[hellofrom托尼亚]

感谢大家测试并提供反馈-摇滚明星🌟

• 测试（包括来自受影响插件作者的测试）证实了它的工作原理，并符合此问题的范围。

• 反馈表明一致同意继续前进。

接下来是什么？

• 调整过滤器的描述（在其docblock中），以更清楚地描述“我在过滤什么？”，而不是Core将采取的行为。​在此处加入讨论.

• 完成后，应做好提交准备。

[hellofrom托尼亚]

补丁：​https://github.com/WordPress/WordPress-develop/pull/6606

准备提交到大旅行箱.

[hellofrom托尼亚]

将所有权分配给将处理提交的@costdev。

[彼得威尔逊公司]

对于跟踪此票证的插件开发人员，请注意，过滤器已被重命名为包含WordPress前缀：wp_plugin_configuration_data{$slug}.

这是为了避免与第三方代码发生命名冲突的可能性。

[hellofrom托尼亚]

更新：

如果AJAX可以在不需要过滤器的情况下在次要版本中进行更改，该怎么办？这样的更改是否可以在不引起其他未知问题的情况下干净地进行？

这张票据中的“为什么不恢复？”部分没有提到：部分恢复很混乱，引起了对潜在问题的担忧。在未成年人身上似乎太冒险了。

@costdev和我又看了一眼AJAX，问自己：这一变化的哪一部分导致了回归和影响？只能更改该部分以恢复6.5之前的行为吗？是的，有一种方法。

#61319是这张票的替代品。就像这张票一样，它也有优点和缺点。与此票证不同，它不引入过滤器，也不需要更改插件。

尽管有人支持并一致同意推进这一问题（过滤器），但IMO值得暂停考虑#61319哪种方法更适合次要（解决影响和回归）和未来？

行动项目：

@costdev和我邀请您对#61319（请在该票据中，在一个位置捕获上下文和历史）。

[hellofrom托尼亚]

今天Dev Chat的反馈摘要，在Making WordPress slack中进行核心频道：

指向线程开头的链接：​https://wordpress.slack.com/archives/C02RQBWTW/p1717013066479629

@阿夫拉根分享了：

我相信最简单的方法是#61319

@mikachan分享了：

我在这里没有太多背景知识，但在阅读了@hellofromtonya关于#61319，我同意这听起来是最好的方法（代码更少，恢复“激活”按钮以前的本机行为）：+1：

@iron程序员共享：

我喜欢这个[即。#61319]处理最初报告的回归，不添加任何新内容。更好地遵守小版本中预期的范围。

@乔麦吉尔问道：

从那些对最初的方法持批评态度的人那里获得反馈会好吗？

好吧，听起来你在收到来自

@swissspidy和@azaozz，所以最好能得到他们对新方法的反馈。一般来说，我认为我们需要对这种方法非常有信心，然后才能在小版本中发布它，所以获得额外的公关反馈和测试是一种很好的做法

我分享了他们的反馈(​在这里和​在这里).

[hellofrom托尼亚]

我正在删除犯罪关键字，直到就是否继续使用此票据或#61319.

两个票证的补丁都已准备好提交，但只应提交一个。

[hellofrom托尼亚]

大家好，

感谢大家为这张票和付出的努力。开源的力量！

这里所做的工作更适合于主要版本，即Trac#61040。请注意，对于哪些参数应该包含在其中，哪些参数不应该包含在中，以及在配置数据注册中这些参数的命名应该是什么，进行了反复的讨论。这种讨论很重要，需要深思熟虑和试验。

但这就是重点：添加插件工作流程中的入职/配置步骤仍处于构思阶段。这个想法成为下一步需要时间。

虽然人们强烈希望过滤器是并将成为下一步/工作流的一部分，但仍然存在这样的风险：网址参数可能不适合这种想法。因此，它会锁定入口点或导致弃用。

随着新方法的出现#61319，它直接解决了回归的范围。对于未成年人，大家一致同意采用这种方法。

这张票将被关闭以支持#61319但这里的工作和讨论是构思阶段的一部分，需要继续到下一步，即继续#61040.

我邀请大家积极参与并为#61040以及细化和定义添加插件工作流的下一步，以及如何将配置/登录融入其中，以改善大多数用户的体验。

再次感谢您。快乐贡献：）

Trac注释：
我将此标记为的副本#61319虽然实现不是重复的，但它要解决的问题，即回归，是相同的。

成交有利追踪61319及其补丁#6670.

感谢大家为这项工作做出的贡献🥇 这项工作可以在https://core.trac.wordpress.org/tickt/61040作为主要发布的一部分。