Lee la configuración del tema POM de forma segura

Usa los asistentes públicos de configuración en lugar de leer opciones, archivos PHP generados o el almacenamiento del framework directamente.

pom_get_theme_mod()

$value = pom_get_theme_mod( 'setting_name', $fallback );
$child = pom_get_theme_mod( 'group_setting/child_key', $fallback );
$color = pom_get_theme_mod( 'palette_reference_setting', '', true );

Firma:

pom_get_theme_mod( string $theme_mod, mixed $default = false, bool $hex = false ): mixed

Comportamiento:

• lee la caché de configuración del tema POM a nivel de petición;
• recurre a la alternativa predeterminada del tema cuando el valor está ausente;
• admite acceso parent/child para ajustes de tipo matriz;
• resuelve una referencia de paleta a su valor hexadecimal cuando $hex es true;
• aplica el filtro theme_mod_{$theme_mod} de WordPress al valor final.

Usa una alternativa explícita que tu integración pueda mostrar de forma segura. Una cadena vacía y false no son intercambiables cuando el ajuste controla la visibilidad.

pom_get_default()

$default = pom_get_default( 'pom_custom_color_1' );

Esto devuelve el valor predeterminado registrado de POM para una clave conocida o false cuando no existe ningún valor predeterminado. Resulta útil para explicar o comparar el valor predeterminado incluido; el renderizado normal normalmente debería llamar a pom_get_theme_mod() para que el valor guardado tenga prioridad.

Ajustes respaldados por el framework

Algunas áreas de configuración más recientes pertenecen a POM Framework en lugar de a la caché heredada de modificaciones del tema. Cuando exista un asistente público del producto, llama a ese asistente. Si una extensión necesita de verdad un valor del framework, usa el contrato documentado POM_Framework_Settings::get_setting_value() de POM Framework en lugar de leer archivos wp-content/settings.

Multisitio

Ejecuta siempre la lectura en el contexto de blog previsto. No almacenes en caché el valor de tema de un sitio en una clave global de red. Si el código usa switch_to_blog(), combínalo con restore_current_blog() y evita filtrar el contexto modificado mediante un retorno anticipado.

No hacer

• llamar a get_option() para una clave POM adivinada;
• incluir archivos de configuración generados;
• depender de la forma de matriz de un repetidor no documentado;
• escribir a través de un asistente de lectura;
• mostrar un valor sin el escapado adecuado al contexto.