Potrebbe un membro dello staff @staff valutare di spostare questo argomento in Customization > Theme component? Non sono in grado di creare nuovi argomenti lì.
 |
Riepilogo | Discourse Custom Post Button trasforma i link all’interno dei post di Discourse in pulsanti stilizzati. |
 |
Repository | github.com/koloki-co/discourse-custom-post-button |
 |
Guida all’installazione | Installazione di un tema o componente di tema |
 |
Nuovo ai temi di Discourse? | Guida per principianti all’uso dei temi di Discourse |
Installa questo componente di tema
Questo è un componente di tema della community mantenuto da Koloki Ltd. Non è un componente ufficiale di Discourse. È in fase alfa, 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 post utilizzando
[wrap]. - Fornisce colore di sfondo predefinito configurabile a livello di TC, raggio del bordo, padding, peso del font, colore del testo e opacità al passaggio del mouse; 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 immagino che pochi sapranno effettivamente come farlo. È possibile anche usare Watched Words per filtrare i post contenenti
[wrap=custom-button]per l’approvazione, il che limiterebbe la funzionalità.
Installazione
In Admin > Aspetto > Temi e componenti, apri la scheda Componenti, seleziona Installa e scegli Installa da URL di repository Git. Usa:
https://github.com/koloki-co/discourse-custom-post-button
Dopo l’installazione, aggiungi il componente a ciascun 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][Testo del tuo pulsante personalizzato](https://example.com)[/wrap]
Impostazione colore per pulsante
[wrap=custom-button color=#7CC146][Testo del tuo pulsante personalizzato](https://example.com)[/wrap]
Pulsante seguito da testo esplicativo
[wrap=custom-button][Testo del tuo pulsante personalizzato](https://example.com)[/wrap]
[wrap=text-after-button]Testo esplicativo aggiuntivo[/wrap] (su una nuova riga)
Apri 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 Componente di Tema, 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][Facci una domanda](/new-message?groupname=somegroup&title=Aask%20Us&body=Please%20type%20your%20question%20here.)[/wrap]
Usa il nome slugificato del gruppo anziché il suo ‘Nome Completo’ e codifica i valori dei parametri in URL. L’impostazione Chi può inviare messaggi a questo gruppo? 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 attualmente 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 restano link e le autorizzazioni di destinazione non cambiano.
- I client di posta elettronica 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 Come incorporare un pulsante in un post di Argomento.
