Docs
Documentación
Escrito sobre la versión tal y como está ahora. Lo que todavía no está implementado se marca como tal, en lugar de describirse como si ya existiera.
Requisitos
Estos son los requisitos de la primera versión, que es la de WordPress. Cada una de las demás plataformas tendrá su propia versión con sus propios requisitos, y el estado de cada una está en Funciona con tu CMS.
- WordPress 6.0 o posterior
- PHP 8.1 o posterior
- Una clave de API de OpenAI, Anthropic, Google o Mistral
- Sin depender de cron, sin acceso a shell, sin Node en el servidor
Instalación
- Plugins, Añadir nuevo, Subir plugin, elige el zip, Instalar ahora.
- Activar.
- Ajustes, DFYe. Pega la clave de tu modelo y guarda.
El primer indexado se ejecuta de inmediato. En una web grande continúa en segundo plano y el widget se activa en cuanto termina la primera pasada.
Elegir qué se indexa
Por defecto, DFYe indexa cada entrada, página y producto publicados. Nunca indexa:
- Cualquier cosa que tu plugin de SEO marque como noindex
- Cualquier cosa protegida con contraseña o privada
- Borradores, revisiones y contenido en la papelera
Un interruptor en la barra lateral del editor, entrada a entrada, deja fuera cualquier otra cosa.
Dar estilo al widget
Cada decisión visual es una propiedad personalizada de CSS en el host del widget. Defínelas en el panel de ajustes, o en tu tema si prefieres tenerlo en el código:
dfye-chat {
--dfye-action: #6c4dff; /* tu color de acento: la burbuja de pregunta, el botón de enviar, el lanzador */
--dfye-action-on: #ffffff; /* el texto sobre el acento */
--dfye-bg: #ffffff; /* la cabecera y el cuadro de escritura */
--dfye-surface: #ffffff; /* el panel */
--dfye-ink: #0b0d12; /* el texto */
--dfye-radius: 18px;
--dfye-font: "Your Face", system-ui, sans-serif;
}El widget usa por defecto la fuente del sistema de tu visitante a propósito, para que tu web nunca
tenga que descargar una tipografía. Pásale la tuya con --dfye-font. El modo oscuro es automático;
fíjalo con data-theme="dark" en el elemento si tu web es siempre oscura.
El widget se renderiza dentro de un shadow root, así que nada de tu tema se cuela dentro y nada del widget se escapa fuera. Por eso estas propiedades son toda la superficie de personalización: no hay ninguna hoja de estilos contra la que pelear.
El embed, en cualquier plataforma
El widget es un script normal y corriente y le da igual qué haya generado la página que lo rodea, así que funciona en un CMS que todavía no tiene versión del plugin, y en una web sin CMS ninguno. Lo que el plugin añade encima es la lectura: rastrear tus páginas publicadas, mantener el índice al día cuando editas una, y el registro de preguntas. Una etiqueta script para el widget flotante:
<script src="https://dfye.com/w.js" data-dfye="demo" defer></script>O un contenedor para un panel en línea, que es lo que usa la página de demo:
<div data-dfye-inline data-opening="Pregúntame lo que quieras."></div>
<script src="https://dfye.com/w.js" defer></script>Presupuesto de tamaño
La compilación falla si el widget supera los 20 kB en gzip. La versión actual pesa 9.7 kB en gzip, 8.3 kB en brotli, 27.1 kB en bruto. Esa cifra la escribe en esta página la propia compilación, así que no puede desviarse de la realidad.
Todavía sin construir
Lista honesta de lo que esta documentación describe pero el plugin no hace hoy:
- La propia versión para WordPress. El widget y el motor de recuperación ya están listos; el envoltorio de PHP es lo siguiente, y todas las demás plataformas de Funciona con tu CMS van detrás.
- La clave de licencia y el endpoint de actualizaciones.
- El registro de preguntas en la administración.
El avance se sigue en la página de lanzamiento y se actualiza según van llegando las cosas, no por adelantado.
Pon una respuesta de verdad en cada página.
Hazle una pregunta al widget de esta misma web y mira cómo cita la página, o cómo se niega a responder. Es el mismo plugin, funcionando sobre el mismo contenido que estás leyendo.