woocommerce_loop_add_to_cart_link 过滤钩子是如何深入工作的？

Question

我有一些基本的 Woocommerce 问题，在网上找不到任何地方。

• 从下面的代码中，$args 来自哪里？
• $product 和 $args 如何分配给 %s ？

谢谢！

global $product;

echo apply_filters( 'woocommerce_loop_add_to_cart_link', // WPCS: XSS ok.
    sprintf( '<a href="%s" data-quantity="%s" class="%s" %s>%s</a>',
        esc_url( $product->add_to_cart_url() ),
        esc_attr( isset( $args['quantity'] ) ? $args['quantity'] : 1 ),
        esc_attr( isset( $args['class'] ) ? $args['class'] : 'button' ),
        isset( $args['attributes'] ) ? wc_implode_html_attributes( $args['attributes'] ) : '',
        esc_html( $product->add_to_cart_text() )
    ),
$product, $args );

Answer 1

1) 模板文件中 $args 变量的说明loop/add_to_cart.php：

您问题中的代码来自模板文件loop/add_to_cart.php。
它由挂接的content-product.php模板文件调用woocommerce_after_shop_loop_item：

/**
 * Hook: woocommerce_after_shop_loop_item.
 *
 * @hooked woocommerce_template_loop_product_link_close - 5
 * @hooked woocommerce_template_loop_add_to_cart - 10
 */
do_action( 'woocommerce_after_shop_loop_item' );

正如您所看到的，模板函数woocommerce_template_loop_add_to_cart()完成了这项工作，它位于includes/wc-template-functions.php.

所以默认参数是：

$defaults = array(
    'quantity'   => 1,
    'class'      => implode(
        ' ',
        array_filter(
            array(
                'button',
                'product_type_' . $product->get_type(),
                $product->is_purchasable() && $product->is_in_stock() ? 'add_to_cart_button' : '',
                $product->supports( 'ajax_add_to_cart' ) && $product->is_purchasable() && $product->is_in_stock() ? 'ajax_add_to_cart' : '',
            )
        )
    ),
    'attributes' => array(
        'data-product_id'  => $product->get_id(),
        'data-product_sku' => $product->get_sku(),
        'aria-label'       => $product->add_to_cart_description(),
        'rel'              => 'nofollow',
    ),
);

它们通过过滤器钩子解析woocommerce_loop_add_to_cart_args：

$args = apply_filters( 'woocommerce_loop_add_to_cart_args', wp_parse_args( $args, $defaults ), $product );

...允许对这个论点进行更改。

该$args变量在woocommerce_loop_add_to_cart_link由这一点。

2)如何$product和$args被分配给%s：

这是特定于 PHPprintf()和sprintf()函数的，其中每个%s都是占位符。

在'<a href="%s" data-quantity="%s" class="%s" %s>%s</a>'：

• 第一个占位符%s将被替换为esc_url( $product->add_to_cart_url() )
• 第二个占位符%s由esc_attr( isset( $args['quantity'] ) ? $args['quantity'] : 1 )
• and so on…

printf()和sprintf()php 函数的文档。