WackoWiki version 4.2 : notes d'installation

Ces notes concernent à la fois l'installation, la mise à jour (passage de la version 4.0 à la version 4.2) et la personnalisation.

Elles s'adressent aux personnes connaissant un peu LAMP (Linux, Apache, MySQL, PHP).

L'installation en bref

Soit [racine] le répertoire des données du site web (indiqué comme 'DocumentRoot' dans le fichier de configuration d'Apache httpd.conf). Pour moi c'est /var/www/html en local, /home/epsm/www chez mon hébergeur.

• Télécharger wacko.r4.2.tar.gz sur la page http://wackowiki.com/WackoDownload/InEnglish dans le répertoire [rep]
• cd [rep] && mv wacko.r4.2.tar.gz [racine] && cd [racine] && tar xzf wacko.r4.2.tar.gz
• mv wacko.r4.2 wiki && cd wiki # on accédera au wiki par [racine]/wiki
• touch wakka.config.php && chmod 666 wakka.config.php # le script de configuration doit écrire dans ce fichier
• chmod 777 xml && chmod 777 _cache && chmod 777 files && chmod 777 files/perpage # tous doivent avoir le droit d'écrire dans ces répertoires. Le dernier est protégé par un .htaccess avec la directive 'deny from all'
• ouvrir un navigateur et aller à [racine]/wiki
• effectuer l'installation en répondant aux questions
• chmod 644 wakka.config.php # Protéger en écriture le fichier de configuration avec le mot de passe MySQL

Corrections

• [racine]/wiki/db : remplacer mysql_escape_string par mysql_real_escape_string dans mysql.php, ligne 7 pour éviter que /var/log/apache/error_log soit encombré de messages 'PHP Warning: mysql_escape_string(): This function is deprecated; use mysql_real_escape_string() instead'
• [racine]/wiki/lang/lang.fr.php ligne 6 : devrait être "charset" => “iso-8859–1”, et non "charset" => “iso8859–1”,
• Pour mémoire, j'ai encore trouvé quelques corrections et traductions complémentaires à faire dans [racine]/wiki/lang/wakka.fr.php

Migration

Soit fichier.sql le résultat d'une exportation de la base de données (exploitée avec un version précédente de WackoWiki). Le préfixe précédent des tables était 'wakka_'

• Remplacer 'wakka_' par 'wiki_' dans tout le fichier fichier.sql
• démarrer un client mysql, puis taper les commandes 'use bdd;' et 'source fichier.sql;' # bdd est la base de données ; pour moi : epsm. Bien sûr on peut aussi utiliser PhpMyAdmin.

Personnalisation

Précédemment j'utilisais la version 4.0 de wackowiki, le répertoire du wiki était [racine]/wacko au lieu de [racine]/wiki ; j'avais créé le thème 'epsm' dans [racine]/wacko/themes pour intégrer le wiki au site http://epsm.fr avec une présentation homogène. Pour en tenir compte :

• copier le thème epsm dans [racine]/wiki/themes
• mettre à jour le fichier [racine]/wiki/wakka.config.php
• remplacer toutes les occurences de wacko/ par wiki/ dans les fichiers du répertoire [racine]/xhtml (il contient toutes les pages hors wiki du site http://epsm.fr)
• (uniquement pour le site epsm.fr) remplacer toutes les occurences de 'wacko' par 'wiki' dans les champs de la table 'arbre' (qui me sert à répertorier les pages hors wiki ainsi qu'à générer automatiquement la liste des pages et le menu)
• mv [racine]/wacko [racine]/wacko.old && ln -s [racine]/wacko [racine]/wiki # pour diriger vers les nouvelles adresses tous ceux qui en ont mémorisé d'anciennes (dont les moteurs de recherche).