 |
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 du dépôt | https://github.com/discourse/discourse-right-sidebar-blocks |
 |
Nouveau sur les thèmes Discourse ? | Guide pour débutants 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 meilleurs contributeurs soit remplie. Si votre liste est vide, recherchez
enable user directorydans vos paramètres administrateur pour vous assurer qu’il est activé.
* Disponible uniquement lorsqu’il est utilisé avec le plugin Calendar.
** Disponible uniquement lorsqu’il est utilisé avec le plugin Gamification.
Vous pouvez également utiliser d’autres composants Ember comme blocs, il vous suffit d’utiliser le nom correct. Par exemple, le cœur inclut un composant Ember signup-cta, et vous pouvez l’utiliser tel quel dans la barre latérale. Notez que vous ne pouvez pas utiliser des composants qui s’attendent à recevoir 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.
| name | description | default | value | available for |
|---|---|---|---|---|
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 la catégorie | id de catégorie (category-list utilise une liste séparée 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 tags exclus | noms de tags | popular-tags | |
displayInSpecificCategories |
liste des catégories pour afficher le widget | all | nombres séparés par des virgules | popular-tags |
id |
id du tableau des leaders | nombre | minimal-gamification-leaderboard | |
tag |
quel tag afficher | nom du tag | tag-topics | |
period |
période des meilleurs sujets | weekly | all, yearly, quarterly, monthly, weekly, daily | 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 pour les meilleurs contributeurs | yearly | all, yearly, quarterly, monthly, weekly, daily | top-contributors |
includeSubcategories |
inclut les événements des sous-catégories | false | false, true | upcoming-events-list |
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 tags). 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 s’affichera sur toutes les routes de découverte sauf /categories.
| Traduction | Défaut |
|---|---|
| top_contributors.heading | Meilleurs contributeurs |
| top_contributors.view_all | Voir tout |
| popular_tags.heading | Tags populaires |
| popular_tags.view_all | Voir tout |
| recent_replies.heading | Réponses récentes |
| subcategory_list.heading | Sous-catégories |
| top_topics.heading | Meilleurs sujets |
| category_list.heading | Catégories |
Captures d’écran
Notez que le composant ne comprend qu’un style très basique, l’hypothèse étant que les administrateurs utilisant le composant ajouteront leur propre style dans leur propre thème.
Interactions
Lorsqu’il est utilisé en conjonction 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 la date peut être personnalisé en suivant cette syntaxe (par exemple, MMMM D, YYYY ). Vous pouvez également configurer jusqu’où regarder dans le futur, et si les événements des sous-catégories sont inclus (voir le tableau ci-dessus)
