Le fichier de configuration de votre installation est le fichier inc/config.php. Celui-ci aura été créé soit à la main, soit par l’assistant d’installation.

Nous allons voir les différentes valeurs qu’il est possible d’y ajouter, ainsi que quelques astuces pouvant s’avérer utiles.

Les paramètres du fichier de configuration sont des constantes. On les définit donc comme ceci :

define('NOM_PARAMETRE','valeur');

Type de base de données utilisée par Dotclear. Vous pouvez indiquer les valeurs suivantes :

• mysql : MySQL
• pgsql : PostgreSQL
• sqlite : SQLite

Nom d’hôte de la base de données. Notez que vous pouvez ajouter un port en suffixant le nom d’hôte de : :num-port.

Nom d’utilisateur de la base de données.

Mot de passe de l’utilisateur de la base de données.

Nom de la base de données. Dans le cas de SQLite, il s’agit du seul paramètre à indiquer et il contient le chemin vers le fichier de la base de données.

Préfixe des tables Dotclear dans la base de données. Si vous indiquez par exemple dc_, les noms de table commenceront tous par dc_.

Ce paramètre peut valoir true ou false et indique si les connexions à la base de données doivent être persistantes.

Ce paramètre est une chaîne de caractères contenant la clé privée permettant de chiffre les mots de passe stockés dans la base de données. Ne changez pas ce paramètre si Dotclear est installé, vous ne pourriez plus vous authentifier.

Adresse complète de l’interface d’administration. Cette indication est nécessaire pour le fonctionnement complet de certains plugins. L’adresse doit se terminer par un slash ("/"). Exemple :

define('DC_ADMIN_URL','http://monsite/dotclear/admin/');

Adresse email à utiliser comme émetteur des mails de récupération de mot de passe.

Nom du cookie de session. Par défaut, il s’agit de dcxd mais vous pouvez le changer par ce que vous voulez.

Ce paramètre indique le chemin d’accès aux plugins. Par défaut, il vaut dirname(__FILE__).'/../plugins' ce qui correspond au répertoire plugins de votre installation. Vous pouvez le changer ou, mieux, en ajouter d’autres. Par exemple :

define('DC_PLUGINS_ROOT',dirname(__FILE__).'/../plugins'.PATH_SEPARATOR.dirname(__FILE__).'/../../mes-plugins');

Ceci indique à Dotclear de chercher les plugins dans le répertoire plugins de Dotclear puis dans un répertoire mes-plugins à côté du dossier contenant Dotclear. Notez que les plugins du dernier répertoire défini remplacent ceux des précédents s’ils ont le même nom (ce qui peut être utile pour changer le comportement d’un plugin par défaut sans l’effacer ).

Ce paramètre indique le chemin du répertoire de cache de Dotclear.

Ce paramètre prend les valeur true ou false et indique si l’interface d’administration se trouve sur un hôte sécurisé en SSL. Le but principal de ce paramètre est de ne permettre la transmission du cookie de session que dans un contexte sécurisé.

Si ce paramètre vaut true, le scheme retourné par certaines méthodes de Dotclear pour définir son URL sera toujours https. Ceci ne doit être utilisé que si vous rencontrez des problèmes de redirection ne fonctionnant pas dans l’interface d’administration et si vous avez placé l’interface d’administration sur un hôte SSL.

Ce paramètre indique le patron de l’adresse de l’interface XML-RPC. Sa valeur par défaut est : %1$sxmlrpc/%2$s où %1$s correspond à l’URL du blog et %2$s à l’identifiant du blog.

Dotclear fournit un point d’accès XML-RPC supplémentaire dans le répertoire d’administration. Ceci permet notamment d’autoriser l’accès XML-RPC via un canal sécurisé si l’administration du blog se trouve en SSL.

Vous pouvez ainsi indiquer la valeur suivante :

define('DC_XMLRPC_URL',DC_ADMIN_URL.'xmlrpc.php?b=%2$1s');

ou encore (si votre système/hébergeur supporte le PATH_INFO) :

define('DC_XMLRPC_URL',DC_ADMIN_URL.'xmlrpc/%2$1s');

La valeur de ce paramètre est stable par défaut. Vous pouvez indiquer testing si vous souhaitez profiter des mises à jour intermédiaires à tester de Dotclear.

Si vous souhaitez couper le trafic web de votre serveur vers l’extérieur, ces deux paramètres indiquent respectivement l’hôte et le port du proxy HTTP qui seront utilisés par Dotclear pour accéder à l’extérieur.

Ce paramètre, s’il vaut true n’autorise certains aspects de la configuration de l’antispam que par un super-administrateur. (Notamment le temps de conservation du spam).

Ce paramètre, s’il vaut true n’autorise la configuration du filtre Akismet que par un super-administrateur.

Ce paramètre, s’il vaut true n’autorise la configuration du filtre DNSBL que par un super-administrateur.

Ce paramètre, s’il vaut true force l’utilisation du filtre FairTrackbacks quel que soit le choix de l’utilisateur.

Le fichier de configuration est un des tous premiers à être appelé. Il est ainsi possible d’y ajouter des éléments dont nous pouvons avoir besoin, en plus de simple constantes.

Il est possible de surcharger la fonction utilisée pour envoyer des mails. Par défaut celle-ci utilise le mécanisme standard de php (la fonction mail()). Si vous rencontrez des problèmes avec l’envoi de mails, par exemple si les mails envoyés sont trop fréquemment arrêtés par des filtres antispams, nous vous conseillons de configurer l’envoi de mail. Pour plus d’informations, reportez-vous à : Personnaliser l’envoi des mails.