Saltar al contenido principal
Versión: 1.x

Plantillas de Recibo

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

Resumen​

El sistema de plantillas proporciona dos tipos de plantillas:

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

Acceso al Editor de Plantillas​

  1. Navegue a su panel de administración de WordPress
  2. Vaya a POS > Plantillas
  3. Verá una lista de plantillas disponibles organizadas en dos secciones:
    • Plantillas Predeterminadas (desde archivos de plugin/tema)
    • Plantillas Personalizadas (sus 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
Pro PluginPlantilla mejorada de WooCommerce POS ProDisponible con licencia activa
TemaPlantilla personalizada de su tema activoDisponible si el tema incluye plantilla

Acciones de Plantilla​

Para cada plantilla predeterminada, puede:

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

Creación de Plantillas Personalizadas​

Método 1: Copiar de la Plantilla Predeterminada​

  1. En la sección de Plantillas Predeterminadas, encuentre la plantilla que desea personalizar
  2. Haga clic en el botón Copiar
  3. Ingrese un nombre para su plantilla personalizada
  4. Haga clic en Copiar Plantilla
  5. Edite la nueva plantilla personalizada creada

Método 2: Crear desde Cero​

  1. Haga clic en Agregar Nueva Plantilla en la parte superior de la página
  2. Ingrese un nombre para la plantilla
  3. Seleccione Recibo como el tipo de plantilla
  4. Comience a codificar su 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: Establezca 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 su plantilla con datos de muestra
  • Establecer como Activa: Hacer que esta plantilla sea la predeterminada para su POS
  • Actualizar: Guardar sus 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, tiene 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​

Puede 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. Comience con una Copia: Siempre comience copiando una plantilla predeterminada en lugar de crear desde cero
  2. Pruebe a Fondo: Use la función de vista previa para probar su plantilla antes de activarla
  3. Mantenga Copias de Seguridad: Exporte sus plantillas personalizadas o guarde copias de su código
  4. Adaptable a Móviles: Asegúrese de que sus plantillas funcionen bien en diferentes tamaños de pantalla

Calidad del Código​

  1. Valide HTML: Asegúrese de que su HTML esté bien formado
  2. Escape Salidas: Use funciones de escape de WordPress para seguridad
  3. Manejo de Errores: Incluya verificación de errores adecuada en su código PHP
  4. Comentarios: Documente sus personalizaciones para referencia futura

Rendimiento​

  1. Optimice CSS: Mantenga los estilos mínimos y eficientes
  2. Minimice PHP: Evite lógica compleja en las plantillas
  3. Prueba de Impresión: Verifique que las plantillas funcionen bien con sus impresoras de recibos

Solución de Problemas​

Problemas Comunes​

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

Obtener Ayuda​

Si encuentra problemas con la personalización de plantillas:

  1. Revise la vista previa de la plantilla para mensajes de error
  2. Revise el registro de depuración de WordPress para errores PHP
  3. Pruebe 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. Puede pegar su código de plantilla y describir lo que desea lograr.
  5. Consulte 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​

Puede sobrescribir la plantilla predeterminada colocando un archivo receipt.php personalizado en su tema:

your-theme/woocommerce-pos/receipt.php

Hooks y Filtros​

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

Campos Personalizados​

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