Shortcodes de WooCommerce: Guía completa para insertar productos, carrito y más

febrero 08, 2023

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:

text
[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 .

ShortcodeQué 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:

text
[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

AtributoQué haceValor por defecto
limitNúmero de productos a mostrar-1 (todos)
columnsNúmero de columnas4
paginateActiva la paginaciónfalse
orderbyOrdena los productostitle
orderOrden ascendente (ASC) o descendente (DESC)ASC
classClase CSS para personalizar—

Opciones de orderby:

  • date — Fecha de publicación

  • id — ID del producto

  • menu_order — Orden del menú

  • popularity — Número de compras

  • rand — Orden aleatorio

  • rating — Calificación promedio

  • title — Título del producto

Atributos de contenido

AtributoQué hace
categoryFiltra por slug de categoría
tagFiltra por etiqueta
idsFiltra por IDs de producto
skusFiltra por SKUs
attributeFiltra por atributo
termsTérminos del atributo
visibilityVisibilidad del producto
on_saleProductos en oferta
best_sellingProductos más vendidos
top_ratedProductos mejor calificados

Ejemplos prácticos

Escenario 1: Artículos en oferta aleatorios

text
[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

text
[products limit="4" columns="2" visibility="featured"]

Muestra 4 productos destacados, 2 por fila .

Escenario 3: Productos más vendidos

text
[products limit="3" columns="3" best_selling="true"]

Escenario 4: Productos más nuevos

text
[products limit="4" columns="4" orderby="id" order="DESC" visibility="visible"]

Escenario 5: Categorías específicas

text
[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

text
[products limit="8" columns="4" category="capuchas, camisetas" cat_operator="NOT IN"]

Escenario 6: Filtrado por atributos

text
[products columns="3" attribute="temporada" terms="calido" orderby="date"]

Escenario 7: Productos con etiqueta específica

text
[products tag="capucha"]

🗂️ Shortcodes de categorías de producto

ShortcodeQué muestra
[product_category]Productos de una categoría específica
[product_categories]Todas las categorías de productos

Args de [product_categories]

AtributoQué haceValor por defecto
idsIDs de categorías específicas—
limitNúmero de categorías—
columnsNúmero de columnas4
hide_emptyOculta categorías vacías1
parentMuestra subcategorías de un padre—
orderbyOrdena por nombre, id, slug, menu_ordername
orderASC o DESCASC

Ejemplo: Solo categorías de nivel superior

text
[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:

text
[product_page id="99"]
[product_page sku="FOO"]

🔗 Shortcode de productos relacionados

text
[related_products limit="12"]

Args:

text
[related_products limit="12" columns="4" orderby="title"]

➕ Shortcodes de añadir al carrito

Botón de añadir al carrito

text
[add_to_cart id="99"]

Args:

text
[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

text
[add_to_cart_url id="99"]

🔔 Mostrar notificaciones de WooCommerce

text
[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:

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

← Anterior Siguiente →