Saltar al contenido principal
Versión: 1.x

Plantillas de Recibo

El editor de plantillas de recibo te permite personalizar la apariencia y el contenido de los recibos impresos desde tu sistema POS. Puedes acceder al editor de plantillas navegando a: WP Admin > POS > Plantillas

Descripción General​

El sistema de plantillas proporciona dos tipos de plantillas:

  • Plantillas Predeterminadas: Detectadas automáticamente desde los archivos de tu plugin y tema. Estas no se pueden eliminar, pero se pueden copiar para crear versiones personalizadas.
  • Plantillas Personalizadas: Plantillas creadas por el usuario que puedes personalizar, editar y gestionar completamente.

Accediendo al Editor de Plantillas​

  1. Navega a tu panel de administración de WordPress
  2. Ve a POS > Plantillas
  3. Verás una lista de plantillas disponibles organizadas en dos secciones:
    • Plantillas Predeterminadas (desde archivos de plugin/tema)
    • Plantillas Personalizadas (tus creaciones personalizadas)

Plantillas Predeterminadas​

El sistema detecta automáticamente las plantillas de recibo de tres fuentes:

Fuentes de Plantilla​

FuenteDescripciónEstado
PluginPlantilla de recibo básica incluida con WooCommerce POSSiempre disponible
Plugin ProPlantilla mejorada de WooCommerce POS ProDisponible con licencia activa
TemaPlantilla personalizada de tu tema activoDisponible si el tema incluye plantilla

Acciones de Plantilla​

Para cada plantilla predeterminada, puedes:

  • Vista previa: Ver cómo se ve la plantilla con datos de muestra
  • Copiar: Crear una copia personalizada que puedes editar
  • Activar: Establecerla como la plantilla activa para tu POS

Creación de Plantillas Personalizadas​

Método 1: Copiar de la Plantilla Predeterminada​

  1. En la sección de Plantillas Predeterminadas, encuentra la plantilla que deseas personalizar
  2. Haz clic en el botón Copiar
  3. Ingresa un nombre para tu plantilla personalizada
  4. Haz clic en Copiar Plantilla
  5. Edita la nueva plantilla personalizada creada

Método 2: Crear desde Cero​

  1. Haz clic en Agregar Nueva Plantilla en la parte superior de la página
  2. Ingresa un nombre para la plantilla
  3. Selecciona Recibo como el tipo de plantilla
  4. Comienza a codificar tu plantilla en el editor

Características del Editor de Plantillas​

El editor de plantillas proporciona:

Editor de Código​

  • Resaltado de Sintaxis: Resaltado de sintaxis PHP para mejor legibilidad del código
  • Números de Línea: Navegación y depuración sencilla
  • Edición en Pantalla Completa: Entorno de edición sin distracciones

Panel de Configuración de Plantillas​

  • Idioma: Establecer en PHP para un resaltado de sintaxis adecuado
  • Tipo de Plantilla: Elegir entre plantillas de Recibo o Informe
  • Estado: Gestión del estado de Publicado/Borrador
  • Visibilidad: Controlar la visibilidad de la plantilla

Acciones de Plantilla​

  • Vista previa: Ver cómo se renderiza tu plantilla con datos de muestra
  • Establecer como Activa: Hacer que esta plantilla sea la predeterminada para tu POS
  • Actualizar: Guardar tus cambios
  • Mover a la Papelera: Eliminar plantillas personalizadas

Estructura de la Plantilla​

Las plantillas de recibo son archivos PHP que generan salida HTML. Aquí está la estructura básica:

<?php
/**
 * Custom Receipt Template
 */

if ( ! defined( 'ABSPATH' ) ) {
    exit; // Exit if accessed directly
}
?>
<!DOCTYPE html>
<html <?php language_attributes(); ?>>
<head>
    <meta charset="<?php bloginfo( 'charset' ); ?>">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <style>
        /* Your custom CSS styles */
        body { font-family: sans-serif; font-size: 14px; }
        .receipt-header { text-align: center; margin-bottom: 20px; }
        /* Add more styles as needed */
    </style>
</head>
<body>
    <!-- Your receipt content -->
    <div class="receipt-header">
        <h1><?php echo get_bloginfo( 'name' ); ?></h1>
        <p><?php echo get_bloginfo( 'description' ); ?></p>
    </div>

    <!-- Order details, items, totals, etc. -->

</body>
</html>

Variables de Plantilla Disponibles​

Al crear plantillas personalizadas, tienes acceso a varias funciones y datos de WordPress y WooCommerce:

Información de la Tienda​

  • get_bloginfo( 'name' ) - Nombre de la tienda
  • get_bloginfo( 'description' ) - Lema de la tienda
  • get_bloginfo( 'url' ) - URL de la tienda

Datos del Pedido​

Los datos del pedido actual están disponibles a través de funciones de pedido estándar de WooCommerce cuando se renderiza la plantilla.

Funciones de WCPOS​

Puedes usar funciones específicas de WCPOS (prefijadas con wcpos_) para acceder a datos y funcionalidades relacionadas con el POS.

Mejores Prácticas​

Desarrollo de Plantillas​

  1. Comienza con una Copia: Siempre comienza copiando una plantilla predeterminada en lugar de crear desde cero
  2. Prueba a Fondo: Usa la función de vista previa para probar tu plantilla antes de activarla
  3. Mantén Copias de Seguridad: Exporta tus plantillas personalizadas o guarda copias de tu código
  4. Adaptable a Móviles: Asegúrate de que tus plantillas funcionen bien en diferentes tamaños de pantalla

Calidad del Código​

  1. Valida HTML: Asegúrate de que tu HTML esté bien formado
  2. Escapa Salidas: Usa funciones de escape de WordPress para seguridad
  3. Manejo de Errores: Incluye verificación de errores adecuada en tu código PHP
  4. Comentarios: Documenta tus personalizaciones para referencia futura

Rendimiento​

  1. Optimiza CSS: Mantén los estilos mínimos y eficientes
  2. Minimiza PHP: Evita lógica compleja en las plantillas
  3. Prueba de Impresión: Verifica que las plantillas funcionen bien con tus impresoras de recibos

Solución de Problemas​

Problemas Comunes​

La plantilla no muestra cambios
  • Asegúrate de haber hecho clic en "Actualizar" para guardar tus cambios
  • Verifica que la plantilla esté establecida como "Activa"
  • Borra cualquier plugin de caché
Errores de sintaxis
  • Utiliza el resaltado de sintaxis para identificar problemas
  • Verifica si faltan puntos y coma, llaves o comillas
  • Valida tu sintaxis PHP
Problemas de estilo
  • Prueba tu CSS en el modo de vista previa
  • Asegúrate de que los estilos sean compatibles con impresoras de recibos
  • Mantén principios de diseño amigables para impresión en mente
Plantilla no disponible
  • Verifica que el tipo de plantilla esté establecido en "Recibo"
  • Verifica que el estado de la plantilla sea "Publicado"
  • Asegúrate de tener los permisos adecuados

Obtener Ayuda​

Si encuentras problemas con la personalización de plantillas:

  1. Revisa la vista previa de la plantilla para mensajes de error
  2. Revisa el registro de depuración de WordPress para errores PHP
  3. Prueba primero con una copia de la plantilla predeterminada
  4. Asistencia de IA: Herramientas de IA modernas como Gemini, ChatGPT y Claude son excelentes para ayudar con plantillas de WordPress simples como estas. Puedes pegar tu código de plantilla y describir lo que deseas lograr.
  5. Consulta la documentación de WooCommerce POS para personalización avanzada

Personalización Avanzada​

Para usuarios avanzados que necesitan más control sobre las plantillas de recibo:

Integración de Temas​

Puedes sobrescribir la plantilla predeterminada colocando un archivo receipt.php personalizado en tu tema:

your-theme/woocommerce-pos/receipt.php

Hooks y Filtros​

WooCommerce POS proporciona varios hooks y filtros para la personalización de plantillas. Consulta la documentación para desarrolladores para las opciones disponibles.

Campos Personalizados​

Puedes incluir campos de pedido personalizados, atributos de productos y otros metadatos en tus plantillas de recibo utilizando las funciones apropiadas de WordPress y WooCommerce.