3- Identification et modifications personnelles de votre système actuel
Cette étape consiste à déterminer votre version actuelle de pragmaMx et concerne surtout les utilisateurs ayant fait multiples modifications personnelles par modification du code php et/ou html de notre système. Nous pouvons donc déterminer deux grands groupes d'utilisateurs.
1er Groupe: Certains utilisateurs qui profitent de pragmaMx tel quel, c.a.d sans avoir modifié aucun des fichiers source du cms .
Sachez dans tous les cas quel que soit votre groupe, le template utilisé et/ou modifié a sa propre entité et n'est pas directement concerné lors des mise à jour !
2ème Groupe: Des utilisateurs plus connaisseurs ont apporté des modifications personnelles directement dans les fichiers du système (Modification de code php-html). Si vous effectuez la mise à jour "classiquement", celle-ci va écraser vos modifications personnelles qu'il faudra sera obligé de refaire uns à uns par la suite. Nous allons donc vous expliquer comment cibler les fichiers concernés et la manière la plus simple et plus rapide d'effectuer votre mise à jour tout en conservant vos modifications personnelles.
3-1 Identification de la version actuelle de votre pragmaMx
Dans tous les cas, pour connaitre la version actuelle de votre système (1), connectez-vous en administrateur et rendez-vous sur la page d'accueil du panneau d'administration, visualisez ensuite la version du cms comme l'exemple ci-dessous.
En (1) nous avons la version du système utilisé (PragmaMx 0.1.9 pour notre exemple).
La mise à jour se fait toujours vers la version immédiatement supérieure.
C'est à dire si vous avez une version 0.15 vous devez passer par la mise à jour 0.16 puis 0.17 puis, 0.18 etc........
3-2 Vérification des fichiers sources et fichiers modifiés
Vous faites parti du deuxième groupe d'utilisateurs (connaisseur) et vous avez effectué des modifications directement dans le code des fichiers .php de votre système, mais avec le temps vous en vous souvenez plus quels fichiers vous avez modifié et quelles modifications vous avez effectué. PragmaMx est là pour vous aider car il dispose d'un script intégré de vérification de version permettant de lister tous les fichiers du système en vous indiquant clairement lesquels ont été modifié par rapport à une version originale de pragmaMx.
Cliquez donc sur le lien (2) et affichez seulement les différences.
Exemple:
Vous avez ainsi une liste plus où moins grande des fichiers du système qui présentent des différences par rapport à la version originale. Il s'agit de l'ensemble des fichiers que vous avez modifié (cf statut) de vous même suite à des changements personnels, il va donc falloir se souvenir de la liste de ces fichiers qui faudra revoir par la suite.
Nous vous conseillons donc:
- Soit de faire une capture d'écran du listing
- Soit de faire une sélection puis un copier/coller dans votre éditeur de la liste de ces fichiers.
Ensuite, sachant que nous nous avons une sauvegarde de tous ces fichiers (cf: Sauvegarde intégrale du tutorial), vous pouvez faire votre mise à jour comme indiqué à l'étape suivante (4).
Pour retrouver l'ensemble de vos modifications personnelles une fois la mise à jour de pragmaMx effectuée et fonctionnelle il vous suffit d'utiliser un comparateur de fichiers.
Vous comparez ensuite vos fichiers de sauvegarde (contenant vos modifications personnelles) avec ceux de la nouvelle version de pragmaMx et vous pouvez ainsi transposer vos modifications de code sur le nouveau fichier de pragmaMx.
Cas particulier de certains fichiers blocs et modules particuliers. Ceux-ci contiennent des options de configuration directement dans le code php et en cas de mise à jour vous devrez à nouveau régler votre configuration (la technique de comparaison précitée peut aussi être utilisée).