WooCommerce Print Invoices/Packing Lists

Ejemplo 1: Agregar una columna de imagen en miniatura

Agregar una columna de imagen en miniatura a tus documentos de Print Invoices & Packing Lists es una excelente manera de mejorar la apariencia de tus facturas, listas de embalaje y listas de selección. Esto te permitirá mostrar una imagen visual de los productos junto con su información correspondiente en la tabla de elementos.

Para lograr esto, sigue estos pasos sencillos. Primero, necesitarás agregar el encabezado para la columna de imagen en miniatura utilizando el filtro `wc_pip_document_table_headers`. Este filtro te permite modificar los encabezados existentes o agregar nuevos. Puedes personalizar el nombre de la columna según tus preferencias.

/**
 * Filtro para agregar un encabezado de imagen del producto a la tabla de documentos
 *
 * @param array $table_headers Encabezados de las columnas de la tabla
 * @return array Los encabezados de las columnas de la tabla actualizados
 */
function sv_wc_pip_document_table_headers_product_thumbnail( $table_headers ) {

    $thumbnail_header = array( 'product_thumbnail' => 'Imagen' );

    // Agregar columna de imagen en miniatura del producto como primera columna
    return array_merge( $thumbnail_header, $table_headers );
}
add_filter( 'wc_pip_document_table_headers', 'sv_wc_pip_document_table_headers_product_thumbnail' );

Una vez que hayas agregado el encabezado, necesitarás asegurarte de que la celda en la tabla se llene con la imagen en miniatura correspondiente para cada fila. Este paso se realiza utilizando el filtro `wc_pip_document_table_row_cells`. Dentro de esta función, puedes personalizar el tamaño de la imagen en miniatura y cualquier otro detalle relacionado con la visualización de las imágenes.

/**
 * Filtro para agregar datos de imagen en miniatura a las celdas de la tabla de documentos
 *
 * @param string $table_row_cells Las celdas de la fila de la tabla
 * @param string $type Tipo de documento de WC_PIP_Document
 * @param string $item_id ID del elemento
 * @param array $item Datos del elemento
 * @param WC_Product $product Objeto de producto
 * @return array Las celdas de la fila de la tabla filtradas
 */
function sv_wc_pip_document_table_row_cells_product_thumbnail( $table_row_cells, $document_type, $item_id, $item, $product ) {

    // Obtener la imagen en miniatura del producto o variante
    $thumbnail_content = array( 'product_thumbnail' => $product->get_image( array( 75, 75 ) ) );

    return array_merge( $thumbnail_content, $table_row_cells );
}
add_filter( 'wc_pip_document_table_row_cells', 'sv_wc_pip_document_table_row_cells_product_thumbnail', 10, 5 );

Con estos cambios realizados, ahora podrás disfrutar de una columna de imagen en miniatura en tus documentos de Print Invoices & Packing Lists. Esto mejorará la presentación visual de tus facturas y hará que tus listas de embalaje y listas de selección sean más atractivas y fáciles de entender para tu equipo y tus clientes.

Ejemplo 2: Eliminar columnas según el tipo de documento

A veces, es posible que desees personalizar aún más tus documentos eliminando columnas que no son relevantes para ciertos tipos de documentos. En Print Invoices & Packing Lists, esto es fácil de hacer utilizando los ganchos adecuados y algunos filtros simples. A continuación se muestra cómo puedes eliminar columnas según el tipo de documento específico.

Primero, considera qué columnas deseas eliminar. Por ejemplo, si deseas eliminar la columna de SKU de tus facturas y la columna de peso de tus listas de embalaje y listas de selección, puedes utilizar los siguientes filtros.

/**
 * Filtro para eliminar headers de columnas en documentos específicos
 *
 * @param array $table_headers Encabezados de las columnas de la tabla
 * @param int $order_id ID del pedido de WooCommerce
 * @param string $document_type Tipo de documento de Print Invoices & Packing Lists (por ejemplo, invoice, packing-list, pick-list)
 * @return array Los encabezados de las columnas de la tabla actualizados
 */
function sv_wc_pip_document_table_headers_remove_columns( $table_headers, $order_id, $type ) {

    // Eliminar columna de SKU en las facturas
    if ( 'invoice' === $type && isset( $table_headers['sku'] ) ) {
        unset( $table_headers['sku'] );
    }

    // Eliminar columna de peso de las listas de embalaje y las listas de selección
    elseif ( ( 'packing-list' === $type || 'pick-list' === $type ) && isset( $table_headers['weight'] ) ) {
        unset( $table_headers['weight'] );
    }

    return $table_headers;
}
add_filter( 'wc_pip_document_table_headers', 'sv_wc_pip_document_table_headers_remove_columns', 10, 3 );

Además de eliminar los encabezados de las columnas, también necesitas eliminar las celdas correspondientes utilizando otro filtro. Esto se hace de manera similar al ejemplo anterior.

/**
 * Filtro para eliminar datos de las celdas de columnas específicas en la tabla de documentos
 *
 * @param string $table_row_cells Las celdas de la fila de la tabla
 * @param string $type Tipo de documento de Print Invoices & Packing Lists
 * @param string $item_id ID del elemento
 * @param array $item Datos del elemento
 * @param WC_Product $product Objeto de producto
 * @param WC_Order $order Objeto de pedido
 * @return array Las celdas de la fila de la tabla filtradas
 */
function sv_wc_pip_document_table_row_cells_remove_columns( $table_row_cells, $type, $item_id, $item, $product, $order ) {

    // Eliminar celdas de columna de SKU en las facturas
    if ( 'invoice' === $type && isset( $table_row_cells['sku'] ) ) {
        unset( $table_row_cells['sku'] );
    }

    // Eliminar columna de peso de las listas de embalaje y las listas de selección
    elseif ( ( 'packing-list' === $type || 'pick-list' === $type ) && isset( $table_row_cells['weight'] ) ) {
        unset( $table_row_cells['weight'] );
    }

    return $table_row_cells;
}
add_filter( 'wc_pip_document_table_row_cells', 'sv_wc_pip_document_table_row_cells_remove_columns', 10, 6 );

Con estos cambios implementados, tus facturas ahora mostrarán el contenido sin la columna de SKU y tus listas de embalaje y listas de selección no mostrarán la columna de peso. Esto puede ayudar a simplificar la información presentada en tus documentos y hacer que sean más concisos y fáciles de leer para ti y tus clientes.