 |
Resumen | Discourse Custom Post Button convierte los enlaces dentro de las publicaciones de Discourse en botones con estilo. |
 |
Repositorio | github.com/koloki-co/discourse-custom-post-button |
 |
Guía de instalación | Instalación de un tema o componente de tema |
 |
¿Nuevo en temas de Discourse? | Guía para principiantes sobre el uso de temas de Discourse |
Instalar este componente de tema
Este es un componente de tema de la comunidad mantenido por Koloki Ltd. No es un componente oficial de Discourse. Está en fase alfa, por lo que podría contener errores. Por favor, informe de errores y solicite funciones en el repositorio de GitHub.
Capturas de pantalla
Botones
Un caso de uso específico: un botón de ‘Pregúntenos por mensaje privado’
Funciones
- Convierte un enlace normal en un botón en cualquier parte de un tema o publicación usando
[wrap]. - Proporciona color de fondo predeterminado, radio de borde, relleno, peso de la fuente, color del texto y opacidad al pasar el cursor, configurables a nivel de componente de tema (TC); de lo contrario, utiliza los valores predeterminados de su sitio.
- Permite que un botón individual anule el color de fondo predeterminado.
- Admite texto explicativo junto a un botón.
- Mantiene el contenido subyacente como un enlace normal, de modo que los botones pueden abrir páginas externas o rutas internas de Discourse, como
/new-message.
IMPORTANTE: Si este TC está instalado, cualquier usuario de su foro puede crear estos botones. Para restringir la capacidad de crear botones a ciertos usuarios, se requeriría un Plugin completo. Sin embargo, en la práctica, los usuarios necesitan saber que está instalado y cómo crear un botón, por lo que sospecho que pocos sabrán realmente cómo hacerlo. También puede usar Palabras vigiladas para filtrar publicaciones que contengan
[wrap=custom-button]para su aprobación, lo que restringiría la funcionalidad.
Instalación
En Administración > Apariencia > Temas y componentes, abra la pestaña Componentes, seleccione Instalar y elija Instalar desde una URL de repositorio Git. Use:
https://github.com/koloki-co/discourse-custom-post-button
Después de la instalación, agregue el componente a cada tema activo donde deba estar disponible.
Uso
Botón básico
Se utilizará el color predeterminado del botón desde la configuración del TC
[wrap=custom-button][Texto de su botón personalizado](https://example.com)[/wrap]
Configuración de color por botón
[wrap=custom-button color=#7CC146][Texto de su botón personalizado](https://example.com)[/wrap]
Botón seguido de texto explicativo
[wrap=custom-button][Texto de su botón personalizado](https://example.com)[/wrap]
[wrap=text-after-button]Texto explicativo adicional[/wrap] (en una nueva línea)
Abrir un mensaje privado a un grupo
(Nota: Esto utiliza la funcionalidad integrada de Discourse para abrir el Compositor con texto prellenado; esa parte de la funcionalidad no proviene del Componente de Tema, solo la estoy usando para demostrar un caso de uso posible. Requiere que la configuración del grupo permita mensajes privados a ese grupo.)
[wrap=custom-button][Pregúntenos una pregunta](/new-message?groupname=somegroup&title=Aask%20Us&body=Please%20type%20your%20question%20here.)[/wrap]
Use el name slugificado del grupo en lugar de su ‘Nombre completo’ y codifique los valores de los parámetros en URL. La configuración de ¿Quién puede enviar mensajes a este grupo? del grupo sigue determinando quién puede abrir un compositor dirigido, y los visitantes no iniciados en sesión se les pedirá que inicien sesión.
Configuración
| Ajuste | Propósito |
|---|---|
button_default_color |
Color de fondo y borde predeterminado del botón |
button_border_radius |
Radio de las esquinas del botón |
button_padding |
Espacio alrededor de la etiqueta del botón |
button_font_weight |
Peso de la etiqueta del botón |
button_text_color |
Color de la etiqueta del botón |
button_hover_opacity |
Opacidad del botón al pasar el cursor |
El componente también expone una configuración svg_icons para los iconos de tema disponibles, pero actualmente no inserta un icono en un botón de publicación. Añadiré esa función si hay demanda.
Notas
- El componente solo cambia la presentación. Los botones siguen siendo enlaces y los permisos de destino no cambian.
- Los clientes de correo electrónico y otros contextos que no carguen el tema de Discourse activo pueden mostrar el enlace subyacente sin el estilo de botón.
- El componente está licenciado bajo la Licencia MIT.
El componente surgió del mismo patrón útil de [wrap] discutido en Cómo insertar un botón en una publicación de tema.
