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>

Mantener actualizadas las plantillas sobrescritas

El plugin no marca las plantillas con un número de versión ni comprueba si el tema tiene copias obsoletas. Tras actualizar el plugin, compara tú mismo el archivo sobrescrito con el actual en wp-content/plugins/polski/templates/, por ejemplo con una herramienta diff, y traslada los cambios.

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.