--- url: 'https://dxpr.com/es/hc/documentacion/aprender-dxpr-builder/avanzado/cache' title: 'Caché | DXPR' author: name: Jurriaan url: 'https://dxpr.com/users/jurriaan' date: '2026-10-24T11:15:24+00:00' updated: '2026-10-24T17:19:22+00:00' copyright: 'Copyright DXPR. All rights reserved.' type: article summary: |- Una página de DXPR Builder es un array de renderizado de campo de Drupal con sus propios metadatos de caché, más unas pocas cachés internas que el módulo guarda para el editor y la comprobación de licencias. Esta página enumera lo que el código pone en caché, qué etiquetas y contextos usa, qué los invalida y qué debes limpiar a mano tras una actualización. El campo del constructor El formato de campo DXPR Builder fija estos metadatos de caché en cada campo del constructor: tags: - 'Run it in production' image: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg' published: true og: site_name: DXPR updated_time: '2026-10-24T17:19:22+0000' 'image:alt': 'DXPR, powered by Drupal: AI-powered Drupal for marketers.' schema: '@context': 'https://schema.org' '@graph': - mainEntity: { } - '@type': TechArticle headline: Caché description: |- Una página de DXPR Builder es un array de renderizado de campo de Drupal con sus propios metadatos de caché, más unas pocas cachés internas que el módulo guarda para el editor y la comprobación de licencias. Esta página enumera lo que el código pone en caché, qué etiquetas y contextos usa, qué los invalida y qué debes limpiar a mano tras una actualización. El campo del constructor El formato de campo DXPR Builder fija estos metadatos de caché en cada campo del constructor: image: '@type': ImageObject url: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg' width: '1200' height: '630' datePublished: '2026-10-24T11:15:24+0000' dateModified: '2026-10-24T17:19:22+0000' author: '@type': Organization '@id': 'https://dxpr.com/#organization' name: DXPR url: 'https://dxpr.com/' logo: '@type': ImageObject url: 'https://dxpr.com/themes/custom/dxpr_com/dxpr-logo-dark.svg' width: '1348' height: '501' publisher: '@type': Organization '@id': 'https://dxpr.com/#organization' name: DXPR url: 'https://dxpr.com/' logo: '@type': ImageObject url: 'https://dxpr.com/themes/custom/dxpr_com/dxpr-logo-dark.svg' width: '1348' height: '501' mainEntityOfPage: 'https://dxpr.com/es/hc/documentacion/aprender-dxpr-builder/avanzado/cache' articleSection: 'Puesta en producción' - '@type': WebPage '@id': 'https://dxpr.com/es/hc/documentacion/aprender-dxpr-builder/avanzado/cache' description: |- Una página de DXPR Builder es un array de renderizado de campo de Drupal con sus propios metadatos de caché, más unas pocas cachés internas que el módulo guarda para el editor y la comprobación de licencias. Esta página enumera lo que el código pone en caché, qué etiquetas y contextos usa, qué los invalida y qué debes limpiar a mano tras una actualización. El campo del constructor El formato de campo DXPR Builder fija estos metadatos de caché en cada campo del constructor: breadcrumb: '@type': BreadcrumbList itemListElement: - '@type': ListItem position: 1 name: Inicio item: 'https://dxpr.com/es' publisher: '@type': Organization '@id': 'https://dxpr.com/#organization' name: DXPR inLanguage: es --- [Centro de ayuda](/es/hc)/[Documentación](/es/hc/documentacion) /[Aprende DXPR Builder](/es/hc/documentation/learn-dxpr-builder) /[Gestionar el sitio](/es/hc/documentation/learn-dxpr-builder/manage) /[Puesta en producción](/es/hc/documentation/learn-dxpr-builder/manage/production) # Caché. Aprende DXPR BuilderGestionar el sitioPuesta en producción ## En esta guía Guías relacionadas - [Rendimiento](/es/hc/documentacion/aprender-dxpr-builder/avanzado/rendimiento) - [Arquitectura](/es/hc/documentacion/aprender-dxpr-builder/desarrollo/arquitectura) - [Las personas visitantes ven otra cosa](/es/hc/documentacion/aprender-dxpr-builder/solucion-problemas/visitas-ven-otra-cosa) Una página de DXPR Builder es un array de renderizado de campo de Drupal con sus propios metadatos de caché, más unas pocas cachés internas que el módulo guarda para el editor y la comprobación de licencias. Esta página enumera lo que el código pone en caché, qué etiquetas y contextos usa, qué los invalida y qué debes limpiar a mano tras una actualización. ## El campo del constructor El formato de campo **DXPR Builder** fija estos metadatos de caché en cada campo del constructor: | Metadatos | Valor | Efecto | |---|---|---| | Contexto de caché | `user.roles:authenticated` | Las visitas anónimas y autenticadas reciben entradas de caché separadas. | | Etiquetas de caché | Las etiquetas propias de la entidad, `config:dxpr_builder.settings` y `config:language.entity.` para el idioma renderizado | Guardar la entidad, guardar los ajustes del módulo o cambiar la configuración de idioma invalida el campo renderizado. | | `max-age` | `0` para cualquier usuario autenticado | Los campos del constructor nunca quedan en la caché dinámica de página para personas con sesión iniciada, porque el array de renderizado lleva `drupalSettings` específicos de cada persona (correo, tokens CSRF, perfil). | Para las visitas anónimas el campo se guarda en caché con normalidad, así que la caché interna de página y la caché dinámica de página sirven páginas del constructor sin ejecutar el código del módulo. Guardar en el constructor guarda la entidad, así que Drupal invalida las etiquetas de caché de la entidad como en cualquier otro guardado. Cuando el editor está habilitado en el campo, el módulo añade `config:dxpr_builder.settings` de nuevo. Con **Asset source** fijado en **Cloud** y sin clave de producto configurada, también fija `max-age` en `0` para que el mensaje de clave de producto aparezca en cada página. Los formularios de administración propios del módulo invalidan `config:dxpr_builder.settings`de forma explícita: **General Settings**, **AI**, el formulario de perfil de usuario y los formularios de plantillas de página y de usuario. ## Vistas y bloques dentro de una página Los bloques y las vistas se guardan en el HTML guardado como marcadores `az-cms-element` vacíos. Cuando el campo se renderiza, el módulo carga cada bloque o vista, lo renderiza con el renderizador del núcleo e inserta la salida en el marcado del campo. Las bibliotecas de la vista y sus `drupalSettings` se copian al campo; sus metadatos de caché emergen por el renderizador como en cualquier array de renderizado construido durante un renderizado de página. La consecuencia es que las filas de una vista quedan dentro del campo en caché hasta que se invalida una de las etiquetas de caché de la vista. Una vista con caché por tiempo conserva filas viejas toda su vida útil. Si las visitas ven filas obsoletas: 1. Abre la vista, expande **Advanced** y fija **Caching** en **Tag based**. **None** detiene la caché dinámica de página, pero la caché interna de página aún guarda páginas completas para visitas anónimas. 2. Guarda la vista. Guardar cualquier vista también invalida `config:view_list`, lo que limpia las listas de vistas del módulo para el editor. 3. Limpia todas las cachés. En el editor, un bloque o vista que añades o cambias se obtiene por `/dxpr_builder/ajax`. El módulo no guarda en caché esa respuesta. ## Cachés internas Todas las entradas viven en el contenedor de caché predeterminado (`cache.default`). Las cachés del selector de elementos llevan la etiqueta `dxpr_builder:cms_elements`más las etiquetas de caché de lista de los tipos de entidad que enumeran, así que se limpian solas cuando esas entidades cambian. | ID de caché | Contenido | Quién lo limpia | |---|---|---| | `dxpr_builder:cms_elements_blocks`, `dxpr_builder:cms_block_categories` | Lista de bloques y categorías de bloques para el selector de elementos | Guardar o eliminar un bloque de contenido o un webform (`block_content_list`, etiquetas de lista de webforms), eliminar las entradas cuando se desinstala cualquier módulo, `drush cr` | | `dxpr_builder:cms_disallowed_elements::` | Bloques que la persona usuaria actual no puede usar | Las mismas etiquetas más `config:user.role.` por cada uno de sus roles | | `dxpr_builder:cms_elements_views`, `dxpr_builder:cms_view_elements_settings`, `dxpr_builder:cms_views_tags` | Pantallas de vistas, sus ajustes e identificadores para el editor | Guardar, añadir o eliminar cualquier vista (`config:view_list`), `drush cr` | | `dxpr_builder:button_styles` | Estilos de botón para el elemento Button | Etiqueta `dxpr_builder:cms_elements`, `drush cr` | | `dxpr_builder_license_info` | Resultado de la llamada de estado de licencia | Caduca tras 24 horas si está autorizada, 30 minutos si no (`LICENSE_CHECK_INTERVAL`, `LICENSE_NOT_AUTHORIZED_INTERVAL`); se invalida después de que el sitio envíe un cambio de usuario al servidor de licencias | | `dxpr_builder_license_users` | Lista de personas que editan desde el servidor de licencias | Caduca tras 24 horas; se invalida después de que el sitio envíe un cambio de usuario al servidor de licencias | | `dxpr_builder_blacklisted` | Resultado de la lista de dominios bloqueados | Caduca tras una hora, o un minuto mientras el dominio está bloqueado | | `dxpr_builder:jwt_decoded:` | Clave de producto decodificada, una entrada por clave | Etiqueta `config:dxpr_builder.settings` | Las clases de utilidades del tema (`dxpr_builder_classes` en un `.info.yml` del tema) vienen de la información de tema en caché de Drupal, así que un cambio necesita `drush cr` antes de que el editor lo vea. Los archivos de conjuntos de iconos (`*.dxpr_icon_sets.yml`) se leen en cada carga de página del editor, pero una biblioteca que nombran necesita `drush cr` como cualquier biblioteca nueva. ## Recursos y agregación Los seis scripts del editor son externos (Cloud) o están declarados con `preprocess: FALSE`, así que la agregación nunca los toca. La agregación sí se aplica a las bibliotecas de ayuda del editor, como `dxpr_builder/editor.core` con Sortable, y a los archivos para visitas (`dxpr_builder/core`, `dxpr_builder/editor.frontend`, las bibliotecas `elements.*` y `bootstrap_5`). Dos síntomas vienen de la caché de agregación: - El editor se rompe tras una actualización, o informa de `Sortable is not defined` solo con la agregación activada. Sigue [El editor no aparece](/es/hc/documentacion/aprender-dxpr-builder/solucion-problemas/editor-no-aparece). - Las visitas no ven estilos ni iconos tras una actualización o un cambio de ajustes. Sigue [Las visitas ven algo distinto](/es/hc/documentacion/aprender-dxpr-builder/solucion-problemas/visitas-ven-otra-cosa). ## Qué limpiar tras una actualización 1. Ejecuta las actualizaciones de base de datos y luego limpia las cachés: ```bash drush updb -y drush cr ``` `drush cr` reconstruye las definiciones de biblioteca del constructor, que siguen la versión del módulo y el origen de recursos, los archivos agregados de recursos y las cachés internas de arriba. 2. Abre una página del constructor como editor y guárdala. Esto escribe la página con el marcado de la versión actual e invalida sus etiquetas de entidad. 3. Detrás de Varnish o una CDN, purga las páginas del constructor o espera a que pase la edad máxima; el módulo no envía peticiones de purga. Si una página aún muestra contenido viejo a las visitas, consulta [Problemas tras actualizar](/es/hc/documentacion/aprender-dxpr-builder/solucion-problemas/tras-actualizar). ## ¿Qué sigue? - [Rendimiento](/es/hc/documentacion/aprender-dxpr-builder/avanzado/rendimiento): lo que descarga cada página de visitas y de edición. - [Arquitectura](/es/hc/documentacion/aprender-dxpr-builder/desarrollo/arquitectura): el código que renderiza, guarda y pone en caché un campo del constructor. - [Las visitas ven algo distinto](/es/hc/documentacion/aprender-dxpr-builder/solucion-problemas/visitas-ven-otra-cosa): los síntomas de caché y sus soluciones.