Objet

Ce jeu de script est destiné à recevoir les informations envoyés par CyberMailing afin d'en réaliser une archive personnelle. Il reçoit les informations lors d'une inscription ou d'une annulation lorsque l'un des champs de configuration de liste, script inscription, script annulation et/ou script avant validation a été défini.

Le script peut être parâmetré pour écrire les données dans des fichiers log, écrire dans une table d'une base de donnée, envoyer un email au propriétaire de la liste, à chaque information traitée.

Ces trois fonctionnalités sont activables et désactivables à volonté pour chacune des actions (inscription ou annulation).

à l'installation, les fonctions activées par défaut sont celles ci :

Nom du fichier	Envoi Email notification	Archive fichier log	Archive Mysql
appel_inscription.php	x	x	x
appel_annulation.php	x	x	x
appel_avant_validation.php			x

Pré-requis

Ces scripts nécessitent PHP et MYSQL en option

Ils ont été testés sur un serveur Appache disposant de PHP5 et MYSQL5

Instruction d'installation

1. Etraire l'archive sur votre ordinateur. (Téléchargez le logiciel 7zip si nécessaire)

2. Uploader le répertoire CYBERM sur votre serveur avec tous les fichiers qu'ils contient (le nom du répertoire peut être changé, si vous le désirez, il n'influence pas le fonctionnement).

3. Ouvrez le fichier definition.php, et modifiez les données indiquées.<

Vous devrez y indiquer :

- votre adresse email
- les informations de connection à votre base de donnée MYSQL (host, user, password, nom de la base)

Si vous n'avez pas de base de donnée MYSQL, vous devrez modifier les fichiers : appel_inscription.php, appel_annulation.php, appel_avant_validation.php pour désactiver l'archive MYSQL en indiquant :

DEFINE("FONCTION_LOG_MYSQL","OFF"); [au lieu du "ON"initialement paramêtré]

4. Vérifier l'installation, en vous rendant sur votre site avec un navigateur à l'adresse /CYBERM/appel_inscription.php et suivre les instructions.

5. Une fois l'installation terminée, vous rendre dans la définition de vos listes CyberMailing pour spécifier l'adresses de votre script d'inscription, d'annulation et avant validation

REMARQUE : l'archive de données avant validation n'est pas vraiement nécéssaire, seules les données d'inscription et d'annulation sont importantes.

Problèmes courrants & leur solution

Pour que le script puissent créer un fichier et écrire dedans, il faut le répertoire CYBERM dans le quel les scripts sont installés ait les droits appropriés. Dépendamment de la configuration de votre serveur cela sera ou non le cas.

A l'installation, le script tente de créer un fichier et d'écrire dedans, et vous prévient si il n'y parvient pas. Le message d'erreur indique qu'il faut changer les droits du répertoire pour 0777.

Cela se fait avec votre logiciel FTP qui doit vous permettre de changer les droits d'accès aux fichiers et aux repertoires.

Dans Filezilla, par exemple, il vous suffit de :

séléctionner le repertoire CYBERM
cliquer droit sur la souris.
selectionner "attributs du fichier
indiquer 777
et valider.

Tous les logiciels FTP fonctionnent de manière similaire, et si vous ne vous en sortez pas Filezilla est gratuit.

Extension de la table de la base de donnée avec vos champs personnalisés

Le script est conçu pour stocker, par défaut, dans la MYSQL les donnée suivantes :


cyber_id : l'identifiant de l'inscription de l'abonné
name : le nom fourni par le formulaire d'inscription dans le champs "Name"
email : le email fourni par le formulaire d'inscription dans le champs "Email"
list : le numéro de liste fourni par le formulaire d'inscription dans le champs "Liste"
ip : l'adresse ip du visiteur qui remplit le formulaire
date : la date d'inscription
url : l'url sur lequel se trouve le formulaire
etat : vaut : "à valider", "validé", "annulé" selon l'action effectuée

Si vos formulaire, demandent d'autres données (par exemple : prenom, departement, preference), pour que ces données soient enregistrées dans la table Mysql il faudra ajouter des colonnes à la table "CYBERMAILING_log" qui stocke les données.

Pour cela, vous devrez vous rendre dans PHPmyadmin, l'interface de gestion de base de donnée fournie dans votre hébergement.

Vous devrez sélectionner la table CYBERMAILING_log (visible dans le panneau de gauche), puis dans "structure", en bas de page vous devrez indiquer le nombre de champs que vous souhaitez ajouter. Dans notre exemple nous entrerons 3.


Ensuite, PHPmyadmin vous demandera de donner des noms et des informations sur la nature de ces champs, Il vous suffit de remplir :

le nom
selectionner le type VARCHAR
et indiquer la taille maximum du champs concerné (indiquez 255, c'est le maximum, pour ne pas vous prendre la tête, ou moins, si vous souhaitez optimiser la taille de votre base de donnée).
cliquez sur sauvegarder.


Votre table est alors prête à recevoir ces données supplémentaires, il n'y a pas besoin de modifier le script