I. Première installation (démo)

Ce paragraphe sur la première installation explique comment préparer un site GuppY avec du contenu de démonstration, de façon à ce que vous puissiez jouer avec.

• Téléchargez le fichier guppy.zip (http://www.freeguppy.org) sur votre PC.

• Décompressez ce fichier guppy.zip avec votre programme de décompression favori (7zip, WinZip, Winrar...) dans un dossier de votre PC.

• BRAVO, GuppY est prêt à fonctionner !

• Si vous souhaitez jouer avec GuppY sur votre PC avant de le mettre sur Internet, installez EasyPHP (http://www.easyphp.org) sur votre PC et copiez le contenu du dossier précédent dans le sous-répertoire www de EasyPHP, puis lancez EasyPHP... et votre site web tournera en local sur votre PC. C'est aussi simple que cela !

• Si vous souhaitez installer votre site directement sur Internet, alors copiez tous les fichiers décompressés sur le FTP de votre site avec un simple programme client FTP (FileZilla, FireFTP, CuteFTP, etc.). Et c'est tout, il vous suffit maintenant de taper l'URL de votre site dans la barre d'adresse de votre navigateur pour vous retrouver sur votre site "online".

• Félicitations, vous venez d'installer GuppY avec succès !

 

REMARQUE IMPORTANTE

-Si vous ne prévoyez pas d'installer une base de données vierge, supprimez le répertoire install/ maintenant.Sinon toute personne qui l'exécuterait détruirait tout le contenu de votre site web !

 

ALTERNATIVE

Vous pouvez aussi télécharger miniGuppY sur le site de GuppY. miniGuppY est un package qui comprend un serveur léger et complet (ZazouMiniWebServer) et GuppY, le tout "packagé"avec un programme d'installation automatique pour PC sous Windows.

On ne peut pas faire plus simple !

miniGuppY ne modifie pas la base de registres de Windows, s'installe aussi bien sur clé USB et se prête donc parfaitement à une utilisation "nomade";.

 

Remarque "CHMOD";

Voici comment mettre en place les droits sur les fichiers pour les serveurs internet qui le nécessitent (pas tous).

1. Répertoire admin
- Fichier admin/mdp.php : droits = 666. commande UNIX = chmod 666 admin/mdp.php
+ Répertoire admin/redac : droits = 777. commande UNIX = chmod 777 admin/redac
- Fichiers admin/redac/* : droits = 666. commande UNIX = chmod 666 admin/redac/*

2. Répertoire data : droits = 777. commande UNIX = chmod 777 data
- Fichiers data/* : droits = 666. commande UNIX = chmod 666 data/*
+ Répertoire data/archive : droits = 777. commande UNIX = chmod 777 data/archive
- Fichiers data/archive/* : droits = 666. commande UNIX = chmod 666 data/archive/*
+ Répertoire data/cache : droits = 777. commande UNIX = chmod 777 data/cache
- Fichiers data/cache/* : droits = 666. commande UNIX = chmod 666 data/cache/*
+ Répertoire data/countmsg : droits = 777. commande UNIX = chmod 777 data/countmsg
- Fichiers data/countmsg/* : droits = 666. commande UNIX = chmod 666 data/countmsg/*
+ Répertoire data/usermsg : droits = 777. commande UNIX = chmod 777 data/usermsg
- Fichiers data/usermsg/* : droits = 666. commande UNIX = chmod 666 data/usermsg/*
+ Répertoire data/error : droits = 777. commande UNIX = chmod 777 data/error
- Fichiers data/error/* : droits = 666. commande UNIX = chmod 666 data/error/*

3. Répertoire file : droits = 777 : commande UNIX = chmod 777 file
- Fichiers file/* : droits = 666. commande UNIX = chmod 666 file/*

4. Répertoire img : droits = 777. commande UNIX = chmod 777 img
- Fichiers img/* : droits = 666. commande UNIX = chmod 666 img/*

5. Répertoire pages : droits = 777. commande UNIX = chmod 777 pages
- Fichiers pages/* : droits = 666. commande UNIX = chmod 666 pages/*

6. Répertoire photo : droits = 777. commande UNIX = chmod 777 photo
- Fichiers photo/* : droits = 666. commande UNIX = chmod 666 photo/*

7. Pour tous les dossiers de skins il sera peut-être nécessaire de chmoder aussi les fichier de configuration:
- skin/ma_skin/confskin.inc : droits = 666. commande UNIX = chmod 666 skin/ma_skin/confskin.inc
- skin/ma_skin/style.css : droits = 666. commande UNIX = chmod 666 skin/ma_skin/style.css

Comment détecter que vous devez exécuter ces "CHMOD" ? Eh bien c'est facile àdétecter, c'est quand vous obtenez une ribambelle de messages d'erreurs de ce style :

Warning: fopen("data/logh.dtb","w")- Permission denied in http://www.mysite.com/inc/functions.php online 198
Warning: Supplied argument is not a valid File-Handleresource in http://www.mysite.com/inc/ functions.php on line206
Warning: fopen("../data/logh.dtb", "w") -Read-only file system in functions.php on line 198
Warning:fputs(): supplied argument is not a valid File-Handle resource infunctions.php on line 206

Remarque .htaccess

GuppY est proposé avec un fichier .htaccess dans le répertoire racine. Ce fichier n'est utile que si votre serveur web fonctionne sous Apache (serveur web le plus commun). Voici sa structure:
--------------------------------------
<files>
Order allow,deny
Deny from all
Satisfy All
</files>
<files>
Order allow,deny
Deny from all
Satisfy All
</files>
ErrorDocument 400 /error.php?err=400
ErrorDocument 403 /error.php?err=403
ErrorDocument 404 /error.php?err=404
ErrorDocument 500 /error.php?err=500
--------------------------------------
Les 10 premières lignes servent à protéger le contenu de votre base de données des regards indiscrets des internautes mal intentionnés (et il y en a !). Sinon, des fichiers comme le fichier data/frth.dtb par exemple qui contient toutes les adresses e-mail des gens ayant posté un message dans le forum sont lisibles et peuvent même servir à alimenter un fichier de Spam (berk !). Ces 10 lignes sont à laisser telles quelles.

Les 4 lignes suivantes servent à rediriger les internautes vers la page erreur lorsqu'ils demandent une page inexistante, etc. Celles ci doivent être adaptées par vos soins (via un simple éditeur de texte comme Notepad ou Notepad++ par exemple) selon l'endroit où est placé votre GuppY.

Ainsi, si votre installation GuppY est faite à la racine de votre site (URL = http://www.votresite.com/) alors vous n'avez rien à faire. Par contre si votre installation GuppY est faite dans un répertoire de votre site (URL =http://www.votresite.com/ici/ par exemple) alors il vous faut modifier ainsi ces 4 lignes:
------------------------------------------
ErrorDocument 400/ici/error.php?err=400
ErrorDocument 403/ici/error.php?err=403
ErrorDocument 404/ici/error.php?err=404
ErrorDocument 500/ici/error.php?err=500
------------------------------------------

Dans certains cas, vous aurez peut-être à modifier ainsi ces 4 lignes (pour un site dont l'URL serait http://www.votresite.com/):
--------------------------------------------------------------
ErrorDocument400 http://www.votresite.com/error.php?err=400
ErrorDocument 403http://www.votresite.com/error.php?err=403
ErrorDocument 404http://www.votresite.com/error.php?err=404
ErrorDocument 500http://www.votresite.com/error.php?err=500
--------------------------------------------------------------

Ou encore, si installé dans le sous-répertoire ici/:
------------------------------------------------------------------
ErrorDocument400 http://www.votresite.com/ici/error.php?err=400
ErrorDocument403 http://www.votresite.com/ici/error.php?err=403
ErrorDocument404 http://www.votresite.com/ici/error.php?err=404
ErrorDocument500http://www.votresite.com/ici/error.php?err=500
------------------------------------------------------------------

Il serait aussi judicieux de protéger votre répertoire par un nom d'utilisateur et un mot de passe spécifiques via .htaccess. Comme la façon de faire est souvent spécifique à votre hébergeur, merci de consulter ses pages d'aide à ce sujet.
Pour de plus amples renseignements sur la protection de votre site par .htaccess, référez-vous à la documentation officielle d'Apache.

 

II. Installation propre

L'installation propre permet de supprimer le contenu de démonstration et de commencer avec un beau site GuppY vierge de tout contenu.

Le point de départ de cette installation propre est n'importe où entre la première installation et l'état de votre base de démo avec son contenu que vous avez pu modifier. Cette installation va détruire tout le contenu mais garder le paramétrage que vous avez pu réaliser dans les différents &quot;Config quelquechose&quot; dans la zone d'admin.

• Si l'URL de votre site est http://www.mysite.com/ alors saisissez le texte suivant dans votre navigateur : http://www.mysite.com/install/

• Suivez les instructions pour une "Installation propre".

• Félicitations, votre site web est prêt à fonctionner avec votre contenu !
   

III. Migrer d'une version ANTERIEURE à Miniportail 1.7 ou GuppY 2.4

• Faites une sauvegarde complète de votre site avant de passer à l'étape suivante.

• Exécutez un "contrôle d'intégrité DB". Assurez-vous qu'il ne produit pas d'erreur sinon exécutez-le une nouvelle fois.

• Aller dans Config. Site pour activer la skin "no_skin".

• Aller dans les pages d'administration des plugins pour retirer les icônes de la barre supérieure d'icônes.

• Supprimez les fichiers contenus à la racine de votre site (/) sauf guppy.ico
  Conservez précieusement les 5 répertoires : data/ ; file/ ; img/ ; pages/ et photo/ qu'il ne faut donc surtout pas les supprimer de votre site web.
  Suprimez les autres repertoires : admin/ ; inc/ ; install/ et mobile/ et tout leurs contenus y compris leurs sous-répertoires.
  (mobile/ est apparu avec la version 2.3)

• Ajoutez les nouveaux répertoires et fichiers de la nouvelle version de GuppY : / ; admin/ ; flash/ ; inc/ ; install/ ; mobile/ ; plugins/ et skins/ .

• Si l'URL de votre site est http://www.mysite.com/ alors saisissez le texte suivant dans la barre d'adresse de votre navigateur : http://www.mysite.com/install/migrate17.php
  puis http://www.mysite.com/install/migrate18.php si vous êtes en version < 1.7 de miniPortail. Ou bien exécutez http://www.mysite.com/install/migrate18.php si vous êtes en version 1.7 de miniPortail.

• Vérifiez si la remarque "CHMOD" (du paragraphe 2) s'applique à votre installation. C'est le cas si vous avez eu à l'appliquer dans vos installations/migrations précédentes de miniPortail / GuppY.

• Si l'URL de votre site est http://www.mysite.com/ alors saisissez le texte suivant dans la barre d'adresse de votre navigateur : http://www.mysite.com/install/

• Suivez les instructions pour une "Migration".

• Félicitations, vous venez de migrer dans la toute dernière version de GuppY.

• Des modifications dans le paramétrage vous imposent de revérifier "Config générale", "Config site", "Config sections", "Config services", "Config boîtes", "Config forum" et "Config style". Il vous faudra aussi faire tourner un "Contrôle d'intégrité DB" pour mettre à jour les index de la base de données GuppY.

• Il vous reste à installer votre skin et vos plugins en vous assurant auparavant que vous disposez de versions compatibles avec la présente version.
   

IV. Migrer d'une version ULTERIEURE à Miniportail 1.7 ou GuppY 2.4

 

IMPORTANT : le script de migration est destiné aux sitesweb fonctionnant avec miniPortail v1.8 ou GuppY v 2.4 ou ultérieure.

• Faites une sauvegarde complète de votre site avant de passer à l'étape suivante.

• Exécutez un "contrôle d'intégrité DB". Assurez-vous qu'il ne produit pas d'erreur sinon exécutez-le une nouvelle fois.

• Désactiver les plugins utilisés.

• Aller dans Config. Site pour activer la skin "no_skin".

• Aller dans les pages d'administration des plugins pour retirer les icônes de la barre supérieure d'icônes.

• Aller dans Config. Boîtes pour retirer les boîtes latérales des plugins.

• Supprimez les fichiers contenus à la racine de votre site (/) sauf guppy.ico
  Conservez précieusement les 6 répertoires : data/ ; file/ ; img/ ; flash/ ; pages/ et photo/ qu'il ne faut donc surtout pas supprimer de votre site web.
  Supprimez les autres repertoires : admin/ ; inc/ ; install/ ; mobile/ et plugins/ et tout leurs contenus y compris leurs sous-répertoires.
  (mobile/ est apparu avec la version 2.3 ; plugins/ est apparu avec la version 3.0 ; flash/ et skins/ avec la version 4.6)

• Ajoutez les nouveaux répertoires et fichiers de la nouvelle version de GuppY : / ; admin/ ; flash/ ; inc/ ; install/ ; mobile/ ; plugins/ et skins/ .

• Vérifiez si la remarque "CHMOD" (du paragraphe 2) s'applique à votre installation. C'est le cas si vous avez eu à l'appliquer dans vos installations/migrations précédentes de miniPortail / GuppY.

• Si l'URL de votre site est http://www.mysite.com/ alors saisissez le texte suivant dans la barre d'adresse de votre navigateur : http://www.mysite.com/install/

• Suivez les instructions pour une "Migration".

• Félicitations, vous venez de migrer dans la toute dernière version de GuppY.

• Des modifications dans le paramétrage vous imposent de revérifier "Config générale", "Config sections", "Config services", "Config accueil", "Config forum", et pour chaque skin "Config boîtes",  "Config site",et "Config style". Il vous faudra aussi faire tourner un "Contrôle d'intégrité DB" pour mettre à jour les index de la base de données GuppY.

• Il vous reste à installer votre skin et vos plugins en vous assurant auparavant que vous disposez de versions compatibles avec la présente version.
   

V. Remarques importantes à prendre en compte pour toute installation ou mise à jour :

• Une fois que vous avez fini la migration, assurez-vous que les fichiers dans le répertoire install/ ont bien été supprimés. Sinon toute personne qui l'exécuterait détruirait tout le contenu de votre site web !

• Si vous ne pouvez plus voir le répertoire install/, ça veut dire que tout s'est passé correctement. Même conclusion si le répertoire install/ existe toujours mais est vide (supprimez le alors par FTP, votre hébergeur n'autorise pas son effacement par PHP).

• A l'issue de la migration, le mot de passe d'admin est remis à "pass". N'oubliez pas de le changer.
  Profitez-en pour revalider toutes les pages de configuration (même après une mise à jour)

• Si vous avez rapatrié votre site en local ou inversement, aussitôt le transfert effectué modifiez l'url de votre site comme indiqué dans "config générale", sinon vous pourriez rencontrer quelques messages d'erreurs lors de l'édition d'article.