Installation en Francais

Translation in progress.

Pages supplémentaires:{toc}

1. Prérequis pour utiliser LimeSurvey sur votre site web

Assurez-vous que votre serveur possède :

• Environ 40 Mo d'espace libre pour la plateforme proprement dite.
• MySQL 4.1.0 et versions suivantes OU Microsoft SQL Server 2000 et versions suivantes OU Postgres 8.1 et versions suivantes
• PHP 5.x ou plus et ces extensions :
  • l'extension mbstring (Multibyte String Functions) installée dans votre PHP pour que le système de traduction fonctionne. Voir aussi FAQ de l'installation
  • les librairies PHP pour MySQL4 ou MySQL5 (cela devra être le cas avec la plupart des hébergeurs. Si vous avez vous-même configuré votre serveur web, assurez-vous qu'elles sont installées et actives)
  • Le support des sessions et Expressions rationnelles sur votre installation de PHP (supporté par défaut)

Pour utiliser certaines fonctionnalités de LimeSurvey, il faudra aussi :

• l'extension iconv , particulièrement si vous utilisé PHP4. Utilisé pour les exports excel
• l'extension GD installée avec le support FreeType sur votre installation de PHP pour la protection captcha (voir la doc sur l'extension GD)
• l'extension LDAP installée dans votre PHP pour la création d'invitations depuis un annuaire LDAP (voir la doc sur l'extension LDAP)

Dans la plupart des cas, votre hébergeur pourra vous assister sur ces points.

Si vous souhaitez tester LimeSurvey sur votre propre machine, notamment sous Windows, nous vous conseillons l'utilisation de XAMPP qui vous installeras Apache, MySQL et perl. LimeSurvey fonctionne sur une installation de XAMPP sans changement de configuration.

1.1 Hébergement pour LimeSurvey

LimeSurvey devrait fonctionner chez la plupart des hébergeur proposant PHP et MySQL. Si vous souhaitez une installation de LimeSurvey toute prète, vous pouvez utiliser LimeService, vous pouvez aussi vérifier sur la liste des hébergeur compatible avec LimeSurvey.

• Cas particulier de free.fr: Il serait possible d'installer limesurvey sur les serveur perso.free.fr selon ce [LimeSurvey sur pages perso free.fr|commentaire sur framasoft]. Cette information n'a pas était vérifiée.

2. Téléchargement du programme LimeSurvey

Sur la page de téléchargement de limesurvey sur sourceforge (en anglais) vous pourrez téléchargez la dernière version stable de LimeSurvey dans un fichier zip. Vous trouverez aussi des fichiers compressé en gzip,bz2 ou 7zip si vous le souhaitez.

3. Décompression du paquetage LimeSurvey

Décompressez le fichier ZIP dans un dossier/répertoire dédié avec votre outil de décompression préféré. Assurez-vous que votre logiciel de décompression recrée bien la structure des dossiers avec les fichiers (c'est normalement le comportement par défaut de ce genre de programmes)

4. Collecte d'informations au sujet de votre serveur

Vous devez vous renseigner sur les points suivants pour pouvoir installer correctement LimeSurvey sur votre serveur web :

• L'URL prévue pour se connecter au programme (exemple : 'http://mon.domaine.com/limesurvey').
• L'emplacement physique des fichiers sur le serveur (exemple : '/var/www/htdocs/limesurvey').
• L'adresse IP ou le nom d'hôte de votre serveur MySQL (exemple : 'localhost')
• Si votre serveur MySQL n'utilise pas le port par défaut, vous devrez connaître sur quel port il écoute.
• Vos nom d'utilisateur et mot de passe pour l'accès au serveur MySQL.
• La plupart des hébergeurs n'autorisent pas les scripts à créer des bases de données mais c'est à vous de le faire manuellement. Si vous êtes dans ce cas, n'oubliez pas de créer vous-même une base de données (par exemple, 'limesurvey')

5. Configurer LimeSurvey

Modifiez le fichier config.php situé dans le dossier /limesurvey/ grâce à votre éditeur de texte préféré. Les réglages suivants doivent être ajustés :

5.1 Réglages obligatoires

• $databasetype : défini le type de base de données utilisée. A ce jour, vous pouvez utiliser "mysql" pour une base de données de type MySQL ou "odbc_mssql" pour une base de type Microsoft SQL server et "postgres" pour une base de type Postgres SQL Server. Au minimum, ces types ont étaient testés. (:biggrin:)
• $databaselocation : défini l'adresse IP ou le nom d'hôte de votre serveur de base de données. Dans la plupart des cas, "localhost" doit convenir.
• $databasename : le nom de la base utilisée par LimeSurvey sur votre serveur de base de données. Si vous avez les permissions suffisantes sur ce serveur, vous pourrez créer une base depuis LimeSurvey. Dans ce cas, indiquez le nom voulu pour cette base ici. Vous pouvez aussi indiquer le nom d'une base créée précédemment et dans ce cas, assurez-vous que la base ne contient pas d'anciennes tables de LimeSurvey.
• $databaseuser : votre nom d'utilisateur pour l'accès à la base de données.
• $databasepass : votre mot de passe pour l'accès au serveur de base de données.
• $dbprefix : laissez ce réglage à blanc (càd : $dbprefix="";) si vous utilisez une base dédiée à LimeSurvey. Si vous voulez ou devez partager votre base entre LimeSurvey et d'autres programmes utilisant la même base de données, ajoutez un préfixe pour le nom des tables avec ce réglage. Le paramètre recommandé est "lime_" mais vous pouvez mettre ce que vous voulez.
  • La création d'une base de données MySQL est décrite dans la FAQ de l'installation.
• $rooturl : indique l'adresse URL pour accéder à votre questionnaire. Le réglage par défaut essaie de trouver ça automatiquement pour vous et, la plupart du temps, ce réglage ne devra pas être modifié (le code {$_SERVER['SERVER_NAME']} devrait fonctionner dans la majorité des cas). Si cela ne fonctionne pas, vous devrez entrer manuellement l'adresse ici, par exemple "http://www.mydomain.com/limesurvey").
• $rootdir : doit contenir le chemin physique vers les fichiers du programme. Le réglage par défaut essaie de trouver cette valeur pour vous et, la plupart du temps, ce réglage ne devra pas être modifié (le code "dirname(!!!FILE!!!);" essaie de trouver automatiquement. Si cela ne fonctionne pas, vous devrez entrer manuellement l'emplacement physique des fichiers, par exemple "/home/public_html/limesurvey".)
• $defaultuser: A l'installation, le script va créer un administrateur, vous pouvez modifier son nom ici (par défaut: admin).
• $defaultpass: A l'installation, le script va créer un administrateur, vous pouvez modifier son nom ici (par défaut: password)
• $siteadminemail: L'adresse email par défaut de l'administrateur du site. Elle est utilisée pour les messages système et l'adresse de contact sur la page d'accueil.
• $siteadminbounce: Adresse de rebond des emails, c'est l'adresse ouvont être renvoyé les erreurs d'envois.
• $siteadminname: Le nom de l'administrateur, apparaitra sur les eamil.

5.2 Réglages optionnels

Les paramètres listés ci-dessous n'empêcheront pas LimeSurvey de fonctionner si vous avez fait une installation standard (respect des différents dossiers). Ne modifiez ces valeurs que si vous avez renommé certains dossiers de LimeSurvey.

Les réglages optionnels sont en cours de transfert sur la page spécifique : Réglages optionnels

• $sitename : définit le nom qui sera affiché dans la page d'administration et dans la barre de titre du navigateur. Vous pouvez mettre ce que vous voulez comme par exemple "Mon outil d'enquêtes en ligne"
• $scriptname : Laissez la valeur "admin.php" tant que vous ne renommez pas ce fichier. Si vous renommez le fichier admin.php, cette variable devra contenir le nouveau nom.
• $accesscontrol : la valeur 1 active le contrôle d'accès par nom d'utilisateur et mot de passe, la valeur 0 le désactive. Ce réglage est obsolète et a été enlevé depuis la version 1.52.
• $defaultuser : Quand le contrôle d'accès est activé, c'est le nom du premier administrateur que LimeSurvey va créé automatiquement.
• $defaultpass : Le mot de passe de l'administrateur créé automatiquement.
• $lwcdropdowns : 2 valeurs sont possibles : "R" ou "L". La valeur "R" permet d'afficher les questions de type "liste avec commentaires" sous forme de boutons radio alors que la valeur "L" affiche cette question sous forme d'une liste déroulante.
• $dropdownthreshold : Quand vous avez choisi "R" pour l'option précédente, vous pouvez fixer un nombre maximum (de réponses) à partir duquel ces réponses seront quand même affichées sous forme de liste déroulante. Cela évite d'avoir des questions d'une longueur trop importante à l'écran. Par défaut ce maximum vaut 25.
• $repeatheadings : Pour les questions de type "Ligne", vous pouvez parfois avoir de très nombreuses réponses qui ne s'afficheront pas toutes en pleine page et nécessiteront de la faire défiler. Ainsi, en défilant, le participant ne verra plus la ligne d'entêtes. Ce paramètre permet d'indiquer le nombre de réponses à afficher avant de répéter la ligne d'entêtes. La valeur "15" semble être celle qui donne les meilleurs résultats. Si vous ne souhaitez pas utiliser cette fonctionnalité, mettez la valeur "0" (valeur par défaut).
• $minrepeatheadings : Cette option est à utiliser conjointement avec la précédente. Elle permet d'indiquer le nombre minimum de réponses restantes nécessaires pour répéter les entêtes.
• $defaultlang : Définit la langue à utiliser par défaut pour l'écran d'administration et les questionnaires publics. La langue peut cependant être changée lors de la connexion à l'interface d'administration et/ou pour chaque questionnaire.
• $timeadjust : Permet de régler les problèmes liés aux fuseaux horaires si vote serveur hébergeant LimeSurvey n'est pas dans le même que vous. La valeur déclarée ici sera ajoutée à l'heure du serveur lors de l'enregistrement d'une heure. C'est très important si vous utilisez l'horodatage.
• $allowmandbackwards : Si vous mettez la valeur "1" ici, un participant pourra revenir à une question précédente même s'il n'a pas répondu à une question obligatoire de la page courante. Si cette valeur vaut "0", il devra d'abord répondre à toutes les questions obligatoires avant de pouvoir revenir en arrière.
• $deletenonvalues : si la valeur est "0", LimeSurvey enregistrera quand même les réponses faites à une question affichée sous conditions si le participant revient en arrière en modifiant sa réponse à la question qui conditionnait l'affichage. Cela peut-être intéressant dans certains cas. la valeur "1" désactive cette fonctionnalité et ainsi, seules les réponses "réelles" du participant seront enregistrées dans la base.
• $shownoanswer : quand une question de type liste ou ligne n'est pas obligatoire et que cette variable vaut "1", une réponse supplémentaire sera proposée : "Sans réponse" afin qu'un participant puisse indiquer qu'il ne souhaite pas répondre. La valeur "0" désactive cette possibilité.
• $debug : La valeur "1" permet de lancer LimeSurvey en mode débogage (E_ALL). Ainsi, même la plus petite "notice" sera logguée. Attention, l'activation de ce mode peut révéler les chemins vers les fichiers de LimeSurvey.
• $translationmode : Si le système de traductions ne fonctionne pas (l'interface d'administration reste toujours en anglais quelque soit la langue choisie), cela peut être dû à un bogue dans votre version de PHP. Mettez la valeur '1' pour activer un correctif de ce bogue (Nouveau dans la version 1.52)
• $sessionlifetime : Détermine le nombre de secondes pendant lesquelles un participant peut rester inactif (ce qui signifie sans changer de page) avant que sa session ne se termine et qu'il perde toutes les réponses faites. Par défaut, la valeur est à "3600"
• $stripQueryFromRefurl : Détermine si LimeSurvey doit ou non sauvegarder les paramètres qui apparaissent dans l'URL référente. La valeur par défaut est "false" et permettra d'enregistrer la totalité de l'URL référente. Si la valeur est "true", les paramètres qui pourraient se trouver dans l'URL ne seront pas conservés.

5.3 Configuration des mails

• $siteadminemail : Représente l'adresse électronique de l'administrateur par défaut du site. Elle est utilisée pour les messages système et les contacts.
• $siteadminname : Le nom de l'administrateur par défaut du site.
• $emailmethod : Ce paramètre détermine la méthode que doit utiliser LimeSurvey pour envoyer des mails. Les valeurs suivantes sont possibles :
  • mail : utilisation des routines mail internes à PHP
  • sendmail : utilisation de Sendmail
  • smtp : utilisation d'un serveur SMTP. Utilisez ce réglage quand la machine qui héberge LimeSurvey n'est pas votre serveur de mail.
• $emailsmtphost : Si vous avez choisi la méthode "smtp" pour les mails dans LimeSurvey, c'est ici que vous renseignerez l'adresse de ce serveur (ex : smtp.free.fr). Sinon, laissez ce champ vide.
• $emailsmtpuser : Si ce serveur smtp requiert une authentification, saisissez ici le nom d'utilisateur pour vous y connecter. Sinon, laissez ce champ vide.
• $mailsmtppassword : De la même façon, indiquez ici l'éventuel mot de passe nécessaire pour l'authentification sur votre serveur smtp.
• $maxemails : Permet de préciser le nombre maximum de mails à envoyer en une seule fois afin de respecter les capacités de vos serveurs. La plupart des serveurs web peuvent envoyer une centaine de mails dans les 30 secondes imparties à l'exécution d'un script PHP. Cependant, si vous avez des "timeout" lors de l'envoi de mails, veuillez diminuer ce nombre ici.

5.4 Configuration des statistiques lors du parcours des réponses

• $usejpgraph (obsolete depuis la version 1.85): Si vous avez correctement installé et configuré la classe ["JPGraph"] sur votre serveur, vous pouvez activer cette fonctionnalité en mettant la valeur "1" ("0" pour la désactiver). Les scripts de statistiques vous proposeront alors des représentations de vos résultats sous forme de camemberts et de barres. Chaque version de PHP a besoin d'une version spécifique de JPGraph. Cette fonctionnalité est encore au stade de développement donc ne soyez pas trop surpris de voir des choses étranges.
• $jpgraphdir (obsolete depuis la version 1.85): Indiquez ici l'emplacement physique sur le disque du serveur des fichiers de la classe jpgraph. Ce paramètre n'est nécessaire que si $usejpgraph est à "1".
• $jpgraphfont (obsolete depuis la version 1.85): La police à utiliser pour les graphiques. Un paramètre sans risque est "FF_FONT1"
• $embedded : Si vous voulez intégrer LimeSurvey dans une autre page, vous pouvez désactiver l'envoi des entêtes HTML pour les pages de LimeSurvey et indiquer ici votre propre méthode à utiliser. C'est une méthode un peu barbare mais elle permet une intégration facile et rapide.
• $filterout_incomplete_answers : Indiquez "true" pour ce paramètre si vous souhaitez que, par défaut, LimeSurvey ne tiennent pas compte des réponses incomplètes dans le parcours des réponses et les statistiques. Pour avoir plus d'informations sur les réponses incomplètes, référez-vous au chapitre Parcourir les résultats d'un questionnaire. Au besoin, il est possible de changer temporairement ce comportement directement dans l'interface de LimeSurvey.

5.5 Configuration de LDAP

LDAP est actuellement utilisé dans LimeSurvey pour la fonctionnalité "Importer les invitations depuis une requête LDAP" mais, à terme, il est prévu d'étendre son utilisation à l'authentification. Pour utiliser cette fonctionnalité, vous devez activer le support de LDAP dans le fichier config.php et configurer le support LDAP dans le fichier config-ldap.php.

5.5.1 Activer LDAP dans config.php

• $enableLdap : si vous voulez utilisez les fonctionnalités liées à LDAP, vous devez régler ce paramètre sur "true" (réglé sur "false" par défaut)

6. Envoi des fichiers sur votre serveur web

En utilisant votre client FTP favori, connectez-vous à votre serveur web et créez un dossier pour y stocker les fichiers de LimeSurvey. Envoyez dans ce dossier l'ensemble des fichiers de LimeSurvey en respectant la structure des dossiers.

Permissions des dossiers :

• Les scripts doivent avoir un accès en écriture au dossier admin pour pouvoir importer des questionnaires. Le dossier "/limesurvey/tmp/" est utilisé pour les envois et doit être en lecture et écriture pour le serveur web. Dans Linux ou Unix, il doit être chmodé en 775
• Les autres dossiers peuvent rester en lecture seule (dans Linux ou Unix, il doit être chmodé en 755). Vous pouvez aussi chmodé chaque fichier de "/limesurvey/admin/" en 755

7. Exécution du script d'installation

Un script est fourni avec LimeSurvey pour installer ce programme. Rendez-vous à l'adresse "http://votre.domaine.com/limesurvey/admin/install/index.php" (à adapter évidemment (:wink:). Si vous avez tout configuré correctement, le script va vous demander de créer la base de données et/ou les différentes tables nécessaires. Laissez faire...

Une fois cette étape franchie et quand le script vous informe que tout s'est déroulé sans problème, renommer ou effacer le dossier /admin/install.

8. Première connexion à l'interface d'administration

Après avoir installé LimeSurvey, vous êtes prêt à le configurer via votre navigateur web. Ouvrez votre navigateur et entrez l'adresse du script d'administration. Si vous avez installé le programme d'une façon standard dans un dossier limesurvey, cette adresse devrait ressembler à ceci : "http://your.domain.com/limesurvey/admin/admin.php"

La première fois que vous utiliserez LimeSurvey, celui-ci essayera de se connecter à la base de données à partir des informations fournies dans le fichier config.php. Si la base de données n'existe pas, LimeSurvey retournera un message d'erreur. Normalement, vous devriez tomber sur un écran d'identification. Les valeurs par défaut pour pouvoir se connecter sont :

Utilisateur : admin Mot de passe : password

N'oubliez pas de changer ce mot de passe après la première connexion à l'interface d'administration

9. En cas de problème...

Comme tout programme informatique, les choses se dérouleront telles que décrites dans les instructions mais, en général, ce ne sera pas le cas. Après avoir tout (re)vérifié, si vous avez toujours des soucis, veuillez les décrire dans le forum de LimeSurvey ou essayer de contacter quelqu'un dans le IRC de LimeSurvey : irc://irc.freenode.net/limesurvey