 |
Résumé | Right Sidebar Blocks affiche une barre latérale à droite des listes de sujets avec une liste configurable de blocs. |
 |
Aperçu | Aperçu sur Discourse Theme Creator |
 |
Lien vers le dépôt | https://github.com/discourse/discourse-right-sidebar-blocks |
 |
Nouveau sur les thèmes Discourse ? | Guide pour débutant sur l’utilisation des thèmes Discourse |
Installer ce composant de thème
Fonctionnalités
Le composant inclut quelques blocs que vous pouvez afficher dans la barre latérale :
- popular-tags
- top-contributors
- recent-replies
- category-topics
- custom-html
- category-list
- subcategory-list
- upcoming-events-list*
- minimal-gamification-leaderboard**
Le répertoire des utilisateurs doit être activé pour que la liste des principaux contributeurs soit remplie. Si votre liste est vide, recherchez
enable user directorydans vos paramètres d’administration pour vous assurer qu’il est activé.
* Disponible uniquement lors de l’utilisation avec le plugin Calendar.
** Disponible uniquement lors de l’utilisation avec le plugin Gamification.
Vous pouvez également utiliser d’autres composants Ember comme blocs, il vous suffit d’utiliser le bon nom. Par exemple, le noyau inclut un composant Ember signup-cta, que vous pouvez utiliser tel quel dans la barre latérale. Notez que vous ne pouvez pas utiliser de composants qui attendent un ensemble de paramètres, mais vous pouvez créer votre propre composant Ember dans un thème séparé et le référencer simplement par son nom dans le paramètre blocks de la barre latérale.
Vous pouvez contrôler certaines fonctionnalités pour les blocs fournis via des paramètres.
| nom | description | défaut | valeur | disponible pour |
|---|---|---|---|---|
count |
limite le nombre de résultats | varie | nombre | tous sauf custom-html |
excerptLimit |
limite la longueur de chaque extrait de réponse | 150 | nombre | recent-replies |
id |
id de catégorie | id de catégorie (category-list utilise des valeurs séparées par des virgules) | category-topics, category-list | |
content |
contenu à afficher | html | custom-html | |
scopeToCategory |
n’affiche que dans la catégorie ou sous-catégorie X | id de catégorie | popular-tags | |
excludedTags |
liste des balises exclues | noms de balises | popular-tags | |
displayInSpecificCategories |
liste des catégories où afficher le widget | toutes | nombres séparés par des virgules | popular-tags |
id |
id du classement | nombre | minimal-gamification-leaderboard | |
tag |
quelle balise afficher | nom de la balise | tag-topics | |
period |
période temporelle des sujets principaux | hebdomadaire | toutes, annuelles, trimestrielles, mensuelles, hebdomadaires, quotidiennes | top-topics |
title |
titre du bloc | varie | chaîne | tag-topics, category-list, top-contributors |
excludedGroupNames |
Exclut les groupes spécifiés | Noms de groupes | top-contributors | |
order |
Trie les contributeurs | Chaîne (likes_received ou likes_given) | top-contributors | |
period |
Période temporelle pour les principaux contributeurs | annuelle | toutes, annuelles, trimestrielles, mensuelles, hebdomadaires, quotidiennes | top-contributors |
upcomingDays |
Événements commencés avant la valeur fournie | 180 | nombre | upcoming-events-list |
timeFormat |
Format de la date/heure de l’événement | LT | format momentjs | upcoming-events-list |
Paramètres
| Nom | Description |
|---|---|
| blocks | |
| show in routes | Utilisateurs avancés uniquement : limiter la barre latérale aux routes sélectionnées. Exemples : discovery.latest, discovery.unread, discovery.new, discovery.top, tag.show, “c/category-slug” (pour les catégories), “tag/sample-tag” (pour les balises). Lorsqu’il est vide, la barre latérale est affichée sur toutes les routes de liste. |
blocks : choisissez les blocs à afficher et ajustez leur ordre
show_in_routes : décidez sur quelles routes de liste de sujets afficher la barre latérale. Par défaut, elle l’affiche sur toutes les routes de découverte sauf /categories.
| Traduction | Défaut |
|---|---|
| top_contributors.heading | Principaux contributeurs |
| top_contributors.view_all | Voir tous |
| popular_tags.heading | Balises populaires |
| popular_tags.view_all | Voir tous |
| recent_replies.heading | Réponses récentes |
| subcategory_list.heading | Sous-catégories |
| top_topics.heading | Sujets principaux |
| category_list.heading | Catégories |
Captures d’écran
Notez que le composant est livré avec un style très basique ; l’hypothèse est que les administrateurs utilisant le composant ajouteront leur propre style dans leur propre thème.
Interactions
Lorsqu’il est utilisé conjointement avec le plugin Discourse Calendar, vous pouvez ajouter un bloc de barre latérale pour vos événements à venir. Le nom du bloc est upcoming-events-list, et le format de date peut être personnalisé en suivant cette syntaxe (par exemple, MMMM D, YYYY).
Hébergé par nous ? Les composants de thème sont disponibles pour une utilisation sur nos offres Pro, Business et Enterprise.