Cómo crear un producto WooCommerce PDF
· por Daniel

En algún momento, como responsable de una tienda, quizá quiera ofrecer a sus clientes la posibilidad de descargar PDF de productos directamente desde WooCommerce. Ya sea porque sus usuarios necesitan una versión impresa, su equipo comercial necesita fichas de producto para visitar a socios o sus clientes quieren una versión sin conexión de sus artículos.
En este tutorial le mostramos cómo crear su propio PDF de producto en WooCommerce a partir de los datos existentes. Aprenda a convertir sus datos de producto en una ficha PDF que los clientes pueden descargar y consultar sin conexión.
¿Qué es WooCommerce?
Antes de empezar, debe saber qué es WooCommerce. WooCommerce es un plugin de tienda online para WordPress que ofrece todas las funciones que necesita hoy una tienda. Puede crear productos, configurar métodos de envío y de pago y empezar a vender en pocos clics. No solo puede mostrar sus artículos: también puede reutilizar todos los datos para crear una ficha de producto en PDF.
¿Qué es WooCommerce Print Products (PDF)?
Supongamos que no quiere empezar desde cero para convertir los datos de sus productos online en un PDF imprimible. Configurar un motor de renderizado de PDF es complejo: hay que encontrar todos los hooks, filtros y funciones esenciales de WooCommerce, y uno se pierde enseguida en el universo WordPress.
Por eso puede usar el plugin Print Products (PDF) para WooCommerce como base sencilla. Este plugin convierte fácilmente sus productos en PDF, Word o versión para imprimir. Puede elegir entre 3 diseños, ocultar o mostrar datos y añadir una cabecera y un pie de página con su logotipo, su marca, el nombre del producto y más.
Usaremos este plugin para crear nuestro propio PDF de producto mediante los filtros que incluye.
Usar hooks de WordPress en un tema hijo
WordPress y muchos plugins bien programados ofrecen filtros para modificar contenido o datos, o añadir textos propios. Hay dos tipos de hooks:
- Action hooks
- Filter hooks
La diferencia no es fácil de explicar, porque ambos tipos de hooks pueden hacer casi exactamente lo mismo. Pero una acción sirve para añadir contenido, mientras que un filtro sirve para modificar datos que ya aporta un plugin, un tema o el núcleo de WordPress.
El plugin WooCommerce Print Products PDF usa filtros para modificar el HTML que se coloca en el archivo PDF del producto. Vamos a usar el filtro woocommerce_print_products_product_html para crear una plantilla personalizada.
Para usar hooks de WordPress se recomienda crear un tema hijo. Un tema hijo hereda todas las funciones del tema principal. En él puede crear funciones propias o modificar estilos sin perderlo todo en la próxima actualización del tema principal. La mayoría de los temas de Themeforest, por ejemplo, incluyen un tema hijo en los archivos descargados. Instale el tema principal y el tema hijo, active el tema hijo y listo. En Apariencia verá entonces 2 temas: el tema hijo debe estar activo.
Crear nuestra plantilla HTML personalizada
Como hemos dicho, vamos a usar el filtro woocommerce_print_products_product_html. Este filtro modifica toda la parte HTML del PDF, pero no toca la cabecera ni el pie de página, que puede definir en los ajustes del plugin.
Abra el archivo functions.php de su tema hijo y haga una pequeña prueba añadiendo esta función:
add_filter('woocommerce_print_products_product_html', 'custom_print_products_template', 10, 2);
function custom_print_products_template($html, $product_id)
{
$product = wc_get_product($product_id);
if(!$product) {
return $html;
}
$product_id = $product->get_id();
$html = 'test';
return $html;
}
Ahora abra la URL del PDF de su producto así: https://yourdomain.com/product/YOUR_PRODUCT_URL/?print-products=pdf
Verá en el archivo una sencilla cadena de prueba con la cabecera y el pie de página predefinidos del plugin. Así de sencillo: ahora puede añadir al PDF el HTML que quiera.
Vamos a añadir más datos del producto al HTML:
- Imagen del producto alineada a la izquierda
- Título y descripción del producto a la derecha
- Campo meta personalizado
Añadir la imagen, el nombre y la descripción del producto al PDF
Modifiquemos la función anterior para añadir más datos. Empezamos con la imagen, el título y la descripción del producto. La imagen irá en una columna izquierda y el bloque del título en una columna derecha, así que necesitamos algo de CSS para el posicionamiento flotante.
add_filter('woocommerce_print_products_product_html', 'custom_print_products_template', 10, 2);
function custom_print_products_template($html, $product_id)
{
// Check if Product exists
$product = wc_get_product($product_id);
if(!$product) {
return $html;
}
// Get product ID
$product_id = $product->get_id();
// Custom CSS Styling
$html =
'<style>
.container {
padding: 20px;
}
.col-12 {
width: 100%;
padding: 10px;
}
.col-6 {
width: 45%;
float: left;
padding: 10px;
}
</style>';
// Start with a container
$html .= '<div class="container">';
// Get Product Image URL
$product_image_url = get_the_post_thumbnail_url($product_id);
if($product_image_url) {
$html .=
'<div class="col-6">
<img src="' . $product_image_url . '">
</div>';
}
// Get Product Name & Description
$product_name = $product->get_name();
$product_desc = $product->get_description();
if($product_name) {
$html .=
'<div class="col-6">
<h1>' . $product_name . '</h1>
<p>' . $product_desc . '</p>
</div>';
}
$html .= '</div>';
return $html;
}
Hemos añadido CSS para los bloques flotantes y algo de relleno. Después usamos el objeto $product y llamamos a funciones para obtener datos como el nombre, la descripción, etc. Aquí encontrará la lista completa de funciones del objeto de producto de WooCommerce. Por último devolvemos el HTML, y así queda:
Añadir un campo de producto personalizado al PDF
Si usa campos personalizados, puede obtener sus valores con la función de WordPress get_post_meta. WooCommerce también guarda metadatos en la tabla post_meta, por ejemplo el precio, que también se puede obtener con la función $product->get_price();. Para campos meta realmente específicos, como los del plugin ACF u otros plugins, esta función es fundamental. Un ejemplo de cómo usar get_post_meta para mostrar un campo personalizado en nuestro PDF de producto de WooCommerce:
$html .= '<div class="container">';
// Get Custom Field
$custom_field = get_post_meta($product_id, 'custom_field', true);
if($custom_field) {
$html .=
'<div class="col-12">
<p>' . $custom_field . '</p>
</div>';
}
$html .= '</div>';
Y eso es todo. Si usa ACF, por ejemplo, puede usar la función get_field de ACF en lugar de get_post_meta.
Si tiene más preguntas sobre cómo crear una plantilla de PDF de producto personalizada, deje un comentario debajo de este artículo.