Installer YesWiki sur son espace Internet

Pré-requis

  • Vous avez téléchargé la dernière version de YesWiki sur le site yeswiki.net
  • Vous disposez d'un espace d'hébergement avec PHP version 7.1 (la version doryphore nécessite une version de php >= 7.4) et MariaDB > 10 ou MYSQL >= 5.6 (⚠️ la version 5.5 ne supporte pas la recherche fulltext) et des droits d'accès à l'hébergement (codes FTP et MYSQL) > Attention : voir les instructions spécifiques pour l'installation sur les hébergements Free.fr
  • Vous disposez d'un logiciel pour faire du FTP (le client FTP libre FileZilla par exemple)
  • En cas de bug pour les mises à jour sur certains systèmes très légers, vérifiez la présence des librairies php-stype, php-curl, php-filter, php-gd, php-iconv, php-json, php-mbstring, php-mysqli, php-pcre et php-zip ; la liste à jour des extensions est décrite dans le fichier composer.json.
  • Les extensions peuvent nécessiter des librairies supplémentaires. Vérifiez le contenu du fichier README.md de chacune (ex.: ferme, lms).

Préparation

  • Décompressez le fichier téléchargé sur votre disque dur et renommez-le à votre convenance (par exemple monYeswiki)
  • Si elle n'existe pas déjà, créez 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.

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é.

En vidéo

Déposer mon wiki sur mon hébergement avec Filezilla


créer mon yeswiki



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 Atom 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.

Cas particulier : pour les installation sur un serveur local WAMP

Si vous installez votre Yeswiki sur votre PC en utilisant WAMPServer,
Vous aurez probablement un message d'erreur lorsque vous souhaitez "Sauver" une page.
Le problème peut être réglé en rajoutant la ligne 'use_hashcash' => false, dans le wakka.config.php
Et voilà votre wiki devrait fonctionner maintenant ;-)


documentation