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
Changer les droits de lectures et d'écriture par défaut
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
en
'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
Changer l'url de votre wiki
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
en
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
- 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
Envoyer un mail aux @admins à chaque nouvel encodage de fiche
'BAZ_ENVOI_MAIL_ADMIN' => true
Laisser ouverte en écriture votre page tout en vous protégeant des spams
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 |
Changer le thème par défaut de votre wiki
'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.
Cacher le bouton Thèmes de votre wiki en mode édition
'hide_action_template' => '1', // Cache le bouton thème et empêche la modification du thème lors de l'édition.
Changer l'affichage par défaut des cartes
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
Empêcher la création de pages SAUF via les formulaires
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
utiliser une base sql avec port privé...
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',
Facebook opengraph : choisir l'image utilisée quand on partage un wiki sur FB
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
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
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
Attention, tous les serveur mail n'accepte pas de jouer ce jeu.
ou
https://support.google.com/accounts/answer/6010255
Autre piste possible, acheter un nom de domaine chez gandi et utiliser le smtp lié
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 icihttps://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é
Lien vers la doc
http://
documentation