Pourriez-vous demander à un membre du @staff de déplacer ce sujet dans Customization > Theme component ? Je ne parviens pas à créer de nouveaux sujets dans ce canal.
 |
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’usage 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 des valeurs par défaut configurables au niveau du TC (couleur de fond, rayon des coins, marge, graisse de la police, couleur du texte et opacité au survol), et utilise sinon les valeurs par défaut de votre site.
- Permet à un bouton individuel de remplacer la couleur de fond 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 cette capacité à certains utilisateurs, il faudrait un Plugin complet. Cependant, en pratique, les utilisateurs doivent savoir qu’il est installé et comment créer un bouton, donc je soupçonne que peu de personnes sauront réellement le faire. Vous pouvez également utiliser Watched Words pour filtrer les publications contenant
[wrap=custom-button]afin de les soumettre à une approbation, ce qui permettrait de restreindre cette fonctionnalité.
Installation
Dans Administration > Apparence > Thèmes & composants, ouvrez l’onglet Composants, sélectionnez Installer, puis 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 de bouton par défaut des paramètres du TC sera utilisée.
[wrap=custom-button][Votre texte de bouton personnalisé](https://example.com)[/wrap]
Couleur par bouton
[wrap=custom-button color=#7CC146][Votre texte de bouton personnalisé](https://example.com)[/wrap]
Bouton suivi d’un texte explicatif
[wrap=custom-button][Votre texte de 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 un 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’usage 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 sous forme de slug (name) plutôt que son « Nom complet » et encodez les valeurs des paramètres pour l’URL. 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 | Objectif |
|---|---|
button_default_color |
Couleur de fond 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 de la demande.
Notes
- 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 est issu du même motif [wrap] utile discuté dans Comment intégrer un bouton dans un sujet.
