pré-requis

• Un hébergement web
• avec Php (version 5 minimum)

• Téléchargez la dernière version de mtweb 

installation rapide

• l'archive mtweb.<version>.tar.gz contient un dossier mtweb
• uploadez le contenu du dossier mtweb sur votre site
• ouvrez le site dans un navigateur et suivez l'installeur 

Droits en écriture

si vous tombez sur un message qui dit :

Php ne peut pas ecrire dans le dossier content

C'est parce que Php n'a pas des droits suffisants en écriture. Php doit pouvoir écrire dans le dossier content (ainsi que dans ses fichiers et ses sous-dossiers).

Chez certains hébergeurs, les droits seront suffisants sans que vous n’ayez rien à faire. Chez d'autres, il faudra le préciser, avec votre client FTP par exemple, et donner explicitement les droits en écriture.

L'installeur

Une fois que vous avez uploadé les fichiers sur votre site et que les droits en écriture vont bien, en allant sur votre site vous devriez arriver sur l'installeur.

L'installeur vous propose de choisir un mode de stockage pour les données du site, et de créer un premier utilisateur.

Choix du mode de stockage des données

Si vous ne savez pas quoi choisir, les informations pré-remplies devraient être bonnes.

SQLite 

Si vous choisissez SQLite, les informations pré-remplies devraient être bonnes.

MySql 

Si vous choisissez MySql (ou PDO MySql), renseignez les informations de connexion à votre base de données.

XML 

Avec le stockage des données XML, les informations sont enregistrées dans des fichiers XML. Ce mode de stockage permet d'installer mtweb sur un hébergement sans base de données.

Si vous choisissez ce mode de stockage, les informations pré-remplies devraient être bonnes.

Choix d'un premier utilisateur 

Choisissez ensuite un login, un email et un mot de passe pour votre compte sur le site.

Lancer l'installation 

Lorsque vous avez précisé la méthode de stockage et un premier compte utilisateur, cliquez sur le bouton installer. Et si tout se passe bien, vous devriez avoir une installation de mtweb sur votre site.

Installation personnalisée

Connexion aux données de l'application 

L'installeur enregistre les information de connexion aux données dans le fichier :

content/config/config.php 

Editez ce fichier si vous souhaitez changer les information de connexion.

Chemins de l'application

Les dossiers de l'application sont configurables dans le fichier :

pathes.php

Par défaut, ce fichier contient le code suivant :

  // -----------------------------------------------------------
  //                                                     chemins
  //

  $PATHES = array(

    //
    // dossier des contenus editables par l'application
    // relatif au dossier qui contient le fichier d'appel
    //
    // PHP doit pouvoir acceder en ecriture sur ce dossier
    // ainsi que sur toute l'arborescence a partir de ce dossier
    //
    "content" => "content",

    //
    // chemin HTTP du dossier "mw"
    // relatif au dossier qui contient le fichier d'appel
    //
    "mw_path" => "mw",

    //
    // chemin du dossier "mw" sur le systeme d'exploitation
    // relatif au dossier qui contient le fichier d'appel
    // ou absolu dans le systeme de fichiers
    //
    "mw_dir" => "mw"

  );

content indique le chemin du repertoire dans lequel l'application ira enregistrer ou modifier des fichiers. C'est l'unique dossier de l'application dans lequel Php doit pouvoir accéder en écriture (ainsi que dans ses fichiers et sous-dossiers). C'est par exemple dans ce dossier que sont enregistrés les données si vous choisissez le stoquage des données avec SQLite ou XML.

mw_path indique le chemin HTTP du dossier mw.

mw_dir indique enfin le chemin du dossier mw dans le système de fichiers du serveur.

Vous pouvez déplacer ou renommer ces dossier content et mw, et adpater le fichier pathes.php avec leur chemin.

Notes concernant le stockage des données avec SQLite ou XML

Confidentialité des informations

Si vous utilisez le stockage des données au format SQLite (configuration par défaut) ou XML, les données seront enregistrées dans des fichiers, dans le dossier :

content/data

Le contenu de ce dossier ne doit pas être accessible par Internet. Il contient des informations personnelles (comme les emails des utilisateurs) qui ne doivent pas être publiques. Ce dossier contient un fichier .htaccess avec ce code :

Deny from all

Si vous ouvrez ce dossier avec votre navigateur (en remplaçant avec l'URL de votre installation) :

http://votre.site.web/votre/installation/content/data

Votre navigateur DOIT vous afficher un message d'erreur de type 403 - Forbidden.

Une alternative, pour rendre vos données inaccessibles par Internet, consiste à déplacer leur dossier sous la racine du site (si votre hébergement le permet) et de préciser le chemin dans le fichier content/config/config.php.

Si vous utilisez SQLite :

    // repertoire contenant le fichier de base de donnees SQLite
    "host" => "content/data/sqlite",

Si vous utilisez XML :

    // les fichiers XML sont enregistres dans le repertoire :
    "host" => "content/data/xml",

Vérifiez que Php a le droit d'écrire dans ce dossier.