Integración domótica Wiki.js, gratuita y de código abierto
Su Wiki.js en Gladys: contadores, páginas modificadas, páginas y diario desde escenas.
Publicado por guim31
- Dispositivos
- Versión 1.0.0
- Requiere Gladys >=5.1.0
- ★ 0
Conecte Gladys a Wiki.js, el wiki autoalojado: siga sus contadores, reaccione cuando se crea o modifica una página, escriba páginas desde sus escenas y lleve un diario (la caldera, la alarma, el jardín…) que Gladys rellena línea a línea. Todo se queda en su red local: Gladys habla directamente con su Wiki.js.
Probada con un Wiki.js 2.5.317 real (la imagen Docker oficial). Sus comentarios son bienvenidos en el foro de Gladys.
Requisitos previos
- Gladys Assistant 5.1 o posterior.
- Wiki.js 2.x accesible desde la máquina de Gladys. Wiki.js 3 no está soportado.
- Una clave de API: en Wiki.js, abra Administration → API Access, pulse Enable API si está desactivada y luego New API Key. Una clave Full Access sirve. Una clave limitada a un grupo ve lo que ve el grupo: debe poder leer las páginas, y escribirlas para las acciones de escena. Copie la clave: solo se muestra una vez.
Configuración
- Abra la pestaña Configuración de la integración.
- En Dirección de Wiki.js, introduzca la dirección en la que abre Wiki.js,
por ejemplo
192.168.1.50:3000ohttps://wiki.example.org. - Pegue la Clave de API.
- Leer Wiki.js cada: 5, 15 (por defecto), 30 o 60 minutos. Las páginas modificadas se anuncian en la siguiente lectura.
- Idioma de nombres y mensajes fija el nombre de las funciones (al añadir un dispositivo) y los textos de la integración. Francés por defecto.
- Guarde y use Probar la conexión: muestra el número de páginas.
- En la pestaña Descubrimiento, añada el dispositivo Wiki.js.
Dispositivos
Wiki.js (un dispositivo):
| Función | Valor |
|---|---|
| Páginas | número de páginas |
| Páginas modificadas hoy | páginas creadas o guardadas desde medianoche |
| Última página modificada | título de la página creada o guardada más recientemente |
Los contadores conservan su historial. El dispositivo conserva su identidad cuando cambia la dirección de Wiki.js.
Widget del panel
Wiki.js: dos mosaicos (páginas, páginas modificadas hoy) y las ocho últimas
páginas modificadas, con su ruta y la hora del cambio. En los ajustes del
widget, Carpeta conserva las páginas bajo una ruta (p. ej. casa) y
Etiqueta las páginas que la llevan; el mosaico las cuenta entonces.
Ocultar los contadores deja solo la lista. Cuando se accede a Wiki.js por
https, cada página se abre en Wiki.js.
Disparadores de escena
- Página de Wiki.js creada o modificada: se crea o guarda una página en
Wiki.js. Filtros: Carpeta (la primera parte de la ruta, p. ej.
casaparacasa/caldera), Ruta de la página (una sola página, p. ej.casa/caldera) y Cambio (creada, actualizada, o vacío: ambos). Los filtros vacíos dejan pasar todas las páginas. - Página de Wiki.js etiquetada modificada: lo mismo, para las páginas con
una etiqueta: Etiqueta (obligatoria, en minúsculas como la guarda Wiki.js,
p. ej.
journal), Carpeta y Cambio. Una página con varias etiquetas dispara una vez por etiqueta: una escena configurada en una etiqueta se ejecuta una sola vez.
Las rutas se escriben como en la dirección de la página, sin el idioma (/es/)
ni las barras en los extremos.
Variables: Título de la página, Ruta de la página, Carpeta,
Cambio (created o updated), Dirección de la página, Actualizada
por, Etiquetas (separadas por comas), Id. de la página, y
Etiqueta para el segundo disparador.
La primera lectura tras la instalación es silenciosa: las páginas ya existentes no se anuncian. Las páginas escritas por esta integración nunca se anuncian. Se anuncian como máximo diez páginas por lectura, las más antiguas primero; las siguientes esperan a la siguiente lectura. Por encima de 50 cambios entre dos lecturas (una importación), se anuncian diez y el resto se cuenta como visto.
Acciones de escena
- Crear una página de Wiki.js: Ruta de la página (p. ej.
informes/2026-10), Título y, si lo desea, Contenido (Markdown) y Etiquetas (separadas por comas). La página se publica, en el idioma de la mayoría de las páginas del wiki. Una página ya existente en esa ruta es un error: nunca se sobrescribe. - Añadir una línea a una página de Wiki.js: Ruta de la página y Línea. La línea se añade al final de la página, como un nuevo párrafo, precedida de la fecha y la hora salvo si Empezar con la fecha y la hora está desactivado. La página se crea con su primera línea, titulada con el final de su ruta salvo si se rellena Título si se crea la página. Las páginas Markdown reciben la línea en Markdown, las del editor visual como texto plano. Todo lo demás de la página (título, etiquetas, publicación, scripts) se conserva.
Ambas devuelven Id. de la página, Ruta de la página y Dirección de la página; la segunda también Página creada.
Ejemplos de escenas
- Diario de la caldera: cuando la presión de la caldera baja de 1 bar →
Añadir una línea a una página de Wiki.js, ruta
diario/caldera, línea «Presión por debajo de 1 bar». - Saber qué ha cambiado: disparador Página de Wiki.js creada o
modificada, carpeta
procedimientos→ enviar un mensaje «{{triggerEvent.data.updated_by}} modificó {{triggerEvent.data.title}}». - Lista de la compra en el wiki: disparador Página de Wiki.js creada o
modificada, ruta
casa/compra→ enviar la dirección de la página a la familia. - Informe de vacaciones: cuando se desactiva la alarma al volver de
vacaciones → Crear una página de Wiki.js en
informes/vacaciones-2026, con la etiquetainforme.
Solución de problemas
- «Wiki.js no aceptó la clave de API»: la clave se revocó, caducó o se copió mal, o la API está desactivada. Wiki.js responde entonces como a un visitante no conectado: compruebe Administration → API Access.
- «La clave de API no puede escribir esta página»: el grupo de la clave no tiene permiso de escritura en esa ruta. Use una clave Full Access o amplíe el grupo.
- «Wiki.js no responde»: compruebe la dirección y el puerto desde la máquina
de Gladys. El contenedor usa una red en puente:
localhostes el propio contenedor, introduzca la dirección IP del servidor. - «Esta dirección no responde como Wiki.js»: responde la página de inicio de sesión de un proxy en lugar de Wiki.js, o la dirección contiene la ruta de una página. Introduzca la dirección de inicio del wiki.
- La versión muestra
?en el dispositivo: la clave no puede leer la información del sistema (solo una clave Full Access puede). Nada más se ve afectado. - Para ver más detalles en los registros de la integración, ponga
LOG_LEVEL=debug.
Límites
- Un solo Wiki.js, visto con los permisos de su clave de API.
- Los disparadores se activan en la siguiente lectura (15 minutos por defecto), no al instante: Wiki.js no envía nada. Las páginas eliminadas, movidas o solo comentadas no se anuncian; una página guardada varias veces entre dos lecturas se anuncia una vez.
- Una lectura es una petición que lista todas las páginas (unos cientos de kB para miles de páginas), más una por página anunciada. Wiki.js no impone ninguna cuota de peticiones.
- Las páginas no publicadas se cuentan y anuncian como las demás: la clave las ve.
- La integración nunca elimina ni mueve nada en Wiki.js.
- Sin relación con Wiki.js ni con Requarks.
Parámetros de configuración
Estos son los parámetros que Wiki.js te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Conectar Wiki.js | section | No | Introduzca la dirección de su Wiki.js (versión 2) y una clave de API: en Wiki.js, abra Administration → API Access, active la API y cree una clave. Una clave «Full Access» sirve; una clave de grupo debe poder leer las páginas, y escribirlas para las acciones de escena. |
| Dirección de Wiki.js | string | Sí | La dirección en la que abre Wiki.js. |
| Clave de API | secret | Sí | Se muestra una sola vez, al crear la clave. |
| Leer Wiki.js cada | select | No | Las páginas modificadas se anuncian en la siguiente lectura. |
| Idioma de nombres y mensajes | select | No | Los nombres de las funciones se fijan al añadir un dispositivo a Gladys. |
Cómo instalar Wiki.js en Gladys
- En Gladys, abre Integraciones: Wiki.js aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/guim31/gladys-wikijs:1.0.0), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-wikijs.
Wiki.js requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
Wiki.js es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene guim31, no el equipo principal de Gladys.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación