我可以修改 'wc-template-functions.php' 文件中的 WooCommerce 函数,还是应该坚持使用 'functions.php' 文件进行此类修改?
Can I modify WooCommerce functions within the 'wc-template-functions.php' file or should I stick with the 'functions.php' file for such modifications?
为什么将 WooCommerce 功能修改放在主题的 'function.php' 文件中是首选?加班,这会使文件相当大。我的理解是,通常更好的做法是拥有大量组织良好的小文件,而不是更少的大文件。
考虑到这一点,将 'wc-template-functions.php' 和 'wc-templates-hooks.php' 文件复制到您的主题中(同时保持其文件层次结构)并相应地修改这些文件有什么问题?
作为 WooCommerce 平台的相对新手的附带请求,如果我能得到 'Yes, that works' 或 'No, I have missed something out' 对我对 WooCommerce 的以下理解的回应,我将不胜感激;文件、挂钩、动作和模板都可以相互配合
我的理解:
- WooCommerce 函数在 'wc-template-functions.php' 文件中注册。出于解释的目的,我想参考
woocommerce_breadcrumb
条目。
- WooCommerce 然后使用 'wc-templates-hooks.php' 文件通过使用典型条目(例如
add_action('woocommerce_before_main_content','woocommerce_breadcrumb', 20, 0 );
来调用已注册的函数 这只是指示 woocommerce_breadcrumb
在 woocommerce_before_main_content
中调用钩.
- WooCommerce 然后可以通过在必要时放置
do_action( 'woocommerce_before_main_content' );
来输出上述内容。在这种情况下,在所有模板文件中。
你对1,2,3的理解是正确的。
但是,文件 wc-template-functions.php
和 wc-templates-hooks.php
不会因在您的主题中放置类似文件而被覆盖,因此将它们放在您的主题中不会有任何作用。
当您想更改特定内容时,批发 copy/override 文件也是一个坏主意(在我看来)。当客户的网站崩溃时,我不得不搜索整个 WooCommerce 模板文件夹以找到需要维护的实际更改。
将 functions.php
文件分成更小、更易于管理的文件没有任何问题。因此,您 可以 有一个 woocommerce-functions.php
文件,命名为您想要存储 WooCommerce-specific 代码的任何名称。
编辑以扩展一些想法
任何时候 WooCommerce(或任何 WordPress 功能)都会向您显示此模式:
if ( ! function_exists( 'some_function_name' ) ) {
function some_function_name() {
echo 'taco';
}
}
你有一个可插入的功能,你可以在你的主题 function.php
中定义它,WooCommerce 将使用你的 some_function_name()
.
版本
但是,可插入函数在它们被钩住的地方被钩住,您不能通过在 theme/plugin 中重新定义它们来移动它们。因此,一种更强大的方法是从它的挂钩中删除该函数,然后添加回另一个挂钩,或者添加您自己的自定义函数,或两者兼而有之。下面是一个将自定义标题移动到价格之后的示例:
function kia_switch_loop_title(){
remove_action( 'woocommerce_shop_loop_item_title', 'woocommerce_template_loop_product_title', 10 );
add_action( 'woocommerce_after_shop_loop_item_title', 'kia_template_loop_product_title', 15 );
}
add_action( 'woocommerce_before_shop_loop_item', 'kia_switch_loop_title' );
function kia_template_loop_product_title() {
echo '<h4 class="we-do-what-we-want">' . get_the_title() . '</h4>';
}
一直在纠结如何让相关产品按desc方式排序,刚刚找到解决方案。以防万一有人需要
function custom_remove_hook(){
remove_action( 'woocommerce_after_single_product_summary', 'woocommerce_output_related_products', 20 );
add_action( 'woocommerce_after_single_product_summary', 'custom_function_to_sort_related', 22 );
}
add_action( 'woocommerce_after_single_product_summary', 'custom_remove_hook' );
function custom_function_to_sort_related( $args = array() ) {
global $product;
if ( ! $product ) {
return;
}
$defaults = array(
'posts_per_page' => 4,
'columns' => 4,
'orderby' => 'price', // @codingStandardsIgnoreLine.
'order' => 'desc'
);
$args = wp_parse_args( $args, $defaults );
// Get visible related products then sort them at random.
$args['related_products'] = array_filter( array_map( 'wc_get_product', wc_get_related_products( $product->get_id(), $args['posts_per_page'], $product->get_upsell_ids() ) ), 'wc_products_array_filter_visible' );
// Handle orderby.
$args['related_products'] = wc_products_array_orderby( $args['related_products'], $args['orderby'], $args['order'] );
// Set global loop values.
wc_set_loop_prop( 'name', 'related' );
wc_set_loop_prop( 'columns', apply_filters( 'woocommerce_related_products_columns', $args['columns'] ) );
wc_get_template( 'single-product/related.php', $args );
}
为什么将 WooCommerce 功能修改放在主题的 'function.php' 文件中是首选?加班,这会使文件相当大。我的理解是,通常更好的做法是拥有大量组织良好的小文件,而不是更少的大文件。
考虑到这一点,将 'wc-template-functions.php' 和 'wc-templates-hooks.php' 文件复制到您的主题中(同时保持其文件层次结构)并相应地修改这些文件有什么问题?
作为 WooCommerce 平台的相对新手的附带请求,如果我能得到 'Yes, that works' 或 'No, I have missed something out' 对我对 WooCommerce 的以下理解的回应,我将不胜感激;文件、挂钩、动作和模板都可以相互配合
我的理解:
- WooCommerce 函数在 'wc-template-functions.php' 文件中注册。出于解释的目的,我想参考
woocommerce_breadcrumb
条目。 - WooCommerce 然后使用 'wc-templates-hooks.php' 文件通过使用典型条目(例如
add_action('woocommerce_before_main_content','woocommerce_breadcrumb', 20, 0 );
来调用已注册的函数 这只是指示woocommerce_breadcrumb
在woocommerce_before_main_content
中调用钩. - WooCommerce 然后可以通过在必要时放置
do_action( 'woocommerce_before_main_content' );
来输出上述内容。在这种情况下,在所有模板文件中。
你对1,2,3的理解是正确的。
但是,文件 wc-template-functions.php
和 wc-templates-hooks.php
不会因在您的主题中放置类似文件而被覆盖,因此将它们放在您的主题中不会有任何作用。
当您想更改特定内容时,批发 copy/override 文件也是一个坏主意(在我看来)。当客户的网站崩溃时,我不得不搜索整个 WooCommerce 模板文件夹以找到需要维护的实际更改。
将 functions.php
文件分成更小、更易于管理的文件没有任何问题。因此,您 可以 有一个 woocommerce-functions.php
文件,命名为您想要存储 WooCommerce-specific 代码的任何名称。
编辑以扩展一些想法
任何时候 WooCommerce(或任何 WordPress 功能)都会向您显示此模式:
if ( ! function_exists( 'some_function_name' ) ) {
function some_function_name() {
echo 'taco';
}
}
你有一个可插入的功能,你可以在你的主题 function.php
中定义它,WooCommerce 将使用你的 some_function_name()
.
但是,可插入函数在它们被钩住的地方被钩住,您不能通过在 theme/plugin 中重新定义它们来移动它们。因此,一种更强大的方法是从它的挂钩中删除该函数,然后添加回另一个挂钩,或者添加您自己的自定义函数,或两者兼而有之。下面是一个将自定义标题移动到价格之后的示例:
function kia_switch_loop_title(){
remove_action( 'woocommerce_shop_loop_item_title', 'woocommerce_template_loop_product_title', 10 );
add_action( 'woocommerce_after_shop_loop_item_title', 'kia_template_loop_product_title', 15 );
}
add_action( 'woocommerce_before_shop_loop_item', 'kia_switch_loop_title' );
function kia_template_loop_product_title() {
echo '<h4 class="we-do-what-we-want">' . get_the_title() . '</h4>';
}
一直在纠结如何让相关产品按desc方式排序,刚刚找到解决方案。以防万一有人需要
function custom_remove_hook(){
remove_action( 'woocommerce_after_single_product_summary', 'woocommerce_output_related_products', 20 );
add_action( 'woocommerce_after_single_product_summary', 'custom_function_to_sort_related', 22 );
}
add_action( 'woocommerce_after_single_product_summary', 'custom_remove_hook' );
function custom_function_to_sort_related( $args = array() ) {
global $product;
if ( ! $product ) {
return;
}
$defaults = array(
'posts_per_page' => 4,
'columns' => 4,
'orderby' => 'price', // @codingStandardsIgnoreLine.
'order' => 'desc'
);
$args = wp_parse_args( $args, $defaults );
// Get visible related products then sort them at random.
$args['related_products'] = array_filter( array_map( 'wc_get_product', wc_get_related_products( $product->get_id(), $args['posts_per_page'], $product->get_upsell_ids() ) ), 'wc_products_array_filter_visible' );
// Handle orderby.
$args['related_products'] = wc_products_array_orderby( $args['related_products'], $args['orderby'], $args['order'] );
// Set global loop values.
wc_set_loop_prop( 'name', 'related' );
wc_set_loop_prop( 'columns', apply_filters( 'woocommerce_related_products_columns', $args['columns'] ) );
wc_get_template( 'single-product/related.php', $args );
}