====== Dokuwiki ======

===== Installation =====

Sur une debian :

   - aller sur la [[http://download.dokuwiki.org/|page de download de dokuwiki]] et sélectionner ce qui est nécessaire (par exemple en limitant aux langues nécessaires et en ajoutant les plugins populaires désirés).
   - télécharger le tar.gz proposé.
   - ''tar xvfz [dokuwiki].tar.gz'' pour décompresser l'archive
   - ''mv [dokuwiki/] /var/www/html/'' pour placer les sources au bon endroit (dans un apache2.4, par exemple), on peut profiter pour renommer le répertoire si désiré.
   - ''cd /var/www/html''
   - ''chown -R www-data:www-data [dokuwiki/]'' pour donner au serveur web les droits en écriture dans le répertoire
   - il est nécessaire de configurer son serveur web, notamment pour empêcher l'indexation du répertoire ''data/''.
   - dans le navigateur se diriger sur http://[serveur]/[dokuwiki]/install.php et suivre les instructions.
   - ''cd [dokuwiki/] && rm install.php'' pour supprimer le script d'installation, une fois celle-ci faite.

===== Changement du logo et du favicon =====

Il y a plusieurs méthodes, mais si on a accès aux sources alors il faut changer le fichier :

  lib/tpl/dokuwiki/images/logo.png

Les favicon se trouvent au même endroit.

===== Mail de notification =====

==== Plugin SMTP ====

Si la mise en place d'un serveur mail (par exemple postfix) n'est pas envisagée ou possible, il existe un plugin bien pratique : [[https://www.dokuwiki.org/plugin:swiftmail|SwiftMail]]

Il permet d'indiquer un serveur SMTP alternatif.

==== Modification du contenu des messages ====

Il peut y avoir plusieurs raisons de modifier le contenu des messages de notification. Par exemple, lors de la création de nouveaux utilisateurs, celui-ci peut-être notifié par email de son nouveau compte, //y compris son mot de passe//.

Le texte de l'e-mail pourrait par exemple conseiller à l'utilisateur de modifier son mot de passe.

Il faut modifier le fichier suivant :

  inc/lang/fr/password.txt

Bien entendu, il s'agit là du texte en français, il est nécessaire de modifier les fichiers des autres langues utilisées...

Pour modifier les autres messages, c'est la même méthode.

===== Mise à jour =====

La doc : https://www.dokuwiki.org/install:upgrade

Ce qui revient à :

   wget http://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz
   tar zxvf dokuwiki-stable.tgz
   cp -R /contenu/répertoire/extrait/* /chemin/de/install/dokuwiki/
   chown -R www-data:www-data /chemin/de/install/dokuwiki/*

En gros, c'est fait.

Encore plus simple : utiliser le plugin [[https://www.dokuwiki.org/plugin:upgrade|Dokuwiki Upgrade]]. Testé, il fonctionne correctement.