_ _ U _____ u ____ _ U _____ u _____ _____ _ _ __ __ _____ | \ |"| \| ___"|/ __ __ / __"| u |"| \| ___"|/ |_ " _| |_ " _| U |"|u| | \ \/"/ |___"/u <| \| |> | _|" \"\ /"/ <\___ \/ U | | u | _|" | | | | \| |\| | /\ /\ U_|_ \/ U| |\ |u | |___ /\ \ /\ / /\ u___) | \| |/__ | |___ /| |\ /| |\ | |_| | U / \ u ___) | |_| \_| |_____| U \ V V / U |____/>> |_____| |_____| u |_|U u |_|U <<\___/ /_/\_\ |____/ || \\,-. << >> .-,_\ /\ /_,-. )( (__) // \\ << >> _// \\_ _// \\_ (__) )( ,-,>> \\_ _// \\ (_") (_/ (__) (__) \_)-' '-(_/ (__) (_")("_) (__) (__) (__) (__) (__) (__) (__) \_) (__) (__)(__) (c) 2009-2011 Matthieu LACROIX - http://www.newslettux.fr - NEWSLETTUX 3 R2 ------------------------------------------------------------------------------- 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. Par son téléchargement, et/ou son installation, utilisation, copie en mémoire ou sur différents supports, vous acceptez le Contrat de Licence qui est joint. I) Installation : facile et rapide ! ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 1 - Dézippez l'archive sur votre disque dur. Ouvrez un logiciel FTP type "FileZilla" et copiez, en respectant l'arborescence, l'intégralité du dossier dézippé sur votre serveur. Je vous conseille de créer un dossier, par exemple newslettux3/, dans lequel vous mettrez le Logiciel. 2 - Rendez-vous à l'adresse http://www.votresite.ext/newslettux3/_admin/install.php Renseignez les variables demandées. Si vous êtes sur un serveur OVH mutualisé, rendez-vous à l'adresse suivante : http://www.votresite.ext/newslettux3/_admin/install.php?ovh 3 - Effacez (ou renommez) le fichier _admin/install.php si le script ne l'a pas fait ; sinon quelqu'un pourra réinstaller NewsletTux pour vous ! (donc c'est important...) 4 - Configurez-le comme indiqué dans le paragraphe suivant. II) Configuration : simple et intuitive ! ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ II) partie 1 - installation sur votre site ****************************************** NewsletTux 3 est livré avec 3 pages "par défaut" vous permettant d'utiliser rapidement le Logiciel. Ces pages permettent : - de s'inscrire : newslettux_reg.php - de se désinscrire : newslettux_unreg.php - d'afficher un flux RSS : newslettux_rss.php Vous pouvez, sur votre site : - soit faire des liens vers ces pages (que vous pouvez décorer à souhait sauf pour RSS) - soit les remplacer par vos pages, il vous suffira de garder le code PHP tel qu'indiqué dans ces 3 pages fournies. Vos pages remplaçantes devront alors obligatoirement porter l'extension .php L'installation sur votre site est à présent terminée. Faites attention aux chemins relatifs dans le "require_once". Si vous désirez remplacer les pages par défaut par des pages situées ailleurs dans votre site, regardez le code PHP de NewsletTux des pages à remplacer, le code que vous devrez conserver est clairement indiqué. (Il y a 2 parties à chaque fois) II) partie 2 - configuration basique du Logiciel ************************************************ Connectez-vous à l'interface d'administration : http://www.votresite.ext/newslettux3/_admin/index.php Identifiant (login) : adresse email saisie lors de l'installation Mot de passe : idem Ouvrez Général > Assistant Installation sur site Cet assistant va terminer la configuration pour vous. Je vous laisse ensuite le soin de regarder Général > Configuration ... :-) III) Inscription, types de formulaires : ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Vous pouvez choisir entre 2 types de formulaires d'inscription. Pour faire le choix, allez dans : Général > Configuration > Configuration des inscriptions. a) le formulaire normal (format par défaut). Dans ce formulaire, le visiteur voit toutes les listes de diffusion et doit saisir son email. Il peut choisir ses formats d'inscription (Texte, HTML) selon ce que vous aurez configuré. b) le formulaire mini : un champ unique pour l'email, l'inscription à une ou plusieurs listes est faite de manière transparente. Vous devez utiliser le §IV pour finir de configurer ce formulaire (réservé aux utilisateurs expérimentés). IV) Configuration avancée ~~~~~~~~~~~~~~~~~~~~~~~~~ IV) partie 1 - surcharge de formulaire (valable pour les affichages normal et mini) *********************************************************************************** Chaque formulaire (normal, mini) a des "fonctions cachées" que ce petit guide va vous dévoiler. Vous devrez mettre la ligne en question AVANT l'affichage du formulaire bien entendu. Tout est expliqué, n'ayez pas peur :-) Au lieu du code ... RegForm(); ?> Utilisez ... ** Forcer ou non l'anti spam ** SetForceAntispam('no'); echo $newslettux3->RegForm(); ?> ** forcer l'URL de redirection une fois l'inscription terminée ** SetRegUserRedirect('http://www.newslettux.fr'); echo $newslettux3->RegForm(); ?> ** demander plus d'informations que l'email seul ** SetOtherFields('firstname,zip,city,mobile'); echo $newslettux3->RegForm(); ?> ** changer la langue du formulaire ** SetLang('de'); echo $newslettux3->RegForm(); ?> ** changer le temps de redirection ** SetRedirectTime(10); // 10 secondes echo $newslettux3->RegForm(); ?> ** désactiver la confirmation d'inscription (seulement si pas de vérification de l'email) ** SetConfirmReg(0); // 1 par défaut, si cette ligne n'est pas mise, la valeur sera initiée à 1 echo $newslettux3->RegForm(); ?> ** formulaire mini uniquement : spécifier les listes de diffusion de manière transparente ** Format // le visiteur sera inscrit avec l'exemple suivant // aux listes numéro 1 en HTML, 3 en texte et 4 en HTML $array_regs = array(1 => 'HTML', 3 => 'TEXT', 4 => 'HTML'); $newslettux3->SetForcePidFormat($array_regs); echo $newslettux3->RegForm(); ?> ** proposer un formulaire de désinscription ** UnregForm(); // les mêmes actions que pour RegForm() s'appliquent ?> ** ajouter un message d'erreur (code HTML) personnalisé avec l'erreur NewsletTux ** Ce message sera affiché au dessus de l\'erreur.

'; $html_en_dessous = '

Ce message sera affiché en dessous de l\'erreur.

'; // vous pouvez utiliser l'un ou les 2. $newslettux3->SetCustomMessageOnError($html_au_dessus, 'up'); $newslettux3->SetCustomMessageOnError($html_en_dessous, 'down'); ?> Bien sûr, vous pouvez cumuler : SetForceAntispam('no'); $newslettux3->SetOtherFields('firstname,zip,city,mobile'); $newslettux3->SetLang('de'); echo $newslettux3->RegForm(); ?> /!\ ATTENTION : pensez à mettre echo $newslettux3->RegForm(); en tout dernier ! /!\ IV) partie 2 - Flux RSS *********************** Comme dans la version 2, NewsletTux offre toujours la possibilité de lire les lettres d'informations. Le principe est le même que pour le formulaire d'inscription. Vous pouvez créer une page dédiée ou en utiliser une sur votre site (extension .php) Placez ce code en haut de cette page : Ensuite, pour afficher le flux RSS, vous devez définir 3 variables : - le type de flux, NewsletTux offre les flux aux normes RSS 2.0 et ATOM 1.0 - la (ou les) liste(s) de diffusion (il faut qu'elle(s) ai(en)t le flux RSS d'activé) - le nombre d'items que vous voulez lister. Vous devez utiliser ce code pour afficher le flux RSS : RssFeed($type_flux, $listes_diffusion, $nb_items); ?> IV partie 3 - lecture d'une lettre sur site ******************************************* Même type de code que le flux RSS avec l'ID de la lettre d'information en paramètre. Vous pouvez créer une page dédiée ou en utiliser une sur votre site (extension .php) Placez ce code en haut de cette page : Vous devez utiliser ce code pour afficher la lettre d'information : GetValue('nid', 'int', 0); // l'ID de la lettre à afficher $newslettux3->DisplayNewsletter($get_nid); ?> Et vous passez un ?nid=... dans votre URL avec la valeur de l'ID de la lettre à afficher. /!\ ATTENTION : si toutes les listes de diffusion auxquelles cette lettre a été envoyée sont en flux RSS "off", vous ne pourrez pas la lire sur le site. V) Aide, support, licence ~~~~~~~~~~~~~~~~~~~~~~~~~ Vous trouverez des mises à jour, de l'aide via un blog, une Foire Aux Questions sur le site officiel : http://www.newslettux.fr/ *** Pas de support par mail ***, veuillez privilégier le forum. Vous devez laisser les informations de licence intactes (liens, présence de copyright dans le code source). La licence ne vous donne pas le droit d'éditer le code du Logiciel. Merci de votre utilisation, Matthieu