# Configuration du thème et des composants

## Comment ça marche ?

### Configuration du thème

Les couleurs par défaut peuvent être modifier avec votre palette de couleurs dans `Customize / Colors`. Pour plus d'information sur les palettes de couleurs [voir ici](https://meta.discourse.org/t/how-to-create-and-share-a-color-scheme/61196).

**Trois composants sont utilisés dans notre thème :**

- _Versatile Banner_
- _Categories boxes_
- _Showcased Categories_

### Bannière _How to begin ?_

C'est le composant **_Versatile Banner_** qui est utilisé pour cette banière.

- Doc : https://meta.discourse.org/t/versatile-banner/109133
- Dépôt : https://github.com/tshenry/discourse-versatile-banner.git

#### Configuration

La bannière s'affiche pour tout le monde et il est possible de la masquer mais pas de l'enlever.
Elle apparaît sur les pages :

- `/latest`
- `/categories`
- `/new`
- `/unread`
- `/top*`
- `/tag/*`
- `/tags/*`
- `/c/*`
- `/t/*`

Il n'y a pas de fond ni d'image de fond, il est néanmoins possible d'en ajouter.

Ensuite il faut configuer le contenu de la bannière : texte, images dans chaque colonnes en ecrivant le code HTML.

Pour personnaliser les images de la banière, il faut les ajouter dans la categorie accessible uniquement par [les responsables](https://meta.discourse.org/t/upload-image-in-discourse/141504/4). 

Pour se faire, créez un post avec une image dans la catégorie _staff_ (privée). parcourir le post créée qui affiche l'image et faite un clic droit pour **copier le lien de l'image**. Puis, coller ce lien dans la page configuration du composant, section `Column Icons`.
[Pour plus d'information voir ici](https://meta.discourse.org/t/upload-image-in-discourse/141504/4)

---

### Categories boxes

Ce composant est inspiré du composant **_Categories Layout Override_**. C'est luis qui affiche les boîtes de categories.

- Doc : https://meta.discourse.org/t/categories-layout-override/131098
- Dépôt : https://github.com/tshenry/discourse-categories-layout-override
- [ ] TODO mettre le lien de notre dépot


---

### Category post

Le composant **_Showcased Categories_** présente deux boîtes avec une liste de 4 postes.

- Doc : https://meta.discourse.org/t/showcased-categories-theme-component/173524
- Dépôt : https://github.com/discourse/discourse-showcased-categories.git

#### Configuration

Défini la taille en nombre de post maximum du contenu des boîtes et les catégories qui seront dans les boites contenu : _Latest_ et _Top_.