 |
Riepilogo | Discourse Custom Post Button trasforma i link all’interno dei post di Discourse in pulsanti con stile personalizzato. |
 |
Repository | github.com/koloki-co/discourse-custom-post-button |
 |
Guida all’installazione | Installing a theme or theme component |
 |
Nuovi ai temi di Discourse? | Beginner’s guide to using Discourse Themes |
Installa questo componente del tema
Questo è un componente del tema della community mantenuto da Koloki Ltd. Non è un componente ufficiale di Discourse. Si trova in fase alpha, quindi potrebbero esserci bug. Si prega di segnalare i bug e richiedere funzionalità nel repository GitHub.
Screenshot
Pulsanti
Un caso d’uso specifico: un pulsante “Facci una domanda via PM”
Funzionalità
- Trasforma un link normale in un pulsante ovunque in un argomento o in un post utilizzando
[wrap]. - Fornisce colori di sfondo predefiniti, raggio degli angoli, padding, peso del font, colore del testo e opacità al passaggio del mouse configurabili a livello di TC (Theme Component), altrimenti utilizza i valori predefiniti del tuo sito.
- Consente a un pulsante singolo di sovrascrivere il colore di sfondo predefinito.
- Supporta testo esplicativo accanto a un pulsante.
- Mantiene il contenuto sottostante come link normale, in modo che i pulsanti possano aprire pagine esterne o rotte interne di Discourse come
/new-message.
IMPORTANTE: Se questo TC è installato, qualsiasi utente del tuo forum può creare questi pulsanti. Per limitare la capacità di creare pulsanti a determinati utenti sarebbe necessario un Plugin completo. Tuttavia, nella pratica, gli utenti devono sapere che è installato e come creare un pulsante, quindi ipotizzo che pochi sapranno effettivamente come farlo. È possibile anche utilizzare Watched Words per filtrare i post contenenti
[wrap=custom-button]per approvazione, il che limiterebbe la funzionalità.
Installazione
In Admin > Appearance > Themes & components, apri la scheda Components, seleziona Install e scegli Install from a Git repository URL. Usa:
https://github.com/koloki-co/discourse-custom-post-button
Dopo l’installazione, aggiungi il componente a ogni tema attivo in cui dovrebbe essere disponibile.
Utilizzo
Pulsante di base
Verrà utilizzato il colore predefinito del pulsante dalle impostazioni del TC
[wrap=custom-button][Your Custom Button Text](https://example.com)[/wrap]
Impostazione del colore per singolo pulsante
[wrap=custom-button color=#7CC146][Your Custom Button Text](https://example.com)[/wrap]
Pulsante seguito da testo esplicativo
[wrap=custom-button][Your Custom Button Text](https://example.com)[/wrap]
[wrap=text-after-button]Additional explanatory text[/wrap] (su una nuova riga)
Aprire un messaggio privato a un gruppo
(NB: Questo utilizza la funzionalità integrata di Discourse per aprire il Composer con testo precompilato - quella parte della funzionalità non proviene dal Theme Component, lo sto solo usando per dimostrare un possibile caso d’uso. Richiede che le impostazioni del gruppo consentano i PM a quel gruppo.)
[wrap=custom-button][Ask Us a Question](/new-message?groupname=somegroup&title=Aask%20Us&body=Please%20type%20your%20question%20here.)[/wrap]
Usa il nome slugificato del gruppo anziché il suo ‘Full Name’ e codifica in URL i valori dei parametri. L’impostazione Who can message this group? del gruppo determina ancora chi può aprire un composer indirizzato, e i visitatori non autenticati verranno invitati ad accedere.
Impostazioni
| Impostazione | Scopo |
|---|---|
button_default_color |
Colore di sfondo e bordo predefinito del pulsante |
button_border_radius |
Raggio degli angoli del pulsante |
button_padding |
Spazio attorno all’etichetta del pulsante |
button_font_weight |
Peso dell’etichetta del pulsante |
button_text_color |
Colore dell’etichetta del pulsante |
button_hover_opacity |
Opacità del pulsante al passaggio del mouse |
Il componente espone anche un’impostazione svg_icons per le icone del tema disponibili, ma al momento non inserisce un’icona in un pulsante del post. Aggiungerò questa funzionalità se ci sarà domanda.
Note
- Il componente modifica solo la presentazione. I pulsanti rimangono link e i permessi di destinazione non cambiano.
- I client email e altri contesti che non caricano il tema Discourse attivo potrebbero visualizzare il link sottostante senza lo stile del pulsante.
- Il componente è concesso in licenza sotto la MIT License.
Il componente è cresciuto dallo stesso utile pattern [wrap] discusso in How to embed a button into a Topic Post.
