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, // nbr de jours après lesquels les révisions sont effacées
  '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

Par défaut, les pages de votre wiki sont visible set éditables par tout visiteur. Pour limiter la lecture et l'écriture aux seuls administrateurs par exemple, il faut changer les lignes
  'default_write_acl' => '*', // droits d'écriture par défaut des pages
  'default_read_acl' => '*', // droits de lecture par défaut des pages

en
  'default_write_acl' => '@admins', // droits d'écriture par défaut des pages
  'default_read_acl' => '@admins', // droits de lecture par défaut des pages


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)

Pour tous les détails sur les droits d'accès : https://yeswiki.net/?DocumentationDroitsDAcces

'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

  'default_write_acl' => '@admins', // ceci interdit la création de pages sauf pour les @admins
  'bazarIgnoreAcls' => true, // ceci permet de passer au-dessus de cette interdiction uniquement via les formulaires


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',


pour ouvrir une image par défaut : il faut mettre un lien vers l'image dans le wakka.config.php
idéalement, l'image doit faire 1200x630 selon les specs imposées par facedebouc
par défaut il prend cette image, et si une image est présente dans la page (mise avec attach) ou une fiche bazar avec bf_image , il remplace par cela

'opengraph_image' => 'https://domaine.ext/nomdelimage.jpg',


réparer les wikis qui n'envoient pas les mails ;-(

Concerne
  • Codes utiles /raw...
  • Hors yeswiki
La réponse sur certains hébergements, l'envoi de mail par défaut ne marche pas , il faut créer un compte smtp
et donc rajouter dans le fichier wakka.config.php les parametres suivants
'contact_mail_func' => 'smtp',
  'contact_smtp_host' => 'ssl://<mon serveur smtp>:465',
  'contact_smtp_user' => 'user@mail.ext',
  'contact_smtp_pass' => '<monpassword>',


Attention, tous les serveur mail n'accepte pas de jouer ce jeu.

avec sendinblue

créez-vous un compte puis allez dans les paramètres (via ce lien) chercher votre clé smtp (limitée à 300 mails par jour)
'contact_mail_func' => 'smtp',
  'contact_smtp_host' => 'smtp-relay.sendinblue.com:587',
  'contact_smtp_user' => 'monmail@pourmoncomptesendinblue.com',
  'contact_smtp_pass' => '<ma cle smtp>',

ou
'contact_mail_func' => 'smtp',
  'contact_smtp_host' => 'smtp-relay.sendinblue.com',
  'contact_smtp_port' => '587',
  'contact_smtp_user' => 'monmail@pourmoncomptesendinblue.com',
  'contact_smtp_pass' => '<ma cle smtp>',

avec gmail

Gmail le fait mais avec une limite d'envoi journalière et souvent un blocage de scurité à lever via un paramètre : plus d'infos ici
https://support.google.com/accounts/answer/6010255
'contact_smtp_host' => 'ssl://smtp.gmail.com:465',


Autre piste possible, acheter un nom de domaine chez gandi et utiliser le smtp lié



documentation