Installer YesWiki sur son espace Internet

Pré-requis

Préparation

  • Décompressez le fichier téléchargé sur votre disque dur et renommez-le à votre convenance (par exemple monYeswiki)
  • Créer une base de données vide sur votre espace d'hébergement (par exemple mabase).
  • Le plus souvent, il vous faudra créer un utilisateur pour cette base de donnée avec un identifiant et un mot de passe (par exemple identifiant = moi, mot de passe = oups)
  • Dans la mesure du possible évitez les identifiant avec "tiret" (genre moi-moi) car ça crée parfois une erreur lors de l'installation
  • Noter le nom de votre base de données et les identifiants et mot de passe d'accès à celle-ci.

Upload par FTP

  • Connectez-vous à votre espace personnel par FTP (filezilla par exemple)
  • Glissez et déposez votre dossier local (monYeswiki) sur votre espace personnel
  • Sur certains hébergements, il faut attribuer des droits d'accès en écriture au dossier principal du wiki (monYeswiki) : mettre les droit d'accès en écriture pour tous (chmod 777), en faisant clic droit sur le dossier puis "droits d'accès au dossier" dans filezilla)
    • Il est bon aussi (pour éviter des erreurs futures lors de l'insertion d'images dans le wiki par exemple) de déjà attribuer au dossier "Cache" et "File" des droits d'accès en écriture pour tous (777)
  • Fermez le client Ftp. Nous allons pouvoir configurer le yeswiki.

Paramétrage du YesWiki

  • Ouvrez votre navigateur et tapez l'url de votre site perso jusqu'au répertoire créé.
  • Une page de configuration s'ouvre.
  • Renseignez le nom de votre serveur MySQL (donné par votre hébergeur, en général c'est "localhost")
  • Renseignez le nom de votre base de données MySQL (dans notre exemple : mabase) (attention en php 5.5, ne pas mettre de tiret dans les noms de bases mysql)
  • Renseignez le nom d'utilisateur et le mot de passe de votre base de données MySQL (dans notre exemple : moi et oups)
  • Renseignez le préfixe des tables : par défaut yeswiki_ (vous pouvez laisser comme cela)
  • Modifiez le nom de votre YesWiki (cela deviendra le titre de votre wiki affiché en grand en haut du site... modifiable par après si nécessaire - ne pas mettre de caractères spéciaux html, typiquement "&Eacute", "&Egrave"; )
  • Renseignez la page d'accueil de votre YesWiki. Ceci doit être un NomWiki. : par défaut  PagePrincipale (vous pouvez laisser comme cela)
  • Renseignez les champs mots-clés et description si vous le souhaitez (si vous laissez vide cela ne posera pas de problème)
  • Renseignez les champs (Administrateur, Mot de passe, Confirmation du mot de passe et Adresse e-mail) afin de créer un compte administrateur pour gérer votre wiki
  • Les pages par défaut de YesWiki nécessitent du code html pour fonctionner cocher la case "Autoriser l'insertion de HTML brut.". Vous pourrez alors plus facilement intégrer des widgets HTML.

Note :
Concernant les erreurs deprecated (si affichage): elles ne sont pas bloquantes pour l'instant : elles signalent qu'elles seront bientot obsoletes.
En attendant on peut les cacher en php en ajoutant au début de wakka.php : error_reporting(E_ALL & ~E_DEPRECATED);

Conclusion

Les tables MySQL sont automatiquement créées.
Si tout a bien fonctionné vous en avez confirmation.
Le fichier de configuration est écrit. C'est terminé.

Que faire en cas d'erreur ligne 97 dans wiki.php ?

Il arrive que lors de l'installation, une des tables (prefixe_nature) ne puisse être créée par yeswiki. Ceci entraîne une erreur à la ligne 97 du wiki.php et empêche l'affiche de votre yeswiki ;-(

Pour résoudre ce problème (pas très grave)

  • éditer votre fichier wiki.php (situé dans tools/bazar/wiki.php avec l'aide d'un éditeur html (comme Sublime Text 2 par exemple)
  • remplacer dans wiki.php le bout de code
    if ($resultat->numRows() == 0) {
    
    par
    if (FALSE && $resultat->numRows() == 0) {
    
  • créér la table préfixe_nature (prefixe est à remplacer par votre préfixe de table,, indiqué lors de l'installation du wiki)
    • pour ce faire, rendez-vous dans votre phpmyadmin et rentrez y avec votre nom d'user et mot de passe (dans notre exemple moi et oups)
    • sélectionnez votre base de donnée (dans notre exemple mabase)
    • exécutez cette requête SQL
      • CREATE TABLE IF NOT EXISTS `votrepréfixe_nature` (
          `bn_id_nature` int(10) unsigned NOT NULL DEFAULT '0',
          `bn_label_nature` varchar(255) DEFAULT NULL,
          `bn_description` text,
          `bn_condition` text,
          `bn_ce_id_menu` int(3) unsigned NOT NULL DEFAULT '0',
          `bn_commentaire` tinyint(3) unsigned NOT NULL DEFAULT '0',
          `bn_appropriation` tinyint(3) unsigned NOT NULL DEFAULT '0',
          `bn_image_titre` varchar(255) NOT NULL DEFAULT '',
          `bn_image_logo` varchar(255) NOT NULL DEFAULT '',
          `bn_couleur_calendrier` varchar(255) NOT NULL DEFAULT '',
          `bn_picto_calendrier` varchar(255) NOT NULL DEFAULT '',
          `bn_template` text NOT NULL,
          `bn_ce_i18n` varchar(5) NOT NULL DEFAULT '',
          `bn_type_fiche` varchar(255) NOT NULL,
          `bn_label_class` varchar(255) NOT NULL,
          PRIMARY KEY (`bn_id_nature`)
        ) ENGINE=MyISAM DEFAULT CHARSET=latin1;
        
    • Cette requête va créer la table manquante.

Et voilà votre wiki devrait fonctionner maintenant ;-)