Liens en vedette de la bannière

:information_source: Résumé Banner Featured Links vous permet de créer une bannière de liens.
:eyeglasses: Aperçu Theme Creator
:hammer_and_wrench: Dépôt GitHub - Arkshine/discourse-banner-featured-links · GitHub
:question: Guide d’installation Comment installer un thème ou un composant de thème
:open_book: Nouveau sur les thèmes Discourse ? Guide pour débutant sur l’utilisation des thèmes Discourse

Installer ce composant de thème

Résumé

Banner Featured Links vous permet de créer une bannière de liens.
Il offre une large gamme d’options de personnalisation.

C’est une fonctionnalité inspirée du fantastique thème Discourse “Meta Branded”.

Fonctionnalités

L’apparence par défaut – elle utilise la couleur du thème.
image

Le bouton peut être stylisé séparément :
image

Vous pouvez placer les liens à divers endroits via le paramètre plugin outlet.
Une liste des emplacements courants est fournie dans la description.

:information_source: Je recommande d’utiliser le composant de thème Barre d’outils développeur pour voir où se trouvent les sorties de plugin !

Par exemple, si vous souhaitez imiter le thème Meta Brand, utilisez la sortie search-banner-below-input. Cela suppose que vous avez installé le composant Search Banner.

Détails

Le style actuel peut être obtenu avec les paramètres suivants :

Je vous encourage à essayer votre propre style !

Paramètres

Général

Nom Description
links Liens textuels à afficher dans l’en-tête.
show_for_members Afficher les liens pour les utilisateurs connectés.
show_for_anon Afficher les liens pour les utilisateurs anonymes.
display_on_mobile Afficher les liens sur les appareils mobiles.
display_on_desktop Afficher les liens sur les ordinateurs de bureau.
display on homepage Afficher les liens 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.
plugin outlet L’emplacement où afficher les liens.
Emplacements courantsabove-main-containerabove-site-headerafter-headerbefore-header-panelbefore-list-areabefore-topic-listbelow-site-headerheader-list-container-bottomtopic-above-post-stream
Composant Search Banner :
search-banner-below-headlinesearch-banner-below-input

Paramètre links :

Nom Description
Icône L’icône ou l’émoji FontAwesome à afficher pour les liens.
Raccourcis
Windows : Win + ..
Mac : Cmd + Ctrl + Espace
ChromeOS : Lancer + Maj + Espace
Titre Le titre du lien.
URL L’URL vers laquelle rediriger.
Cible Ouvre le document lié :
_blank : dans une nouvelle fenêtre ou un nouvel onglet (c’est le défaut)
_self : dans le même cadre que celui sur lequel on a cliqué
_parent : dans le cadre parent
_top : dans le corps complet de la fenêtre.

Vous pouvez également styliser chaque bouton individuellement. Cela remplacera le style global.

Nom Description
Largeur La largeur du bouton.
Police La police du bouton.
Arrondi La quantité d’arrondi à appliquer au bouton.
Arrière-plan La couleur d’arrière-plan du bouton.
Arrière-plan au survol` La couleur d’arrière-plan du bouton au survol.
Couleur` La couleur du texte du bouton.
Couleur au survol` La couleur du texte du bouton au survol.
Bordure La bordure du bouton.
Bordure au survol La bordure du bouton au survol.
Ombre L’ombre du bouton.
Classe CSS Une classe CSS personnalisée à appliquer au bouton.
Utile si vous souhaitez styliser le bouton différemment et que les paramètres ne suffisent pas.
Vous pouvez cibler avec .banner-featured-links__link.votre-classe {}

Style global

Personnalisez l’espacement et l’apparence par défaut des liens.
Vous pouvez remplacer le style des boutons pour chaque lien individuellement.

Style du conteneur des boutons

Personnalisez le conteneur des liens.

Nom Description
largeur maximale du conteneur des boutons La largeur maximale du conteneur des boutons.
marge du conteneur des boutons La marge du conteneur des boutons.
largeur maximale du conteneur des boutons mobile La largeur maximale du conteneur des boutons sur mobile.
marge du conteneur des boutons mobile La marge du conteneur des boutons sur mobile.

Espacement des boutons et police de texte

Personnalisez l’espacement des boutons et la taille de la police du texte.

Nom Description
justification des boutons Comment distribuer l’espace entre et autour des liens.
espacement des boutons L’espacement entre les boutons.
police des boutons La police des boutons.
justification des boutons mobile Comment distribuer l’espace entre et autour des liens sur mobile.
espacement des boutons mobile L’espacement entre les boutons sur mobile.
direction des boutons mobile La direction des boutons sur mobile.
police des boutons mobile La police des boutons sur mobile.

Style des boutons

Personnalisez l’apparence par défaut des boutons.

Nom Description
largeur du bouton La largeur du bouton.
remplissage du bouton Le remplissage du bouton.
arrondi du bouton La quantité d’arrondi à appliquer au bouton.
arrière-plan du bouton La couleur d’arrière-plan du bouton.
arrière-plan du bouton au survol La couleur d’arrière-plan du bouton au survol.
couleur du bouton La couleur du texte du bouton.
couleur du bouton au survol La couleur du texte du bouton au survol.
bordure du bouton La bordure du bouton.
bordure du bouton au survol La bordure du bouton au survol.
ombre du bouton L’ombre du bouton.

Personnalisation avancée

Vous pouvez utiliser le CSS suivant pour personnaliser davantage :

.banner-featured-links {
  &__wrapper {

  }

  &__wrapper-links {

  }

  &__link {

  }
}

Si vous fournissez une personnalisation par bouton, vous pouvez spécifier un nom de classe dans le paramètre Classe CSS.

Ensuite, vous pouvez cibler de cette manière :

.banner-featured-links {
  &__link.ma-classe {

  }
}

Liens utiles

Crédits

  • Discourse pour l’idée, inspirée par le remarquable thème Meta Branded.
  • Don et nolo – Ils ont créé une version initiale ; j’ai repris certaines de leurs idées.
20 « J'aime »

Un commentaire méta pour améliorer une introduction de composant par ailleurs de bonne qualité : une capture d’écran d’un mobile. Cela permettrait de gagner du temps lors du choix entre l’utilité, les avantages et les inconvénients.

3 « J'aime »

Ceci a été inspiré par le thème Meta Branded ?

Je pense que oui :wink:

3 « J'aime »

J’ai dû le survoler trop rapidement - je regardais la section ‘Crédits’ :rire:

3 « J'aime »

Pas de souci. J’ai mis à jour la section des crédits pour la rendre plus claire. Merci !

3 « J'aime »

J’ai poussé un petit correctif si vous avez installé le composant pour la première fois. :+1:
Mon dernier commit a renommé un paramètre, mais les valeurs par défaut n’ont pas été mises à jour.
Merci à @manuel d’avoir signalé le problème !

5 « J'aime »

Salut @Arkshine, merci beaucoup pour ce plugin !

Je l’utilise depuis un moment, mais après avoir ajouté un autre bouton aujourd’hui, tout le forum s’est cassé et ressemble maintenant à ceci :

Savez-vous pourquoi cela pourrait arriver ?

2 « J'aime »

Hé, est-ce que cela signifie que si vous supprimez ce bouton, cela ne casse pas ?

Eh bien, j’ai dû contacter l’équipe Discourse pour désactiver le plugin, donc tout est de retour à la normale, ouais.

J’hésite maintenant à restaurer les anciens paramètres pour tester la théorie :sweat_smile:

2 « J'aime »

Je comprends, ne vous inquiétez pas. Désolé pour ça ! Vous êtes le premier à avoir ce problème. Vous souvenez-vous encore des valeurs que vous avez saisies pour le bouton ? Si je peux le reproduire, ce serait utile !

3 « J'aime »

Bien sûr, merci beaucoup pour votre aide !

C’est vraiment bizarre, car j’ai fait des modifications il n’y a pas longtemps et ça fonctionnait très bien.
J’ai supprimé un des boutons et ajouté le nouveau :

Voici les journaux, si cela peut aider

[{“url”:“Topics tagged new-widget Widgets”,“target”:“_self”,“button_color_hover”:“#197bff”},{“url”:“Topics tagged In-Progress cours”,“target”:“_self”,“button_color_hover”:“#197bff”},{“url”:“CSS Codes - Elfsight Community CSS”,“target”:“_self”,“button_color_hover”:“#197bff”},{“url”:“Ask the Community - Elfsight Community mensuels”,“target”:“_self”},{“icon”:“:trophy:”,“text”:"Rejoignez notre programme Champion ! ",“url”:“Elfsight Champion Program: Help us grow our community forum! - Announcements - Elfsight Community”}]

Précédent : [{“url” => “Topics tagged new-widget”, “icon” => “:fire:”, “text” => “Nouveaux Widgets”, “target” => “_self”, “button_color_hover” => “#197bff”}, {“url” => “Topics tagged In-Progress”, “icon” => “”, “text” => “En cours”, “target” => “_self”, “button_color_hover” => “#197bff”}, {“url” => “CSS Codes - Elfsight Community”, “icon” => “”, “text” => “Codes CSS”, “target” => “_self”, “button_color_hover” => “#197bff”}, {“url” => “Ask the Community - Elfsight Community”, “icon” => “”, “text” => “Support”, “target” => “_self”, “button_color_hover” => “#197bff”}, {“url” => “Elfsight Champion Program: Help us grow our community forum! - Announcements - Elfsight Community”, “icon” => “:trophy:”, “text” => "Rejoignez notre programme Champion ! ", “target” => “_self”}]

3 « J'aime »

Grâce à l’aide de @Helga_Razinkova en MP, j’ai pu reproduire le problème.
J’ai poussé un correctif :+1:.

En bref, le composant ne s’attendait pas à ce que les paramètres soient mis à jour via Éditeur de paramètres et une erreur s’est produite avec un champ icon manquant.

2 « J'aime »

C’est brillant ! C’est tellement complet et personnalisable ; vous semblez avoir pensé à presque tout.

J’ai remarqué un petit bug où les icônes ne sont pas visibles par moments.

Voici à quoi ressemblent mes liens :
image

Voici ce qui se passe lorsque vous :

  1. Utilisez Chrome (je n’ai pas essayé d’autres navigateurs, désolé)
  2. Quittez une page contenant les liens mis en avant de la bannière
  3. Revenez à la page en utilisant le bouton “Retour” du navigateur

image

Vous pouvez le démontrer vous-même sur ehealthforum.nz

4 « J'aime »

Merci Nathan ! J’ai apporté une correction. Dis-moi si cela se produit toujours !

4 « J'aime »

Merveilleux !!! Tout est réparé.

J’ai trouvé un autre bug d’UX mineur (mais déconcertant) :

Le texte des boutons est toujours capturé par la pseudo-classe :visited, ce qui signifie que la couleur du texte se comporte étrangement au survol une fois que chaque lien a été visité.

Ceci est sans survol :

image

Ceci est au survol avant la visite (l’icône et le texte changent)
image

Ceci est au survol après la visite (notez que l’icône change mais pas le texte)
image

3 « J'aime »

@nathank Pouvez-vous essayer de mettre à jour pour voir si c’est mieux ?

2 « J'aime »

C’était avec une instance mise à jour. Il y avait une petite PR sur la bannière de recherche, mais aucune sur ce TC à appliquer. Néanmoins, j’ai refait une compilation. Toujours là !

Cela ne s’affiche pas en mode incognito, je suppose parce qu’il n’enregistre pas mon statut de visite.

4 « J'aime »

Est-ce compatible avec le thème AIR pour servir en haut de la page Communauté avec des boutons liant vers un wordpress ?

J’essaie de placer ceux-ci sous la barre de recherche (comme sur ce site) en utilisant ‘search-banner-below-input’ pour la « Sortie de plugin » – j’ai fait des allers-retours avec l’IA et elle a expliqué que maintenant, parce que la recherche est centrale et non une extension, cet emplacement ne fonctionnerait pas. Je me demande juste si c’est correct.

1 « J'aime »