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');

(Obligatoire)

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

• mysql : MySQL ( Obsolète à partir PHP 5.5 )
• mysqli : MySQL ( Recommandé, requiert MySQL >= 4.1 )
• pgsql : PostgreSQL
• sqlite : SQLite

(Obligatoire)

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.

Exemple :

• localhost
• autre.exemple.net:3066

(Obligatoire)

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

(Obligatoire)

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

(Obligatoire)

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.

(Obligatoire)

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_. Ceci permet d'utiliser la même base de données pour plusieurs programmes.

(Obligatoire)

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

(Obligatoire)

Ce paramètre est une chaîne de caractères contenant la clé privée permettant de chiffrer 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.

(Obligatoire)

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/');

(Obligatoire)

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

(Obligatoire)

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

(Obligatoire)

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 si un même plugin est présent dans deux répertoires, alors celui du dernier répertoire sera utilisé. De même, lors de l'installation d'un plugin depuis l'interface d'administration de Dotclear, ce plugin sera installé dans le dernier répertoire.

(Obligatoire)

Ce paramètre indique le chemin du répertoire de cache de Dotclear. Il est utilisé pour stocker temporairement des informations nécessaires au fonctionnement de Dotclear.

(Optionnel)

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é.

(Optionnel)

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.

(Optionnel)

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');

(Optionnel)

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.

(Optionnel)

Permet de spécifier le ficher qui servira à afficher les erreurs d’exécution de Dotclear telles que des problèmes de connexion à la base de donnée, d'identification d'un blog… Par défaut le fichier inc/core_error.php sera utilisé.

(Optionnel)

Par défaut le nom de vendeur sera Dotclear.

Ces paramètres peuvent être utiles pour les développeurs de plugins et thèmes.

(Optionnel)

Ceci va indiquer à Dotclear quelle version doit vous être proposée à la mise à jour. La valeur de ce paramètre est stable par défaut. Vous pouvez indiquer une des valeurs suivantes :

• stable : Dernière version stable.
• testing : Mises à jour intermédiaires en cours de test
• unstable : Tous derniers développements des futurs versions (instable)

(Optionnel)

Ceci est le mode de débogage de Dotclear. Si sa valeur est à true, il relève le niveau d'erreurs affichées. Il ne faut pas utiliser ce mode sur une installation de production.

(Optionnel)

Ceci est également un mode de débogage. Si sa valeur est à true, il génère des fichiers journaux (logs) spécifiques et permet l'accès des consoles X-debug. Ce mode ouvre également des menus supplémentaire dans l'interface d'administration des blogs pour les super-administrateurs.

(Optionnel)

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).

(Optionnel)

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

(Optionnel)

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

(Optionnel)

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.