_ _ _ _ _____ _____ | \ | | | | | ||_ _| / __ \ | \| | ___ __ __ ___ | | ___ | |_ | | _ _ __ __ `' / /' | . ` | / _ \\ \ /\ / // __|| | / _ \| __|| || | | |\ \/ / / / | |\ || __/ \ V V / \__ \| || __/| |_ | || |_| | > < ./ /___ \_| \_/ \___| \_/\_/ |___/|_| \___| \__|\_/ \__,_|/_/\_\ \_____/ v. 2.1.4. (c) 2007 Matthieu LACROIX - http://www.php-astux.info/newslettux-fr.php ------------------------------------------------------------------------------- VERSION FRANCAISE NewsletTux est un script de mailing-list avec administration complète permettant de gérer plusieurs profils de newsletters et écrivains. ATTENTION : NewsletTux permet l'envoi d'emails à plusieurs personnes. Il est manifeste que l'utilisation de NewsletTux n'a pas pour but de développer des courriers non désirés. En installant NewsletTux, vous approuvez son utilisation à des fins d'information et non de spam. I) Installation : facile et rapide ! ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 1 - Téléchargez tout le contenu de l'archive sur votre serveur ; (je vous conseille de créer un dossier newslettux2/ par exemple) - dans la suite de ce fichier texte, je supposerai que newslettux2/ est le dossier où vous avez téléchargé le script sur votre site web - 2 - Rendez-vous à http://votresite/newslettux2/admin/install.php Suivez les 5 étapes d'installation. 3 - Effacez (ou renommez) le fichier install.php si le script ne l'a pas fait ; sinon quelqu'un pourra réinstaller NewsletTux pour vous ! (donc c'est important...) II) Configuration : simple et intuitive ! ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Connexion : http://votresite/newslettux2/admin/index.php Login : votre email saisi dans l'installation Mot de Passe : celui que vous avez rentré durant l'installation A votre première connexion, tout est configuré soit en valeurs saisies pendant l'installation, soit en valeurs par défaut. 1 - Vous devez d'abord créer un profil de newsletter pour utiliser NewsletTux : ouvrez "Lettres d'information" > "Lister les lettres d'information" puis créez-en une. 2 - Installez le script sur votre site (voir paragraphes ci-dessous) 3 - Vous pouvez nommer certains de vos abonnés "écrivain" ou "admin". Editez leur profil ("Gestion des abonnés" > "Lister les abonnés") pour leur donner des permissions. Les admins n'ont pas besoin de permissions d'écriture. Par sécurité, les fonctions vitales d'administration (base de données p.ex.) ne sont pas accessibles aux admins et écrivains. III) Types de formulaires : ~~~~~~~~~~~~~~~~~~~~~~~~~~~ Vous pouvez choisir entre 2 types de formulaires d'inscription. Pour faire le choix, allez dans : "Configuration" > "Configuration des inscriptions" a) le formulaire type NewsletTux 1.X = formulaire "normal" (format par défaut) Dans ce formulaire, le visiteur voit toutes les lettres d'informations, il peut choisir ses formats d'inscription. b) le formulaire "simplifié" : un seul champ (pour l'email) avec 2 boutons : "inscription" ou "désinscription". Pour ce formulaire, choisissez les formats (pour les lettres d'informations) auxquels souscriront, par défaut, tous les nouveaux inscrits. ATTENTION : privilégiez le format texte pour la compatibilité. NOUVEAUTE 2.1.0. : la surcharge du formulaire simple ---------------------------------------------------- Depuis la version 2.1.0. de NewsletTux, il y a possibilité de masquer les boutons "inscription" et "désinscription" du formulaire simple. C'est ce que j'appelle la surcharge. Le principe est expliqué ci-dessous (paragraphe IV - Configuration avancée) III) Intégration au site Web : ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Quel que soit le formulaire choisi, l'insertion dans votre site est très simple. 1 - Vous devez créer une page de votre site (ou en prendre une existante) portant l'extension ".php" (ex. http://www.monsite.ext/ma_newsletter.php) 2 - Vous devez ensuite ouvrir "form-newslettux.php" et le configurer (la zone à configurer y est clairement délimitée). Dans ce fichier, vous avez 2 variables à configurer : NTUX2_ROOT et DOCTYPE. * Pour le Doctype choisissez HTML (par défaut) ou XHTML selon votre page. * Pour la racine (NTUX2_ROOT), l'explication est un peu plus théorique. Il s'agit de renseigner, en chemin relatif, le dossier de NewsletTux 2 par rapport à l'endroit où sera inclus le fichier "form-newslettux.php", comme si vous faisiez un lien href vers form-newslettux.php. Comme un exemple vaut parfois mieux qu'un long discours, j'ai pris soin d'en créer 3. Essayez de voir quelle configuration se rapproche le plus de votre site, sinon posez votre question sur le forum en détaillant votre arborescence. 3 exemples de configuration de NTUX2_ROOT : EXEMPLE 1 : ----------- http://www.monsite.ext |- accueil.html |- contact.php |- ma_newsletter.php | |- newslettux2/ |- admin/ |- img/ |- languages/ |- lib/ |- sql/ |- upload/ | |- form-newslettux.php Dans cet exemple, par rapport à "ma_newsletter.php" il faut ouvrir le sous- dossier "newslettux2/" pour accéder à form-newslettux.php NTUX2_ROOT vaudra alors 'newslettux2/' Pour info : le chemin relatif vers form-newslettux.php est : newslettux2/form-newslettux.php EXEMPLE 2 : ----------- http://www.monsite.ext |- accueil.html |- contact.php | |- newslettux2/ |- admin/ |- img/ |- languages/ |- lib/ |- sql/ |- upload/ | |- form-newslettux.php |- ma_newsletter.php Dans cet exemple, par rapport à "ma_newsletter.php", nous sommmes déjà dans "newslettux2/" pour accéder à form-newslettux.php. NTUX2_ROOT vaudra alors './' (comprenez "point slash") Pour info : le chemin relatif vers form-newslettux.php est : ./form-newslettux.php EXEMPLE 3 : ----------- http://www.monsite.ext |- accueil.html |- contact.php | |- fichiers/ | |- ma_newsletter.php | |- newslettux2/ |- admin/ |- img/ |- languages/ |- lib/ |- sql/ |- upload/ | |- form-newslettux.php Dans cet exemple, par rapport à "ma_newsletter.php", nous sommes dans le dossier "fichiers/". Il faut donc remonter dans le dossier contenant fichiers/ puis descendre dans le dossier newslettux2/ NTUX2_ROOT vaudra alors '../newslettux2/' (comprenez "point point slash") Pour info : le chemin relatif vers form-newslettux.php est : ../newslettux2/form-newslettux.php Voyez l'article sur les chemins relatifs pour plus d'explications : http://www.php-astux.info/chemins-relatif-absolu.php C'est terminé pour la configuration de "form_newslettux.php". 3 - Dans la page de votre site, copiez-collez ce code : (en remplaçant "XXX" par le contenu de NTUX2_ROOT que nous venons de renseigner) là où vous voulez que le formulaire apparaisse et le tour est joué ! 4 - Reportez l'adresse de la page du formulaire d'inscription dans "Configuration" > "Config. des inscriptions" > "URL du formulaire d'inscription" pour mes 3 exemples EX. 1 = http://www.monsite.ext/ma_newsletter.php EX. 2 = http://www.monsite.ext/newslettux2/ma_newsletter.php EX. 3 = http://www.monsite.ext/fichiers/ma_newsletter.php c'est la page où sera exécutée l'inscription (car elle contient le formulaire d'inscription). Elle sert comme lien de désabonnement, aussi, assurez-vous de la remplir correctement. ~~ c'est tout ! ~~ IV ) Configuration avancée ~~~~~~~~~~~~~~~~~~~~~~~~~~ 1. Le flux RSS -------------- NewsletTux 2 offre la possibilité d'exporter un flux RSS de vos newsletters. Vous pouvez choisir entre un flux type RSS 2.0, ou un flux type Atom 1.0 Les explications contenues dans le fichier newslettux_rss.php doivent vous permettre de le configurer facilement. Pour afficher un flux RSS du profil de newsletter n°1, utilisez (et diffusez) ce lien : format RSS 2.0 : http://www.monsite.ext/newslettux2/newslettux_rss.php?feed=RSS&pid=1 format Atom 1.0: http://www.monsite.ext/newslettux2/newslettux_rss.php?feed=ATOM&pid=1 Pour afficher un flux des profils 1, 3 et 4 (par exemple), faites comme ceci : format RSS 2.0 : http://www.monsite.ext/newslettux2/newslettux_rss.php?feed=RSS&pid=1,3,4 format Atom 1.0: http://www.monsite.ext/newslettux2/newslettux_rss.php?feed=ATOM&pid=1,3,4 ATTENTION : lorsque vous créez un profil de newsletter (cf. § II 1.) vous devez cocher "Accès publique" pour que ses newsletters soient consultables via le flux RSS. Les profils n'ayant pas l'accès publique activé ne seront pas lisibles via le flux RSS. 2. Surcharge de formulaire simple --------------------------------- Ce paragraphe ne s'applique qu'à partir de la version 2.1.0. et uniquement pour le formulaire simple (pas pour le formulaire type NewsletTux 1.X). Le formulaire simple permet, par défaut, de n'avoir qu'un champ "email" avec 2 boutons : "inscription" et "désinscription". Il est possible de forcer l'action (inscription ou désinscription) et ainsi de masquer ces boutons. Cela permet par exemple, de n'avoir qu'un champ "email" puis un bouton "ok". Pour ce faire, vous devez inclure form-newslettux.php en déclarant quelques variables. Voici un exemple pour le fichier "ma_newsletter.php" de l'exemple 1, du code à y insérer à l'endroit où doit apparaître le formulaire : Cet exemple inscrira le visiteur aux newsletters n°2 (format texte) et 3 (format HTML) et il recevra un mail récapitulatif en anglais. Utilisez les 2 lettres nominatives de la langue : en, fr, de, sp, it ... selon les fichiers de langue que vous avez installés. Cette surcharge de formulaire écrase les inscriptions par défaut que vous choisissez dans la configuration du formulaire simplifié. V ) Aide, support, licence ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Vous trouverez toute l'aide nécessaire sur le forum pour NewsletTux ainsi que pour votre site. Adresse : http://www.php-astux.info/forum/index.php Pas de support par mail, veuillez privilégier le forum. La licence est une licence CeCILL (http://www.cecill.info/licences.fr.html) à l'exception de la classe "PHPMailer" sous licence GNU GPL et des smileys de Crystal XP. Vous acceptez par l'utilisation du script la licence CeCILL. Vous devez laisser les informations de licence intacts (image du manchot sur le formulaire d'inscription, liens, présence de copyright dans le code source). Merci de votre utilisation, Matthieu