Shortcode web_page_content
El shortcode web_page_content incluye contenido compartido publicado o muestra un campo del post actual. Comparte el renderizado con el bloque Contenido dinámico y sigue estando disponible cuando la interfaz del Legacy Page Builder está desactivada.
Los atributos siguientes coinciden con los controles actuales del Page Builder y con la salida pública. Usa la sintaxis en crudo solo para contenido revisado que no pueda mantenerse mediante los controles visuales.
Uso
[web_page_content type="other_post_content" page_content="123"]
[web_page_content type="post_title" post_title_with_link="yes"]Atributos
| Atributo | Predeterminado | Valores aceptados | Propósito |
|---|---|---|---|
type |
other_post_content |
other_post_content, custom_meta, post_title, permalink, published_date, updated_date, featured_image, image_stored_in_meta |
Selecciona la variante de renderizado o comportamiento que consume el shortcode. |
page_content |
— | Un valor seleccionado de WordPress | Elige la página que se mostrará. Disponible cuando type es other_post_content. |
custom_meta |
— | Clave de metadato escalar pública aprobada | Selecciona el campo del post actual. Disponible cuando type es custom_meta. |
custom_meta_default |
— | Cadena, salvo que se indique lo contrario | Texto predeterminado si el metadato personalizado está vacío. Disponible cuando type es custom_meta. |
custom_meta_prefix |
— | Cadena, salvo que se indique lo contrario | Texto que aparecerá antes del valor del metadato. Disponible cuando type es custom_meta. |
custom_meta_suffix |
— | Cadena, salvo que se indique lo contrario | Texto que aparecerá después del valor del metadato. Disponible cuando type es custom_meta. |
custom_meta_icon |
— | Cadena, salvo que se indique lo contrario | Controla el icono del metadato personalizado. Disponible cuando type es custom_meta. |
image_size |
full-original-ratio |
Tamaño del tema o slug de tamaño de imagen registrado en WordPress | Selecciona el tamaño de imagen de la biblioteca para ambos modos de imagen. |
image_from_meta_name |
— | Clave de metadato escalar pública aprobada | Contiene un ID de adjunto o una URL de imagen HTTP(S). Disponible cuando type es image_stored_in_meta. |
remove_wrapper |
— | yes |
Solo renderiza el contenido, sin añadir un contenedor con el ID del post, etc. Disponible cuando type es other_post_content. |
device_visibility |
— | web-hide-on-lg, web-hide-on-md, web-hide-on-sm, web-hide-on-xs separados por espacios |
Oculta la salida en los rangos de dispositivo seleccionados. Se ignora cuando se elimina el contenedor de inclusión. |
el_id |
— | ID HTML único válido | Se aplica al elemento de salida. Se ignora cuando se elimina el contenedor de inclusión. |
el_class |
— | Cadena, salvo que se indique lo contrario | Si deseas aplicar un estilo diferente a un elemento de contenido concreto, usa este campo para añadir un nombre de clase y luego haz referencia a él en tu archivo CSS. |
post_title_with_link |
— | yes |
Enlaza el título actual a su enlace permanente. Disponible cuando type es post_title. |
Metadatos públicos
El metadato debe ser un valor escalar. Un shortcode creado explícitamente puede mostrar su campo con nombre no protegido sin requerir el registro REST de WordPress. Esto preserva el contenido existente de custom_meta y image_stored_in_meta. Los campos privados o estructurados se omiten, incluso cuando se suministra una alternativa. El cero se conserva. Los valores del shortcode, los prefijos, los sufijos y las cadenas de alternativa conservan el HTML seguro del post, incluidos el énfasis y los enlaces; el marcado ejecutable se elimina. El bloque nativo mantiene estos valores como texto plano.
Los shortcodes de producto creados también pueden mostrar estas claves públicas del escaparate: _price, _regular_price, _sale_price, _sku, _weight, _length, _width, _height y _stock_status. Otras claves protegidas siguen requiriendo una aprobación explícita mediante el filtro que aparece abajo; los metadatos de cuenta, pedido y configuración interna no se abren mediante esta excepción.
El selector de campos del bloque Contenido dinámico se predetermina a los campos no protegidos de valor único registrados en WordPress usando show_in_rest y un tipo escalar.
Los desarrolladores pueden aprobar explícitamente otra clave escalar pública para un tipo de post:
add_filter('pom_dynamic_content_allowed_meta_keys', static function(array $keys, string $post_type): array {
if ($post_type === 'product') {
$keys[] = 'public_product_reference';
}
return $keys;
}, 10, 2);Selecciona o aprueba únicamente los campos destinados a la visualización pública. Los shortcodes existentes que nombren campos escalares no protegidos no necesitan reescribirse ni registrarse con REST.
Inclusión y campos en vivo
Las fuentes deben pertenecer al sitio actual, estar publicadas, no tener contraseña y superar las reglas de permisos del tema. Las colecciones públicas siguen siendo aptas cuando sus rutas de post individuales están desactivadas. Las fuentes de borrador/privadas no se incluyen ni siquiera para un administrador. Los campos del post actual se pueden previsualizar en un borrador editable a través del editor autorizado o de la previsualización del frontend. Los campos anidados conservan el contexto del post consumidor. Tanto los bloques nativos como los shortcodes Legacy de la fuente se renderizan.
Las referencias circulares se omiten. La inclusión está limitada a ocho niveles de renderizado anidados, 64 fuentes incluidas por renderizado raíz y 1 MB por fuente. El proceso de descubrimiento existente resuelve las dependencias de la fuente y el CSS generado de la fuente antes de la cabecera del documento, con una alternativa en el momento del renderizado para el contenido tardío. El Contenido dinámico no añade ninguna hoja de estilos ni script dedicados al frontend.
Las imágenes de la biblioteca usan los metadatos actuales. Las URL de imagen externas conservan su URL de origen, pero no pueden proporcionar el texto alternativo, las dimensiones ni los tamaños responsivos generados de la biblioteca. remove_wrapper="yes" también elimina el lugar donde se aplicarían el ID, las clases y la visibilidad de este shortcode. No repitas una fuente que contenga anclas que deban ser únicas.
Edición de bloques reutilizables
Cuando Other post content apunta a un bloque reutilizable, la previsualización del editor del backend muestra el título del bloque reutilizable y un enlace Edit reusable block. El enlace abre el editor del bloque vinculado en una pestaña nueva para que la página que se está redactando permanezca abierta. Los permisos de WordPress siguen siendo la autoridad, por lo que el enlace de edición solo está disponible para los usuarios que pueden editar el bloque reutilizable vinculado.
Verificación
Guarda y previsualiza fuentes con contenido y vacías, campos del post actual y bloques/shortcodes anidados. Confirma los cuatro rangos de dispositivo, la alternativa de metadatos y el texto alternativo de la imagen. Edita la fuente compartida y vuelve a cargar la página consumidora sin volver a guardarla; borra cualquier caché de página completa si sigue devolviendo una respuesta anterior.