 |
Résumé | Discourse Custom Post Button transforme les liens dans les publications Discourse en boutons stylisés. |
 |
Dépôt | github.com/koloki-co/discourse-custom-post-button |
 |
Guide d’installation | Installer un thème ou un composant de thème |
 |
Nouveau aux thèmes Discourse ? | Guide du débutant pour utiliser les thèmes Discourse |
Installer ce composant de thème
Il s’agit d’un composant de thème communautaire maintenu par Koloki Ltd. Ce n’est pas un composant officiel de Discourse. Il est en version alpha, il peut donc contenir des bugs. Veuillez signaler les bugs et demander des fonctionnalités dans le dépôt GitHub.
Captures d’écran
Boutons
Un cas d’utilisation spécifique : un bouton « Posez-nous une question par MP »
Fonctionnalités
- Transforme un lien normal en bouton n’importe où dans un sujet ou une publication à l’aide de
[wrap]. - Fournit une couleur d’arrière-plan par défaut, un rayon de bordure, un rembourrage, une graisse de police, une couleur de texte et une opacité au survol configurables au niveau du composant de thème (TC) ; sinon, les valeurs par défaut de votre site sont utilisées.
- Permet à un bouton individuel de remplacer la couleur d’arrière-plan par défaut.
- Prend en charge le texte explicatif à côté d’un bouton.
- Conserve le contenu sous-jacent en tant que lien normal, de sorte que les boutons peuvent ouvrir des pages externes ou des routes internes Discourse telles que
/new-message.
IMPORTANT : Si ce TC est installé, tout utilisateur de votre forum peut créer ces boutons. Pour restreindre la capacité de créer des boutons à certains utilisateurs, un Plugin complet serait nécessaire. Cependant, en pratique, les utilisateurs doivent savoir qu’il est installé et comment créer un bouton, donc je soupçonne que peu sauront réellement comment faire. Vous pouvez également utiliser les Mots surveillés pour filtrer les publications contenant
[wrap=custom-button]pour approbation, ce qui permettrait de restreindre cette fonctionnalité.
Installation
Dans Administration > Apparence > Thèmes et composants, ouvrez l’onglet Composants, sélectionnez Installer et choisissez Installer depuis une URL de dépôt Git. Utilisez :
https://github.com/koloki-co/discourse-custom-post-button
Après l’installation, ajoutez le composant à chaque thème actif où il doit être disponible.
Utilisation
Bouton de base
La couleur du bouton par défaut issue des paramètres du TC sera utilisée.
[wrap=custom-button][Texte de votre bouton personnalisé](https://example.com)[/wrap]
Paramètre de couleur par bouton
[wrap=custom-button color=#7CC146][Texte de votre bouton personnalisé](https://example.com)[/wrap]
Bouton suivi d’un texte explicatif
[wrap=custom-button][Texte de votre bouton personnalisé](https://example.com)[/wrap]
[wrap=text-after-button]Texte explicatif supplémentaire[/wrap] (sur une nouvelle ligne)
Ouvrir un message privé à un groupe
(NB : Cela utilise la fonctionnalité intégrée de Discourse pour ouvrir le Composer avec du texte prérempli - cette partie de la fonctionnalité ne provient pas du composant de thème, je l’utilise simplement pour démontrer un cas d’utilisation possible. Nécessite que les paramètres du groupe autorisent les MP à ce groupe.)
[wrap=custom-button][Posez-nous une question](/new-message?groupname=somegroup&title=Aask%20Us&body=Please%20type%20your%20question%20here.)[/wrap]
Utilisez le nom du groupe slugifié plutôt que son « Nom complet » et encodez en URL les valeurs des paramètres. Le paramètre Qui peut envoyer un message à ce groupe ? du groupe détermine toujours qui peut ouvrir un composer adressé, et les visiteurs non connectés seront invités à se connecter.
Paramètres
| Paramètre | But |
|---|---|
button_default_color |
Couleur d’arrière-plan et de bordure par défaut du bouton |
button_border_radius |
Rayon des coins du bouton |
button_padding |
Espace autour de l’étiquette du bouton |
button_font_weight |
Graisse de l’étiquette du bouton |
button_text_color |
Couleur de l’étiquette du bouton |
button_hover_opacity |
Opacité du bouton au survol |
Le composant expose également un paramètre svg_icons pour les icônes de thème disponibles, mais il n’insère actuellement pas d’icône dans un bouton de publication. J’ajouterai cette fonctionnalité s’il y a une demande à ce sujet.
Remarques
- Le composant ne modifie que la présentation. Les boutons restent des liens et les autorisations de destination ne sont pas modifiées.
- Les clients de messagerie et d’autres contextes qui ne chargent pas le thème Discourse actif peuvent afficher le lien sous-jacent sans le style du bouton.
- Le composant est sous licence MIT License.
Le composant a grandi à partir du même motif utile [wrap] discuté dans Comment intégrer un bouton dans une publication de sujet.
