Clevers Product Carousel

FAQ

Can I use it without WooCommerce?

No. The plugin requires WooCommerce to load products.

How do I change the card layout?

Copy the file from:
wp-content/plugins/clevers-product-carousel/templates/cards/card-1.php
to:
wp-content/themes/tu-tema/clevers-product-carousel/cards/card-1.php
and edit it in your theme.

How do I customize colors?

Each carousel includes color fields in the editor. You can also override CSS variables:

`css

clevers-product-carousel-123 {

–clevers-primary: #e63946;
–clevers-secondary: #1d3557;
}
`

Does the plugin provide hooks/filters for developers?

Yes. The plugin offers several filters and actions for developers to extend its functionality:

Filters:

• cleverspr_carousel_query_args (filter): Modify product query args before product lookup. Receives $args, $carousel_id, and $meta.
• cleverspr_carousel_template_path (filter): Override template relative path inside templates/.
• cleverspr_carousel_css_vars (filter): Adjust per-carousel CSS variables before inline output. Receives $vars, $carousel_id, $settings, and $vars_map.
• cleverspr_carousel/cache_ttl (filter): Control the TTL of the transient cache for rendered carousel HTML.
• cleverspr_carousel/settings (filter): Modify carousel settings before rendering.
• cleverspr_carousel/card_template_relpath (filter): Override card template path.
• cleverspr_carousel/slider_data_attributes (filter): Modify slider data attributes.

Actions:

• cleverspr_carousel_before_render (action): Fires right before carousel template rendering. Receives $carousel_id, $settings, and $products.
• cleverspr_carousel_after_render (action): Fires right after carousel template rendering. Receives $carousel_id, $settings, and $products.

Examples:

`php

// Modify query to limit price range
add_filter( ‘cleverspr_carousel_query_args’, function( $args, $carousel_id, $meta ) {
$args[‘price_range’] = [ 20, 200 ];
return $args;
}, 10, 3 );

// Add custom CSS variables
add_filter( ‘cleverspr_carousel_css_vars’, function( $vars, $carousel_id, $settings, $vars_map ) {
$vars[] = ‘–clevers-margen-cards: 24px;’;
return $vars;
}, 10, 4 );

// Track carousel renders
add_action( ‘cleverspr_carousel_before_render’, function( $carousel_id, $settings, $products ) {
do_action( ‘mi_tracking/carousel_render_start’, $carousel_id, count( $products ) );
}, 10, 3 );
`

Namespace variants such as cleverspr_carousel/query_args, cleverspr_carousel/before, and cleverspr_carousel/after are also available.

WP-CLI commands

When WP-CLI is available, the plugin registers a clevprca-carousel command namespace:

• wp clevprca-carousel list [--preset=<n>] — print every carousel (id, title, status, preset, shortcode) as a table. Filter by preset with --preset.
• wp clevprca-carousel flush-cache — delete all cleverspr_carousel_* cache transients and bump the global cache version so in-process renders rebuild. Use after imports or when prices/stock have changed but the cache has not expired yet.
• wp clevprca-carousel render <id> [--file=<name>] — print the rendered HTML for a given carousel id to stdout, or write it into the plugin uploads directory. Handy for headless smoke tests and template debugging.

Examples:

`

wp clevprca-carousel list
wp clevprca-carousel list –preset=2
wp clevprca-carousel flush-cache
wp clevprca-carousel render 42 –file=carousel-42.html
`

These commands are loaded only when WP_CLI is defined, so there is no overhead in normal HTTP requests.