Contrôle de la visibilité des avis

[Moin]

	Résumé	Personnalisez la visibilité et le style des avis de publication par type et par âge
	Dépôt	GitHub - moin-Jana/post-notice-visibility-control: Customize visibility and style of post notices by type and age
	Guide d’installation	Comment installer un thème ou un composant de thème
	Nouveau aux thèmes Discourse ?	Guide pour débutants sur l’utilisation des thèmes Discourse

Installer ce composant de thème

Ce composant vous permet de contrôler l’apparence de chaque type d’avis de publication (nouvel utilisateur, utilisateur de retour et officiel) sur les nouvelles publications et les anciennes. Vous pouvez choisir s’ils sont mis en surbrillance, visibles ou masqués, et définir des couleurs de surbrillance personnalisées indépendamment pour chaque type.

Les captures d’écran montrent des exemples de l’apparence des différents types sur les nouvelles publications (à gauche) et les anciennes publications (à droite) :

Exemple de configuration 1

"custom_new": "highlighted"
"custom_old": "highlighted"
"custom_highlight_color": "var(--danger-low-mid)"

"new_user_new": "highlighted"
"new_user_old": "visible"
"new_user_highlight_color": "var(--success-low)"

"returning_user_new": "highlighted"
"returning_user_old": "hidden"
"returning_user_highlight_color": "var(--primary-200)"

Exemple de configuration 2

"custom_new": "highlighted"
"custom_old": "visible"
"custom_highlight_color": "var(--gold)"

"new_user_new": "visible"
"new_user_old": "hidden"
"new_user_highlight_color": "var(--tertiary-low)"

"returning_user_new": "visible"
"returning_user_old": "hidden"
"returning_user_highlight_color": "var(--tertiary-low)"

Pour chaque combinaison de type d’avis et d’âge, vous pouvez choisir si l’avis doit être mis en surbrillance, visible (sans surbrillance) ou masqué. Si vous choisissez « mis en surbrillance », vous pouvez éventuellement définir une couleur d’arrière-plan personnalisée.

Je recommande d’utiliser une variable de couleur comme var(--quaternary-low). Ces variables font référence aux couleurs de la palette de couleurs active, elles s’adaptent donc automatiquement lorsqu’un utilisateur bascule entre différentes palettes (par exemple, mode clair et mode sombre). Cela en fait une option plus flexible que les couleurs codées en dur. Bien que la plupart des palettes de couleurs n’affichent que quelques couleurs de base, Discourse génère des nuances de ces couleurs que vous pouvez également utiliser. Vous pouvez explorer de nombreuses variables de couleur disponibles à l’aide du guide de style, que vous pouvez activer via le paramètre de site styleguide enabled. Alternativement, vous pouvez inspecter votre site dans le navigateur : ouvrez les outils de développement, accédez à l’onglet Styles et faites défiler vers le bas pour voir toutes les variables de couleur disponibles.

Vous pouvez également utiliser des valeurs hexadécimales comme #EE8888, des valeurs RVB comme rgb(255, 200, 200) ou des noms de couleurs comme red.

Si aucune couleur n’est fournie, le composant utilise par défaut var(--tertiary-low). Les paramètres par défaut du composant reproduisent le comportement standard de Discourse ; ainsi, le simple fait de l’activer ne changera rien tant que vous ne l’aurez pas configuré.

Le nombre de jours après lesquels un avis de publication est considéré comme « ancien » est défini par le paramètre de site old post notice days. Cela s’applique aux trois types d’avis.
Important : L’âge est basé sur la date de création de la publication – et non sur la date d’ajout de l’avis.
Vous pouvez temporairement définir la valeur sur 0 pour prévisualiser facilement l’apparence des avis dans leur état « ancien ».

[Moin]

Les avis de publication anciens ne sont plus rendus dans la dernière version de Discourse, ce qui signifie qu’ils ne peuvent pas être stylisés via CSS. Par conséquent, tous les paramètres _old n’ont plus aucun effet.

[Moin]

Avec les dernières mises à jour de Discourse, la classe old que le composant utilisait pour appliquer des styles différents aux nouvelles notifications et aux anciennes a été supprimée. Les notifications de publication pour les nouveaux utilisateurs et les utilisateurs de retour seront désormais automatiquement supprimées après le réglage old post notice days (jours de notification de publication ancienne), tandis que les notifications officielles restent visibles en permanence et mises en évidence.

Par conséquent, ce composant est devenu largement obsolète. Les seules options de personnalisation restantes concernent les réglages généraux de couleur pour les notifications de publication. Celles-ci peuvent être facilement ajustées via CSS, comme montré ci-dessous :

.post-notice.custom {
    background-color: var(--danger-low-mid);
}
.post-notice.new-user {
    background-color: var(--success-low);
}
.post-notice.returning-user {
    background-color: var(--primary-200);
}

Si vous souhaitez supprimer la mise en surbrillance de l’arrière-plan pour un type de notification spécifique, utilisez simplement background-color: unset;.