Prenez le temps de lire ce fichier attentivement, il contient des informations utiles.
WAnewsletter requiert une version de PHP >= 4.1.0 ainsi qu'une base de données de type MySQL ou PostgreSQL.
Certaines fonctionnalités secondaires peuvent ne pas être disponibles selon la configuration de votre serveur et les librairies PHP installées. Par exemple, le module de statistiques demande que la librairie GD soit installée.
WAnewsletter dispose d'un script d'installation simplifié au maximum, afin de permettre aux néophytes de pouvoir utiliser le script rapidement. Voici brièvement les différentes étapes nécessaires à l'installation du script :
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/ ainsi que sur le fichier config.inc.php qui se trouve dans le dossier 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/.
À 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.
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. Une fois que le script est installé, retirez bien les droits en écriture sur le dossier includes/ et sur le fichier config.inc.php, et supprimez le dossier setup/ de votre ftp.
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 fichier config.inc.php, ainsi que 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/.
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 fichier config.inc.php, ainsi que 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 ensuite 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/.
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.
Si le safe mode est activé sur votre serveur, le script exige quelques légers aménagements, reportez vous à la FAQ du script.
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.