Formulario de newsletter en Docusaurus
Añade un registro de notas de versión a tu sitio de Docusaurus sin plugin. Un solo campo de correo electrónico pegado en una página MDX, y los suscriptores llegan a tu bandeja de entrada o a tu herramienta de correo. Sin backend propio.
Como construirlo
- Crea un formulario en tu panel de Formpaste y copia su clave de acceso.
- Pega el markup en tu changelog o página de inicio y renombra class a className.
- Reemplaza YOUR_ACCESS_KEY_HERE con tu clave de acceso, luego despliega.
Puntos claves de Docusaurus
Las páginas de Docusaurus son MDX, así que un formulario de Formpaste es markup que pegas directamente en el documento. No hay plugin que instalar ni tema que swizzlear. La única trampa es que MDX trata el markup como JSX, así que el snippet pegado necesita className en lugar de class.
MDX es JSX, así que usa className
En un archivo .mdx todo lo que parece HTML es en realidad JSX. Renombra class a className en el formulario pegado, y escribe cualquier estilo inline como un objeto, por ejemplo style={{marginTop: '1rem'}}, en lugar de una cadena de texto. El snippet CSS sin estilos es el más fácil de adaptar.
Sin plugin y sin swizzling
No necesitas un plugin de Docusaurus, ni necesitas swizzlear un componente de tema. Un formulario en el cuerpo de la página funciona igual en docs, en el blog y en páginas independientes.
Muévelo a un componente cuando se repite
Si el mismo formulario va en muchas páginas, ponlo en src/components/ como un archivo .jsx o .tsx e impórtalo en cada documento. Ese es el patrón que recomienda la documentación de Docusaurus para cualquier cosa que no sea algo puntual, y mantiene el markup fuera de tu prosa.
Conserva el access_key oculto
Deja el input oculto access_key generado tal como está, para que Formpaste sepa a qué formulario pertenece el envío. Es un input normal, así que sobrevive sin cambios al moverlo a un componente.
Que debes acertar
Un solo campo convierte mejor
Un formulario de boletín debe pedir solo el correo electrónico. Cada campo adicional reduce los registros.
Confirma antes de celebrar
Muestra un mensaje de suscrito al tener éxito. Si necesitas doble confirmación, envíala desde tu herramienta de correo, no desde el formulario.
Envía los datos a tu herramienta de correo
Reenvía los envíos a tu ESP con un webhook para que los nuevos suscriptores lleguen adonde envías tus campañas.
Cómo funciona
Tres pasos simples para que los envíos de formularios lleguen a tu bandeja de entrada.
Crea tu formulario, apunta la URL de action al endpoint de Formpaste y añade tu clave de acceso.
Crea tu formulario
Regístrate, verifica tu correo y crea una clave de acceso en tu panel.
Copia el código
Pega el fragmento de arriba en tu proyecto. Elige CSS o Tailwind para que combine con tu sitio.
<form action="https://api.formpaste.com/submit" method="POST" class="mx-auto flex w-full max-w-md flex-col gap-4 rounded-xl border border-gray-200 bg-white p-6 shadow-sm dark:border-gray-800 dark:bg-gray-950">
<input type="hidden" name="access_key" value="YOUR_ACCESS_KEY_HERE">
<label class="flex flex-col gap-1.5 text-sm font-medium text-gray-900 dark:text-gray-100">Correo electrónico
<input type="email" name="email" placeholder="tu@ejemplo.com" required class="rounded-md border border-gray-300 bg-white px-3 py-2 text-sm text-gray-900 shadow-sm outline-none focus-visible:ring-2 focus-visible:ring-gray-900 dark:border-gray-700 dark:bg-gray-900 dark:text-gray-100 dark:focus-visible:ring-gray-100" />
</label>
<button type="submit" class="w-full rounded-md bg-gray-900 px-4 py-2 text-sm font-medium text-white shadow-sm transition-colors hover:bg-gray-800 disabled:opacity-60 dark:bg-white dark:text-gray-900 dark:hover:bg-gray-200">Suscribirme</button>
</form>Añade tu clave de acceso
Reemplaza el marcador por tu clave de acceso para empezar a recibir envíos.
<input type="hidden" name="access_key" value="YOUR_ACCESS_KEY_HERE">Formulario de newsletter en Docusaurus FAQ
Pega un formulario. Recibe envíos.
Al instante, sin configurar ningún backend, servidor ni base de datos. 250 envíos/mes gratis, sin tarjeta de crédito.