为 WooCommerce 我的账户订单页面添加具有唯一 CSS 类的操作按钮

本文将指导您如何在 WooCommerce 的“我的账户”订单页面上添加一个自定义操作按钮，并为其应用唯一的 CSS 类，以便您可以针对该按钮进行特定的样式设置，而不会影响其他按钮的样式。文章将提供详细的代码示例和步骤，帮助您轻松实现这一功能。

添加自定义操作按钮

首先，我们需要使用 woocommerce_my_account_my_orders_actions 过滤器来添加自定义操作按钮。以下代码演示了如何实现：

add_filter( 'woocommerce_my_account_my_orders_actions', 'add_my_account_my_orders_custom_action', 10, 2 );
function add_my_account_my_orders_custom_action( $actions, $order ) {
    $action_slug = 'specific_name';

    $actions[$action_slug] = array(
        'url'  => home_url('/the_action_url/'),
        'name' => 'The Button Text',
    );
    return $actions;
}

这段代码会将一个名为 "The Button Text" 的按钮添加到每个订单的动作列表中。$action_slug = 'specific_name'; 这行代码非常重要，因为它将自动为该按钮添加一个 CSS 类 specific_name。home_url('/the_action_url/') 定义了按钮点击后跳转的 URL。

应用自定义 CSS 样式

现在，我们可以使用 CSS 选择器 .woocommerce-account table.account-orders-table .specific_name 来专门针对我们新创建的按钮应用样式。

例如，要将按钮的文字颜色设置为红色，可以使用以下 CSS 代码：

.woocommerce-account table.account-orders-table .specific_name {
    color: red;
}

将这段 CSS 代码添加到您的主题的 style.css 文件或通过 WordPress 的自定义 CSS 功能添加，即可生效。

移除默认 CSS 类（可选）

如果您希望完全控制按钮的样式，并且想要移除默认的 woocommerce-button button 类，则需要覆盖 WooCommerce 的模板文件。

1. 复制模板文件: 将 wp-content/plugins/woocommerce/templates/myaccount/orders.php 文件复制到您的主题目录下的 yourtheme/woocommerce/myaccount/orders.php。 如果 woocommerce/myaccount/ 目录不存在，则创建它们。

2. 编辑模板文件: 打开复制后的 orders.php 文件，找到以下代码（大约在第69-71行，基于 WooCommerce 3.7.0）：

   foreach ( $actions as $key => $action ) { // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited
       echo '' . esc_html( $action['name'] ) . '';
   }

3. 替换代码: 将上述代码替换为以下代码：

   foreach ( $actions as $key => $action ) { // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited
       // Compare
       if ( $key == 'specific_name' ) {
           echo '' . esc_html( $action['name'] ) . '';
       } else {
           echo '' . esc_html( $action['name'] ) . '';
       }
   }

这段代码会检查 $key 是否等于 specific_name。如果是，则只输出 specific_name 类，否则输出默认的 woocommerce-button button 类。

注意事项

• 确保您的主题目录中存在 woocommerce/myaccount/ 目录，并且 orders.php 文件位于该目录下。
• 覆盖模板文件意味着您需要关注 WooCommerce 的更新，并在必要时更新您的模板文件，以确保兼容性。
• 使用 sanitize_html_class() 函数来清理 CSS 类名，以防止潜在的安全问题。

总结

通过以上步骤，您可以在 WooCommerce 的“我的账户”订单页面上成功添加一个自定义操作按钮，并为其应用唯一的 CSS 类。您可以根据需要自定义按钮的样式，而不会影响其他按钮的样式。这种方法提供了更大的灵活性和控制力，使您可以更好地定制 WooCommerce 的用户界面。记住，在进行任何代码修改之前，最好备份您的网站，以防止意外情况发生。