Passer de la version 6 à la version 7

LimeSurvey 7, version majeure

Cette page présente une vue d’ensemble des principaux changements introduits avec LimeSurvey 7 et renvoie vers les pages de documentation correspondantes.

  Ces informations s’appliquent principalement à l’édition communautaire de LimeSurvey (CE).

Principaux changements dans LimeSurvey 7

Structure modifiée des tables de réponses et des noms de champs

LimeSurvey 7 introduit un nettoyage structurel de la manière dont les tables de réponses et les noms de champs sont générés. Ce changement améliore la cohérence et facilite la maintenance et l’évolution de la plateforme.

Plus de détails ici : Refonte des noms de champs et des tables de réponses - LimeSurvey 7

Nouvel éditeur de questions

LimeSurvey 7 introduit également un nouvel éditeur de questions, doté d’une interface utilisateur modernisée et de flux de travail améliorés pour créer et gérer les questions.

Plus de détails ici : Nouvel éditeur de questions dans LimeSurvey 7

Modifications de l’API RemoteControl

Les réponses de l’API RemoteControl 2 ont été améliorées : elles renvoient désormais des codes d’erreur en plus du texte de l’erreur. Veuillez consulter la documentation API RemoteControl 2 pour connaître ces changements. Selon la manière dont vous traitez les valeurs de retour, cela devrait être rétrocompatible ; toutefois, il se peut que ce ne soit pas géré correctement dans votre implémentation.

Plus de détails ici : API RemoteControl 2

Modifications des fuseaux horaires

Dans la version 6 et les versions antérieures, les horodatages enregistrés n’étaient pas déterminés par rapport à un fuseau horaire et dépendaient de la date et de l’heure du serveur. Lors de la migration vers la version 7, l’ancien paramètre « Décalage horaire » est migré si possible, et tous les horodatages enregistrés par la suite le sont en UTC. Les anciens horodatages ne sont pas migrés. Il est possible de définir un fuseau horaire par défaut dans les paramètres généraux, et un fuseau horaire individuel peut être défini pour chaque utilisateur. Ceux-ci s’appliquent uniquement à l’affichage des données. L’export et l’API RemoteControl n’acceptent et ne fournissent que les horodatages bruts.

Thèmes de questionnaire personnalisés

Tous les thèmes de questionnaire compatibles avec LS6 resteront actifs après la mise à niveau. Si un thème de questionnaire n’était pas compatible avec LS6, il sera désinstallé, et les options de thème dans les paramètres généraux, de groupe et du questionnaire seront réinitialisées aux nouvelles valeurs par défaut.

Stratégie de mise à niveau :

1. Exportez le thème de questionnaire depuis l’ancienne application.
2. Avant de l’importer dans la nouvelle application, assurez-vous que la balise de compatibilité est correctement définie : https://manual.limesurvey.org/Extension_compatibility#Survey_themes
3. Importez-le dans la nouvelle application.
4. Vérifiez le code que vous avez personnalisé pour le thème de questionnaire et mettez-le à jour en fonction de la nouvelle version de l’application que vous souhaitez utiliser.
5. Exportez votre thème de questionnaire personnalisé mis à jour depuis la nouvelle application.
6. Après la mise à niveau, vos thèmes de questionnaire compatibles avec LS6 resteront actifs, tandis que les thèmes plus anciens seront désinstallés.
7. Si vous choisissez de mettre à jour un thème de questionnaire, vous pouvez désormais l’importer. Une fois que vous avez confirmé qu’il a été correctement mis à jour, vous pouvez choisir de supprimer l’ancien.

Thèmes d’administration personnalisés

Le thème d’administration par défaut sera activé par défaut. Les thèmes personnalisés resteront intacts, mais ne pourront pas être réactivés tant qu’ils ne sont pas mis à jour.

Pour les applications auto-hébergées :

1. Avant de copier le thème d’administration dans la nouvelle application, assurez-vous que la balise de compatibilité est correctement définie : https://manual.limesurvey.org/Extension_compatibility#Admin_themes
2. Copiez le thème d’administration existant de l’ancienne application vers la nouvelle application https://manual.limesurvey.org/Custom_Admin_Themes
3. Vérifiez le code que vous avez personnalisé pour le thème d’administration et mettez-le à jour en fonction de la nouvelle version de l’application que vous souhaitez utiliser.
4. Après la mise à niveau de votre ancienne application, notre nouveau thème d’administration est affiché par défaut. Pour mettre à jour le thème d’administration précédemment installé, vous pouvez :
   • Mettre à jour manuellement le code du thème d’administration actuellement marqué comme incompatible
   • Supprimer l’ancien thème d’administration et installer le nouveau que vous avez préalablement mis à jour dans votre environnement de test.

Pour les utilisateurs de Cloud :
Veuillez contacter notre support.

Thèmes de questions personnalisés

Les thèmes de questions personnalisés qui ne correspondent pas à la version actuelle ne peuvent pas être installés, mais resteront actifs après la mise à niveau. Vous trouverez plus d’informations sur les thèmes de questions ici : Thèmes de questions. Le JavaScript personnalisé inséré dans le thème de questionnaire ou dans l’une des questions d’un questionnaire risque également de ne plus fonctionner.

Mise à niveau de votre thème de question personnalisé :

1. Téléchargez le thème de question depuis un site web ou exportez le thème de question actuel.
2. Avant de le téléverser, assurez-vous que la compatibilité de votre thème de question personnalisé est correctement définie.
3. Essayez de téléverser votre thème de question dans la nouvelle application.
4. S’il s’agit d’un thème de question que vous avez créé vous-même, effectuez les ajustements nécessaires.
5. Une fois le téléversement réussi, vérifiez que le thème de question s’affiche et fonctionne comme prévu.

Mise à niveau d’un thème dont vous n’êtes pas l’auteur :
Vérifiez si une mise à jour est disponible sur le site web ou auprès du développeur qui l’a fourni.

Extensions personnalisées

Les extensions personnalisées qui ne correspondent pas à la version actuelle seront désactivées pendant le processus de mise à niveau.

Pour les applications auto-hébergées :

1. Vérifiez si l’extension peut être installée sur la nouvelle version.
2. Mettez à jour l’extension ou contactez son auteur pour qu’il la mette à jour.
3. Remplacez manuellement l’extension par les nouveaux fichiers dans votre application, ce qui conservera les paramètres, ou désinstallez l’ancienne version et réinstallez la nouvelle ; dans ce cas, tous les paramètres devront être saisis à nouveau.

Pour les utilisateurs de Cloud :

1. LimeSAML restera actif.
2. Vérifiez si l’extension peut être installée sur la nouvelle version.
3. Mettez à jour le code de l’extension ou contactez son auteur pour qu’il la mette à jour.
4. Options d’installation :
   • Désinstallez l’ancienne version et réinstallez la nouvelle (tous les paramètres seront perdus et devront être réappliqués)
   • Contactez le support pour qu’il mette à jour l’extension sans perdre les données de configuration

Prérequis

	LimeSurvey 6	LimeSurvey 7
PHP	7.4 ou supérieur	8.1 ou supérieur (8.3 recommandé)
MySQL	8.0 ou supérieur	8.0 ou supérieur
MariaDB	10.3.38 ou supérieur	10.3.38 ou supérieur
PostgreSQL	12 ou supérieur	14 ou supérieur
MSSQL	2016 ou supérieur	2019 ou supérieur
Format de lien	get ou path	path, requis pour le nouvel éditeur

Vous n'avez besoin ni de Node.js ni de npm. Le nouvel éditeur est inclus dans le package LimeSurvey et est prêt à l'emploi.

Effectuez une sauvegarde complète de vos fichiers et de votre base de données avant de commencer, et testez d'abord la mise à jour sur une copie de votre installation. Une fois la mise à jour effectuée, il n'est pas possible de revenir en arrière autrement qu'en restaurant cette sauvegarde.

Prévoyez une fenêtre de maintenance. LimeSurvey place le site en Mode maintenance pendant la mise à jour de la base de données, et sur les installations contenant beaucoup de Données de réponse, cette opération peut prendre un certain temps.

Recommandé : utilisez notre service ComfortUpdate

Le moyen le plus simple et le plus sûr de procéder à la mise à jour est d'utiliser notre service ComfortUpdate. Il télécharge et installe la nouvelle version à votre place, de sorte que vous n'avez aucun fichier à remplacer manuellement.

Si vous préférez effectuer la mise à jour manuellement, suivez plutôt les étapes ci-dessous.

Mise à jour manuelle

1. Sauvegardez vos fichiers et votre base de données, puis placez le site en Mode maintenance.
2. Conservez les fichiers et dossiers suivants de votre ancienne installation :
   • application/config/config.php
   • application/config/security.php
   • application/config/allowed_hosts.php
   • le dossier upload/, qui contient vos fichiers envoyés, vos thèmes utilisateur et vos extensions utilisateur
   • le dossier plugins/, si vous y avez installé des extensions manuellement
3. Téléchargez le package LimeSurvey 7 et mettez à jour l'installation en utilisant l'une des méthodes suivantes :
   1. Supprimez d'abord les anciens fichiers. Mettez de côté les fichiers listés ci-dessus, supprimez tout le reste dans votre répertoire LimeSurvey, décompressez-y le nouveau package, puis remettez en place les fichiers conservés.
   2. Ou copiez les nouveaux fichiers par-dessus les anciens. Décompressez le nouveau package sur votre installation existante et laissez-le écraser les fichiers déjà présents, en laissant intacts les fichiers listés ci-dessus.
4. Quelle que soit l'option choisie, utilisez le nouveau fichier .htaccess du package, car celui de la version 6.x ne fonctionne pas avec le nouvel éditeur. Ensuite, videz tmp/runtime/ afin qu'aucune donnée en cache de la version 6 ne subsiste.
5. Définissez le format de lien sur path dans application/config/config.php.
6. Assurez-vous que votre serveur web sert directement le dossier /editor/ et transmet l'en-tête Authorization à PHP. Plus de détails : Nouvel éditeur de questions dans LimeSurvey 7
7. Lancez la Mise à jour de la base de données. LimeSurvey détecte l'ancienne version de la base de données et propose de la mettre à jour. Confirmez et laissez l'opération se terminer sans l'interrompre.
8. Une fois terminée, désactivez le Mode maintenance et parcourez la liste de contrôle ci-dessous.

Après la mise à jour

• Vérifiez le numéro de version dans le pied de page des pages d'administration.

• Réactivez une par une les extensions dont vous avez besoin.

• Ouvrez un questionnaire et vérifiez que le nouvel éditeur se charge.

• Effectuez une réponse de test complète dans chaque questionnaire actif, en couvrant les conditions, les quotas, les e-mails et l'URL de fin.

Dépannage

Message « Action requise » concernant le format de lien. Le format de lien est toujours get. Remplacez-le par path et videz tmp/runtime/.

L'éditeur se charge mais reste vide. L'en-tête Authorization n'atteint pas PHP.

/editor/ affiche une page LimeSurvey ou une erreur « Non trouvé ». Vérifiez la configuration de votre serveur web et assurez-vous que le dossier /editor/ est servi directement au lieu d'être routé par LimeSurvey.

« Vous ne pouvez pas utiliser ce thème avec le nouvel éditeur de questions ». Le questionnaire utilise un thème qui n'est pas basé sur fruity_twentythree. Changez de thème ou continuez avec l'éditeur classique.

Une extension provoque des erreurs après sa réactivation. Elle n'est pas compatible avec LimeSurvey 7. Désactivez-la et contactez son mainteneur.

Remarques

Chaque changement majeur est documenté sur sa propre page. Cela permet de garder la documentation ciblée et de trouver plus facilement les informations adaptées à votre configuration.