 |
Resumen | Convierte una tabla en un tema en elementos buscables que los miembros pueden mencionar con +, incluyendo enlaces y vistas previas de onebox. |
 |
Repositorio | Discourse Mentionables |
 |
Guía de instalación | Instalar plugins en un sitio Discourse autoalojado |
 |
Patrocinio | Por favor, considera patrocinar el desarrollo continuo para ayudar a mantener estos plugins actualizados y funcionando con la versión actual de Discourse. |
Dale a tu comunidad un vocabulario compartido para las cosas sobre las que habla: libros,
productos, proyectos, lugares, recursos de soporte o cualquier otra cosa con una URL.
Los miembros escriben + y parte de un nombre, eligen una sugerencia y obtienen un enlace legible sin tener que recordar la dirección.
Características
- Comienza solo con URLs. El importador recupera nombres y genera slugs; agrega
tus propios nombres y slugs como reemplazos opcionales. - Busca mientras escribes. Escribe
+o usa el botón de la barra de herramientas del compositor para buscar
en tu catálogo. Funciona tanto en los compositores de Markdown como de texto enriquecido. - Enlaces en línea legibles. Las menciones aparecen como píldoras compactas usando el nombre de
visualización del elemento, con un slug estable en el Markdown de la publicación. - Oneboxes nativos. Coloca una mención en su propia línea para mostrar un onebox usando
los diseños existentes de Discourse y los destinos compatibles. - Vistas previas en escritorio. Pasa el cursor o enfoca una píldora en línea para abrir una vista previa flotante
con un enlace Abrir página original. Los clics normales abren el destino. - Un catálogo que tus administradores pueden editar en Discourse. Importa desde una tabla Markdown
en la publicación inicial de un tema. No se necesita cuenta de Google ni credenciales de API. - Un botón de tabla para administradores. Inserta una tabla de mencionables vacía desde la
barra de herramientas del compositor y luego completa tus elementos.
La apariencia del onebox depende del destino y del soporte normal de onebox de Discourse.
Los destinos no compatibles permanecen como enlaces. Las tarjetas flotantes requieren inicio de sesión;
los invitados aún pueden seguir el enlace de destino. Las menciones dentro de código se dejan intactas,
y las menciones en listas y citas permanecen en línea.
Basic Mentionables y la extensión Pro
Basic Mentionables es el plugin base. Pro es un plugin complementario opcional
instalado junto con él; Pro incluye las funciones básicas a través de esa dependencia.
| Función | Basic Mentionables | Con extensión Pro |
|---|---|---|
| Importar una tabla Markdown desde la publicación inicial de un tema | Sí | Sí |
| Mantener el tema fuente en una categoría restringida | Sí | Sí |
| Botón de compositor solo para administradores para insertar un esqueleto de tabla | Sí | Sí, incluyendo columnas de iconos |
Buscar con + en compositores de Markdown y texto enriquecido |
Sí | Sí |
| Píldoras de mención en línea y oneboxes nativos independientes | Sí | Sí |
| Vistas previas flotantes al pasar el cursor en escritorio o enfoque con teclado | Sí | Sí, en el modo de hover predeterminado |
| Importar desde Google Sheets usando una cuenta de servicio | — | Sí |
| Seleccionar entre tablas de temas y Google Sheets | Solo tablas de temas | Sí |
| Sincronización automática cada 12 horas | — | Opcional, desactivada por defecto |
| Importar nombres de iconos opcionales y colores HTML | — | Sí, desde cualquiera de las dos fuentes |
| Abrir vistas previas flotantes al hacer clic o tocar, incluyendo dispositivos táctiles | — | Opcional |
Las columnas icon e icon_colour de Pro agregan un icono de color antes del nombre de la
mención. Por ejemplo, usa book y #2563eb para un manual. Con
mentionables_pro_click_to_preview habilitado, hacer clic o tocar una píldora abre su
vista previa; el enlace Abrir página original en la vista previa te lleva al objetivo.
Configuración rápida
-
Instala el plugin base usando la guía de instalación anterior. Reconstruye Discourse
después de la instalación. -
Crea un tema para tu catálogo. Como administrador, usa Insertar tabla de mentionables
en la barra de herramientas del compositor o pega esta tabla en la publicación inicial:| name | url | slug | image_url | | ------------------ | ----------------------------------- | ------------------ | --------- | | Getting started | https://example.com/getting-started | getting-started | | | Community handbook | https://example.com/handbook | community-handbook | | | Events calendar | https://example.com/events | events-calendar | | -
Reemplaza las URLs de ejemplo con las tuyas, guarda la publicación y establece
mentionables_topic_iden el ID numérico de ese tema. Manténmentionables_enabled
habilitado. Las instalaciones de Pro deben seleccionartopic_tableenmentionables_source
para esta configuración. -
Abre Administración → Plugins → Mentionables, haz clic en Iniciar importación y luego
en Actualizar para inspeccionar el informe. El trabajador de trabajos en segundo plano debe estar ejecutándose. -
Recarga tu navegador, abre un compositor y escribe
+para probar tus elementos.
Usa nombres de columnas en minúsculas. Solo url es obligatorio, comenzando con http://
o https://. Las filas solo con URL recuperan un nombre del destino y generan
un slug. Puedes proporcionar name, slug o ambos para reemplazar esos valores predeterminados, mezclando
estas opciones dentro de una sola tabla. Si no hay título disponible, la URL se convierte en el
nombre de visualización. Las URLs existentes conservan sus slugs cuando la fuente los omite.
image_url y description son opcionales.
El importador lee la primera tabla sin comillas con una columna url en la publicación
inicial. Las respuestas, tablas citadas y muestras de código delimitado se ignoran. Los temas fuente
deben ser temas regulares, no eliminados, en lugar de mensajes personales.
Privacidad de la fuente y actualización de tu catálogo
Puedes mantener el tema fuente en Staff u otra categoría restringida para que solo
personas de confianza puedan mantenerlo. Los nombres, URLs e imágenes importados están
disponibles para los usuarios de mentionables. Restringir el tema no hace que el
catálogo importado sea privado. Mantén la información confidencial fuera de la tabla.
Cada importación sincroniza por URL: las URLs coincidentes se actualizan, las nuevas URLs crean registros,
y las URLs eliminadas de la fuente borran registros. La fuente completa debe ser
válida; URLs o slugs duplicados, filas inválidas, fallos de recuperación y conjuntos de datos vacíos
dejan el catálogo sin cambios. Usa Eliminar todo para una limpieza intencional.
Los temas fuente y hojas de cálculo nunca se modifican. La configuración opcional de Pro
mentionables_pro_sync_enabled ejecuta la misma importación cada 12 horas.
Recarga el navegador después de importar. Las publicaciones cocinadas existentes no se reconstruyen automáticamente,y cambiar explícitamente un slug puede romper referencias anteriores de +slug.
Ajustes e información adicional
| Ajuste | Propósito |
|---|---|
mentionables_enabled |
Habilitar o deshabilitar Mentionables. |
mentionables_topic_id |
Tema que contiene la tabla fuente en su publicación inicial. |
mentionables_autocomplete_limit |
Número máximo de sugerencias; predeterminado en cinco. |
mentionables_onebox_fallback |
También recuperar imágenes/descripciones faltantes cuando se proporciona un nombre; desactivado por defecto. |
Consulta el README para la guía de configuración completa, el comportamiento de importación y
la solución de problemas. Las capturas de pantalla usan datos de muestra de los fixtures de prueba del plugin.
