Template overrides

Sistema de plantillas basado en WooCommerce. Sobrescribe cualquier plantilla copiándola a yourtheme/polski/ en tu tema.

Cómo sobrescribir una plantilla

1. Encuentra la plantilla original en el directorio del plugin: wp-content/plugins/polski/templates/
2. Copia el archivo al directorio de tu tema: wp-content/themes/your-theme/polski/
3. Conserva la estructura de subdirectorios
4. Modifica el archivo copiado

El plugin detectará automáticamente la plantilla en tu tema y la usará en lugar de la predeterminada.

Ejemplo: para sobrescribir la plantilla de precio Omnibus, copia:

wp-content/plugins/polski/templates/omnibus/price-display.php

a:

wp-content/themes/your-theme/polski/omnibus/price-display.php

Tema hijo

Si usas un tema hijo, coloca las plantillas en el directorio del tema hijo. El plugin busca las plantillas en el siguiente orden:

1. wp-content/themes/child-theme/polski/
2. wp-content/themes/parent-theme/polski/
3. wp-content/plugins/polski/templates/

Lista de plantillas

Requisitos legales

Archivo de plantilla	Descripción
omnibus/price-display.php	Visualización del precio Omnibus
omnibus/price-history.php	Historial de precios (tabla)
gpsr/product-info.php	Información GPSR en la página de producto
gpsr/safety-sheet.php	Ficha de seguridad del producto
withdrawal/form.php	Formulario de desistimiento del contrato
withdrawal/confirmation.php	Confirmación del desistimiento
withdrawal/email.php	Plantilla de correo de confirmación
dsa/report-form.php	Formulario de denuncia DSA
dsa/report-confirmation.php	Confirmación de denuncia DSA
gdpr/consent-checkboxes.php	Casillas de consentimiento RGPD
ksef/invoice-template.php	Plantilla de factura KSeF
greenwashing/product-claims.php	Declaraciones medioambientales del producto
legal-pages/terms-template.php	Plantilla de términos y condiciones de la tienda
legal-pages/privacy-template.php	Plantilla de política de privacidad
legal-pages/withdrawal-template.php	Plantilla de información sobre desistimiento

Precios e información del producto

Archivo de plantilla	Descripción
prices/unit-price.php	Precio unitario
prices/vat-notice.php	Información sobre IVA y envío
prices/delivery-time.php	Tiempo estimado de entrega
manufacturer/info.php	Información del fabricante
manufacturer/logo.php	Logotipo del fabricante

Productos alimentarios

Archivo de plantilla	Descripción
food/nutrients-table.php	Tabla de información nutricional
food/allergens-list.php	Lista de alérgenos
food/nutri-score.php	Distintivo Nutri-Score

Pago y pedidos

Archivo de plantilla	Descripción
checkout/button-label.php	Etiqueta del botón de pedido
checkout/legal-checkboxes.php	Casillas legales en el pago
checkout/nip-field.php	Campo NIP con autocompletado
checkout/doi-notice.php	Mensaje de doble opt-in

Módulos de la tienda

Archivo de plantilla	Descripción
wishlist/table.php	Tabla de lista de deseos
wishlist/button.php	Botón para añadir a la lista
wishlist/header-icon.php	Icono en la cabecera
compare/table.php	Tabla de comparación
compare/button.php	Botón de comparación
compare/floating-bar.php	Barra de comparación (parte inferior de la pantalla)
quick-view/modal.php	Ventana lightbox de vista rápida
quick-view/button.php	Botón de vista rápida
ajax-search/form.php	Campo de búsqueda AJAX
ajax-search/results.php	Desplegable con resultados de búsqueda
ajax-search/result-item.php	Resultado de búsqueda individual
ajax-filters/container.php	Contenedor de filtros AJAX
ajax-filters/filter-category.php	Filtro de categoría
ajax-filters/filter-price.php	Filtro de precio (control deslizante)
ajax-filters/filter-attribute.php	Filtro de atributo
ajax-filters/active-filters.php	Barra de filtros activos
product-slider/slider.php	Contenedor del slider
product-slider/item.php	Tarjeta de producto en el slider
badges/badge.php	Distintivo individual
badges/container.php	Contenedor de distintivos en el producto
waitlist/form.php	Formulario de lista de espera
waitlist/email.php	Correo de notificación de disponibilidad

Herramientas

Archivo de plantilla	Descripción
tools/compliance-checklist.php	Lista de verificación de conformidad
tools/audit-report.php	Informe de auditoría
tools/security-incident-form.php	Formulario de incidente de seguridad
tools/verified-review-badge.php	Distintivo de reseña verificada

Variables disponibles en las plantillas

Cada plantilla recibe un conjunto de variables. Ejemplo para omnibus/price-display.php:

<?php
/**
 * Omnibus price display template
 *
 * Available variables:
 * @var float  $lowest_price  Lowest price from the period
 * @var int    $days          Number of days
 * @var int    $product_id    Product ID
 * @var string $price_html    Formatted price HTML
 * @var string $date          Lowest price date
 *
 * @package Polski
 */

defined('ABSPATH') || exit;
?>

<div class="polski-omnibus-price">
    <span class="polski-omnibus-label">
        <?php printf(
            esc_html__('Lowest price from %d days before the discount:', 'polski'),
            $days
        ); ?>
    </span>
    <span class="polski-omnibus-amount">
        <?php echo wp_kses_post($price_html); ?>
    </span>
</div>

Comprobar la versión de la plantilla

Cada plantilla contiene un comentario @version en la cabecera. Tras actualizar el plugin, comprueba si tus plantillas sobrescritas necesitan actualizarse.

El plugin muestra una advertencia en el panel de administración (WooCommerce > Estado > Polski) si detecta plantillas obsoletas en el tema.

/**
 * @version 1.5.0
 */

Hook para cambiar la ruta de las plantillas

Si quieres cambiar la ubicación predeterminada de las plantillas en el tema:

add_filter('polski/template/path', function (string $path): string {
    return 'custom-polski-templates/'; // instead of 'polski/'
});

Entonces las plantillas se buscarán en: wp-content/themes/your-theme/custom-polski-templates/

Depurar plantillas

Para comprobar qué plantilla se está cargando en un momento dado, activa el modo de depuración:

// In wp-config.php
define('POLSKI_TEMPLATE_DEBUG', true);

En el modo de depuración, cada plantilla queda rodeada de comentarios HTML que indican la ruta:

<!-- polski template: /themes/your-theme/polski/omnibus/price-display.php -->
...
<!-- /polski template -->

Informar de problemas: github.com/wppoland/polski/issues

Esta página tiene únicamente carácter informativo y no constituye asesoramiento legal. Consulta con un abogado antes de su implementación. Polski for WooCommerce es software de código abierto (GPLv2) proporcionado sin garantía.