### Découverte de l’interface

#### Aides contextuelles

Outre les pages d'aide globale, plusieurs pages d'administration disposent d'une aide en ligne. Si Javascript est activé sur votre navigateur, vous pouvez voir l'aide en ligne en haut à droite de la page, en cliquant sur le lien Need Help ? . Si Javascript est désactivé, l'aide est affichée en bas de la page.

Sur chaque page de l’administration, vous retrouverez les mêmes volet en haut, menu principal et pied de page. (Les emplacements de chacun de ces éléments sont indiqués ici pour une consultation sur ordinateur ; sur un mobile ou une tablette, leur emplacement varie selon la place disponible.)

#### Bandeau haut

Le volet en haut de chaque page est composé de trois éléments :

##### Logo

Par défaut, ce logo est celui de Dotclear et son lien conduit vers l’accueil de l’administration. Toutefois, un·e gestionnaire de plate-forme peut choisir un autre logo et diriger le lien vers autre chose que l’accueil (en général la page d’accueil du service).

##### Blog(s)

Le premier élément situé après le logo indique le bloc dit actif, c’est-à-dire celui sur lequel vous êtes en train d’agir. Si vous avez plusieurs blogs sur la même installation, cette information figure dans un menu déroulant qui permet de permuter sur un autre blog.

Le lien suivant le nom du blog permet d’aller voir le blog dans une autre fenêtre ou un autre onglet.

##### Utilisateur

À l’extrême droite du volet haut, le lien Mon tableau de bord permet de revenir à l’accueil du blog.

Le lien suivant, Mes préférences dirige vers la page où vous pourrez modifier vos informations personnelles, configurer votre tableau de bord et choisir vos options d’interface et d’édition.

Étonnamment, le lien Déconnecter [votre login] permet de… se déconnecter, si si. (Chez Dotclear, on est trop forts en ergo.)

#### Menu principal

Le menu principal est situé à gauche de l’écran. Il peut être rétracté en cliquant sur sa bordure droite (puis déployé en cliquant sur cette même bordure).

Il conduit vers les différentes pages d’administration correspondant à vos permissions sur le blog actif. Quatre blocs le composent

- Mes Favoris liste les pages que vous avez désignées comme telles dans l’onglet Mon tableau de bord de Mes préférences. Si vous n’avez encore choisi aucun favori, cette liste correspond au set par défaut de Dotclear ou celui du ou de la gestionnaire de la plate-forme. Si vous ne souhaitez pas afficher ce bloc, décochez la case correspondante dans vos options de tableau de bord.
- Blog répertorie toutes les pages qui permettent d'alimenter et de configurer le blog en cours, qu'il s'agisse de modifier une entrée, de gérer les médias, de choisir l'apparence du blog ou d'autres paramètres.
  Si vous n'avez pas les droits d'administrateur sur le blog en cours, il n'y aura pas d'autre bloc en dessous de celui-ci dans le menu principal.
- Réglages système offre l’accès aux pages permettant d’administrer l’installation Dotclear : gestion des blogs, utilisateur·rice·s et langues disponibles, installation d’extensions, réglages système. Si vous possédez des droits sur plusieurs blogs mais ne disposez pas du statut de super administrateur·rice, il est constitué du seul item Blogs.
- Plugins permet d’effectuer les paramétrages des plugins installés. Si les réglages d’un plugin n’impactent qu’un blog à la fois, sa page d’administration est disponible depuis le bloc Blog, mais si les réglages ont des répercussions sur toutes les pages de l’installation ils figurent ici et ne sont accessibles qu’aux utilisateur·rice·s disposant des droits de super admin.

#### Pied de page

Une version gratuite de Dotclear est offerte à tout utilisateur·rice découvrant le secret du pied de page.

### Aide aux grands débutants

Si vous n'êtes pas familier avec les blogs, nous vous recommandons de consulter notre documentation (la table des matières complète est disponible dans l'onglet Documentation de cette page) ainsi que des tutoriels tels que :

- Ma première entrée, étape par étape.

Le forum est un lieu d’entraide convivial où aucune question n’est considérée comme stupide. N’hésitez pas à y participer pour demander de l’aide et – pourquoi pas – aider d’autres utilisateurs à votre tour.

Nous nous efforçons d’utiliser un vocabulaire compréhensible sans connaissances préalables. Toutefois si nous nous sommes laissés aller à employer un terme de jargon, vous en trouverez sans doute l’explication dans le glossaire de notre documentation en ligne.

### Documentation pour les utilisateur·rice·s

#### Alimentation du blog

- Billets
  - Création et édition
  - Informations du billet
  - Actions sur le billet
  - Commentaires et rétroliens
  - Traitement par lots des billets
- Commentaires et rétroliens
  - Suivi
  - Gestion
- Catégories
  - Créer une catégorie
  - Éditer une catégorie
  - Supprimer une catégorie
  - Ordonner la liste des catégories
- Mots-clés (Tags)
  - Ajouter des mots-clés
  - Gestion des mots-clés
- Médias et pièces jointes
  - Créer un sous-répertoire
  - Ajouter des fichiers
  - Télécharger une archive zip du dossier courant
  - Modifier ou compléter les informations d'un fichier
  - Ajout direct de fichiers
  - Types de fichier particuliers
  - Pièces jointes
- Contenu du menu du blog (widgets)
  - Bandeau de navigation, volet d'extra
  - Les widgets par défaut
  - Ajouter/Supprimer un widget
  - Paramétrage des widgets
- Liste des liens
  - Liste des liens
  - Ajouter un lien
  - Ajouter une catégorie de liens
  - XFN
  - Importer depuis un fichier OPML ou XBEL

#### Paramétrage et personnalisations

- Paramètres du blog
  - Informations du blog
  - Configuration du blog
  - Commentaires et rétroliens
  - Présentation du blog
  - Médias et images
  - Paramètres d'indexation
  - Antispam
  - LightBox
  - Enregistrer
- Mes préférences
  - Mon profil
  - Mes options
  - Mon tableau de bord
- Apparence du blog
  - Choisir un thème
  - Installer un thème
  - Personnaliser un thème
  - Éditeur de thème

#### Lectures complémentaires

##### Glossaire

- Tous ces mots mystérieux utilisés dans le web et pour Dotclear

##### Syntaxes de saisie

- Syntaxe wiki et équivalent HTML
- Aller plus loin

##### Syndication RSS, Atom

- Kesako ?
- Comment les mettre à disposition ?
- Comment s'abonner ?
- En savoir plus

#### Tutoriels

- Le forum de Dotclear
- Questions fréquemment posées

### Documentation pour les administrateur·rice·s

#### Installation et mise à jour

- Installation
  - Prérequis
  - Installation automatique
  - Installation « classique »
  - Assistant d’installation
  - Mise en place manuelle du fichier config.php
  - Fin de l’installation
  - Étapes suivantes
- Mise à jour
  - Préparatifs
  - Mise à jour automatique
  - Mise à jour manuelle du programme
  - Mise à jour de la base de données
  - Annexe : mise à jour d'une copie avec mercurial
- Paramètres du fichier de configuration (config.php)
  - Introduction
  - Paramètres
  - Ajouts au fichier
- Mise à jour de Dotclear 1.2 vers 2
- Migration d'un autre système de blog à Dotclear
- Installer en local
  - Windows
  - Mac OS X
  - Linux
- Installation de Dotclear avec IIS7

##### Annexe hébergeur·euse·s

- Hébergeur·euse·s

#### Administration

- Gestion des utilisateur·rice·s
  - Liste des utilisateur·rice·s existant·e·s
  - Créer un·e utilisateur·rice
  - Modifier un·e utilisateur·rice
  - Permissions de l'utilisateur·rice
- Installation optimisée
- Installation multiblogs
- Gestion des extensions
  - Installer une extension
  - Configuration des extensions
  - Suppression d'une extension
  - Mettre à jour une extension
- Blowup, le thème par défaut
- Autre apparence
  - Choisir un thème
  - Installer un thème
  - Personnaliser un thème
  - Éditeur de thème
- Configuration avancée

#### Gestion et maintenance

- Sauvegarde et restauration
  - Import/Export
  - Médias
  - Base de données
- Filtre de commentaires indésirables
  - Organisation des filtres
  - Configuration des filtres

#### Entraide

- Le forum de Dotclear
- Questions fréquentes des administrateur·rice·s

### Documentation et ressources pour les développeur·euse·s

#### Design & Thèmes

- Thèmes
  - Guide d'utilisation des thèmes
  - Les balises template
  - Annexes
- L'héritage des thèmes
  - L'héritage des thèmes
  - Principe
  - Limitations
- Les balises de template
  - Généralités / utilitaires
  - Blog
  - Billets
  - Pagination des billets
  - Commentaires
  - Prévisualisation d'un commentaire
  - Rétroliens
  - Pièces jointes
  - Catégories
  - Mots-clés
  - Archives
  - Langues
  - Système
  - Widgets

#### Code & Plugins

- Création d’une balise tpl pour un plugin ou un thème
  - Introduction
  - Les valeurs
  - Les blocs d'instruction
  - Démonstration de l'influence du cache des templates
- Plugins
  - Réalisation de plugin
  - Documents annexes
- Construire l'aide contextuelle d'un plugin
- Authentification externe
  - Préambule
  - Une nouvelle classe d'authentification
  - Scénario
  - Application
- Interface XML/RPC
- Documentation de l'API

#### Contribution & Support

- Contribuer
  - Améliorer la documentation
  - Où envoyer vos œuvres?
  - Rapporter les bugs ou proposer une amélioration
  - Suggestions
- Le dépôt du code source de Dotclear
- Le forum de Dotclear

#### Lectures complémentaires

- Normes de programmation
- Charte des pages d'administration

### Accessibilité et ergonomie

L'interface de Dotclear répond à la quasi totalité des critères WCAG 2.0 ; un reporting précis sera prochainement publié sur le blog du projet. À terme nous aimerions également répondre pleinement aux critères ATAG 2.0.

L'accessibilité et l'ergonomie sont au cœur des préoccupations de l'équipe Dotclear. Nous menons régulièrement des analyses avec l'aide d’expert·e·s et procédons continuellement à des correctifs et améliorations.

Vous pouvez nous aider en ouvrant des tickets ou en participant au forum . Vous pouvez également participer à des tests utilisateurs ou rejoindre notre équipe !