Paquete de Consentimiento de Cookies de Umbraco
El paquete de Conzent para Umbraco agrega gestión de consentimiento a cualquier sitio Umbraco 13+. Instala a través de NuGet, agrega dos ayudantes de etiqueta a tu diseño y la configuración se maneja a través de appsettings.json.
Instalación
Instala a través de la CLI de .NET:
dotnet add package Conzent.Umbraco
O a través del Administrador de Paquetes NuGet en Visual Studio:
nstall-Package Conzent.Umbraco
Configuración
Agrega tus configuraciones a appsettings.json:
{
"Conzent": {
"WebsiteKey": "TU-CLAVE-DE-SITIO",
"Enabled": true
}
}
Luego registra los ayudantes de etiqueta en _ViewImports.cshtml:
@addTagHelper *, Conzent.Umbraco
Y agrega los ayudantes de etiqueta a tu _Layout.cshtml:
<head>
...
<conzent-scripts />
</head>
<body>
<conzent-gtm-noscript />
...
</body>
Consulta la Página Oficial
Características
- Inyección de ayudantes de etiqueta —
<conzent-scripts />inyecta el script de consentimiento y GTM opcional en<head> - Fallback de GTM sin script —
<conzent-gtm-noscript />agrega el iframe sin script cuando GTM está configurado - Panel de control de backoffice — un panel de control CMP de Conzent aparece bajo Configuraciones en el backoffice de Umbraco
- Modo de Consentimiento de Google v2 — señalización avanzada de consentimiento para servicios de Google
- Soporte para variables de entorno — configura a través de variables de entorno
Conzent__WebsiteKeycomo alternativa aappsettings.json
Opciones de Configuración
| Configuración | Predeterminado | Descripción |
|---|---|---|
| WebsiteKey | (requerido) | Tu clave de sitio desde el panel de control de Conzent |
| ServerUrl | https://cdn.getconzent.com | Para autoalojado (OCI), ingresa la URL de tu servidor |
| Enabled | true | Activa/desactiva el banner de consentimiento |
Requisitos
- Umbraco 13+
- .NET 8.0+
Autoalojado (OCI)
Si ejecutas OCI en tu propio servidor, establece el ServerUrl a tu instancia de OCI:
{
"Conzent": {
"WebsiteKey": "TU-CLAVE-DE-SITIO",
"ServerUrl": "https://consent.tudominio.com",
"Enabled": true
}
}
Preguntas frecuentes
¿Qué versiones de Umbraco son compatibles?
Umbraco 13+ en .NET 8.0+.
¿Necesito editar las vistas de Razor extensivamente?
No — solo dos ayudantes de etiqueta en tu diseño, <conzent-scripts /> y <conzent-gtm-noscript />. Todo lo demás se configura en appsettings.json o en el panel de control de backoffice.
¿Puedo configurarlo a través de variables de entorno en lugar de appsettings.json?
Sí, usando Conzent__WebsiteKey y variables de entorno relacionadas.
¿Soporta OCI autoalojado?
Sí, establece el ServerUrl a tu instancia de OCI.
Otras Plataformas
Consulta las integraciones para WordPress, Drupal, Joomla, TYPO3, Wix, o la etiqueta de script universal para cualquier otra plataforma.