Configurer YesWiki : le fichier wakka.config.php

Une fois le YesWiki créé, on peut aller éditer le fichier wakka.config.php, se trouvant à la racine du dossier du YesWiki, accessible par FTP. Le fichier de configuration déclare un tableau avec des valeurs pour chaque élément de configuration.

Voici le contenu du fichier de configuration par défaut, voir les commentaires en fin de ligne pour le détail de chaque élément de configuration :

<?php
// wakka.config.php créée Fri Jun  8 20:58:37 2012
// ne changez pas la wikini_version manuellement!

$wakkaConfig = array ( // tableau de configuration
  'wakka_version' => '0.1.1', // Ne pas toucher, version originale du code de wakka, ancêtre de wikini
  'wikini_version' => '0.5.0', // Ne pas toucher, version originale du code de wikini, ancêtre de YesWiki
  'debug' => 'no', // active le mode de débogage si passé à la valeur 'yes' (infos sur le nombre de requêtes, le temps écoulé et force l'affichage des erreurs php pour les développeurs) astuce : on peut aussi passer &debug dans l'url pour debugguer
  'mysql_host' => 'localhost', 
  'mysql_database' => 'yeswiki',
  'mysql_user' => 'yeswiki',
  'mysql_password' => '#######',
  'table_prefix' => 'yeswiki_',
  'root_page' => 'PagePrincipale',
  'wakka_name' => 'YesWiki de présentation', // titre du YesWiki
  'base_url' => 'http://localhost/?', // url d'accès au site
  'rewrite_mode' => '0', 
  'meta_keywords' => 'yeswiki, wiki, gpl, php, super', // mot clé pour le référencement (séparés par des virgules, par plus de 20-30)
  'meta_description' => 'Un site de présentation de ce merveilleux outil qu\'est YesWiki', // description du site en une phrase, pour le référencement (Attention : ne pas mettre de "." (point) dans ces méta descriptions
  'action_path' => 'actions',
  'handler_path' => 'handlers',
  'header_action' => 'header',
  'footer_action' => 'footer',
  'navigation_links' => 'DerniersChangements :: DerniersCommentaires :: ParametresUtilisateur',
  'referrers_purge_time' => 24,
  'pages_purge_time' => 90,
  'default_write_acl' => '*', // droits d'écriture par défaut des pages
  'default_read_acl' => '*', // droits de lecture par défaut des pages
  'default_comment_acl' => '*', // droits des commentaires
  'preview_before_save' => '0',
  'allow_raw_html' => '1', // autorise le html
);

Les éléments que vous pouvez rajouter sur wakka.config.php

Mon wiki se trouve à l'adresse suivante http://site-coop.net/Louise, je souhaiterais qu'il se nomme maintenant http://site-coop.net/Mathieu
- Via ftp, il faut changer le nom du dossier Louise en le nommant Mathieu
- dans le fichier wakka.config.php, il faut changer la ligne
'base_url' => 'http://site-coop.net/Louise/?" 

en
'base_url' => 'http://site-coop.net/Mathieu/?"

et tester si tout fonctionne dans votre navigateur (attention les majuscules et minuscules ont leur importance)

'BAZ_ENVOI_MAIL_ADMIN' => true


Quelques paramètres peuvent être ajoutés au fichier de configuration wakkaconfig afin de gérer plus finement les droits d'édition des pages et fiches bazar de votre wiki. L'objectif de ces ajouts vise à ne pas rendre trop complexe l'édition des pages tout en luttant contre le spam devenu fléau ces derniers temps !

Les paramètres ajoutables au wakkaconfig


  'password_for_editing' => 'votremotdepasse',
  'password_for_editing_message' => 'un message qui apparait au dessus du champ mot de passe',
  'use_hashcash' => true, //ne pas toucher pour l'instant
  'use_nospam' => true, // ne pas toucher pour l'instant
  'use_alerte' => true,
  'use_captcha' => true, 


Quelques détails

Paramètre Actions
'password_for_editing' demande un mot de passe AVANT de rentrer en mode édition que ce soit pour les pages wiki ET les fiches bazar. Si vous êtes connectés, ce mot de passe ne vous est pas demandé
'password_for_editing_message' vous pouvez indiquer un message afin de donner à vos usagers une info sur le mot de passe à rentrer (on fait le pari que les turcs spanners ne le liront pas ;-)
'use_captcha' => true place un captcha en bas des pages wiki, à remplir avant de pouvoir faire valider. A remplir même si vous êtes connectés



  'favorite_theme' => 'yeswiki', // theme par défaut, présent dans /themes ou /tools/templates/themes
  'favorite_squelette' => 'responsive-1col.tpl.html', // squelette par défaut
  'favorite_style' => 'yellow.css', // style css par défaut
  'favorite_background_image' => 'graphy.png', // image de fond par défaut, située dans /files/backgrounds
  'hide_action_template' => '1', // Force le template par défaut et empêche la modification du thème lors de l'édition.



  'hide_action_template' => '1', // Cache le bouton thème et empêche la modification du thème lors de l'édition.


Par défaut les cartes sont centrées sur le centre de la France et affiche l'intégralité de la France. On peut forcer le centre ailleurs en configurant dans wakaconfig :

  'baz_map_center_lat' => '50.725777', //permet de caler les cartes utilisées dans le wiki sur cette latitude
  'baz_map_center_lon' => '4.867795', //permet de caler les cartes utilisées dans le wiki sur cette longitude
  'baz_map_zoom' => '8', //permet de caler les cartes utilisées dans le wiki sur ce niveau de zoom


Permet de saisir une fiche formulaire même si la création de page YesWiki est interdite

  'bazarIgnoreAcls' => true,


si la base mysql utilise un autre port que 3306, vous pouvez spécifier le numéro du port privé

 'mysql_port' => 'n° du port',