[TOC] 钩子和过滤器是WooCommerce中非常重要的概念，它们可以让开发人员在WooCommerce的核心代码中添加自定义代码，以扩展和定制平台。下面是WooCommerce的钩子和过滤器的详细介绍： # WooCommerce的钩子和过滤器 ### 钩子 钩子（Hook）是WooCommerce中的一种机制，它可以让开发人员在WooCommerce的核心代码中添加自定义代码。钩子本质上是一种回调函数，当WooCommerce的某个事件发生时，钩子会自动调用回调函数。WooCommerce提供了许多钩子，可以帮助开发人员在WooCommerce的各个阶段添加自定义功能。 #### 1\. 动作钩子（Action Hook） 动作钩子（Action Hook）是一种特殊的钩子，它可以让开发人员在WooCommerce的某个事件发生时执行自定义代码。动作钩子本身不返回任何值，只是执行一些操作，例如添加产品、更新订单等。动作钩子的格式如下： ~~~ do_action($hook_name, $args); ~~~ 其中，$hook\_name是钩子的名称，$args是传递给回调函数的参数。下面是一些常用的动作钩子： * `woocommerce_before_main_content`：在主内容区域之前添加内容。 * `woocommerce_after_main_content`：在主内容区域之后添加内容。 * `woocommerce_before_cart`：在购物车页面之前添加内容。 * `woocommerce_after_cart`：在购物车页面之后添加内容。 * `woocommerce_before_checkout_form`：在结算页面之前添加内容。 * `woocommerce_after_checkout_form`：在结算页面之后添加内容。 #### 2\. 过滤器钩子（Filter Hook） 过滤器钩子（Filter Hook）是一种特殊的钩子，它可以让开发人员在WooCommerce的某个事件发生时修改数据。过滤器钩子本身不执行任何操作，只是修改数据并返回修改后的结果。过滤器钩子的格式如下： ~~~ apply_filters($hook_name, $value, $args); ~~~ 其中，$hook\_name是钩子的名称，$value是需要修改的数据，$args是传递给回调函数的参数。下面是一些常用的过滤器钩子： * `woocommerce_product_get_price`：修改产品的价格。 * `woocommerce_cart_item_price`：修改购物车中产品的单价。 * `woocommerce_checkout_fields`：修改结算页面的表单字段。 * `woocommerce_billing_fields`：修改账单地址表单字段。 * `woocommerce_shipping_fields`：修改配送地址表单字段。 ### 过滤器 过滤器（Filter）是WooCommerce中的另一种机制，它可以让开发人员在WooCommerce的核心代码中修改数据。过滤器本质上也是一种回调函数，当WooCommerce的某个事件发生时，过滤器会自动调用回调函数，并且将数据作为参数传递给回调函数。回调函数可以修改数据，并返回修改后的结果。WooCommerce提供了许多过滤器，可以帮助开发人员修改WooCommerce中的数据。 #### 1\. 简单过滤器 简单过滤器可以修改数据的值，而不需要修改数据的结构。简单过滤器的格式如下： ~~~ apply_filters($hook_name, $value, $args); ~~~ 其中，$hook\_name是过滤器的名称，$value是需要修改的数据，$args是传递给回调函数的参数。下面是一些常用的简单过滤器： * `woocommerce_cart_item_price`：修改购物车中产品的单价。 * `woocommerce_product_get_price`：修改产品的价格。 * `woocommerce_product_get_regular_price`：修改产品的常规价格。 #### 2\. 复杂过滤器 复杂过滤器可以修改数据的结构，例如添加、删除或替换数据。复杂过滤器的格式如下： ~~~ apply_filters($hook_name, $value, $args); ~~~ 其中，$hook\_name是过滤器的名称，$value是需要修改的数据，$args是传递给回调函数的参数。下面是一些常用的复杂过滤器： * `woocommerce_checkout_fields`：修改结算页面的表单字段。 * `woocommerce_billing_fields`：修改账单地址表单字段。 * `woocommerce_shipping_fields`：修改配送地址表单字段。 * `woocommerce_payment_gateways`：添加、修改或删除支付网关。 需要注意的是，WooCommerce的钩子和过滤器非常强大，但也需要开发人员谨慎使用。过度使用钩子和过滤器可能会导致代码混乱和性能问题。在使用钩子和过滤器时，开发人员应该遵循最佳实践和安全建议，例如不直接修改核心代码、使用唯一的钩子名称、测试代码等。 # 钩子 WooCommerce提供了大量的钩子（Hooks），可以帮助开发人员扩展和定制平台。以下是钩子按功能分类的整理： ### 1\. 购物车 * `woocommerce_add_cart_item_data`：在向购物车添加产品时保存额外的数据。 * `woocommerce_add_to_cart_validation`：在向购物车添加产品之前验证产品是否可以添加。 * `woocommerce_after_cart_item_quantity_update`：在购物车中的产品数量更新后执行操作。 * `woocommerce_cart_calculate_fees`：计算购物车中的费用。 * `woocommerce_cart_contents`：在购物车中添加、更新或删除产品时执行操作。 * `woocommerce_cart_item_removed`：在购物车中删除产品时执行操作。 * `woocommerce_cart_item_restored`：在购物车中恢复已删除的产品时执行操作。 * `woocommerce_cart_loaded_from_session`：在购物车从会话中加载时执行操作。 * `woocommerce_checkout_create_order_line_item`：在结算页面创建订单行项目时执行操作。 * `woocommerce_checkout_create_order_product`：在结算页面创建订单产品时执行操作。 * `woocommerce_checkout_order_processed`：在处理结算页面订单时执行操作。 * `woocommerce_checkout_update_order_review`: 在结算页面更新订单审查时执行操作。 * `woocommerce_clear_cart_after_payment`：在支付后清空购物车时执行操作。 * `woocommerce_remove_cart_item`：在从购物车中删除产品时执行操作。 * `woocommerce_update_cart_action_cart_updated`：在更新购物车时执行操作。 * `woocommerce_update_cart_validation`：在更新购物车之前验证购物车是否可以更新。 ### 2\. 订单 * `woocommerce_admin_order_actions`：在后台订单操作菜单中添加自定义操作。 * `woocommerce_after_order_itemmeta`：在订单项元数据后添加内容。 * `woocommerce_after_order_item_quantity_update`：在订单中的产品数量更新后执行操作。 * `woocommerce_after_order_notes`：在订单备注后添加内容。 * `woocommerce_after_shop_order_form`：在订单表单后添加内容。 * `woocommerce_before_order_itemmeta`：在订单项元数据前添加内容。 * `woocommerce_before_order_notes`：在订单备注前添加内容。 * `woocommerce_before_shop_order_form`：在订单表单前添加内容。 * `woocommerce_checkout_order_processed`：在处理结算页面订单时执行操作。 * `woocommerce_order_actions`：在订单操作菜单中添加自定义操作。 * `woocommerce_order_item_add_action_buttons`：在订单项操作按钮后添加内容。 * `woocommerce_order_item_meta_end`：在订单项元数据后添加内容。 * `woocommerce_order_item_meta_start`：在订单项元数据前添加内容。 * `woocommerce_order_status_changed`：在订单状态更改时执行操作。 * `woocommerce_payment_complete`：在订单支付完成时执行操作。 * `woocommerce_payment_complete_order_status`：在订单支付完成时更改订单状态。 * `woocommerce_save_order_items`：在订单项保存之前执行操作。 * `woocommerce_thankyou`：在订单完成页面添加内容。 ### 3\. 产品 * `woocommerce_add_to_cart`：在向购物车添加产品时执行操作。 * `woocommerce_after_add_to_cart_button`：在添加到购物车按钮后添加内容。 * `woocommerce_after_shop_loop_item`：在产品列表项后添加内容。 * `woocommerce_before_add_to_cart_button`：在添加到购物车按钮前添加内容。 * `woocommerce_before_shop_loop_item`：在产品列表项前添加内容。 * `woocommerce_get_availability`：获取产品的库存状态。 * `woocommerce_product_add_to_cart_text`：更改添加到购物车按钮的文本。 * `woocommerce_product_get_price`：获取产品价格。 * `woocommerce_product_get_regular_price`：获取产品常规价格。 * `woocommerce_product_options_general_product_data`：在产品编辑页面添加自定义选项。 * `woocommerce_product_quick_edit_end`：在快速编辑产品页面末尾添加内容。 * `woocommerce_product_quick_edit_start`：在快速编辑产品页面开头添加内容。 * `woocommerce_product_tabs`：添加自定义产品选项卡。 * `woocommerce_single_product_summary`：在产品摘要部分添加内容。 * `woocommerce_single_product_add_to_cart_text`：更改单个产品页面上添加到购物车按钮的文本。 * `woocommerce_single_product_image_thumbnail_html`：修改产品缩略图的HTML。 * `woocommerce_single_product_summary`：在产品摘要部分添加内容。 * `woocommerce_single_product_title`：修改单个产品页面上的产品标题。 ### 4\. 支付 * `woocommerce_available_payment_gateways`：获取可用的支付网关。 * `woocommerce_checkout_before_order_review`：在订单审查之前添加内容。 * `woocommerce_checkout_order_processed`：在处理结算页面订单时执行操作。 * `woocommerce_checkout_process`：在处理结算页面之前验证订单是否可以处理。 * `woocommerce_payment_complete`：在订单支付完成时执行操作。 * `woocommerce_payment_gateways`：添加、修改或删除支付网关。 * `woocommerce_review_order_before_payment`：在订单支付之前添加内容。 ### 5. 用户和会员 * `woocommerce_account_dashboard`：在用户帐户仪表板上添加内容。 * `woocommerce_after_my_account`：在用户帐户页面之后添加内容。 * `woocommerce_before_lost_password_form`：在丢失密码表单之前添加内容。 * `woocommerce_before_login_form`：在登录表单之前添加内容。 * `woocommerce_before_my_account`：在用户帐户页面之前添加内容。 * `woocommerce_customer_save_address`：在保存地址时执行操作。 * `woocommerce_login_redirect`：更改用户登录后的重定向页面。 * `woocommerce_login_form_end`：在登录表单末尾添加内容。 * `woocommerce_login_form_start`：在登录表单开头添加内容。 * `woocommerce_lost_password_form`：在丢失密码表单中添加内容。 * `woocommerce_register_form_end`：在注册表单末尾添加内容。 * `woocommerce_register_form_start`：在注册表单开头添加内容。 * `woocommerce_registration_redirect`：更改用户注册后的重定向页面。 * `woocommerce_reset_password_message`：更改重置密码电子邮件的内容。 * `woocommerce_review_order_after_submit`：在订单提交按钮之后添加内容。 * `woocommerce_review_order_before_submit`：在订单提交按钮之前添加内容### 6. 其他 * `woocommerce_email_header`：修改电子邮件头部。 * `woocommerce_email_order_meta`：在电子邮件订单元数据下添加内容。 * `woocommerce_email_order_details`：在电子邮件订单详细信息下添加内容。 * `woocommerce_email_order_meta_fields`：在电子邮件订单元数据字段下添加内容。 * `woocommerce_email_footer`：修改电子邮件页脚。 * `woocommerce_email_recipient_new_order`：更改新订单电子邮件的收件人。 * `woocommerce_email_subject_new_order`：更改新订单电子邮件的主题。 * `woocommerce_email_headers`：更改电子邮件头部。 * `woocommerce_email_from_address`：更改电子邮件发送者地址。 * `woocommerce_email_from_name`：更改电子邮件发送者名称。 * `woocommerce_email_content_type`：更改电子邮件内容类型。 * `woocommerce_email_attachments`：添加附件到电子邮件。 * `woocommerce_after_template_part`：在模板部分后添加内容。 * `woocommerce_before_template_part`：在模板部分前添加内容。 * `woocommerce_get_sections_settings`：获取设置页面的节。 * `woocommerce_settings_tabs_array`：获取设置页面的标签。 * `woocommerce_settings_sections`：获取设置页面的节和标签。 * `woocommerce_admin_fee_rows`：在订单费用表格中添加自定义费用行。 * `woocommerce_admin_order_preview_end`：在后台订单预览页面末尾添加内容。 * `woocommerce_admin_order_preview_start`：在后台订单预览页面开头添加内容。 * `woocommerce_admin_order_totals_after_discount`：在订单总计表格中折扣后添加自定义行。 * `woocommerce_admin_order_totals_after_shipping`：在订单总计表格中运费后添加自定义行。 * `woocommerce_admin_order_totals_before_discount`：在订单总计表格中折扣之前添加自定义行。 * `woocommerce_admin_order_totals_before_shipping`：在订单总计表格中运费之前添加自定义行。 * `woocommerce_admin_order_totals_after_order_total`：在订单总计表格中订单总计后添加自定义行。 * `woocommerce_admin_order_totals_after_tax`：在订单总计表格中税后添加自定义行。 * `woocommerce_admin_order_totals_before_order_total`：在订单总计表格中订单总计之前添加自定义行。 这只是钩子的一小部分，WooCommerce提供的钩子数量非常多，可以满足开发人员的大部分需求。使用这些钩子，开发人员可以轻松地定制和扩展WooCommerce平台，以满足他们的客户需求。 ## 常用钩子和过滤器 ### 产品页面 * `woocommerce_product_tabs`：更改产品页选项卡的顺序和内容。 * `woocommerce_single_product_summary`：更改单个产品页概述区域的内容和布局。 * `woocommerce_after_single_product_summary`：在单个产品页概述区域之后添加自定义内容。 * `woocommerce_before_add_to_cart_button`：在添加到购物车按钮之前添加自定义内容。 * `woocommerce_after_add_to_cart_button`：在添加到购物车按钮之后添加自定义内容。 * `woocommerce_product_add_to_cart_text`：更改添加到购物车按钮的文本。 ### 购物车和结账页面 * `woocommerce_before_calculate_totals`：在计算购物车总价之前执行自定义操作。 * `woocommerce_cart_shipping_packages`：更改购物车中的配送包装。 * `woocommerce_shipping_package_name`：更改配送包装的名称。 * `woocommerce_calculated_shipping`：在计算配送费用时执行自定义操作。 * `woocommerce_review_order_before_submit`：在订单提交按钮之前添加自定义内容。 * `woocommerce_checkout_billing`：更改结账页账单地址表格的 HTML。 * `woocommerce_checkout_shipping`：更改结账页配送地址表格的 HTML。 * `woocommerce_checkout_order_review`：更改结账页订单总计表格的 HTML。 * `woocommerce_checkout_payment`：更改结账页付款表格的 HTML。 * `woocommerce_available_payment_gateways`：更改可用的支付网关。 ### 订单和支付 * `woocommerce_add_to_cart_validation`：验证添加到购物车的产品是否有效。 * `woocommerce_add_cart_item_data`：将自定义数据添加到购物车项目中。 * `woocommerce_get_cart_item_from_session`：从会话中检索购物车项目。 * `woocommerce_add_order_item_meta`：将元数据添加到订单项中。 * `woocommerce_checkout_order_processed`：在订单被处理之后执行自定义操作。 * `woocommerce_order_status_changed`：在订单状态更改时执行自定义操作。 * `woocommerce_payment_complete_order_status`：更改订单完成后的状态。 * `woocommerce_payment_complete`：在支付完成后执行自定义操作。 * `woocommerce_admin_order_actions`：添加自定义操作按钮到订单操作下拉菜单中。 * `woocommerce_admin_order_data_after_billing_address`：在订单管理页面添加自定义数据到账单地址下方。 * `woocommerce_admin_order_data_after_shipping_address`：在订单管理页面添加自定义数据到配送地址下方。 * `woocommerce_admin_order_data_after_order_details`：在订单管理页面添加自定义数据到订单详细信息下方。 * `woocommerce_admin_order_data_after_order_total`：在订单管理页面添加自定义数据到订单总计下方。 ### 电子邮件 * `woocommerce_email_header`：更改电子邮件标题和头部区域的 HTML。 * `woocommerce_email_order_details`：更改电子邮件订单详细信息的 HTML。 * `woocommerce_email_order_meta`：更改电子邮件订单元数据的 HTML。 * `woocommerce_email_order_item_quantity`：更改电子邮件订单商品数量的 HTML。 * `woocommerce_email_order_item_meta`：更改电子邮件订单商品元数据的 HTML。 * `woocommerce_email_order_items_table`：更改电子邮件订单项目表格的 HTML。 * `woocommerce_email_order_item_totals`：更改电子邮件订单项目总计的 HTML。 * `woocommerce_email_footer`：更改电子邮件页脚区域的 HTML。