Wiki

Passer son site 4.0 en version 4.1

Mon, 30 Oct 2023 10:46:14 +0100

Pour pouvoir passer de la version 4.0 à la 4.1, il ne suffit pas de remplacer les fichiers ou d'appliquer un patch comme les mises à jours mineures.

Étant donné qu'il y a eu plusieurs changements au niveau de la base de données, il faut faire des conversions pour que la nouvelle version fonctionne correctement, nous allons donc voir au cours de cet article les différentes choses à faire pour migrer vers PHPBoost 4.1.

N'oubliez pas de faire des sauvegardes de vos fichiers et de la base de données avant la procédure !

Il est nécessaire d'utiliser une version php supérieure ou égale à 5.3 pour installer PHPBoost 4.1. Assurez de modifier la configuration de votre serveur (dans le fichier htaccess si besoin pour certains hébergeurs) avant de transférer les fichiers de la 4.1 sur le serveur.

Pré-requis

En premier lieu, nous vous conseillons très fortement d'effectuer une sauvegarde de tout votre site. Que ce soit au niveau de l'hébergement des répertoires et fichiers constituant le site, ou au niveau de la base de données.

Pour la base de données, nous vous invitons à regarder cet article.
Pour le contenu de votre site, nous vous invitons à regarder cet article (au lieu de copier vers le serveur en ligne, vous copierez vers le serveur local ou nouveau serveur)

En second lieu, suivant le système d'exploitation de votre machine à partir de laquelle vous allez effectuer cette opération, certains fichiers composant la fourniture de la version PHPBoost 4.1 correspondent à des fichiers cachés de type .nom-fichier (avec le point devant). Il sera donc nécessaire que vous régliez votre explorateur de fichiers pour les rendre visibles.

En troisième lieu, cette migration ne vaut que pour le noyau du CMS ainsi que ses modules associés. Les thèmes et les modules non-officiels, eux, devront être migrés à part avec la procédure les affairant.

Il est préférable de désactiver tous vos modules non-officiels avant de procéder à la migration.

Il sera aussi important de sauvegarder la/les versions 4.0 se trouvant dans le répertoire /templates parce que le premier redémarrage se fera avec le thème base de la version 4.1.

Nous vous invitons à regarder cet article.

Enfin, il sera nécessaire que vous fassiez le recensement de tous les répertoires et fichiers que vous avez ajoutés en plus de ceux constituant le CMS PHPBoost 4.0 pour bien les identifier avant de suivre cette procédure.

Préparer votre site

1 - Téléchargez la version complète de PHPBoost 4.1.

2 - Décompressez l'archive et transférez tous les fichiers et dossiers de la version 4.1 sur votre serveur dans le même répertoire de la version 4.0. Contrairement aux versions précédentes, le script de mise à jour se charge automatiquement des fichiers ajoutés/supprimés sur le serveur. Il n'y a plus d'opération manuelle.

3 - Récupérez ensuite le pack de mise à jour à cette adresse : PHPBoost 4.0 vers PHPBoost 4.1

4 - Décompressez l'archive et téléchargez le dossier update dans le répertoire PHPBoost de votre serveur.

5 - Si le module Rapport de bug est installé sur votre site, veuillez le télécharger et mettre le répertoire sur votre FTP.

Mise à jour du site

- Lancez l'adresse suivante :

http://www.monsite.com/update/

(en remplaçant

http://www.monsite.com

par l'adresse de votre site)

- Là vous pouvez suivre les différentes étapes, qui sont proches de la procédure de l'installation de PHPBoost que vous avez connu au moment de la création de votre site PHPBoost version 4.0. A noter que les informations de base de donnée n'ont pas besoin d'être renseignées puisqu'elles l'ont déjà été à l'installation. Le temps de la conversion peut être plus où moins long suivant la taille de la base de données. En moyenne comptez une à deux minutes.

Si vous ne l'aviez pas déjà fait avant de lancer la mise à jour, votre site sera automatiquement placé en maintenance au début de la mise à jour.

Configurez votre site sur PHPBoost 4.1

- En premier lieu supprimez le dossier /update et /install de votre serveur, une personne mal intentionnée pourrait endommager votre site le cas échéant.

- Passez en revue l'ensemble des données, configurations et autorisations puis désactivez la maintenance pour ré-ouvrir le site.

Mise en place des redirections 301 pour les anciens liens de PHPBoost 4.0

Pour éviter que vous tombiez sur des erreurs 404, nous avons développé un module qui met en place tout seul des redirections 301.

Cela va permettre également aux moteurs de recherche de savoir qu'une page à changé d'url.

Le module est à installer comme un module standard et vous n'avez pas besoin de vous en occuper.

Vous pouvez le télécharger ici : Télécharger le module UrlUpdater

Au moindre problème contactez le support sur le forum PHPBoost.

Bonne continuation sur PHPBoost 4.1 !

Passer son site 3.0 en version 4.0

Mon, 30 Oct 2023 10:38:10 +0100

Pour pouvoir passer de la version 3.0 à la 4.0, il ne suffit pas de remplacer les fichiers ou d'appliquer un patch comme les mises à jours mineures.

Étant donné qu'il y a eu plusieurs changements au niveau de la base de données, il faut faire des conversions pour que la nouvelle version fonctionne correctement, nous allons donc voir au cours de cet article les différentes choses à faire pour migrer vers PHPBoost 4.0.

N'oubliez pas de faire des sauvegardes de vos fichiers et de la base de données avant la procédure !

Pré-requis

En premier lieu, nous vous conseillons très fortement d'effectuer une sauvegarde de tout votre site. Que se soit au niveau de l'hébergement des répertoires et fichiers constituant le site, qu'au niveau de la base de données.

Pour la base de données, nous vous invitons à regarder cet article.
Pour le contenu de votre site, nous vous invitons à regarder cet article (Au lieu de copier vers le serveur en ligne, vous copierez vers le serveur local ou nouveau serveur)

En second lieu, suivant le système d'exploitation de votre machine à partir de laquelle vous allez effectuer cette opération, certains fichiers composant la fourniture de la version PHPBoost 4.0 correspondent à des fichiers cachés de type .nom-fichier (avec le point devant) Il sera donc nécessaire que vous régliez votre explorateur de fichiers pour les rendre visibles.

En troisième lieu, cette migration ne vaut que pour le noyau du CMS ainsi que ses modules associés. Les thèmes et les modules non-officiels, eux, devront être migrés à part avec la procédure les affairant.

Il est préférable de désactiver tous vos modules non-officiels avant de procéder à la migration.

Il sera aussi important de sauvegarder la/les versions 3.0 se trouvant dans le répertoire /templates parce que le premier redémarrage se fera avec le thème base de la version 4.0.

Nous vous invitons à regarder cet article.

Enfin, il sera nécessaire que vous fassiez le recensement de tous les répertoires et fichiers que vous avez ajoutés en plus de ceux constituant le CMS PHPBoost 3.0 pour bien les identifier avant de suivre cette procédure.

Préparer votre site

1 - Sur le serveur de votre site PHPBoost en version 3.0, sauvegardez les dossiers suivants :

/gallery/pics (si le module gallery est installé)
/gallery/pics/thumbnails (si le module gallery est installé)
/images
/upload

2 - Sur le serveur de votre site PHPBoost en version 3.0, dans le dossier /cache, sauvegardez les fichiers suivants (s'ils existent) :

pages.txt
os.txt
browsers.txt
lang.txt
robots.txt

3 - Une fois ces fichiers sauvegardés à part en sécurité supprimez tous les dossiers et fichiers.
(attention à ne pas supprimer des dossiers/fichiers étrangers à PHPBoost !)

4 - Téléchargez la version complète de PHPBoost 4.0.

5 - Décompressez l'archive et transférer tous les fichiers et dossiers de la version 4.0 sur votre serveur dans le même répertoire de la version 3.0.

6 - Remettez les fichiers et dossiers de la version 3.0 (sauf ceux du dossier cache) que vous avez préalablement sauvegardés dans l'étape 1, sur votre serveur toujours dans le même répertoire en autorisant le remplacement des fichiers.

7 - Transférez maintenant les fichiers sauvegardés dans l'étape 2 du dossier cache dans le dossier /stats/cache/

8 - Récupérez ensuite le pack de mise à jour à cette adresse : PHPBoost 3.0 vers PHPBoost 4.0

9 - Décompressez l'archive et téléchargez le dossier update dans le répertoire PHPBoost de votre serveur.

Mise à jour du site

- Lancez l'adresse suivante :

http://www.monsite.com/update/

(en remplaçant

http://www.monsite.com

par l'adresse de votre site)

- Là vous pouvez suivre les différentes étapes, qui sont proches de la procédure de l'installation de PHPBoost que vous avez connue au moment de la création de votre site PHPBoost version 3.0. A noter que lorsque vous arriverez au choix du nom de la base de données, il s'agit de celui de la base de données version 3.0 à convertir. Le temps de la conversion peut être plus où moins long suivant la taille de la base de données. En moyenne comptez une à deux minutes.

Configurez votre site sur PHPBoost 4.0

- En premier lieu supprimez le dossier /update et /install de votre serveur, une personne mal intentionnée pourrait endommager votre site le cas échéant.

- Mettez votre site en maintenance dans l'administration et passez en revue l'ensemble des données, configurations et autorisations.

- Allez dans le panneau d'Administration puis Modules \ Modules \ Ajouter et ajouter le nouveau module "Personnalisation" que vous retrouverez ensuite dans le menu Outils.

Au moindre problème contactez le support sur le forum PHPBoost.

Bonne continuation sur PHPBoost 4.0 !

Passer son site 5.2 en version 6.0

Mon, 19 Jun 2023 08:37:57 +0200

Un changement de version, comment ça marche ?

Pour effectuer une montée de version majeure (appelée migration) il ne suffit pas de remplacer les fichiers ou d'appliquer un patch comme pour les mises à jour mineures. Des changements ayant été effectués dans la structure de la base de données, celle ci doit donc être convertie pour que la nouvelle version fonctionne correctement.
La conservation des données existantes (contenus d'articles, de news ou autres) doit être évidemment garantie, c'est ce que fera le script de migration que vous allez utiliser. Voici donc les différentes étapes à suivre pour migrer vers PHPBoost 6.0 :

Prérequis

Conseils

Lisez attentivement et en totalité cette procédure avant de commencer quoi que ce soit. La majorité des migrations ratées sont le résultat d'une procédure non respectée. Si vous avez un doute, posez votre question sur le forum, nous y répondrons dans les meilleurs délais.
Et n'oubliez pas de réaliser vos sauvegardes avant toute chose. Nous pourrons toujours arriver à faire fonctionner votre site, mais pas à restituer vos propres données.

Versions logicielles

La version minimale de PHP est la 7.1, la compatibilité est assurée avec PHP 8.0 et 8.1.

Sauvegardes

Vous devez impérativement effectuer une sauvegarde de tout votre site (répertoires et fichiers) ainsi que de la totalité de la base de données. Si ce n'est pas fait, aucun retour en arrière ne sera possible après migration en cas de problème.

Pour les thèmes, nous vous invitons à regarder cet article.
Pour la base de données, nous vous invitons à regarder cet article ou cet article.
Pour le contenu de votre site, nous vous invitons à regarder cet article (au lieu de copier vers le serveur en ligne, vous copierez vers le serveur local ou nouveau serveur)

Enfin, il vous faudra recenser tous les répertoires et fichiers que vous avez ajoutés en plus de ceux constituant le CMS PHPBoost pour bien les identifier avant de suivre cette procédure.
Durant toute la procédure, il faut rester connecté en tant qu'administrateur et ne jamais se déconnecter volontairement avant la migration.

Préparer votre site

Cette migration ne concernant que le noyau du CMS ainsi que ses modules associés (compatibles avec la nouvelle version), vous devez effectuer quelques manipulations avant de lancer le processus.
Pour plus de sécurité, pensez à placer le site en maintenance pour éviter d'éventuelles interactions avec vos membres ou visiteurs.

Modules

Nous vous conseillons fortement de suivre la procédure suivante avant de lancer le script de migration :Avant de lancer la migration en elle même, prenez le temps d'intégrer les modules ou thèmes non officiels convertis en version 6.0 dans votre organisation de site à l'aide de votre logiciel ftp. Ils seront alors automatiquement installés ou mis à jour pendant le traitement.
En cas de problème, contactez l'auteur du module ou du thème.
Vous pouvez vous reporter à cette liste pour savoir quels sont les modules officiels.
Exemple:
Vous utilisez le module Petites Annonces (dossier smallads) et vous pouvez constater qu'il n'est pas présent dans la liste des modules officiels. Il ne sera donc pas converti automatiquement si vous ne le préparez pas avant. Pour l'inclure dans le processus de mise à jour, voici comment faire :

Sur votre ordinateur

Téléchargez la bonne version sur le site de : PHPBoost et enregistrez le fichier obtenu (smallads.zip) sur votre ordinateur dans le dossier de votre choix.
Décompressez ce fichier zip puis ouvrez le dossier nommé smallads et copiez l'intégralité de son contenu.

Sur votre serveur distant

A l'aide de votre logiciel ftp (Filezilla *mode binaire activé* recommandé), allez dans l'arborescence de votre site, ouvrez le dossier smallads et collez ce que vous avez copié précédemment. Validez la demande d'écrasement des fichiers.

Il s'agit bien de transférer le contenu du dossier smallads, pas le dossier en lui-même.

Thèmes

Avec le nouveau système de templates, l'idéal est de désinstaller puis supprimer les thèmes, en ne laissant que le thème Base, avant de passer la mise à jour.

Cependant, si votre thème est déjà prêt pour la conversion en 6.0, il faut supprimer les fichiers de l'ancienne version avant de remplacer par ceux de la nouvelle version.

La migration

Préparer le script de migration

1. Téléchargez la version mise à jour du Pack de mise à jour 5.2 vers 6.0
Celle-ci contient tous les fichiers nécessaires à la nouvelle version (la dernière version en date avec mises à jour mineures intégrées) ainsi que le script de mise à jour.

2. Décompressez l'archive "update_phpboost5_2_to_6_0.zip" dans votre ordinateur, ce qui vous donnera un dossier nommé "phpboost_update". Ouvrez ce dossier et copiez l'intégralité de son contenu.

3. Copiez (transférez) tous les fichiers et dossiers contenus dans le dossier "phpboost_update" sur votre serveur dans le même répertoire que la version 5.x existante et confirmez l'écrasement des fichiers lorsque cela vous sera demandé. Si vous n'avez pas de confirmation d'écrasement des fichiers, c'est que la procédure n'a pas été respectée.
Attention: Ne transférez pas le dossier "phpboost_update" mais seulement son contenu vers votre serveur.
Dans la plupart des cas la préparation s'arrête ici, si et seulement si c'est le cas (c'est-à-dire que vous avez lu le point 4. mais que cela ne vous concerne pas), vous pouvez passer à la section "Mise à jour du site".

4. Si un module de la version PDK est installé sur votre site (exemple Rapport de bug ou Bac à sable), veuillez le télécharger en version 6.0 et mettre le répertoire sur votre FTP (en même temps que la mise à jour si vous voulez qu'il reste actif), mais vous pourrez le faire plus tard.

Pour les thèmes, vous devez supprimer tous les fichiers de la version 5.x et mettre ceux de la 6.0 pour être sûr qu'il ne reste pas de fichiers issus de la version précédente.

Mise à jour du site

Rendez-vous sur votre site, le script de mise à jour est détecté automatiquement et vous renvoie sur l'adresse nomdusite.ext
```
/update/
```
.
Vous pouvez suivre les différentes étapes, qui sont proches de la procédure d'installation de PHPBoost. Notez que les informations de base de données n'ont pas besoin d'être renseignées puisqu'elles l'ont déjà été lors de l'installation. Le temps de la conversion peut être plus ou moins long suivant la taille de la base de données.
En fin de procédure, un lien vers le rapport de migration vous sera proposé. Ce rapport est situé dans le dossier /cache et se nomme update.log. Il contient des informations sur le résultat de la migration de votre site et pourra vous être demandé en cas de problèmes.

Configurez votre site avec PHPBoost 6.0

Vérifiez vos modules et thèmes

Allez dans le panneau d'administration puis Modules et vérifiez si tous vos modules sont actifs. Si vous avez oublié d'inclure un module non compatible avant la migration, il apparaîtra comme "Non compatible".

Mise à jour d'un module

Sur votre ordinateur

Téléchargez la bonne version du module désactivé sur le site de : PHPBoost et enregistrez le fichier dans le dossier de votre choix dans votre ordinateur.
Décompressez le fichier zip, ouvrez le dossier obtenu et copiez l'intégralité de son contenu.

Sur votre serveur distant

A l'aide de votre logiciel ftp (Filezilla *mode binaire activé* recommandé), allez dans l'arborescence de votre site, ouvrez le dossier du module concerné et collez ce que vous avez copié précédemment. Validez la demande d'écrasement des fichiers.

Il s'agit bien de transférer le contenu du dossier du module, pas le dossier en lui-même.

Sur votre site

Allez maintenant dans le panneau d'administration puis Modules et Mettre à jour un module. Le module sera converti et automatiquement activé en fin de traitement.

Migration terminée

Une fois connecté sur votre site, un message vous invitera à supprimer le dossier /update et/ou /install de votre serveur. Ne laissez pas ces dossiers en place, car une personne mal intentionnée pourrait endommager votre site en relançant les scripts associés. Il suffira de cliquer sur le bouton Supprimer (après avoir fait une sauvegarde de ce dossier à cause des logs qu'il contient) pour supprimer le(s) dossier(s) automatiquement.
En fonction du navigateur utilisé, il est possible que celui-ci garde en cache la redirection vers le script d'update même si le dossier a été supprimé. Dans ce cas, videz le cache du navigateur en appuyant sur Ctrl + F5 ou CTRL + MAJ + F5 (vidage du cache navigateur) si le CTRL + F5 n'a pas suffit.
Passez en revue l'ensemble des données, configurations et autorisations. Vérifiez la présence de vos menus et reparamétrez les si nécessaire dans le panneau d'administration, gestion des menus.

Si vous ne l'aviez pas déjà fait avant de lancer la mise à jour, votre site est automatiquement placé en maintenance au début de celle-ci. N'oubliez pas de la désactiver une fois toutes vos vérifications effectuées.

Mise en place des redirections 301 pour les anciens liens de PHPBoost

Pour éviter que vous ne tombiez sur des erreurs 404, nous avons développé un module qui met en place tout seul des redirections 301.
Cela va permettre également aux moteurs de recherche de savoir qu'une page a changé d'url.
Le module (UrlUpdater) est installé comme un module standard lors de la mise à jour et vous n'avez pas besoin de vous en occuper.
Au moindre problème, contactez le support sur le forum PHPBoost.

Bonne continuation sur PHPBoost 6.0 Zonda !

Migrer son site vers une nouvelle version

Fri, 21 Apr 2023 04:26:48 +0200

Cet article regroupe l'ensemble des liens vers les procédures de mises à jour de PHPBoost.

Il existe deux types de mises à jour sur PHPBoost.

Les mises à jour Mineures
Les mises à jour Majeures

Les mises à jours Mineures

Les mises à jour mineures du type 5.0.1 / 5.0.2 ne sont pas très lourdes et ne nécessitent qu'une copie des nouveaux fichiers sur votre site.

En revanche, elle doivent toutes être appliquées pour ne pas oublier un correctif.

Si votre site est en V5.0.0 et que la dernière mise à jour est la 5.0.10, il vous faudra faire les 10 mises à jour intermédiaires dans l'ordre.Dans le cas ou vous n'avez fait strictement aucune modification sur les fichiers d'origine, il pourrait être aussi rapide de prendre l'archive complète qui est à jour de la dernière version.

=> Rendez-vous dans la section téléchargement pour récupérer les mises à jour dont vous avez besoin.

Pour installer les mises à jours mineures il vous suffit simplement d'écraser les fichiers de votre site par ceux contenu dans l'archive de mise à jour mineur.

Il ne faut rien supprimer, si votre logiciel FTP vous indique que les fichiers sont déjà présent il vous suffit de lui dire de les écraser/remplacer, idem si vous êtes en local

Les mises à jour Majeures

Les mises à jour majeures du type 5.0 / 5.1 sont plus lourdes et nécessitent un script de conversion (/update).

Une procédure est dédiée à chaque mise à jour majeure.

=> Vous pouvez retrouver toutes les procédures ci-dessous afin de procéder à la mise à jour très simplement.

Si vous souhaitez passer plusieurs versions, il est conseillé de suivre les tutoriels un par un, dans l'ordre des évolutions.

Votre site web est maintenant à jour, mais il faut penser aux mises à jour de votre thème afin de pouvoir profiter pleinement de votre site web. L'article migrer-un-theme-vers-une-nouvelle-version vous permettra de réaliser les actions nécessaires.

Passer son site 5.1 en version 5.2

Sun, 09 Feb 2020 13:17:08 +0100

Une migration, comment ça marche ?

Pour effectuer une montée de version majeure (appelée migration) il ne suffit pas de remplacer les fichiers ou d'appliquer un patch comme pour les mises à jour mineures. Des changements ayant été effectués dans la structure de la base de données, celle ci doit donc être convertie pour que la nouvelle version fonctionne correctement.
La conservation des données existantes (contenus d'articles, de news ou autres) doit être évidemment garantie, c'est ce que fera le script de migration que vous allez utiliser.
Voici donc les différentes étapes à suivre pour migrer vers PHPBoost 5.2 :

Prérequis

Conseils

Lisez attentivement et en totalité cette procédure avant de commencer quoi que ce soit. La majorité des migrations ratées sont le résultat d'une procédure non respectée.
Si vous avez un doute, posez votre question sur le forum, nous y répondrons dans les meilleurs délais.
Et n'oubliez pas de réaliser vos sauvegardes avant toute chose. Nous pourrons toujours arriver à faire fonctionner votre site, mais pas à restituer vos propres données.

Versions logicielles

La version minimale de PHP est la 5.6 pour installer PHPBoost 5.2, mais nous vous recommandons de passer si possible en PHP 7.0, 7.1 ou 7.2.

La compatibilité de PHPBoost 5.2 avec la version 7.2 de PHP ayant été testée, vous pouvez donc l'utiliser.

Sauvegardes

Pour les thèmes, nous vous invitons à regarder cet article.
Pour la base de données, nous vous invitons à regarder cet article ou cet article.
Pour le contenu de votre site, nous vous invitons à regarder cet article (au lieu de copier vers le serveur en ligne, vous copierez vers le serveur local ou nouveau serveur)

Préparer votre site

Modules et Thèmes

Nous vous conseillons fortement de suivre la procédure suivante avant de lancer le script de migration :Avant de lancer la migration en elle même, prenez le temps d'intégrer les modules ou thèmes non officiels convertis en version 5.2 dans votre organisation de site à l'aide de votre logiciel ftp. Ils seront alors automatiquement installés ou mis à jour pendant le traitement.
En cas de problème, contactez l'auteur du module ou du thème.
Vous pouvez vous reporter à cette liste pour savoir quels sont les modules officiels.
Exemple:
Vous utilisez le module Petites Annonces (dossier smallads) et vous pouvez constater qu'il n'est pas présent dans la liste des modules officiels. Il ne sera donc pas converti automatiquement si vous ne le préparez pas avant. Pour l'inclure dans le processus de mise à jour, voici comment faire :

Sur votre ordinateur

Téléchargez la bonne version sur le site de : PHPBoost et enregistrez le fichier obtenu (smallads.zip) sur votre ordinateur dans le dossier de votre choix.
Décompressez ce fichier zip puis ouvrez le dossier nommé smallads et copiez l'intégralité de son contenu.

Sur votre serveur distant

A l'aide de votre logiciel ftp (Filezilla *mode binaire activé* recommandé), allez dans l'arborescence de votre site, ouvrez le dossier smallads et collez ce que vous avez copié précédemment. Validez la demande d'écrasement des fichiers.

Il s'agit bien de transférer le contenu du dossier smallads, pas le dossier en lui-même.

La procédure est la même pour les thèmes dont vous pouvez transférer la version compatible par ftp avant de lancer la migration.

La migration

Préparer le script de migration

1. Téléchargez la version mise à jour du Pack de mise à jour 5.1 vers 5.2
Celle-ci contient tous les fichiers nécessaires à la nouvelle version (la dernière version en date avec mises à jour mineures intégrées) ainsi que le script de mise à jour.

2. Décompressez l'archive "pack-de-mise-a-jour-5-1-vers-5-2" dans votre ordinateur, ce qui vous donnera un dossier nommé "phpboost_update". Ouvrez ce dossier et copiez l'intégralité de son contenu.

3. Copiez (transférez) tous les fichiers et dossiers contenus dans le dossier "phpboost_update" sur votre serveur dans le même répertoire que la version 5.1 existante et confirmez l'écrasement des fichiers lorsque cela vous sera demandé. Si vous n'avez pas de confirmation d'écrasement des fichiers, c'est que la procédure n'a pas été respectée.
Attention: Ne transférez pas le dossier "phpboost_update" mais seulement son contenu vers votre serveur.
Dans la plupart des cas la préparation s'arrête ici, si et seulement si c'est le cas (c'est-à-dire que vous avez lu le point 4. mais que cela ne vous concerne pas), vous pouvez passer à la section "Mise à jour du site".

4. Si un module de la version PDK est installé sur votre site (exemple Rapport de bug ou Bac à sable), veuillez le télécharger en version 5.2 et mettre le répertoire sur votre FTP (en même temps que la mise à jour si vous voulez qu'il reste actif), mais vous pourrez le faire plus tard.

Il est quand même conseillé de "purger" totalement le thème en V5.1 avant de mettre celui en V5.2 pour être sûr qu'il ne reste plus de fichiers issus de la version précédente.

Mise à jour du site

Rendez-vous sur votre site (le script de mise à jour est détecté automatiquement).
Vous pouvez suivre les différentes étapes, qui sont proches de la procédure d'installation de PHPBoost. Notez que les informations de base de données n'ont pas besoin d'être renseignées puisqu'elles l'ont déjà été à l'installation. Le temps de la conversion peut être plus ou moins long suivant la taille de la base de données. En moyenne, comptez quelques minutes.

En fin de procédure, un lien vers le rapport de migration vous sera proposé. Utilisez le, téléchargez le fichier texte et enregistrez le dans votre ordinateur.
Ce fichier contient des informations sur le résultat de la migration de votre site, il pourra vous être demandé en cas de problèmes.

Autre problème rencontré :

Code TXT :

Fatal error: Call to a member function get_configuration() on null in VotreSite/admin/server/controllers/AdminServerSystemReportController.class.php on line 58
Fatal error: Call to a member function check_compatibility() on boolean in VotreSite/admin/updates/updates.php on line 60

Solution :
Dans ce cas, recommencez la procédure de migration. Si, à la suite de cette nouvelle migration, les mêmes erreurs surviennent, veuillez revalider (ou remettre les données si non disponibles) l'ensemble des pages configuration générale, configuration avancée et configuration de l'envoi mail dans le panneau d'administration de votre site.

Configurez votre site avec PHPBoost 5.2

Vérifiez vos modules et thèmes

Mise à jour d'un module

Sur votre ordinateur

Téléchargez la bonne version du module désactivé sur le site de : PHPBoost et enregistrez le fichier dans le dossier de votre choix dans votre ordinateur.
Décompressez le fichier zip, ouvrez le dossier obtenu et copiez l'intégralité de son contenu.

Sur votre serveur distant

A l'aide de votre logiciel ftp (Filezilla *mode binaire activé* recommandé), allez dans l'arborescence de votre site, ouvrez le dossier du module concerné et collez ce que vous avez copié précédemment. Validez la demande d'écrasement des fichiers.

Il s'agit bien de transférer le contenu du dossier du module, pas le dossier en lui-même.

Sur votre site

Allez maintenant dans le panneau d'administration puis Modules et Mettre à jour un module. Le module sera converti et automatiquement activé en fin de traitement.

Migration terminée

Une fois connecté sur votre site, un message vous invitera à supprimer le dossier /update et/ou /install de votre serveur. Ne laissez pas ces dossiers en place, car une personne mal intentionnée pourrait endommager votre site en relançant les scripts associés. Il suffira de cliquer sur le bouton Supprimer (après avoir fait une sauvegarde de ce dossier à cause des logs qu'il contient) pour supprimer le(s) dossier(s) automatiquement.
En fonction du navigateur utilisé, il est possible que celui-ci garde en cache la redirection vers le script d'update même si le dossier a été supprimé. Dans ce cas, videz le cache du navigateur en appuyant sur Ctrl + F5 ou CTRL + MAJ + F5 (vidage du cache navigateur) si le CTRL + F5 n'a pas suffit.
Passez en revue l'ensemble des données, configurations et autorisations. Vérifiez la présence de vos menus et reparamétrez les si nécessaire dans le panneau d'administration, gestion des menus.

Mise en place des redirections 301 pour les anciens liens de PHPBoost

Passer son site 5.0 en version 5.1

Sun, 25 Mar 2018 14:33:49 +0200

Pour pouvoir passer de la version 5.0 à la 5.1, il ne suffit pas de remplacer les fichiers ou d'appliquer un patch comme pour les mises à jour mineures.

Étant donné qu'il y a eu plusieurs changements dans la structure de la base de données, il faut faire des conversions pour que la nouvelle version fonctionne correctement. Voici donc les différentes étapes à suivre pour migrer vers PHPBoost 5.1.

La version minimale de PHP est la 5.6 pour installer PHPBoost 5.1, mais nous vous recommandons de passer si possible en PHP 7.0 ou 7.1.

La compatibilité de PHPBoost 5.1 avec la version 7.2 de php n'ayant pas été testée, nous vous recommandons de ne pas l'utiliser pour le moment.

Prérequis

En premier lieu, vous devez effectuer une sauvegarde de tout votre site (répertoires et fichiers constituant le site et la base de données). Si ce n'est pas fait, aucun retour en arrière ne sera possible après migration en cas de problème.

Aussi durant tout le long il faut rester connecté en tant qu'administrateur et ne jamais se déconnecter volontairement avant la migration.

Pour la base de données, nous vous invitons à regarder cet article.
Pour le contenu de votre site, nous vous invitons à regarder cet article (au lieu de copier vers le serveur en ligne, vous copierez vers le serveur local ou nouveau serveur)

En second lieu, cette migration ne vaut que pour le noyau du CMS ainsi que ses modules associés, compatibles avec la nouvelle version. Les thèmes et les modules non officiels non compatibles devront être migrés à part avec la procédure les affairant.

Les modules et thèmes non officiels non compatibles seront désactivés pendant migration, il faudra uploader leur version PHPBoost 5.1 pour pouvoir les réactiver.

Les modules ou thèmes non officiels qui ont déjà été convertis en version compatible PHPBoost 5.1 peuvent être inclus lors de la mise à jour, ils seront automatiquement installés ou mis à jour lors de la migration. En cas de problème, contactez l'auteur du module ou du thème.

Vous pouvez vous reporter à cette liste pour savoir quels sont les modules officiels.

Il sera aussi important de sauvegarder la/les thèmes 5.0 se trouvant dans le répertoire /templates car le premier redémarrage se fera avec le thème base de la version 5.1 si votre thème n'est pas compatible.

Nous vous invitons à regarder cet article.

Enfin, il vous faudra recenser tous les répertoires et fichiers que vous avez ajoutés en plus de ceux constituant le CMS PHPBoost pour bien les identifier avant de suivre cette procédure.

Préparer votre site

Cette partie doit être bien lue dans son intégralité (et plusieurs fois au besoin) pour diminuer le risque d'erreurs ou de fausses manipulations qui pourraient rendre le site provisoirement inutilisable.

De plus vous devez être connecté avec un compte administrateur sur votre site avant de commencer la migration, et pour plus de sécurité, il est conseillé de placer le site en maintenance pour éviter d'éventuelles interactions avec vos membres ou visiteurs.

1. Téléchargez la version mise à jour du Pack de migration 5.0 en 5.1.

Celle-ci contient tous les fichiers nécessaires à la nouvelle version (la dernière version en date avec mises à jour mineures intégrées) ainsi que le script de mise à jour.

2. Décompressez l'archive "pack-de-mise-a-jour-5-0-vers-5-1" sur votre bureau, ce qui vous donnera un dossier nommé "phpboost_update" et transférez tous les fichiers et dossiers contenus dans le dossier phpboost_update (et non le dossier) sur votre serveur dans le même répertoire que la version 5.0 existante et confirmez l'écrasement des fichiers lorsque cela vous sera demandé. Si vous n'avez pas de confirmation d'écrasement des fichiers, c'est que la procédure n'a pas été respectée.

Attention: Ne transférez pas le dossier "phpboost_update" mais seulement son contenu vers votre serveur.

Dans la plupart des cas la préparation s'arrête ici, si et seulement si c'est le cas (c'est-à-dire que vous avez lu le point 3. et 4. mais que cela ne vous concerne pas), vous pouvez passer à la section "Mise à jour du site".

3. Si un module de la version PDK est installé sur votre site (exemple Rapport de bug ou Bac à sable), veuillez le télécharger en version 5.1 et mettre le répertoire sur votre FTP (en même temps que la mise à jour si vous voulez qu'il reste actif, mais vous pouvez le faire plus tard, auquel cas il(s) sera/seront désactivé(s)).

4. Si les versions compatibles PHPBoost 5.1 de vos modules non officiels et/ou vos thèmes non officiels sont disponibles, téléchargez-les, décompressez-les et uploadez-les également (avant de lancer la migration). Ils seront mis à jour automatiquement dans ce cas.

Il est quand même conseillé de "purger" totalement le thème en V5.0 avant de mettre celui en V5.1 pour être sûr qu'il ne reste plus de fichiers de la V5.0 au niveau du thème

Mise à jour du site

Rendez-vous sur votre site (le script de mise à jour est détecté automatiquement).
Vous pouvez suivre les différentes étapes, qui sont proches de la procédure d'installation de PHPBoost que vous avez connue au moment de la création de votre site PHPBoost version 5.0, 4.1 ou 4.0. À noter que les informations de base de données n'ont pas besoin d'être renseignées puisqu'elles l'ont déjà été à l'installation. Le temps de la conversion peut être plus ou moins long suivant la taille de la base de données. En moyenne, comptez quelques minutes.

Problèmes potentiels

Dans certains cas, vous risquez de voir s'afficher un message de ce genre:

Code TEXT :

unserialize(): Error at offset 358 of 681 bytes
[0] /kernel/framework/helper/TextHelper.class.php:305
[0] /kernel/framework/helper/TextHelper.class.php:305 - unserialize(string)
[1] /kernel/framework/phpboost/menu/MenuService.class.php:602 - TextHelper::unserialize(string)
[2] /kernel/framework/phpboost/menu/MenuService.class.php:88 - MenuService::initialize(array)
[3] /admin/menus/menus.php:117 - MenuService::get_menus_map()
[URL] /admin/menus/menus.php

Nous avons effectivement constaté que certains menus n'étaient pas correctement convertis en UTF-8 et généraient ce type de message.

Solution de contournement conseillée:

Restaurer votre version 5.0 (ftp + bdd)
Supprimer dans l'administration les menus personnalisés que vous aviez créés.
Faculatif mais recommandé - Désinstaller les thèmes personnalisés que vous aviez créés pour avoir seulement le thème de base actif ( vérification dans la configuration générale)
Relancer la procédure transfert ftp + lancement du script de migration expliquée plus haut.

Pour les utilisateurs novices, cette procédure (ci-dessus) peut être appliquée durant la préparation de votre site avant la migration. Elle garantit un plus grand pourcentage de réussite.

Autre solution de contournement (pour les utilisateurs familiers à l'utilisation de PhpMyAdmin) :

Dans la table PREFIX_menus (par défaut PREFIX = phpboost), supprimer un par un les enregistrements correspondants aux menus ajoutés par vos soins (autres que ceux existants par défaut)
Une fois que le message n'apparaît plus, vous devrez refaire le (ou les) menus concernés directement à partir de l'administration du site.

Autre problème rencontré :

Code TXT :

Fatal error: Call to a member function get_configuration() on null in VotreSite/admin/server/controllers/AdminServerSystemReportController.class.php on line 58
Fatal error: Call to a member function check_compatibility() on boolean in VotreSite/admin/updates/updates.php on line 60

Solution :

Dans ce cas, recommencez la procédure de migration. Si, à la suite de cette nouvelle migration, les mêmes erreurs surviennent, veuillez revalider (ou remettre les données si non disponibles) l'ensemble des pages configuration générale, configuration avancée et configuration de l'envoi mail dans le panneau d'administration de votre site.

Configurez votre site avec PHPBoost 5.1

Une fois connecté sur le site, un message vous invitera à supprimer le dossier /update et/ou /install de votre serveur. Ne laissez pas ces dossiers en place, car une personne mal intentionnée pourrait endommager votre site en relançant les scripts associés. Il suffira de cliquer sur le bouton Supprimer (après avoir fait une sauvegarde de ce dossier à cause des logs qu'il contient) pour supprimer le(s) dossier(s) automatiquement. En fonction des navigateurs il est possible que celui-ci garde en cache la redirection vers le script d'update même quand le dossier a été supprimé. Dans ce cas, videz le cache de votre navigateur en appuyant sur Ctrl + F5.
Passez en revue l'ensemble des données, configurations et autorisations puis désactivez la maintenance pour rouvrir le site.

Si vous ne l'aviez pas déjà fait avant de lancer la mise à jour, votre site sera automatiquement placé en maintenance au début de celle-ci. N'oubliez pas de la désactiver une fois toutes vos vérifications effectuées.

Mise en place des redirections 301 pour les anciens liens de PHPBoost 5.0

Pour éviter que vous tombiez sur des erreurs 404, nous avons développé un module qui met en place tout seul des redirections 301.

Cela va permettre également aux moteurs de recherche de savoir qu'une page a changé d'url.

Le module (UrlUpdater) est installé comme un module standard lors de la mise à jour et vous n'avez pas besoin de vous en occuper.

Au moindre problème, contactez le support sur le forum PHPBoost.

Bonne continuation sur PHPBoost 5.1 !

Passer son site 4.1 en version 5.0

Thu, 01 Mar 2018 11:35:15 +0100

Pour pouvoir passer de la version 4.1 à la 5.0, il ne suffit pas de remplacer les fichiers ou d'appliquer un patch comme pour les mises à jour mineures.

Étant donné qu'il y a eu plusieurs changements dans la structure de la base de données, il faut faire des conversions pour que la nouvelle version fonctionne correctement. Voici donc les différentes étapes à suivre pour migrer vers PHPBoost 5.0.

N'oubliez pas de faire des sauvegardes de vos fichiers et de la base de données avant la procédure !

La version PHP minimale est toujours la 5.4 pour installer PHPBoost 5.0, mais cela fonctionne également avec PHP 7.0.

Prérequis

En premier lieu, nous vous conseillons très fortement d'effectuer une sauvegarde de tout votre site. Que ce soit des répertoires et fichiers constituant le site ou de la base de données.

Pour la base de données, nous vous invitons à regarder cet article.
Pour le contenu de votre site, nous vous invitons à regarder cet article (au lieu de copier vers le serveur en ligne, vous copierez vers le serveur local ou nouveau serveur)

Les modules et thèmes non officiels non compatibles seront désactivés pendant migration, il faudra uploader leur version PHPBoost 5.0 pour pouvoir les réactiver.

Les modules ou thèmes non officiels qui ont déjà été convertis en version compatible PHPBoost 5.0 peuvent être inclus lors de la mise à jour, ils seront automatiquement installés ou mis à jour lors de la migration. En cas de problème, contactez l'auteur du module ou du thème.

Il sera aussi important de sauvegarder la/les thèmes 4.1 se trouvant dans le répertoire /templates car le premier redémarrage se fera avec le thème base de la version 5.0 si votre thème n'est pas compatible.

Nous vous invitons à regarder cet article.

Les menus présents dans le dossier /menus (donc le dossier sur le FTP) sont aussi à sauvegarder. Le fonctionnement des menus a changé, il faut maintenant les installer comme des modules. Ils seront désactivés lors de la mise à jour.

Nous vous invitons à regarder cet article pour créer un menu si besoin.

Enfin, il vous faudra recenser tous les répertoires et fichiers que vous avez ajoutés en plus de ceux constituant le CMS PHPBoost pour bien les identifier avant de suivre cette procédure.

Préparer votre site

Télécharger les sources

Téléchargez la version mise à jour du pack-de-mise-a-jour-4-1-vers-5-0. Ce zip contient le script de mise à jour ainsi que les mises à jour mineures de la dernière version de PHPBoost 5.0 (jusqu'à la 5.0.18 incluse à la date du 11/07/2017).

Si vous avez téléchargé le pack de migration avant le 11/07/2017, nous vous conseillons de le télécharger à nouveau pour bénéficier de toutes les mises à jour mineures.

Transférer les fichiers

Décompressez le fichier "update_phpboost4_1_to_5_0.zip" dans le dossier de votre choix sur votre ordinateur, vous obtenez un dossier "phpboost_update".
Ouvrez votre logiciel ftp (filezilla par exemple) et sélectionnez tous les dossiers et fichiers contenus dans le dossier "phpboost_update" et transférez les sur votre serveur dans le même répertoire que la version 4.1 existante. Une confirmation d'écrasement des fichiers vous sera demandée, ce qu'il faudra accepter, d'où la sauvegarde obligatoire avant de lancer la procédure.
Vérifiez sur votre serveur que tous les fichiers ont été correctement transférés.

Attention: Ne transférez pas le dossier "phpboost_update" mais seulement son contenu vers votre serveur.

Dans la plupart des cas la préparation s'arrête ici (si et seulement si c'est le cas, vous pouvez passer à la section "Mise à jour du site").

3. Si un module de la version PDK est installé sur votre site (exemple Rapport de bug ou Bac à sable), veuillez le télécharger en version 5.0 et mettre le répertoire sur votre FTP (en même temps que la mise à jour si vous voulez qu'il reste actif, mais vous pouvez le faire plus tard, auquel cas il(s) sera/seront désactivé(s)).

4. Si les versions compatibles PHPBoost 5.0 de vos modules non officiels et/ou vos thèmes non officiels sont disponibles, téléchargez-les, décompressez-les et uploadez-les également. Ils seront mis à jour automatiquement dans ce cas.

5. Si vous avez des menus de liens, éditez-les un a un puis revalidez-les pour leur appliquer la nouvelle configuration.

Mise à jour du site

Connectez-vous sur votre site (le script de mise à jour est détecté automatiquement).

- Vous pouvez suivre les différentes étapes, qui sont proches de la procédure d'installation de PHPBoost que vous avez connue au moment de la création de votre site PHPBoost version 4.1 ou 4.0. À noter que les informations de base de données n'ont pas besoin d'être renseignées puisqu'elles l'ont déjà été à l'installation. Le temps de la conversion peut être plus où moins long suivant la taille de la base de données. En moyenne, comptez une à deux minutes.

Si vous ne l'aviez pas déjà fait avant de lancer la mise à jour, votre site sera automatiquement placé en maintenance au début de celle-ci.

Configurez votre site sur PHPBoost 5.0

Une fois connecté sur le site, un message vous invitera à supprimer le dossier /update et/ou /install de votre serveur afin d'empêcher une personne mal intentionnée de relancer la procédure, ce qui pourrait endommager votre site. Il suffira de cliquer sur le bouton Supprimer (après avoir fait une sauvegarde de ce dossier à cause des logs qu'il contient) pour supprimer le(s) dossier(s) automatiquement. En fonction des navigateurs il est possible que celui-ci garde en cache la redirection vers le script d'update même quand le dossier a été supprimé. Dans ce cas, videz le cache de votre navigateur en appuyant sur Ctrl + F5.

- Passez en revue l'ensemble des données, configurations et autorisations puis désactivez la maintenance pour rouvrir le site.

Mise en place des redirections 301 pour les anciens liens de PHPBoost 4.1

Pour éviter que vous tombiez sur des erreurs 404, nous avons développé un module qui met en place tout seul des redirections 301.

Cela va permettre également aux moteurs de recherche de savoir qu'une page a changé d'URL.

Le module (UrlUpdater) est installé comme un module standard lors de la mise à jour et vous n'avez pas besoin de vous en occuper.

Au moindre problème, contactez le support sur le forum PHPBoost.

Bonne continuation sur PHPBoost 5.0 !

Passer son site 2.0 en version 3.0

Tue, 08 Jan 2013 11:53:28 +0100

Un processus de conversion complexe

La version 3 est une version majeure de PHPBoost, les changements du code en interne et de la base de données (qui stocke le contenu du site) sont très nombreux. Certains systèmes n'existent plus : c'est le cas des menus de liens gérés par le système désormais. Tout convertir aurait énormément retardé la sortie du script de migration. Ainsi certains éléments ne sont pas convertis, en voici la liste :

Certaines configurations sont perdues car trop différentes par rapport à la 3.0.
Les menus de liens 2.0 ne sont pas transférés, les menus des modules 3.0 sont mis par défaut.
Les droits dans de nombreux endroits sont perdus. Le système d'autorisations par niveau/groupes/membres beaucoup plus puissant et flexible les remplace alors.
Les rangs ne sont pas transférés

Il est donc fortement conseillé, une fois la mise à jour achevée, de mettre votre site en maintenance et de vérifier les autorisations dans les différents modules.

Un dernier conseil avant de commencer qui est primordial, faites la mise à jour sur une sauvegarde et non sur votre site.

Détail de la procédure

Préparation de votre site

- Sur votre site PHPBoost 2.0 avec les fichiers de la version 2.0, sauvegardez les dossiers suivants :

/gallery/pics (si le module gallery est installé)
/gallery/pics/thumbnails (si le module gallery est installé)
/images
/upload

- Une fois ces fichiers sauvegardés à part en sécurité supprimez tous les autres dossiers et fichiers. (attention à ne pas supprimer de dossiers/fichiers étrangers à PHPBoost !)

- Mettez les fichiers et dossiers de la version 2.0 que vous avez préalablement sauvegardés sur votre serveur dans le répertoire où la version 2.0 était installée.

- Téléchargez la version complète de PHPBoost 3.0 Tornade. Il faut cette version pour une conversion correcte !

- Mettez tous les fichiers et dossiers de la version 3.0 au même endroit qu'à l'étape précédente.

- Téléchargez le pack de mise à jour à cette adresse : PHPBoost 2.0 vers PHPBoost 3.0

- Mettez le pack de mise à jour au même endroit qu'à l'étape précédente.

Mise à jour de votre site

- Rendez vous à l'adresse suivante (en remplaçant

http://www.monsite.com

par l'adresse de votre site) :

http://www.monsite.com/update/update.php

- Là vous pouvez suivre les différentes étapes, il s'agit d'une procédure proche de l'installation de PHPBoost que vous avez dû connaitre au tout début de votre site 2.0. A noter que lorsque vous choisirez le nom de base de données, il s'agit de celui de la base de données 2.0 à convertir.

Configurez votre site sur PHPBoost 3.0

- En premier lieu supprimez le dossier /update de votre serveur, une personne mal intentionnée pourrait endommager votre site le cas échéant.

- Mettez votre site en maintenance dans l'administration et passez en revue l'ensemble des configurations et autorisations.

Au moindre problème contactez le support sur le forum PHPBoost.

Bonne continuation sur PHPBoost 3.0 !