Installer une application vapspace

Présentation pour l’utilisateur

vapspace est une application sous licence Gnu GPL qui gère un espace membre orienté mobilité de proximité par auto-stop.

Proximité
L’espace membre est géographiquement réparti par antenne-commune et rassemble les membres d’une même antenne autour des propositions de trajets initiés par d’autres membres.
 Tout membre peut consulter les trajets de toutes antennes mais ne peut proposer un trajet que dans son antenne. (limite de proximité)

Auto-stop
 Un membre piéton sera toujours demandeur de trajet.
 Un membre automobiliste sera toujours offreur de trajet.
 Les membres inscrits comme piéton et automobiliste devront à chaque fois choisir leur deal : offrir-demander un trajet.
 Pour chaque antenne, les trajets sont classés par point de rencontre, lieux de rencontre propices à l’auto-stop et bien connu des membres d’une antenne.

Interaction des membres
 En manifestant un intérêt pour un trajet, un membre reçoit le mail de l’initiateur du trajet.
 L’ensemble des trajets récoltés forme une bibliothèque de trajets. Cette bibliothèque est la propriété de tous les membres inscrits. Chaque membre peut créer,modifier, supprimer son/ses trajets
 Un mini chat par antennes permet l’échange de messages entre membres.

Gestion de l’inscription des membres
 En l’état, les membres s’enregistrent dans une base de donnée avec un numero de membre fictif. C’est à l’administrateur de modifier ce paramètre et éventuellement d’envoyer un kit de membre au nouveau membre avec son vrai numéro.
 Il est possible de modifier ce fonctionnement manuel pour un fonctionnement automatisé, le nouveau membre recevant directement un numéro unique.

Compléments
 Il est possible d’adjoindre un outil de personnalisation de carte d’auto-stop.
 Tout membre peut éditer et modifier ses données.
 L’application contient également une interface de gestion complète des membres ainsi qu’une interface et un moteur de newsletter activable par 2 commandes périodiques (CRON) sur le serveur d’hébergement.

Instructions webmaster :

Pré-requis
 Un serveur web avec PHP 5.2 minimum.
 Une base de donnée MySQL
 Vos identifiants à votre base de donnée.

Installation en ligne :
 Dézipper le fichier vapspace.zip ci-joint.
 Transférer par FTP, le répertoire vapspace dans le répertoire de votre serveur web (www, public_html, etc)
 Transférer par FTP le reste au même niveau que le répertoire de votre serveur web. Si p.ex. www/ est à la racine de votre espace hébergement, vapdata, vapapi et vaplib seront également à la racine de votre espace de téléchargement.
 Avec votre navigateur internet, rendez-vous sur l’url correspondant à vapspace (exemple : www.mon.domaine.com/vapspace)

Installation locale
 Dézipper le fichier vapspace.zip ci-joint.
 Creer un répertoire d’accueil intitulé :vaptest dans votre répertoire web (typiquement www)
 Installer tout la structure dezippée dans www/vaptest/
 Avec votre navigateur, rendez-vous à l’url http://localhost/vaptest/vapspace

Déroulement de l’installation
 Page Un : comment se connecter à votre base de donnée MySQL.
 Page Deux : une fois la connexion initialisée, quelques questions sont posées :
 Préfixe des tables sql :
vapspace crée 12 tables sql mais leur préfixe est personnalisable (par défault : vap_ )
 Choix par défault du pays des membres.
 Choix d’une antenne Une antenne est requise à ce stade.
 Régionalisation :
cette antenne doit-elle faire partie d’une liste de région ? Si non, laissez vide. Si oui, rentrez un nom de région.
 vapspace doit-il être géographiquement limité à ses antennes ou bien doit-il accepter des membres ’hors-antenne’ ?
 comment vapspace doit-il identifier les nouveaux membres ?
par default un numero transitoire ’AAA000’ est utilisé ?.
 Choix d’un courriel de contact général.
 L’inscription des membres doit-elle contenir un mini sondage pour des sociétés de mobilités ?
Si non, laisser vide. Si oui, rentrer le nom de chaque société séparé par des virgules.

Une fois les réponses traitées, le système technnnique est en place.
Vous devez alors vous inscrire comme tout membre normal.
Une fois l’inscription réussie, vous rentrez dans vapspace
Le menu de gestion pour administrateurs s’affiche en-bas sous le lien ’gestion’

Si votre installation ne suit pas ce chemin...me contacter :
marcvancraesbeeck(aroBase]scarletPointbe

Evolutions du code :

 2 mai : modification du système de login, authorise un mail avec apostrophe
 5 mai : installation testée avec wamp dans MS-Windows et Gnu/Linux
 7 mai : correction d’inversion de fichiers et classement membres par dates decroissante
 9 mai : corrections diverses newsletter pour responsable et gestionnaire fichiers
 16 mai : ajout d’un formulaire de promo (non-actif en local), correction du lien contact (pied)
 21 mai : le champ ’passe’ de la table sql ’vap_human’ passe à 128 caractères pour gérer correctement différentes tailles d’algorythme de cryptage.
 28 mai, bug fichier ABS_Membre.php, ligne 552 corrigé
 2 juin, bugs mineurs corrigés : stdt_connect.tpl, RegionCtrl.php et SponsorCtrl.php

Instructions développeur

vapspace est une application Modele-Vue-Control (MVC)
 Controleurs
Tous les controleurs propre à l’application se situent dans vapapi/controleurs
Le controleur principal est vaplib/Controleur.class.php
 Vues
Le moteur de template est un search&replace adapté de PHPLIB et publié par Philippe Rigaux [1]
Tous les template (fichiers.tpl) se trouvent dans vapapi/vues
 Modèle
3 classes php situées dans vaplib : IniData.class.php GererData.classe.php Filtresdata.class.php
 Relation entre Codage et URL
Toutes les url sont de type :
index.php?ctrl=nomctrl&action=nomaction[autres paramètres]
nomctrl est le nom d’une classe php dans vapapi/controleurs/NomCtrl.php
nomaction est le nom d’une methode publique de cette classe.
C’est vaplib/frontal.php qui gère cela.
 Configuration
Deux fichiers forment le centre de configuration du système :
vapspace/index.php chargé en premier et à chaque fois.
vaplib/Connect.php pour les constantes générales.

Marc Van Craesbeeck