 |
Résumé | Support communautaire - don configurable |
 |
Aperçu | Theme Creator |
 |
Dépôt | GitHub - VaperinaDEV/community-support: Community Support - configurable donation · GitHub |
 |
Vous avez trouvé cela utile ? | ./support --coffee |
 |
Guide d’installation | Comment installer un thème ou un composant de thème |
 |
Nouveau aux thèmes Discourse ? | Guide du débutant pour l’utilisation des thèmes Discourse |
Installer ce composant de thème
Bonjour 
L’objectif était de le rendre suffisamment flexible pour s’adapter à des conceptions et cas d’utilisation communautaires très différents, tout en gardant la configuration entièrement dans les Paramètres du thème.
Fonctionnalités
Fenêtre modale de don / soutien
Le composant peut afficher automatiquement une fenêtre modale de soutien de manière optionnelle.
La fenêtre modale automatique prend en charge :
- délai d’ouverture configurable
- visibilité basée sur l’URL/le chemin
- visibilité pour les membres/les utilisateurs anonymes
- niveau de confiance minimal
- groupes exclus
- durée de vie du cookie de fermeture configurable
- trois tailles de fenêtre modale :
normal,large,maximized
La fenêtre modale peut également être ouverte manuellement n’importe où en utilisant :
#donate
Ceci est intentionnellement indépendant des règles de visibilité automatique, afin qu’une communauté puisse partager un lien #donate ou l’ajouter à la barre latérale tout en contrôlant où les sollicitations de soutien automatiques apparaissent.
Méthodes de don / soutien
Plusieurs méthodes de soutien peuvent être configurées à l’aide de l’éditeur de paramètres d’objets de Discourse.
Chaque méthode peut avoir :
- nom
- description
- fournisseur
- propriétaire
- icône
- URL
- texte du bouton
- valeur copiable
- état de mise en avant
- traductions
Ceci est indépendant du fournisseur, de sorte que le composant n’exige pas un fournisseur de paiement spécifique.
Par exemple, une méthode peut simplement pointer vers une page de paiement/soutien existante sur PayPal, Revolut, Wise ou autre.
Localisation par méthode
Les méthodes de don prennent en charge leurs propres traductions.
Le sélecteur de langue inclut les langues disponibles de Discourse, et chaque méthode peut être traduite pour :
- nom
- description
- texte du bouton
- libellé de copie
- propriétaire
- fournisseur
Si une langue exacte n’est pas disponible, le composant bascule sur la langue de base, puis sur l’anglais ou une autre traduction disponible.
Objectif de soutien et barre de progression
Le composant inclut un objectif de soutien et une barre de progression optionnels.
Vous pouvez configurer :
- montant actuel
- montant cible
- devise
- libellé de soutien
- période de soutien
- affichage de la progression
- emplacement de la barre de soutien
Périodes prises en charge :
- ponctuel
- mensuel
- annuel
La barre de progression gère également le soutien au-delà de l’objectif.
Au lieu de simplement s’arrêter à 100 %, le pourcentage réel continue d’être affiché :
75% → progression normale
100% → objectif atteint
125% → 25 % dans le prochain cycle d'objectif
220% → 20 % dans le troisième cycle d'objectif
La barre de progression visuelle reste une seule barre compacte.
Avant le premier objectif :
background: tertiary-low
fill: tertiary
À exactement 100 %, 200 %, 300 %, etc. :
background: success
fill: success
Entre les jalons :
background: success-low
fill: success
Cela signifie qu’une communauté peut continuer à afficher une progression significative même lorsqu’elle dépasse largement son objectif initial.
Avatars des soutiens
La barre de soutien peut afficher optionnellement les avatars des soutiens.
Les soutiens sont actuellement configurés manuellement via le paramètre d’objet supporters.
Chaque soutien peut avoir :
- nom d’utilisateur
- montant de la contribution
- devise
Le nom d’utilisateur est résolu par rapport au profil utilisateur, de sorte que les informations de profil/avatar de l’utilisateur peuvent être affichées automatiquement.
Le nombre d’avatars affichés directement dans la barre de soutien est configurable.
Par exemple :
◉ ◉ ◉ ◉ ◉ +8
S’il y a plus de soutiens que le nombre d’avatars visibles configuré, les soutiens restants sont accessibles via un DMenu.
Le menu des soutiens peut afficher :
- avatar
- nom d’utilisateur
- lien du profil
- montant de la contribution
- devise
Les montants de contribution peuvent être activés ou désactivés indépendamment.
Les soutiens peuvent également être remplis à partir d’un ou plusieurs groupes à l’aide du paramètre supporter_groups. Cela complète la liste des soutiens configurée manuellement plutôt que de la remplacer.
Plusieurs designs
Le composant inclut trois designs visuels indépendants :
- Classique : présentation équilibrée de style communautaire
- Minimal : éléments visuels réduits et présentation compacte
- Moderne : hiérarchie plus forte et cartes plus proéminentes
Le design est indépendant de la vue sélectionnée, de sorte que les deux peuvent être combinés librement.
Plusieurs vues
Le composant prend en charge plusieurs modes de présentation :
- Complète : contenu de soutien complet avec héros, méthode mise en avant et méthodes de don
- Compacte : présentation réduite pour des emplacements plus petits
- Minimale : présentation axée sur les méthodes
- Progression : objectif de soutien et progression uniquement
Cela permet d’utiliser le même composant dans des emplacements très différents sans dupliquer la configuration ou le style.
Intégrations dans les publications
Le contenu de soutien peut être intégré directement dans les publications.
Activez enable_post_embed, puis utilisez :
[wrap=donate]
[/wrap]
Des vues supplémentaires sont disponibles directement via l’enveloppe :
[wrap=donate-compact]
[/wrap]
[wrap=donate-minimal]
[/wrap]
[wrap=donate-progress]
[/wrap]
L’enveloppe contrôle la vue, tandis que le paramètre global design contrôle le design visuel.
Cela est utile lorsque le contenu de soutien doit faire partie du contexte d’une publication particulière plutôt que d’apparaître comme un élément d’interface global.
Prise en charge des prises de plugin
Le composant peut rendre le widget de soutien via des prises de plugin.
Activez outlet_enabled et spécifiez les noms de prise souhaités dans outlet_locations, séparés par |.
La vue et le design de la prise peuvent être configurés indépendamment :
outlet_viewoutlet_design
Cela permet d’utiliser le composant de soutien dans des emplacements tels que les listes de sujets, les en-têtes, les pieds de page et d’autres prises prises en charge.
Compatibilité avec Discourse Ads
Le composant peut également être utilisé avec le plugin Discourse Ads.
Au lieu de dépendre directement du plugin Ads, Community Support fournit un marqueur d’intégration HTML stable :
<div data-donation-widget="support"></div>
Ceci peut être copié dans une publicité HTML et placé dans la prise Ads souhaitée.
Le composant possède le balisage et le CSS, il n’est donc pas nécessaire de dupliquer le style du don dans la publicité elle-même.
La vue et le design peuvent être remplacés optionnellement :
<div
data-donation-widget="support"
data-view="compact"
data-design="minimal"
></div>
Cela signifie que le même système de soutien peut être réutilisé dans différents emplacements Ads tout en maintenant un design cohérent.
Intégrations HTML génériques
Le même mécanisme d’intégration peut également être utilisé dans d’autres emplacements compatibles avec HTML :
<div data-donation-widget="support"></div>
Le marqueur HTML reste intentionnellement simple tandis que le composant de thème gère le rendu réel.
Cela permet de modifier le design ou l’implémentation du composant sans avoir à réécrire chaque intégration individuelle.
Contrôles de visibilité
Le contenu de soutien automatique et globalement rendu peut être contrôlé par plusieurs paramètres :
- Afficher pour les membres
- Afficher pour les utilisateurs anonymes
- Niveau de confiance minimal
- Groupes exclus
- Afficher sur la page d’accueil
- Correspondance d’URL/chemin
Les groupes exclus sont appliqués au contenu de soutien rendu automatiquement, tel que la fenêtre modale, les widgets de prise de plugin et les intégrations génériques.
Le contenu contextuel reste disponible :
#donate[wrap=donate]
Cela permet d’exclure certains utilisateurs de l’interface de soutien promotionnelle/automatique sans les empêcher d’accéder à un lien de soutien explicitement partagé ou à un bloc de soutien contextuel.
Fermeture / contrôle des cookies
Lorsque la fenêtre modale ouverte automatiquement est fermée, le composant peut mémoriser cette décision.
La durée de vie du cookie peut être configurée comme suit :
- aucune
- minute
- jour
- semaine
- mois
- année
Cela empêche la fenêtre modale automatique d’apparaître de manière répétée au même visiteur selon la durée de vie sélectionnée.
Exemples de base
Ouvrir la fenêtre modale de soutien
#donate
Intégrer le contenu de soutien dans une publication
[wrap=donate]
[/wrap]
Version compacte de publication
[wrap=donate-compact]
[/wrap]
Intégration HTML générique
<div data-donation-widget="support"></div>
Intégration avec présentation personnalisée
<div
data-donation-widget="support"
data-view="compact"
data-design="minimal"
></div>