Shortcodes de WooCommerce: Guía completa para insertar productos, carrito y más
Hola, amigos de Piensa para Crear. 👋
Si tienes una tienda online en WooCommerce, sabes que la flexibilidad es una de sus mayores ventajas. Pero, ¿sabías que puedes insertar casi cualquier parte de tu tienda en cualquier página o entrada usando shortcodes?
Un shortcode es una pequeña etiqueta entre corchetes que WordPress interpreta y reemplaza por contenido dinámico. Y WooCommerce viene con docenas de shortcodes que te permiten mostrar productos, el carrito, el checkout, la cuenta de usuario y mucho más donde tú quieras.
En esta guía te explico todos los shortcodes que incluye WooCommerce, cómo usarlos y ejemplos prácticos para que los apliques en tu tienda.
🧠 ¿Qué son los shortcodes y cómo se usan?
Un shortcode es una etiqueta como [woocommerce_cart] que, al insertarla en una página o entrada, WordPress reemplaza por el contenido correspondiente (en este caso, la página del carrito).
¿Dónde se usan?
Editor de bloques: Busca el bloque "Shortcode" y pega el shortcode dentro .
Editor clásico: Pega el shortcode directamente en el contenido.
¿Qué son los "Args"?
Varios shortcodes aceptan argumentos (args) para personalizar su comportamiento. Por ejemplo:
[add_to_cart id="99"]
Ese id="99" es un argumento que le dice a WooCommerce que muestre el botón de añadir al carrito para el producto con ID 99 .
🛒 Shortcodes de páginas (los esenciales)
WooCommerce no funciona correctamente sin estos shortcodes. Normalmente se añaden automáticamente al configurar la tienda, pero es bueno conocerlos .
| Shortcode | Qué muestra |
|---|---|
[woocommerce_cart] | La página del carrito |
[woocommerce_checkout] | La página de pago |
[woocommerce_my_account] | La página de la cuenta de usuario |
[woocommerce_order_tracking] | El formulario de seguimiento de pedidos |
[woocommerce_my_account]
Muestra la sección "Mi cuenta" donde el cliente ve sus pedidos anteriores y actualiza su información.
Args:
[woocommerce_my_account]
Por defecto, el argumento current_user se establece automáticamente .
🏷️ Shortcodes de productos: el más potente
El shortcode [products] es el más robusto de WooCommerce. Puede reemplazar a varios shortcodes antiguos como [featured_products], [sale_products], [best_selling_products], [recent_products], [product_attribute] y [top_rated_products] .
Atributos de presentación
| Atributo | Qué hace | Valor por defecto |
|---|---|---|
limit | Número de productos a mostrar | -1 (todos) |
columns | Número de columnas | 4 |
paginate | Activa la paginación | false |
orderby | Ordena los productos | title |
order | Orden ascendente (ASC) o descendente (DESC) | ASC |
class | Clase CSS para personalizar | — |
Opciones de orderby:
date— Fecha de publicaciónid— ID del productomenu_order— Orden del menúpopularity— Número de comprasrand— Orden aleatoriorating— Calificación promediotitle— Título del producto
Atributos de contenido
| Atributo | Qué hace |
|---|---|
category | Filtra por slug de categoría |
tag | Filtra por etiqueta |
ids | Filtra por IDs de producto |
skus | Filtra por SKUs |
attribute | Filtra por atributo |
terms | Términos del atributo |
visibility | Visibilidad del producto |
on_sale | Productos en oferta |
best_selling | Productos más vendidos |
top_rated | Productos mejor calificados |
Ejemplos prácticos
Escenario 1: Artículos en oferta aleatorios
[products limit="4" columns="4" orderby="popularity" class="quick-sale" on_sale="true"]
Muestra 4 productos en oferta, los más populares, en 4 columnas .
Escenario 2: Productos destacados
[products limit="4" columns="2" visibility="featured"]
Muestra 4 productos destacados, 2 por fila .
Escenario 3: Productos más vendidos
[products limit="3" columns="3" best_selling="true"]
Escenario 4: Productos más nuevos
[products limit="4" columns="4" orderby="id" order="DESC" visibility="visible"]
Escenario 5: Categorías específicas
[products limit="8" columns="4" category="capuchas, camisetas" cat_operator="AND"]
Muestra productos que están en ambas categorías (capuchas Y camisetas) .
Alternativa: productos que NO están en esas categorías
[products limit="8" columns="4" category="capuchas, camisetas" cat_operator="NOT IN"]
Escenario 6: Filtrado por atributos
[products columns="3" attribute="temporada" terms="calido" orderby="date"]
Escenario 7: Productos con etiqueta específica
[products tag="capucha"]
🗂️ Shortcodes de categorías de producto
| Shortcode | Qué muestra |
|---|---|
[product_category] | Productos de una categoría específica |
[product_categories] | Todas las categorías de productos |
Args de [product_categories]
| Atributo | Qué hace | Valor por defecto |
|---|---|---|
ids | IDs de categorías específicas | — |
limit | Número de categorías | — |
columns | Número de columnas | 4 |
hide_empty | Oculta categorías vacías | 1 |
parent | Muestra subcategorías de un padre | — |
orderby | Ordena por nombre, id, slug, menu_order | name |
order | ASC o DESC | ASC |
Ejemplo: Solo categorías de nivel superior
[product_categories number="0" parent="0"]
Muestra solo categorías principales, sin subcategorías .
📄 Shortcode de página de producto
Muestra una página completa de un solo producto por ID o SKU:
[product_page id="99"] [product_page sku="FOO"]
🔗 Shortcode de productos relacionados
[related_products limit="12"]
Args:
[related_products limit="12" columns="4" orderby="title"]
➕ Shortcodes de añadir al carrito
Botón de añadir al carrito
[add_to_cart id="99"]
Args:
[add_to_cart id="99" style="border:4px solid #ccc; padding: 12px;" sku="FOO" show_price="TRUE" class="CSS-CLASS" quantity="1"]
URL de añadir al carrito
[add_to_cart_url id="99"]
🔔 Mostrar notificaciones de WooCommerce
[shop_messages]
Muestra notificaciones como "El producto se ha añadido al carrito" en páginas que no son de WooCommerce. Útil cuando usas [add_to_cart] y quieres que el usuario reciba feedback .
⚠️ Solución de problemas comunes
1. El shortcode se muestra como texto
Causa: Puede estar dentro de etiquetas <pre>.
Solución: Edita la página, cambia a la pestaña Texto/HTML y elimina las etiquetas <pre> .
2. Las comillas se ven raras
Causa: Las comillas rectas (") se convierten en comillas curvas (").
Solución: Asegúrate de usar comillas rectas. En el editor, escribe el shortcode manualmente o pega desde un editor de texto plano .
3. Los productos no se muestran
Causa: El producto puede estar configurado como "oculto" en la visibilidad del catálogo.
Solución: Ve a Productos → Todos los productos, edita el producto y revisa su visibilidad .
4. El shortcode no funciona en un widget
Causa: Los widgets de texto no siempre procesan shortcodes.
Solución: Añade add_filter('widget_text', 'do_shortcode'); en functions.php.
🎨 Personalización avanzada: ordenar por metacampos
Si quieres ordenar productos por un metacampo personalizado (por ejemplo, precio), añade esto en functions.php:
add_filter( 'woocommerce_shortcode_products_query', 'woocommerce_shortcode_products_orderby' ); function woocommerce_shortcode_products_orderby( $args ) { $standard_array = array( 'menu_order', 'title', 'date', 'rand', 'id' ); if ( isset( $args['orderby'] ) && ! in_array( $args['orderby'], $standard_array ) ) { $args['meta_key'] = $args['orderby']; $args['orderby'] = 'meta_value_num'; } return $args; }
Nota: WooCommerce no da soporte para personalizaciones. Si no estás familiarizado con código, contacta a un WooExpert .
🎯 Conclusión: los shortcodes te dan control total
Los shortcodes de WooCommerce son la forma más flexible de insertar contenido de tu tienda en cualquier página o entrada. Con ellos puedes:
✅ Mostrar productos filtrados por categoría, etiqueta o atributo.
✅ Insertar el carrito, checkout o cuenta de usuario.
✅ Mostrar productos en oferta, destacados o más vendidos.
✅ Añadir botones de "añadir al carrito" en cualquier lugar.
Resumen:
Usa el bloque Shortcode en el editor de bloques.
Pega el shortcode en el editor clásico.
Añade args para personalizar.
Revisa la visibilidad de los productos si no aparecen.
💬 ¿Necesitas ayuda para personalizar tu tienda WooCommerce o insertar shortcodes específicos?
En Piensa para Crear ofrecemos servicios de personalización, desarrollo y optimización para tiendas online.
Contáctanos aquí y hablemos.
❓ Preguntas frecuentes
¿Dónde pego los shortcodes?
En el bloque "Shortcode" del editor de bloques, o directamente en el editor clásico .
¿Qué son los "Args"?
Son argumentos que personalizan el shortcode. Por ejemplo, [add_to_cart id="99"] muestra el botón del producto con ID 99 .
¿Cuáles son los shortcodes esenciales de WooCommerce?[woocommerce_cart], [woocommerce_checkout] y [woocommerce_my_account]. Sin ellos, la tienda no funciona correctamente .
¿Puedo usar shortcodes en widgets?
Sí, pero puede que necesites añadir add_filter('widget_text', 'do_shortcode'); en functions.php.
¿Por qué mis productos no aparecen?
Revisa que no estén configurados como "ocultos" en la visibilidad del catálogo .
¿Cómo ordeno productos por precio?
Añade el filtro woocommerce_shortcode_products_orderby en functions.php .
¿Los shortcodes funcionan en el editor de bloques?
Sí. Usa el bloque "Shortcode" específicamente.
¿Qué pasa si uso comillas curvas?
El shortcode no funcionará. Asegúrate de usar comillas rectas (") .
Comentarios
Publicar un comentario