 |
Résumé | Versatile Banner ajoute une bannière personnalisable à votre site. |
 |
Aperçu | Aperçu sur le Créateur de Thèmes Discourse |
 |
Lien du dépôt | https://github.com/discourse/discourse-versatile-banner |
 |
Nouveau dans les thèmes Discourse ? | Guide pour débutants sur l’utilisation des thèmes Discourse |
Installer ce composant de thème
Fonctionnalités
Ce composant de thème est une évolution des tentatives précédentes de bannières. L’objectif est de fournir plus de facilité et de flexibilité grâce à l’utilisation des paramètres du thème.
Ci-dessous, un aperçu des fonctionnalités :
- Limiter l’affichage aux utilisateurs connectés ou aux utilisateurs anonymes
- Limiter l’affichage exclusivement aux appareils mobiles ou aux ordinateurs de bureau
- Limiter l’affichage à des pages spécifiques
- Options de fermeture, d’expansion et de visibilité permanente
- Option de largeur complète du navigateur
- Gestion des couleurs
- Personnalisation de l’en-tête et des colonnes à l’aide de HTML (voir ci-dessous pour plus de détails)
- Option d’état persistant (voir ci-dessous pour plus de détails)
Personnalisation du contenu de votre bannière
Le contenu de la bannière est divisé en un en-tête principal et des colonnes. Vous pouvez avoir jusqu’à 5 colonnes sur votre bannière, cependant, le nombre recommandé est de 3 ou moins en raison des limitations de largeur. Des modèles HTML sont fournis et peuvent être personnalisés pour répondre à vos besoins individuels. Vous pouvez également contrôler la largeur de chaque colonne et ajouter n’importe quelle image ou icône Font Awesome que vous souhaitez en haut de chaque colonne.
Utilisation de l’option d’état persistant
L’option d’état persistant reposera sur jusqu’à deux cookies. Ces cookies contiendront un nom pour la bannière et une valeur vrai/faux liée à l’état de la bannière. Si vous avez des préoccupations concernant l’utilisation de cookies sur votre site, il est préférable d’éviter d’utiliser ce paramètre. Choisir une option de temps relatif pour le paramètre cookie_lifespan assurera que la bannière reste fermée/déployée/réduite pendant cette durée après que l’utilisateur a appuyé sur le bouton approprié. Sans ce paramètre, la bannière se réinitialise à chaque chargement complet de la page. Si vous apportez une modification à la bannière et souhaitez vous assurer que tous les utilisateurs voient ces modifications, même ceux qui avaient précédemment fermé la bannière, assurez-vous de modifier le “nom du cookie”. Cela réinitialisera essentiellement tout état persistant, puis permettra à l’utilisateur de fermer la bannière une nouvelle fois.
Paramètres
| Nom | Description |
|---|---|
| show for members | Afficher la bannière pour les utilisateurs connectés au forum |
| show for anon | Afficher la bannière pour les utilisateurs anonymes |
| display on mobile | Afficher la bannière sur les appareils mobiles |
| display on desktop | Afficher la bannière sur les ordinateurs de bureau |
| display on homepage | Afficher la bannière sur la page d’accueil |
| url must contain | Saisissez les chemins qui doivent afficher la bannière. Ajoutez * à la fin du chemin comme caractère générique |
| dismissible | Permettre aux utilisateurs de fermer la bannière |
| collapsible | Permettre aux utilisateurs de développer et de réduire la bannière |
| default collapsed state | État réduit par défaut lorsque le paramètre réductible est activé |
| cookie lifespan | La durée de vie du cookie utilisé pour se souvenir si la bannière a été fermée, développée ou réduite. Si défini sur “none”, AUCUN cookie ne sera utilisé avec ce composant, et tous les cookies précédemment créés liés à la bannière seront supprimés la prochaine fois qu’un utilisateur effectuera un chargement complet de la page. Les valeurs sont mesurées comme une unité unique, donc définir “year” sera une année, “week” sera une semaine, etc. |
| cookie name | Lorsque des modifications importantes sont apportées à la bannière, vous devez modifier le nom du cookie pour vous assurer que tous vos utilisateurs voient les modifications. |
| full width banner | Afficher la bannière à la largeur complète du navigateur |
| swap default positioning | S’il y a un autre composant lié à la bannière actif, utilisez ceci pour échanger sa position avec Versatile Banner |
| plugin outlet | below-site-header le place au-dessus de la barre latérale, above-main-container le place au-dessus du contenu à côté de la barre latérale |
| banner background image | L’URL source de votre image d’arrière-plan. Astuce : Vous pouvez télécharger une image sur votre thème principal et utiliser l’URL de celle-ci, mais assurez-vous de ne pas utiliser la section “Uploads” de ce composant. Tous les ajouts à ce composant seront supprimés à chaque mise à jour. |
| banner background image dark | L’URL source de votre image d’arrière-plan lorsque le mode sombre du système est détecté. |
| background color | Utilisé à la place d’une image d’arrière-plan |
| background color dark | Utilisé à la place d’une image d’arrière-plan lorsque le mode sombre du système est détecté. |
| primary text color | La couleur du texte principal de la bannière |
| primary text color dark | La couleur du texte principal de la bannière lorsque le mode sombre du système est détecté |
| secondary text color | La couleur du texte de l’icône et des en-têtes de texte, et la couleur d’arrière-plan du bouton. |
| secondary text color dark | La couleur du texte de l’icône et des en-têtes de texte, et la couleur d’arrière-plan du bouton lorsque le mode sombre du système est détecté. |
| link text color | La couleur du texte des liens dans la bannière |
| link text color dark | La couleur du texte des liens dans la bannière lorsque le mode sombre du système est détecté. |
| Traduction | Défaut |
|---|---|
| close.title | Fermer la bannière |
| close.label | Fermer |
| toggle.title | Développer/Réduire la bannière |
| toggle.collapse_label | Réduire |
| toggle.expand_label | Développer |
Hébergé par nous ? Les composants de thème sont disponibles pour une utilisation sur nos plans Pro, Business et Enterprise.