Fichier lisezmoi - WAnewsletter 2.1.1


Prenez le temps de lire ce fichier attentivement, il contient des informations utiles.

Sommaire
  1. Configuration requise
  2. Installation : Explications rapides
  3. Installation : Explications détaillées
  4. Mise à jour d'une version 1.1
  5. Mise à jour d'une version 2.x
  6. Historique des versions
  7. Hébergeurs posant problème
  8. Notes de l'auteur

I. Configuration requise
Ce script requiert PHP4 ainsi qu'une base de données MySQL ou Microsoft SQL Server.
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.

II. Installation : Explications rapides

  1. Uploadez les fichiers contenus dans l'archive sur votre ftp (respectez bien la structure des répertoires)
  2. Donnez les droits en écriture sur les dossiers admin/upload/, stats/ et includes/ via votre client ftp préféré
  3. 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)
  4. Sur la première page, choisissez "installation", puis remplissez le formulaire qui s'affiche et cliquez sur le bouton de validation
  5. Une fois le script installé, retirez les droits en écriture sur le dossier includes/
  6. Pour finir, supprimez le dossier setup/ de votre ftp afin d'éviter une réinstallation

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 le dossier images/. Les images doivent être uploadées en mode binaire.
Toujours dans votre client ftp favori, donnez les droits en écriture sur les dossiers admin/upload/, 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 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

Une fois sur la page, choisissez le type d'installation, dans notre cas, "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.

Vous arrivez maintenant sur le formulaire d'installation.
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.

Il vous est ensuite demandé l'adresse d'envoi. C'est l'adresse email qui sera utiliser comme expéditrice des emails envoyés aux abonné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.

IV. Mise à jour d'une version 1.1
Commencez par faire une sauvegarde des tables de votre newsletter. (on sait jamais)
Remplacez tous les fichiers de la version 1.1 par par ceux de cette version.
Vous pouvez replacer le fichier config.inc.php de la version 1.1 dans le dossier includes/ de la nouvelle version mais ce n'est pas indispensable.
Donnez les droits en écriture sur les dossier admin/upload/, stats/ et includes/ puis rendez vous sur la page d'installation.
Choisissez "mise à jour d'une version 1.1" et validez. Remplissez le formulaire qui suit et validez.
Une fois la mise à jour réalisée, retirez les droits en écriture sur le dossier includes/ et supprimez le dossier setup/ de votre ftp.

Une mise à jour depuis la version 1.0 n'a pas été prévue (celle ci ayant eu une existence de quelques semaines seulement).
Si toutefois vous vous trouvez dans ce cas, tentez une mise à jour de la version 1.0 à la version 1.1 puis une deuxième mise à jour de la version 1.1 vers une version 2.x .

V. Mise à jour d'une version 2.x
Le dossier stats/ doit être accessible en écriture si ce n'est pas déja le cas.
Pour faire une mise à jour à partir d'une version 2.x, seuls vos login et mot de passe d'administrateur vous seront demandés.
Veillez à remplacer tous les fichiers de votre ancienne version par ceux de la nouvelle. Ne gardez que le fichier config.inc.php que vous devez remettre dans le dossier includes/.
Appellez le fichier install.php et choisissez "Mise à jour d'une version 2.x".
Si vous mettez à jour une version 2.0.0 ou antérieure, donnez les droits en écriture sur le dossier includes/ le temps de la mise à jour.

VI. Historique des versions
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
  • Version d'origine

VII. 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.

VIII. 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 pub (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) mais ce n'est absolument pas obligatoire.


Powered by PHPcodeur © 2002 | WAnewsletter 2.1.1
Ce script est distribué librement sous licence GPL