Cómo personalizar imágenes y miniaturas de productos en WooCommerce
Estoy intentando editar las imágenes y miniaturas de productos en WooCommerce.
Mi objetivo es añadir un atributo a la etiqueta <a>
. Quiero añadir: data-lightbox="Gallery"
, pero no veo cómo puedo hacer esto.
Los archivos de plantilla parecen el lugar obvio pero el código no tiene la estructura de anclaje que esperaba:
woocommerce\single-product\product-image.php
defined( 'ABSPATH' ) || exit;
// Nota: `wc_get_gallery_image_html` fue añadido en WC 3.3.2 y no existía antes. Esta comprobación protege contra anulaciones de tema usadas en versiones antiguas de WC.
if ( ! function_exists( 'wc_get_gallery_image_html' ) ) {
return;
}
global $product;
$columns = apply_filters( 'woocommerce_product_thumbnails_columns', 4 );
$post_thumbnail_id = $product->get_image_id();
$wrapper_classes = apply_filters(
'woocommerce_single_product_image_gallery_classes',
array(
'woocommerce-product-gallery',
'woocommerce-product-gallery--' . ( $product->get_image_id() ? 'with-images' : 'without-images' ),
'woocommerce-product-gallery--columns-' . absint( $columns ),
'images',
)
);
?>
<div class="<?php echo esc_attr( implode( ' ', array_map( 'sanitize_html_class', $wrapper_classes ) ) ); ?>" data-columns="<?php echo esc_attr( $columns ); ?>" style="opacity: 0; transition: opacity .25s ease-in-out;">
<figure class="woocommerce-product-gallery__wrapper">
<?php
if ( $product->get_image_id() ) {
$html = wc_get_gallery_image_html( $post_thumbnail_id, true );
} else {
$html = '<div class="woocommerce-product-gallery__image--placeholder">';
$html .= sprintf( '<img src="%s" alt="%s" class="wp-post-image" />', esc_url( wc_placeholder_img_src( 'woocommerce_single' ) ), esc_html__( 'Esperando imagen del producto', 'woocommerce' ) );
$html .= '</div>';
}
echo apply_filters( 'woocommerce_single_product_image_thumbnail_html', $html, $post_thumbnail_id ); // phpcs:disable WordPress.XSS.EscapeOutput.OutputNotEscaped
do_action( 'woocommerce_product_thumbnails' );
?>
</figure>
</div>
y las miniaturas son similares.
woocommerce\single-product\product-thumbnails.php
defined( 'ABSPATH' ) || exit;
// Nota: `wc_get_gallery_image_html` fue añadido en WC 3.3.2 y no existía antes. Esta comprobación protege contra anulaciones de tema usadas en versiones antiguas de WC.
if ( ! function_exists( 'wc_get_gallery_image_html' ) ) {
return;
}
global $product;
$attachment_ids = $product->get_gallery_image_ids();
if ( $attachment_ids && $product->get_image_id() ) {
foreach ( $attachment_ids as $attachment_id ) {
echo apply_filters( 'woocommerce_single_product_image_thumbnail_html', wc_get_gallery_image_html( $attachment_id ), $attachment_id ); // phpcs:disable WordPress.XSS.EscapeOutput.OutputNotEscaped
}
}
Supongo que necesito usar un filtro, pero no lo he usado antes. ¿O debería eliminar la acción para la imagen y miniaturas y añadir mi propia función?
remove_action( 'woocommerce_product_thumbnails', 'woocommerce_show_product_thumbnails', 20 );
remove_action( 'woocommerce_before_single_product_summary', 'woocommerce_show_product_images', 20 );
function my_plugin_show_product_image() {
// mi código personalizado para imágenes donde puedo usar mis propios atributos, estructura div, etc.
// no tengo idea de qué php se necesita para mostrar las imágenes
}
add_action( 'woocommerce_product_thumbnails', 'my_plugin_show_product_image', 20 );
function my_plugin_show_product_image() {
// mi código personalizado para imágenes donde puedo usar mis propios atributos, estructura div, etc.
// no tengo idea de qué php se necesita para mostrar las imágenes
}
add_action( 'woocommerce_before_single_product_summary', 'my_plugin_show_product_image', 10 );
¿Alguna idea?

En resumen:
Vamos a sobrescribir la plantilla predeterminada y cambiar la función que se llama para generar nuestra etiqueta y la imagen dentro de ella. Luego, crearemos esta función en nuestro functions.php y añadiremos el atributo que queremos a la etiqueta.
- copia/pega la plantilla
woocommerce/templates/single-product/product-image.php
a tu directorio:tu-tema-hijo/woocommerce/single-product/product-image.php
para sobrescribir su funcionalidad - cambia
$html = wc_get_gallery_image_html( $post_thumbnail_id, true );
por$html = my_custom_img_function( $post_thumbnail_id, true );
- copia y pega lo siguiente en tu
functions.php
/**
* sobrescrito desde https://woocommerce.wp-a2z.org/oik_api/wc_get_gallery_image_html/
*/
function my_custom_img_function($attachment_id, $main_image = false)
{
$flexslider = (bool) apply_filters('woocommerce_single_product_flexslider_enabled', get_theme_support('wc-product-gallery-slider'));
$gallery_thumbnail = wc_get_image_size('gallery_thumbnail');
$thumbnail_size = apply_filters('woocommerce_gallery_thumbnail_size', array($gallery_thumbnail['width'], $gallery_thumbnail['height']));
$image_size = apply_filters('woocommerce_gallery_image_size', $flexslider || $main_image ? 'woocommerce_single' : $thumbnail_size);
$full_size = apply_filters('woocommerce_gallery_full_size', apply_filters('woocommerce_product_thumbnails_large_size', 'full'));
$thumbnail_src = wp_get_attachment_image_src($attachment_id, $thumbnail_size);
$full_src = wp_get_attachment_image_src($attachment_id, $full_size);
$alt_text = trim(wp_strip_all_tags(get_post_meta($attachment_id, '_wp_attachment_image_alt', true)));
$image = wp_get_attachment_image(
$attachment_id,
$image_size,
false,
apply_filters(
'woocommerce_gallery_image_html_attachment_image_params',
array(
'title' => _wp_specialchars(get_post_field('post_title', $attachment_id), ENT_QUOTES, 'UTF-8', true),
'data-caption' => _wp_specialchars(get_post_field('post_excerpt', $attachment_id), ENT_QUOTES, 'UTF-8', true),
'data-src' => esc_url($full_src[0]),
'data-large_image' => esc_url($full_src[0]),
'data-large_image_width' => esc_attr($full_src[1]),
'data-large_image_height' => esc_attr($full_src[2]),
'class' => esc_attr($main_image ? 'wp-post-image' : ''),
),
$attachment_id,
$image_size,
$main_image
)
);
return '<div data-thumb="' . esc_url( $thumbnail_src[0] ) . '" data-thumb-alt="' . esc_attr( $alt_text ) . '" class="woocommerce-product-gallery__image"><a data-lightbox="Gallery" href="' . esc_url($full_src[0]) . '">' . $image . '</a></div>';
}
Como puedes ver, lo único que añadimos a la función predeterminada es el atributo que querías en la última línea de la declaración @ return.
