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.woff2y*-latin-ext.woff2directamente desde tu servidor confont-display: swapyunicode-rangeoptimizado, 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);
}