Widget

Opciones del widget

El widget se configura mediante atributos data-. Van en el contenedor con data-captchacore-widget y algunos además en el formulario. Cada valor aquí sustituye al predeterminado que fijó para el sitio en el panel de administración.

Atributos en la etiqueta script

Estos valores van en el propio elemento <script> y se aplican a todos los widgets de la página.

Modos del widget

El modo se define con data-mode="..." en el elemento del widget <div data-captchacore-widget>; si no se indica, se aplica la configuración del sitio en el área de cliente.

API JavaScript del widget

El script crea el objeto global CaptchaCoreV2. En páginas estáticas no necesita nada de esto: el widget se vincula solo a todos los formularios adecuados al cargar. La API resulta relevante en cuanto los formularios se cargan por JavaScript, es decir, en sistemas de tienda, aplicaciones de una sola página y diálogos modales.

Eventos

CaptchaCoreV2.on('ready', function (data) {
  // Widget ist gebunden und einsatzbereit
});

CaptchaCoreV2.on('error', function (err) {
  // Netzwerkfehler, abgelaufener Nonce, ungültiger Schlüssel
  console.warn('CaptchaCore:', err);
});

Formularios cargados después

El widget observa el contenido de la página y detecta por sí mismo los nuevos formularios con data-captchacore. Eso cubre la mayoría de los casos. Sin embargo, si un formulario se sustituye y se envía de inmediato, el observador puede llegar tarde: en ese caso llame explícitamente a attach() tras insertarlo.

// Beispiel: Formular per fetch nachgeladen
const html = await (await fetch(url)).text();
container.innerHTML = html;
CaptchaCoreV2.attach();   // bindet das neue Formular an

Enviar formularios con fetch()

Si su formulario se envía con fetch() o XHR y permite varios envíos por visita (búsqueda, comprobación de dominios, carrito), solicite antes de cada petición un token propio con widget.getToken(). Cada token vale para exactamente una verificación; el widget resuelve el siguiente desafío en segundo plano mientras el visitante sigue trabajando. Las llamadas simultáneas se atienden una tras otra y nunca reciben el mismo token.

const form = document.querySelector('#domaincheck');

form.addEventListener('submit', async (e) => {
  e.preventDefault();
  const body = new FormData(form);
  try {
    body.set('captchacore_token', await CaptchaCoreV2.getWidget(form).getToken());
  } catch {
    // Dienst nicht erreichbar: Platzhalter senden, Ihr Server entscheidet (Fail-Open)
    body.set('captchacore_token', 'cc-unavailable');
  }
  const res = await fetch('/domaincheck', {
    method: 'POST', body,
    headers: { Accept: 'application/json' },   // Fehler als JSON statt Weiterleitung
  });
});