Instalación e inicio rápido

Instalación

npm install astro-cookie-consent

El único requisito como dependencia peer es Astro >=4.0.0.

Inicio rápido

1. Renderiza <ConsentBanner /> una sola vez, de forma global, desde tu layout:

   src/layouts/Layout.astro

   ---
   import ConsentBanner from 'astro-cookie-consent/ConsentBanner.astro';
   ---
   
   <html>
     <body>
       <slot />
       <ConsentBanner privacyHref="/privacy" />
     </body>
   </html>

2. Bloquea cualquier script de terceros tras ese consentimiento:

   <script>
     import { gateScript } from 'astro-cookie-consent';
   
     gateScript({ src: 'https://example-widget.com/embed.js' });
   </script>

   gateScript nunca inserta el script hasta que el visitante acepta, y nunca lo inserta dos veces.

3. Eso es todo. Sin CSS que escribir ni archivo de configuración: el banner es una tarjeta autónoma en la esquina inferior izquierda que ya sigue la preferencia de tema claro/oscuro del visitante.

Próximos pasos

• ¿Necesitas interruptores separados para analítica y marketing en lugar de un único aceptar/rechazar? Consulta Consentimiento por categoría.
• ¿Quieres usar los colores de tu marca? Consulta Temas y modo oscuro.
• ¿Trabajas con un agente de IA? El paquete incluye un SKILL.md: consulta Uso con agentes de IA.