Personalización Avanzada con Variables CSS (:root) y Fuentes Locales .woff2 Zero-Tracking

Tanto Modal COD Form Free como Modal COD Form PRO fueron diseñados bajo dos principios estrictos de rendimiento y privacidad: cero estilos inline (style="") en las plantillas PHP y cero peticiones a servidores externos de fuentes (como Google Fonts CDN) para cumplir al 100% con el RGPD y las directrices de WordPress.org.

En esta referencia técnica aprenderás a dominar las Variables CSS (Custom Properties) del plugin y el motor de tipografías variables locales .woff2.

1. Diccionario Completo de Variables CSS (Custom Properties)

Todas las opciones visuales configuradas en WooCommerce → Ajustes → Modal COD Form se compilan dinámicamente y se inyectan mediante wp_add_inline_style() sobre los handles oficiales (modalcodf-form-style y cod-upsell-style). Puedes sobrescribir cualquiera de estas variables desde el CSS adicional de tu tema:

1.1 Variables del Botón Principal y Modal General (Free y PRO)

Variable CSS Ámbito (Scope) Descripción
--cod-btn-bg :root / .cod_container_button_order Color de fondo del botón principal COD y botón de envío del modal.
--cod-btn-color :root / .cod_container_button_order Color del texto y del icono SVG del botón principal.
--cod-btn-radius :root / .cod_container_button_order Radio de borde en píxeles (ej. 8px).
--cod-btn-bw / --cod-btn-bc :root / .cod_container_button_order Grosor del borde en px y color HEX del borde.
--cod-btn-shadow :root / .cod_container_button_order Intensidad de sombra en rem.
--cod-btn-fs :root / .cod_container_button_order Tamaño de fuente del botón en rem.
--cod-btn-width .cod_container_button_order Ancho del botón: auto (normal) o 100% (full).
--highlight-color #codFormModal Color de acento para bordes activos, radios seleccionados y badges del modal.
--cod-title-size #codFormModal Tamaño del título superior del modal en px.
--mc-icon-color / --mc-icon-size #cod_menu_cart / #modalcodf_menu_cart Color y ancho máximo del icono de carrito para menús.

1.2 Variables Exclusivas de Modal COD Form PRO (Botón Secundario, Tipografía y Upsells)

Variable CSS Ámbito (Scope) Descripción
--sec-btn-bg, --sec-btn-color, --sec-btn-radius, --sec-btn-bw, --sec-btn-bc, --sec-btn-shadow, --sec-btn-fs, --sec-btn-width :root / .modal_button_checkout Control visual completo del botón secundario de pago anticipado dentro del modal.
--cod-font-family Contenedores del plugin Pila tipográfica activa cuando se selecciona inter, montserrat o merriweather.
--upsell-bg, --upsell-border, --upsell-border-style, --upsell-radius, --upsell-highlight [data-upsell-id="..."] Estilos dinámicos por instancia para la caja de 1-Tick Upsell dentro del formulario.
--oc-accent, --oc-accept-bg, --oc-accept-text, --oc-decline-bg, --oc-decline-text #cod_one_click_upsell_modal Paleta personalizada para el popup post-compra de 1-Click Upsell.

2. Sistema de Fuentes Variables Locales .woff2 (Zero-Tracking)

En Modal COD Form PRO, cuando eliges una tipografía personalizada en la pestaña Diseño (opción prcod_font_family), la función prcod_get_typography_dynamic_css() realiza lo siguiente:

  • Herencia Limpia por Defecto (inherit): Si dejas seleccionada la opción Heredar del tema (Inherit), la función devuelve una cadena vacía y no descarga ningún archivo adicional, adoptando al 100% la fuente de tu tema.
  • Alojamiento Local en assets/fonts/: Si eliges Inter, Montserrat o Merriweather, el plugin sirve los archivos variables *-latin.woff2 y *-latin-ext.woff2 directamente desde tu servidor con font-display: swap y unicode-range optimizado, logrando carga instantánea sin llamadas externas a Google.
  • Aislamiento Estricto para No Afectar tu Tema ni Iconos: La regla font-family: var(--cod-font-family) !important; se aplica únicamente a los selectores del plugin (#codFormModal, #codDownsellModal, #codUpsellModal, .cod-upsell-one-tick, .quantity_offer_container, .cod_container_button_order, .shortcode_add_to_cart) excluyendo explícitamente los iconos (*:not(.dashicons)).

3. Snippet: Personalizar el Modo Oscuro o Bordes del Modal vía CSS

/* Personalizar bordes, sombras y acentos del modal COD desde el tema hijo */
#codFormModal {
    --highlight-color: #0ea5e9;
    --cod-title-size: 22px;
}

#codFormModal .cod-modal-content {
    border-radius: 16px;
    box-shadow: 0 25px 50px -12px rgba(15, 23, 42, 0.35);
}

4. Enlaces Relacionados

Compartir esta información

Aumenta tus ventas

Mejora tu conversión en tiendas WordPress y WooCommerce con pago contra-entrega.