Prenez le temps de lire ce fichier attentivement, il contient des informations utiles. |
I. Configuration requise |
WAnewsletter requiert une version de php >= 4.0.6 ainsi qu'une base de données de type MySQL, Microsoft
SQL Server ou PostgreSQL.
Certaines fonctionnalités secondaires peuvent ne pas être disponibles selon la configuration de
votre serveur et les librairies installées.
Exemple : Le module de statistiques demande que la librairie GD soit installée.
|
Top |
|
II. Installation : Explications rapides |
WAnewsletter dispose d'un script d'installation simplifié au maximum, afin de permettre aux néophytes de
pouvoir utiliser le script rapidement.
- Uploadez les fichiers contenus dans l'archive sur votre ftp (respectez bien la structure des répertoires)
- Donnez les droits en écriture sur les dossiers includes/ et upload/
- Rendez-vous à l'adresse où se trouve le fichier install.php (ex: http://www.votredomaine.com/newsletter/setup/install.php si le script est installé dans le dossier newsletter/ à la racine du site)
- Remplissez le formulaire qui s'affiche et cliquez sur le bouton de validation
- Une fois le script installé, retirez les droits en écriture sur le dossier includes/
- Pour finir, supprimez le dossier setup/ de votre ftp afin d'éviter une réinstallation
|
Top |
|
III. Installation : Explications détaillées |
Pour installer correctement WAnewsletter, vous devez commencer par uploader les fichiers du script sur votre ftp.
Tous les fichiers doivent être uploadés en mode ASCII, hormis les quelques images utilisées par le script qui se trouvent dans les dossiers images/ et templates/images/. Les images doivent être uploadées en mode binaire.
Toujours dans votre client ftp favori, donnez les droits en écriture sur les dossiers upload/, tmp/, stats/ et includes/.
Explications :
Le dossier upload/ contiendra les divers fichiers que vous joindrez éventuellement à vos envois. Pour que le script puisse ajouter correctement
ces fichiers dans le dossier upload/, celui ci doit être accessible en écriture.
Le script propose une option permettant de stocker les fichiers joints sur un serveur ftp distant. Dans ce cas, vous pouvez supprimer le dossier upload/.
A propos du dossier tmp/, veuillez voir la section correspondante dans la faq du script.
Le dossier stats/ contiendra les fichiers nécessaires au module de statistiques. Ce dossier est inutile si la librairie GD n'est pas
disponible sur votre serveur.
Lors de l'installation, le script créé le fichier de configuration et le place dans le dossier includes/. Ce dossier doit donc également accessible en écriture,
mais seulement le temps de l'installation ! Une fois celle ci terminée, retirez les droits en écriture sur ce dossier.
Une fois les fichiers en place sur le serveur et les droits en écriture attribués, rendez vous à l'adresse où se trouve le fichier install.php.
Exemple :
Vous avez uploadé le script à la racine de votre site, dans un dossier nommé newsletter. Vous devez donc taper dans votre barre d'adresse : http://www.votredomaine.com/newsletter/setup/install.php
Vous arrivez maintenant sur le formulaire d'installation.
Notez que si vous changez de langue avant de cliquer sur le bouton de validation, vous retomberez sur la même page, mais dans la langue choisie.
Le nom du serveur de base de données, la plupart du temps, est localhost mais cela peut etre autre chose. Si vous n'avez pas connaissance du nom de votre base
de données et/ou des paramètres d'accés nécessaires, renseignez vous auprès de votre hébergeur. (note: le mot de passe d'accés n'est pas nécessaire pour la
validation du formulaire; pratique pour les tests en local)
Il vous est également demandé un prefixe pour les tables, ceci afin d'éviter d'éventuels conflits avec d'autre tables déja présentes, et qui auraient le
même nom qu'une des tables de WAnewsletter.
Vous devez ensuite entrer des paramètres pour l'administration du script, son accés étant protégé. Vous pourrez ultérieurement ajouter d'autres utilisateurs avec des droits d'accés personnalisés.
L'url du site correspond à l'url de votre site, ex: http://www.votredomaine.com
L'url du script correspond au chemin vers le dossier du script, à partir de la racine du site. ex: /newsletter/ (Important: notez bien que le chemin commence et se termine par un slashe (/) )
Une fois que le script est installé, retirez bien les droits en écriture sur le dossier includes/ et supprimez le dossier setup/ de votre ftp.
|
Top |
|
IV. Mise à jour d'une version 2.2.x |
Pour mettre votre version 2.2.x à jour, téléchargez la nouvelle version, remplacez les fichiers de votre version par
ceux de la nouvelle (gardez le contenu des dossiers upload/ et stats/ s'il y a lieu).
Puis tapez l'adresse vers le fichier install.php du script.
Saisissez dans le formulaire qui s'affiche votre pseudo et mot de passe d'administrateur et laissez faire le script.
Une fois la mise à jour terminée, supprimez le dossier setup/
|
Top |
|
V. Mise à jour d'une version 2.1.x ou 2.0.x |
Pour mettre votre version 2.0.x ou 2.1.x à jour, téléchargez la nouvelle version, remplacez les fichiers de votre version par
ceux de la nouvelle (gardez le contenu des dossiers admin/upload/ et stats/).
Il vous est fortement conseillé de faire une sauvegarde des tables du script avant de lancer la mise à jour !
Donnez les droits en écriture sur le dossier includes/ le temps de la mise à jour.
Puis tapez l'adresse vers le fichier update.php du script.
Saisissez dans le formulaire qui s'affiche votre pseudo et mot de passe d'administrateur et laissez faire le script.
Une fois la mise à jour terminée, supprimez le dossier setup/ et retirez les droits en écriture sur le dossier includes/
|
Top |
|
VI. Mise à jour d'une version 1.1 |
Aucun script de mise à jour à partir d'une version 1.1 n'est fourni à partir des versions 2.2.x.
Vous pouvez contourner le problème en mettant à jour vers une version 2.1.x puis de là, mettre à jour vers une version 2.2.x.
|
Top |
|
VII. Historique des versions |
Version 2.2-Beta
- Trop d'ajout/modifications/corrections pour être citées
Version 2.2-Alpha
Le script a été largement réécrit.
- Support sur bases de données PostgreSQL
- Ajout possibilité d'utiliser des fichiers joints au sein d'emails html (images, sons ..)
- Sauvegarde de modèle de newsletters réutilisables
- Système de sauvegarde et de restauration des tables du script
- Vérification et élimination lors d'importation d'emails et fichier explicatif pour les emails refusés
- Possibilité de stocker les fichiers joints sur un serveur ftp distant
- Toute la partie concernant l'envoi proprement dit a été optimisée au maximum pour réduire les risques de time out lors d'envois massifs
- Nouveau système de gestion des fichiers joints (permet d'éviter les doublons et de réutiliser des fichiers uploadés pour d'autres newsletters)
- Refonte de la table des abonnés, élimination des doublons et gestion type "compte"
- Système de purge modifié pour être réglable par liste
- Système de gestion d'extensions de fichiers interdites (pour les fichiers joints)
- Form. generator simplifié
- [...]
Version 2.1.2
- Ajout fonction Location() pour header de redirection absolus (cf spec HTTP /1.1)
- Bug fix : Problèmes avec extra.php, pas d'affichage
- Bug fix : Liste déroulante non fermée dans admin.php
- Bug fix : Utilisation de $_POST au lieu de $HTTP_POST_VARS dans admin_auth.php (problème lorsque php inférieur à 4.1.0)
- Bug fix : Tri par email ne fonctionne pas dans la liste des inscrits
- Bug fix : parse error line 1 dans config.php sur certains serveurs (surement dù au fait que les fichiers php n'étaient pas au format unix)
- Bug fix : Mauvais numéro de version du script dans la base de données après une installation avec la version 2.1.1
- Bug fix : Erreurs php dans stats.php lorsqu'il n'y a aucun inscrit (warning mktime() et date() )
- Bug fix : Erreur SQL lors d'une importation via upload si un des emails contient des guillemets simples
- Bug fix : Si toutes les listes étaient supprimées, plus aucun accés à l'admin n'était possible
- Bug fix : INSERT effectué même si le masque est vide dans la section "emails bannis"
- Bug fix : Erreur d'offset dans stats.php, graphe des inscriptions sur le mois non affiché
Version 2.1.1
- Bug fix : Jeu de caractère non spécifié dans lang.php
- Bug fix : Dates partiellement traduites seulement dans l'admin des inscrits et des logs
- Trou de sécurité corrigé dans newsletter.php ($waroot)
- Perte de la connexion à MySQL après l'envoi et avant la mise à jour de la table des abonnés
Version 2.1.0
- Bug fix : "undefined properties altmessage..." sur Nexen
- Bug fix : Emails en un bloc (sans retour chariot) sous certains environnements logiciels
- Bug fix : Envoi terminé mais le script proposait de continuer s'il y avait un abonné qui n'avait pas confirmé son inscription dans la liste de destination
- Bug fix : Erreur SQL lors de l'envoi à une liste multi-format
- Bug fix : "Warning undefined variable datalang... " lors des messages d'information ou d'erreur
- Bug fix : Problèmes potentiels si cookie nommé "lang", "datetime" ou "datalang" présent sur la machine cliente
- Bug fix : Problèmes potentiels si envoi à une liste multi-format en plusieurs flots
- Bug fix : Navigation générée incorrecte lorsque le nombre de page était supérieur à 100
- Bug fix : Problèmes potentiels lors du passage des critères de recherche dans la navigation par page
- Bug fix : Emails non envoyés sur Online
- Bug fix : Emails reçus en double lors de l'envoi d'une newsletter via le système smtp
- Bug fix : Codes abonnés non présent dans le lien de desinscription lors d'un envoi à une liste multi-format
- Gestion du format des dates
Version 2.1 Beta2
- Bug fix : Email de retour d'erreur non prise en compte lors de l'envoi
- Bug fix : Fonctions de statistiques actives même si la librairie GD n'est pas installée sur le serveur
- Bug fix : Lien de désinscription en double dans les envois au format texte
- Bug fix : Erreur SQL lors de l'envoi à une liste ne comportant aucun abonné
- Bug fix : Erreur "cannot redeclare function email()..." sous Nexen
- Bug fix : Newsletter sauvegardée même si le sujet est vide
- Bug fix : erreur "undefined offset.." si l'extension d'un fichier joint n'est pas listé dans mailer.php
- Bug fix : Boucle infinie dans envoi.php, résultat: les abonnés recevaient des milliers d'emails
- Gestion des jeux de caractères (charset) selon la langue choisie
- faq pour les questions les plus générales (faq_fr.html, dispo dans le dossier docs/)
- Diverses autres corrections dans le code
Version 2.1 Beta
- Administration plus esthétique
- Générateur de formulaire simplifié
- Possibilité d'utiliser le fichier suscribe.php au lieu de générer un formulaire, auquel cas, toutes les listes
apparaissent dans une liste déroulante
- Système de permissions avançé, par liste et/ou action effectuée
- Confirmation de suppression pour les abonnés et les logs
- Option d'email envoyé à un admin lors d'une nouvelle inscription personnalisé à chaque liste
- Système de bannissement d'emails ou de types d'email
- Système de purge de la table des abonnés (inscription non confirmées). Possibilité purge automatique
- Module d'importation simplifié. Gestion d'upload des fichiers compressés au format gzip
- Module d'exportation d'adresses emails. Possibilité de télécharger un fichier "gzippé" si le serveur le permet
- Module de statistiques. Inscriptions par jour selon le mois et l'année donnée ou visualisation graphique du nombre d'abonnés selon les listes
- Téléchargement du fichier de configuration à la fin de l'installation s'il n'a pu être créé sur le serveur
- Gestion des retours d'erreur (email inconnu, etc...)
- Deux moteurs d'envoi :
Un envoi avec les destinataires en copie cachée, ou un envoi type: un abonné = un email
- Fonctionne sur Online (avec le deuxième moteur d'envoi)
- Possibilité de reprise d'un envoi et gestion par l'administrateur du nombre d'envoi effectués en un flot
Version 2.0.2
- Bug fix : Email non envoyé si l'admin veut etre prévenu d'une nouvelle inscription
- Bug fix : section configuration, le script ne prenait pas certains changements en compte
- Bug fix : message d'erreur lors de l'inscription sous certains environnements (Warning: Call-time pass-by-reference has been deprecated ...)
- Bug fix : Erreur lorsqu'une personne confirme son inscription (son inscription etait bien confirmée mais il y avait quand meme un message d'erreur)
- Bug fix : les inscrits qui n'avaient pas confirmés leur inscription reçevaient quand même la newsletter
- Bug fix : variable $waroot incorrect dans version.php
- Table session au format fixe et de type HEAP pour MySQL
- Support pour les bases de données SQL server (aucun test n'a pu etre réalisé, ce support est donc expérimental et tout retour sera le bienvenue !)
- Script d'installation simplifié, notamment pour les mises à jour à partir de versions 2.x
Version 2.0.1
- Bug fix : liste déroulante inopérante dans "voir liste de diffusion" pour modifier le format
- Bug fix : hebergeur non pris en compte pour l'envoi des mails
- Bug fix : fichiers joints endommagés sous windows
- Bug fix : liens cassés dans les emails d'inscription et de confirmation
- Bug fix : erreur set_to() lors de l'envoi à une liste au double format et aucun inscrit dans un des deux formats
- Préparation au support d'autres bases de données (dossier sql/)
- Gestion des headers (header("Refresh: 0; URL=....")) sous les serveurs microsoft et xitami
Version 2.0.0
- Bug fix : Affichage dans l'administration corrigé
- Bug fix : Pas d'inclusion du fichier mailer.php lorsqu'il n'y avait pas de confirmation, dans newsletter.php
- Bug fix : Espaces en trop en tête des emails
Version 2.0 Beta
Le script a été totalement réécrit.
- Gestion de plusieurs listes de diffusion
- Affichage du nombre d'inscrits à une liste sur une page du site
- Choix du format pour chaque liste
- Formulaire d'inscription intégré au site ou affichable par popup
- Confirmation d'inscription par email (possibilité d'activer/désactiver cette option) pour chaque liste
- Possibilité d'être prévenu par email de chaque nouvelle inscription
- Fonctionne sur Nexen
- Si votre hébergeur ne dispose pas de fonction mail() ou autre, possibilité d'accés direct à un serveur smtp
- Multi-administration avec plusieurs niveaux d'accés
- Possibilité de sauvegarder une newsletter en cours de rédaction pour la reprendre plus tard
- Envoi de newsletter avec fichier(s) attaché(s)
- Connexion à l'administration via un système de session (les cookies ne sont plus obligatoires)
- Utilitaire d'importation de masse
- Petit module de recherche d'abonnés dans la table des abonnés
Version 1.1
- Bug fix : Affichage defectueux lors de l'installation
- Bug fix : Affichage defectueux dans la section "rapport de bug" (non non, c'est pas une blague !)
- Possibilité de choisir le type de formulaire d'inscription affiché
- Possibilité de choisir les types de format email autorisés (texte et/ou html)
- Utilisation d'un système de templates
- Utilisation d'une table dans la base de données pour la configuration de la newsletter
- Possibilité de placer soi-même les liens de désinscription et/ou de changement de format dans sa newsletter
Version 1.0
|
Top |
|
VIII. Hébergeurs posant problème |
Important ! Ce script ne fonctionne pas sur free, inutile d'essayer !
Sur multimania/lycos, les envois d'emails (en nombre de destinataires) sont limités à 150 par jour.
|
Top |
|
IX. Notes de l'auteur |
Ce script est diffusé sous licence GPL.
Concrètement, cela signifie que vous pouvez l'utiliser ou le modifier comme bon vous semble, du moment que les
copyright et mentions d'auteur restent tels quels. Lisez attentivement la licence GPL pour plus de détails.
Ce script ne contient aucune forme de publicité dans les emails (mentions en bas des emails ou autre). Mais vous pouvez, si vous le désirez et êtes satisfait de ce script, mettre un lien vers le site
phpcodeur quelque part sur votre site (en bas du formulaire d'inscription par exemple).
Un bouton 88x31 de WAnewsletter est également disponible dans le dossier images/ pour ceux qui le désirent.
|
Top |
|
|