Guide d'utilisation pour l'administrateur

Guide d'utilisation pour l'administrateur

Comment...

1. Se connecter en tant qu'administrateur ?
2. Modifier des paramètres une fois connecté ?
3. Mettre en place l'identification via Twitter ?
4. Mettre en place l'identification via Facebook ?
5. Créer de nouvelles catégories ?
6. Mettre en place l'upload de fichiers ?
7. Personnaliser mon forum avec de nouveaux styles CSS, logos, etc.

## Se connecter en tant qu'administrateur

Travailler avec les données fictives

Un compte administrateur est créé lors de l'installation par défaut de Discourse :

Nom d'utilisateur : eviltrout
Mot de passe : password

Vous pouvez vous connecter via le bouton bleu "Se connecter", en haut à droite de Discourse.

Démarrer à partir de zéro (base de donnée vide)

Si vous choisissez d'installer Discourse avec une base de données vide, vous aurez besoin de créer un premier compte administrateur avant de pouvoir vous connecter. Vous pouvez le créer en exécutant ce script :

bundle exec rails c
u = User.where(username: 'xyz').first
email_token = u.email_tokens.create(email: u.email)  
EmailToken.confirm(email_token.token)  
u.admin = true
u.save()

Remplacez simplement xyz par le nom d'utilisateur que vous souhaitez utiliser pour le compte administrateur. Discourse vous demandera de changer votre mot de passe lors de votre première connexion.

## Modifier des paramètres une fois connecté

La console d'administration de Discourse est disponible en ajoutant /admin à l'url de base de votre forum. Si vous avez suivis le guide d'installation par défaut, l'url complète est :

http://localhost:4000/admin

D'ici, vous pouvez accéder aux sections administratives suivantes :

• Paramètres du site
• Utilisateurs
• Journal des emails
• Modération
• Personnalisation

## Mettre en place l'identification via Twitter

1. Dans la console d'administration, cliquez sur Paramètres du site.
2. Faire défiler vers le bas jusqu'aux champs nommés :

twitter_consumer_key
twitter_consumer_secret

3. Renseignez-y la clé et le secret qui vous ont été donné via dev.twitter.com. Si vous n'êtes pas sûr de connaître votre clé ou secret, ou ne les avez jamais encore obtenu, rendez-vous sur la FAQ de Twitter Dev pour en savoir plus sur comment obtenir ces clés.

## Mettre en place l'identification via Facebook

1. Dans la console d'administration, cliquez sur Paramètres du site.
2. Faire défiler vers le bas jusqu'aux champs nommés :

facebook_app_id
facebook_app_secret

3. Renseignez-y l' id et le secret qui vous ont été donné via developers.facebook.com. Si vous n'êtes pas sûr de connaître votre id ou secret, ou ne les avez jamais encore obtenu, rendez-vous sur la page Facebook Developers :: Access Tokens and Types pour plus d'informations.

## Créer de nouvelles catégories/tags

Les catégories sont des labels colorés utilisés pour définir les discussions ayant un même centre d'intérêt dans Discourse. Ils peuvent également faire office de tags et sont entièrement personnalisable :

1. Connectez-vous à Discourse en utilisant le compte qui dispose d'un accès administrateur.
2. Cliquez sur le bouton "Catégories" dans la barre de navigation en haut du site.
3. Cliquez sur le bouton "Créer une catégorie".
4. Renseignez le nom de la catégorie que vous souhaitez créer et choisissez une couleur hexadécimale dans la pop up associée.

## L'upload de fichiers

Discourse ne permet pas encore l'upload de fichiers. Cependant, cette fonctionnalité est en train d'être développée et sera disponible très bientôt. Nous mettrons alors à jour ce guide (Reference).

## Styles CSS & En-tête personnalisés

1. Pour personnaliser les styles de votre Discourse, vous devez vous rendre dans la console d'administration puis cliquer sur "Personnaliser".
2. L'écran est composé de 2 parties : une liste de styles dans la colonne de gauche et un éditeur permettant de modifier les styles "CSS" et "l'En-tête" sur la droite.
3. Insérez vos styles CSS personnalisés dans la section "CSS" (veillez à respecter les conventions CSS).
4. Insérez votre code HTML afin de personnaliser votre en-tête dans la section du même nom.
5. Si vous voulez que vos modifications prennent effet immédiatement sur votre site, cochez la case "Activer" et cliquez ensuite sur le bouton "Sauvegarder".
6. Si vous souhaitez prévisualiser vos modifications avant de les sauvegarder, cliquez sur le bouton "Prévisualiser" en bas de l'écran. Une nouvelle fenêtre s'ouvrira dans laquelle vous pourrez voir les modifications que vous aurez sauvegardées.
7. Si vous souhaitez surcharger les styles du site par défaut, veillez à cocher la case "Surcharger les styles par défaut".

Exemple de logo d'en-tête

Voici un exemple de code HTML que vous pouvez insérer dans la section "En-tête" :

<div class='myheader' style='text-align:center;background-color:#CDCDCD'>
<a href="/"><img src="http://dummyimage.com/1111x90/CDCDCD/000000.jpg&text=Mon+Logo" width="1111px" height="90px" border="0" /></a>    
</div>