WOOT - WooCommerce Active Products Tables

Columna de cantidad en stock de la tabla de productos WooCommerce y stock bajo

La tabla de productos WooCommerce incluye una columna de cantidad en stock ya preparada, pero imprime un número sin más: 437, 2 o un guion. Las tiendas suelen querer algo más amable: "Más de 100 disponibles" en lugar de una cantidad exacta, o una etiqueta "Solo quedan 3" cuando un producto o un taller está a punto de agotarse. Ambas cosas son pequeños cambios en lo que imprime la columna, mientras que el stock real en WooCommerce no se toca. Esta página muestra lo que presentan las columnas de stock integradas, cómo sustituir el número por texto y cómo añadir una etiqueta de stock bajo basada en el umbral de stock bajo de WooCommerce.

Qué muestran las columnas de stock de la tabla de productos WooCommerce

En la lista Campo (Field) de la pestaña Columnas hay tres campos de stock disponibles:

ColumnaCeldaOrdenación y filtro
Cantidad en stock (Stock quantity)El número de artículos en stock. Un guion cuando el producto no controla el stock y cuando la cantidad es 0; un número negativo cuando las reservas pendientes han llevado el stock por debajo de ceroOrdenable; un control deslizante de rango en la pestaña Filtro
Estado del stock (Stock status)Una marca verde para "En stock" y "En reserva", una cruz roja para "Agotado"Un interruptor en la pestaña Filtro que oculta los productos agotados
Gestionar stock (Manage stock)Una marca o una cruz: si el producto controla su cantidad en stockOrdenable

Hay otras dos opciones relacionadas en otro lugar. La columna Título tiene una opción Mostrar etiquetas (Show labels) que añade pequeñas etiquetas "destacado", "en oferta" y "agotado" al nombre del producto. Y el interruptor Solo en stock (In stock only) de la pestaña Predefinición conserva únicamente los productos con el estado "En stock" (los productos en reserva también se omiten), como se describe en la pregunta frecuente sobre mostrar solo los productos en stock. No hay una etiqueta de stock bajo integrada con umbral; las secciones siguientes añaden una.

Mostrar como texto la columna de cantidad en stock

Cada columna de la tabla es un campo del perfil del plugin, y cada campo tiene una función de retorno action que construye su celda a partir del ID del producto. El hook woot_profile_extend te permite sustituir esa función para stock_quantity, de modo que la celda imprime texto mientras que la ordenación y el filtro de rango siguen funcionando con el número real almacenado en el campo meta _stock:

/*
 * Products tables: print the Stock quantity column as text.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('woot_profile_extend', function ($profile, $action) {

    if ('woot_woocommerce_tables' !== $action || !isset($profile['stock_quantity'])) {
        return $profile;
    }

    $profile['stock_quantity']['action'] = function ($post_id) {
        $product = wc_get_product($post_id);

        if (!$product) {
            return '';
        }
        if (!$product->is_in_stock()) {
            return 'Out of stock';
        }
        if ($product->is_on_backorder()) {
            return 'Available on backorder';
        }
        if (!$product->managing_stock()) {
            return 'In stock'; // the product does not count its items
        }

        $qty = (int) $product->get_stock_quantity();

        if ($qty > 100) {
            return 'More than 100 available';
        }

        return sprintf('%d available', $qty);
    };

    return $profile;
}, 10, 2);

Ajusta los límites y las palabras a tu tienda; para mostrar "100+" con cualquier stock mayor, cambia solo los valores devueltos. Si la tabla está traducida en la pestaña Vocabulario, envuelve cada texto en WOOT_Vocabulary::get() para que reciba la traducción del idioma actual. La misma técnica cambia cualquier otra columna, por ejemplo los iconos de Estado del stock (Stock status) (su clave es stock_status); la pregunta frecuente sobre modificar la salida de la celda de una columna por su clave tiene otro ejemplo.

No uses para esto el filtro de WooCommerce sobre get_stock_quantity(). Cambia la cantidad con la que trabaja el propio WooCommerce: la tabla oculta su botón de añadir al carrito cuando ese número es 0 y lo usa como máximo del campo de cantidad del carrito, y las comprobaciones de stock del carrito también lo leen. Un cambio de visualización pertenece a la columna.

Añadir una etiqueta de stock bajo con el umbral de stock bajo de WooCommerce

Define el umbral en WooCommerce

WooCommerce ya tiene el número que necesitas. El valor para toda la tienda está en WooCommerce > Ajustes > Productos > Inventario, Umbral de pocas existencias. Cada producto puede sustituirlo en su pestaña Inventario, en su propio campo Umbral de pocas existencias, que aparece una vez activado el control de stock de ese producto. Un taller con 12 plazas puede pasar a "casi lleno" en 3, mientras que un artículo a granel lo hace en 50. Ten en cuenta que el valor de toda la tienda también activa las notificaciones por correo de stock bajo; si la etiqueta necesita un número distinto, escríbelo en el fragmento de código.

Registra la columna de la etiqueta

/*
 * Products tables: an "Availability" column with a low stock badge.
 * Threshold: the product's Low stock threshold, otherwise the store-wide one.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('woot_profile_extend', function ($profile, $action) {

    if ('woot_woocommerce_tables' !== $action) {
        return $profile;
    }

    $profile['low_stock_badge'] = [
        'title'  => 'Availability',
        'order'  => false, // not sortable
        'action' => function ($post_id) {
            $product = wc_get_product($post_id);

            // only products that count their stock and are in stock (not on backorder)
            if (!$product || !$product->managing_stock() || !$product->is_in_stock() || $product->is_on_backorder()) {
                return '';
            }

            $qty = (int) $product->get_stock_quantity();

            $threshold = $product->get_low_stock_amount();
            if ('' === $threshold || null === $threshold) {
                $threshold = get_option('woocommerce_notify_low_stock_amount', 2);
            }

            if ($qty > 0 && $qty <= (int) $threshold) {
                return sprintf('<span class="woot-low-stock-badge">Only %d left</span>', $qty);
            }

            return '';
        },
    ];

    return $profile;
}, 10, 2);

El campo aparece ahora en la pestaña Columnas como Availability. Añádelo con Añadir columna al final (Append column) (o Añadir columna al principio (Prepend column)), selecciona Availability en Campo (Field), actívalo con Activa (Active) y, si hace falta, con Móvil (Mobile). Arrastra la fila para colocar la columna junto al título o al precio. Sustituye "Only %d left" por un texto fijo como "Casi lleno" si prefieres no mostrar la cantidad. Para poner la etiqueta en la columna de cantidad en stock en lugar de en una columna aparte, devuelve el mismo <span> desde el fragmento de texto anterior para las cantidades bajas.

Dar estilo a la etiqueta

Pega el CSS en la pestaña CSS personalizado de la tabla y guárdalo con el botón de guardar o con CTRL+S. El plugin antepone a cada regla de allí el ID de esta tabla, de modo que las demás tablas conservan su aspecto. Para todas las tablas a la vez, usa en su lugar el CSS adicional del tema.

.woot-low-stock-badge {
    display: inline-block;
    padding: 2px 8px;
    border-radius: 3px;
    background: #e8a33d;
    color: #fff;
    font-size: 12px;
    line-height: 1.6;
}

/* optional: tint the whole row of a product that is running low */
tr:has(.woot-low-stock-badge) td {
    background: #fff8ec;
}

Mantén cada llave de cierre en su propia línea, como arriba: la pestaña CSS personalizado delimita las reglas por los saltos de línea que las siguen. El tinte de la fila usa el selector CSS :has(), que admiten los navegadores actuales; los más antiguos simplemente lo ignoran.

Productos variables y reservas pendientes

  • Un producto variable muestra una cantidad solo cuando el stock se gestiona en el propio producto, en su pestaña Inventario. Cuando cada variación tiene su propio stock, la fila del producto muestra un guion en Cantidad en stock (Stock quantity) y ninguna etiqueta, y el stock por variación corresponde a la tabla de variaciones; consulta personalizar la ventana emergente de variaciones.
  • Los productos en reserva cuentan como disponibles: Estado del stock (Stock status) les muestra una marca verde y el interruptor del filtro los conserva. El fragmento de texto imprime "Available on backorder" para ellos, y la etiqueta los omite. Una etiqueta "En reserva" en la columna Estado del stock y el botón de añadir al carrito con stock cero se tratan en reservas pendientes en la tabla de productos.
  • Un producto pasa a "Agotado" en el Umbral de agotado de WooCommerce, que no siempre es 0. Ambos fragmentos leen el estado del stock en lugar de comparar el número con 0, así que respetan ese ajuste.

Si la etiqueta o el texto no aparece

  • El producto controla el stock: Gestionar stock (Manage stock) muestra una marca para él en la tabla.
  • Su cantidad es mayor que 0 y menor o igual que el umbral que se le aplica; revisa primero el Umbral de pocas existencias del propio producto, ya que sustituye al valor de toda la tienda.
  • La columna Availability está activa (Activa (Active)) en la tabla cuyo shortcode está en la página, y Móvil (Mobile) está activado si pruebas en un teléfono.
  • El fragmento de código está activo: un plugin de fragmentos de código puede requerir que el fragmento esté activado y configurado para ejecutarse en todas partes, porque las celdas de la tabla se construyen en una solicitud AJAX, no en la plantilla de la página.
  • Se ha vaciado la caché de la página tras el cambio.

Si la columna sigue mostrando la salida anterior, pregunta en el foro de soporte de WOOT con el shortcode de la tabla y el fragmento de código que usas.