README-fr.md 4.6 KB
Newer Older
spf's avatar
spf committed
1 2
Framaforms
==============
spf's avatar
spf committed
3
([English version available here](README.md))
spf's avatar
spf committed
4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91


Description
===============
Framaforms est un logiciel de création de formulaires en ligne.
Lire https://framablog.org/2016/10/05/framaforms-noffrez-plus-les-reponses-que-vous-collectez-a-google/ et https://framablog.org/2016/10/05/en-savoir-un-peu-plus-sur-le-projet-framaforms/ pour plus d'informations.

Current version
================
1.0 - 20180402

Changelog
============
Un changelog sommaire est disponible sur https://framagit.org/framasoft/framaforms/wikis/logbook


Utilisation
=============
Il n'existe pas encore d'aide pour Framaforms. Vous pouvez cependant lire https://framaforms.org/fonctionnalites et https://framablog.org/2016/10/05/framaforms-noffrez-plus-les-reponses-que-vous-collectez-a-google/ pour plus d'informations.


Installation
=================

Framaforms est basé à 99% sur Drupal 7, accompagné de différents modules (notamment le module webform).

Le niveau technique pour l'installer n'est pas très élevé, mais l'installation est tout de même plus complexe que l'installation d'un Drupal "standard".

Pour des raisons de performances, Framaforms utilise postgresql comme BDD, ce qui posait probleme pour en faire une "distribution" <https://www.drupal.org/docs/7/distributions>.

## Prérequis

* PHP 7+ (peut fonctionner avec des versions antérieures, mais PHP7 recommandé pour des raisons de performances)
* Nginx (peut fonctionner avec Apache)
* postgresql 9.4.12 (ou +)
* extension php mb_string pour php7 ( sudo apt-get install php7.0-mbstring )
* un dossier web accessible et fonctionnel


## Base de données

* Créer un utilisateur, une base de données, et attribuer les droits nécéssaires à cet utilisateur sur cette base. Ex: http://www.sakana.fr/blog/2007/06/06/postgresql-create-a-user-a-database-and-grant-accesses/
  * pour la suite, nous prendrons comme exemple le user "framaforms_user" et comme BDD "framaforms"
* Télécharger la BDD d'initialisation de Framaforms : https://framagit.org/framasoft/framaforms/raw/master/framaforms.sql (pour la branche "master", ou http://framaforms.org/framaforms.sql). NB : le fichier fait environ environ 20Mo.
* Importer cette base de données (à faire avec l'utilisateur système "postgres"
  * `psql -U framaforms_user -W -h 127.0.0.1 framaforms < /path/to/framaforms.sql`
  * NB : si vous devez réimporter la base d'initialisation, il est conseillé de détruire puis recréer la BDD avant importation :  `dropdb framaforms;createdb --encoding=UTF8 --owner=framaforms_user framaforms`

## Fichiers

* faire un `git clone https://framagit.org/framasoft/framaforms.git` dans le dossier web de votre choix
* assurez-vous d'appliquer les bons droits utilisateur (chown) et de donner des permissions étendues en lecture/écriture sur /path/to/framaforms/sites/default/files
* créez un dossier qui sera accessible en écriture (mais pas en lecture) à votre utilisateur web. Ex: /path/to/framaforms_private_files/
* configuration de la connexion à la BDD :.
  * allez dans le dossier /path/to/framaforms/sites/default/
  * copiez le fichier default.settings.php en settings.php
  * editez ce fichier et modifiez les information de connexion à la BDD

```php
  $databases = array (
    'default' =>.
    array (
      'default' =>.
      array (
        'database' => 'framaforms',
        'username' => 'framaforms_user',
        'password' => 'yourpassword',
        'host' => 'localhost',
        'port' => '',
        'driver' => 'pgsql',
        'prefix' => '',
      ),
    ),
  );
```

* profitez en pour ajouter la possibilité d'inclure vos formulaires dans des iframes en toute fin de fichier

```php
  /**
   * Turn off the X-Frame-Options header entirely, to restore the previous
   * behavior of allowing the site to be embedded in a frame on another site.
   */
   $conf['x_frame_options'] = '';
```

## Accéder au site

92
A ce stade, vous devriez (si tout va bien) accéder à votre site (par exemple sur example.org) .
spf's avatar
spf committed
93

94
* Rendez-vous sur https://example.org/
spf's avatar
spf committed
95 96
* Connectez vous avec l'identifiant "admin" et le mot de passe "changemeASAP!"
* IMPORTANT : Modifiez votre mot de passe administrateur :)
97 98 99 100
* Editez les infos de https://example.org/admin/config/system/site-information
* Vérifiez les chemins d'accès sur https://example.org/admin/config/media/file-system
* Vérifiez que votre installation et vos modules sont à jour sur https://example.org/admin/reports/status
* Activez éventuellement les informations de cache lorsque vous passerez en production : https://example.org/admin/config/development/performance
spf's avatar
spf committed
101 102

Logiquement, vous devriez pouvoir commencer à utiliser votre instance de Framaforms.