Ce document n'est qu'un EXEMPLE (réalisé pour la 1.6), il est cependant valable pour les versions supérieures ).

La mise à jour de PhpWebGallery se fait en 9 étapes simples.

C'est ici

Remarque : Attention à ne pas télécharger de RC (Release Candidate).

Ici nous avons opté pour le bureau.

Avec un client ftp (ici FileZilla) connectez vous à votre espace d'hébergement, et sauvegardez sur votre disque dur:

• Le dossier galleries/
• Le fichier mysql.inc.php qui se trouve dans le répertoire include/
• Le fichier config_local.inc.php (n'existe pas forcément) qui se trouve dans le répertoire include/
• Le fichier local-layout.css (n'existe pas forcément) qui se trouve dans le répertoire template-common/
• Le fichier local-layout.css (n'existe pas forcément) qui se trouve dans le répertoire template/yoga/

ATTENTION : toutes les modifications, MOD ou template, que vous aurez apportées à PhpWebGallery seront perdues ! [ A rajouter : comment faire pour conserver ces modifications ?]

Supprimer tout les fichiers et dossiers.

Par FTP, transférez l'ensemble de l'archive décompressée sur votre serveur distant.

Soit :

• Le dossier galleries/
• Le fichier mysql.inc.php à mettre dans le répertoire include/
• Le fichier config_local.inc.php (n'existe pas forcément) à mettre dans le répertoire include/
• Le fichier local-layout.css (n'existe pas forcément) à mettre dans le répertoire template-common/
• Le fichier local-layout.css (n'existe pas forcément) à mettre dans le répertoire template/yoga/

N'oubliez pas de transférer le fichier mysql.inc.php dans include/. En effet, celui présent dans la nouvelle version est vide…

Attention, avec online comme hébergeur, vous devez créer un fichier, à l'aide de votre éditeur de texte préféré, nommé .htaccess en y mettant la ligne suivante : AddType application/x-httpd-php5 .php

(Cette manipulation peut s'avérer inutile et différente chez d'autres hébergeurs, c'est un cas spécifique donné pour l'exemple).
Placez ensuite ce fichier dans le répertoire racine de votre galerie à l'aide de votre client ftp. Sans cette manip, vous aurez une page blanche à l'étape suivante…

Une fois le transfert terminé, rendez-vous avec votre navigateur à l'adresse de mise à jour, par exemple : http://votredomaine/phpwebgallery/upgrade.php.

Vous devez obtenir ceci:

Si vous obteniez autre chose, abandonnez!!!
--> Vérifiez que le fichier ''./include/mysql.inc.php'' est bien l'ancien (il ne saurait pas être vide !!!).
--> Rendez-vous sur le forum pour vous faire aider.

Donc quand vous obtenez ceci:

Il vous est demandé de rajouter la ligne :

define('PHPWG_IN_UPGRADE', true);

Éditez votre fichier mysql.inc.php en rajoutant cette ligne. Le fichier devrait alors ressembler à ça:

<?php
$cfgBase = 'NomDeVotreBase';
$cfgUser = 'NomUtilisateurAccesBase';
$cfgPassword = 'MotDePasseAccesBase';
$cfgHote = 'ServeurAccesBase';
$prefixeTable = 'phpwebgallery_';
 
define('PHPWG_INSTALLED', true);
 
// Ligne à rajouter pour permettre la mise à jour !
define('PHPWG_IN_UPGRADE', true);
?>

Remarque : Pas d'espace après le ?> ou de ligne vide après le ?>…

Une fois le fichier mysql.inc.php modifié et enregistré sur le serveur distant, rafraichissez la page upgrade.php dans votre navigateur.

Dans cette exemple je mets à jour la version 1.5.x. Cliquez sur le lien Upgrade from release 1.5.0 to 1.6.0. La page se recharge et vous arrivez à cette page.

Votre PhpWebGallery a été mis à jour. Maintenant, pour sortir du mode UPGRADE, éditez de nouveau le fichier mysql.inc.php et supprimez la ligne :

define('PHPWG_IN_UPGRADE', true);

Par sécurité, il faut aussi que vous supprimiez les fichiers install.php, upgrade.php et le dossier install/.

Et voilà !

Le passage en 1.7 enlève temporairement tout l'historique existant. Vous pourrez le reconstituer facilement car tout a été sauvegardé dans la table history_backup. Pour cela vous devrez installer le plugin ImportStat.

L'opération n'a besoin d'être réalisée qu'une seule fois. Le plugin peut être entièrement désinstallé après son utilisation.