Tout d'abord, faites une sauvegarde de votre base de données, de vos fichiers de configuration etc.

Comme d'habitude, vous devez vider le contenu de votre répertoire temp/votreapp/.

Depuis la dernière version de la branche 1.4, il y a eu quelques correctifs dans les scripts de migrations, mais qui n'ont pas été publié dans une nouvelle version de Jelix 1.4, faute d'avoir un PHP assez vieux pour regénérer les paquets.

Téléchargez donc https://download.jelix.org/jelix/releases/1.4.x/1.4.8/jelix_1.4.8_patch.zip, et dézippez-le à partir du répertoire parent de lib/. Cela remplacera quelques fichiers. Vous pouvez trouvez ceci également ici https://github.com/jelix/jelix/tree/jelix-1.4.x/build/patch .

jApp fournissant de nouvelles API, il faut changer le code de vos points d'entrées.

• L'instance du coordinateur doit être indiqué à jApp.
• Le chemin du fichier de configuration doit être lui aussi indiqué à jApp au lieu d'être passé en paramètre au coordinateur
• Voyez un exemple dans le template dans lib/jelix-scripts/templates/www/index.php.tpl

Voici un exemple typique:

require ('../application.init.php');
require (JELIX_LIB_CORE_PATH.'request/jClassicRequest.class.php');

checkAppOpened();

// Charge la configuration
jApp::loadConfig('index/config.ini.php');

// nouveau coordinateur, que l'on indique à jApp
jApp::setCoord(new jCoordinator());

// Nouvel objet request, que l'on passe au coordinateur, pour traiter le routage.
jApp::coord()->process(new jClassicRequest());

Mettez à jour les sources des modules tiers que vous avez installés, et qui sont compatibles avec Jelix 1.4.

Et pour vos propres modules, vous devez adapter le code source en faisant les modifications suivantes :

• La variable globale $gJConfig est obsolète. Utilisez maintenant jApp::config() pour récupérer la configuration.
• La variable globale $gJCoord est obsolète. Utilisez maintenant jApp::coord() pour récupérer l'objet coordinateur.
• Le code de locale 'en_EN' est maintenant obsolète. Vous avez alors deux solutions si vous l'utilisez dans vos applications :
  • une solution rapide mais temporaire : ajoutez le paramètre "en=en_EN" dans la section "[langToLocale]" de la configuration principale.
  • une meilleure solution: renommez vos repertoires locales/en_EN en locales/en_US, utilisez le code en_US comme locale par défaut (si vous utilisiez en_EN), et si vous stockiez le code en_EN dans vos données, changez les avec en_US. C'est la solution préférée, car le code en_EN ne sera plus supporté dans des versions futures de Jelix.
• Dans les fichiers module.xml, indiquez que le module est compatible avec Jelix 1.4 (changer l'attribut maxversion). Exemple :

        <jelix minversion="1.3" maxversion="1.4.*"/>

• Les méthodes jCoordinator::isModuleEnabled() and jCoordinator::getModulePath() sont désormais obsolète, elles ont été copiée dans jApp, il faut donc utiliser celle de jApp.
• Dans vos pages statiques HTML (via jResponseBasicHtml) et page d'erreur statiques (error.en_US.php etc) la variable $basePath doit être renommée en $BASEPATH. (Jelix 1.4.1)

Lisez la liste détaillée des changements pour savoir la liste des nouvelles classes et méthodes que vous pouvez utiliser.

Après toutes les modifications effectuées, vous devez lancer le script installer.php de votre application. Le module jelix fera le reste des modifications, en particulier :

• Le paramètre de configuration availableLanguageCode du plugin autolocale, si vous l'utilisez, est déplacé vers la configuration principale et renommé en availableLocales.