woocommerce/docs/snippets/number-of-products-per-row.md

30 lines
1.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Change number of related products output
> This is a **Developer level** doc. If you are unfamiliar with code and resolving potential conflicts, select a [WooExpert or Developer](https://woocommerce.com/customizations/) for assistance. We are unable to provide support for customizations under our [Support Policy](http://www.woocommerce.com/support-policy/?).
Add code to your child themes functions.php file or via a plugin that allows custom functions to be added, such as the [Code snippets](https://wordpress.org/plugins/code-snippets/) plugin. Avoid adding custom code directly to your parent themes `functions.php` file as this will be wiped entirely when you update the theme.
Please note that it does not work for all themes because of the way theyre coded.
```php
if ( ! function_exists( 'YOUR_PREFIX_related_products_args' ) ) {
/**
* Change number of related products output.
*
* @param array $args The related products args.
* @return array The modified related products args.
*/
function YOUR_PREFIX_related_products_args( $args ) {
if ( ! is_array( $args ) ) {
$args = array();
}
$args['posts_per_page'] = 4; // 4 related products.
$args['columns'] = 2; // Arranged in 2 columns.
return $args;
}
}
add_filter( 'woocommerce_output_related_products_args', 'YOUR_PREFIX_related_products_args', 20 );
```