A very nice newsletter/messaging infusion for PHP-Fusion ver7. Based on Digitanium's original newsletter script v1.6 for PF-v6 and script upgrades by 'Yxos' and 'Muscapaul' to PF-v7 scripts, ver2.00, 2.01 and 2.02.

   My version 4.01 brings you the added capability to upload files to the new 'attach' folder for sending attachments in your newsletters. Sendmail imposes a filesize limit on attachments of about 700kb. Uploaded files can also be deleted when no longer needed. Thanks to Wooya for the file upload code from his 'Advanced Upload System' ver3.00 based on Digitaniums original upload system.

   Coding has been greatly enhanced so that ALL sending methods now deliver a personalized newsletter/message, with ONLY the recipients email address showing in the TO field. Version 4.01 also now automatically generates a text version of your newsletter for non-html email clients by use of the GNUv2 licensed 'class.html2text.inc' script by Jon Abernathy <jon@chuggnutt.com> in the 'root/includes' folder, renamed by me to 'html2text_include.php'.

*NOTICE* Two different versions of 'newsletters_include.php' in the 'infusion folder' and two different versions of 'phpmailer_include.php' in the 'root/includes' folder that enables total performance whether your host is running PHP-ver4 OR PHP-ver5.

The new files are:
In 'infusions/newsletters' folder - 'newsletters4_include.php' and 'newsletters5_include.php'
In 'root/includes' folder - 'phpmailer4_include.php' and 'phpmailer5_include.php'

   And 'smiley insertion' has been added below the 'html buttons' code. Template/skin files have been totally re-vamped so that font color settings will not be rendered invisible by 'gmail', 'hotmail' and possibly other Web Mail services, thanks to feedback from Diemux; also moved the css coding into the db based templates. All template(skin) 'css' and 'body' tag is now within the template itself, giving TOTAL CONTROL of css settings and body background color or image. When previewing a 'skin' or 'newsletter' file, your entire page temporarily takes on the background image/color specified in the template file due to the 'body/html' tags within the templates. This in no way affects any other part of the system and it's only while previewing..This opens up the possibility for using other templates that are very sophisticated and adaptable for producing very complex newsletters. All images and image fragments that are included in the 'root/infusions/newsletters/nlimages' folder for the template files, are derived from PHP-Fusion themes that I use and like. Individual permissions from individual theme authors for use of their images has not been sought, as the themes are aGPL based and open source.

--------

   In ver4.00 I added the capability to send a newsletter or message to a 'single' or 'multiple users' in addition to the original 'send to all' options. I also added the capability to send to a 'user group'. Now includes a semi-automatic templating(skins) system and a new interface to the entire newsletter sub-system. A new table was added to the db for storage of the template(skin) files. The 'display format' was also been greatly enhanced and code for using 'html formatting' was been added from 'Yxos' and 'Muscapauls' ver2 upgrades. The infusion adds a 'user_field' in the database 'users table' called 'user_newsletter' for storing 'subscribe/unsubscribe' parameter. A zero(0) for 'No' and one(1) for 'Yes'. By default ALL users are added or 'subscribed' to your newsletter at install time. A new side-panel was created for your users to 'subscribe' or 'unsubscribe' to your mailing list. As a user logs on his 'username' and 'subscription status' are displayed in the side-panel with 'subscribe' or 'unsubscribe' button as his/her status dictates.

• You must defuse/uninstall any previous newsletter infusion before proceeding to avoid possible variable name conflicts.



• Upload everything under 'FILES' to your 'root folder' and 'infuse' as usual.



• New skin images have been added to the 'nlimages' folder in 'infusions/newsletters' directory.



• Only an 'English' locale file is available at the moment.




• Next Step:



• Go to 'System Admin/Panels'
  and add the side-panel called 'newsletters_panel'.



• Don't forget to locate: (left-right-up-down) and 'Enable' it.

• File modifications: None.



• File addition: 'root/includes/phpmailer4_include.php'



• File addition: 'root/includes/phpmailer5_include.php'



• File addition: 'root/includes/html2text_include.php'



• Database 'users' table.
  Data field added: 'user_newsletter'.



• Database 'newsletters_skin' table added.
  Stores the html template(skin) files.

Newsletters Admin


Side-Panel

• Using SMTP:
  
  
  • If you use an 'SMTP Host' for email open up the file 'newsletters_include4.php' or
    'newsletters_include5.php' depending on your hosts php version.
  • Change the line near the bottom that reads: $this->SMTPAuth = false;
  • By changing it to a 'true' value thusly.
  • $this->SMTPAuth = true;.
  • The 'smtp_username' and 'smtp_password' are read from your site settings.
  
  
  
• Using My Built-In Html Templates/Skins:
  
  
  • I have included five(5) html template(skin) files for your usage.
  • The skin files are stored in their own db table at 'infuse' time and are named 'Tpl-xxxx'
    for 'Template-Name', so that when you 'Save As Newsletter' the skin files will maintain
    an easily recognizable 'subject/name' as 'templates' in your newsletter system.
  • Just load each skin and change all the text as appropriate for your site and the 'domain name' in each one.
  • If your editor is anything like mine you can just 'cut' the entire 'skin html code' from the skin editor.
  • Then 'paste' into your local editor and use 'find and replace' on YOURDOMAIN.COM on your local system.
  • After all changes are completed paste it back into the skin editor and 'save' the skin file.
  • Repeat the process for all five(5) template/skin files.
  • Then reload each skin file in turn, and hit the 'Save As Newsletter' button.
  • It will be added to your 'newsletters table' as a finished template with the skin name as subject.
  
  
  
• Using Your Own Html Templates/Skins:
  
  
  • If you choose not to use my template(skin) files.
  • You will need to create your own html template(s).
  • Include any needed css at the beginning of your file.
  • Pay close attention to the format of my existing templates.
  • Required if you are going to send 'html based' newsletters.
  • Do not use '<html> <head> <title> <body> </body> </html>' tags in your template/skin file.
  • Those are already built-in to the newsletter script.
  • Start and end with <table> or <div> tags after your css definitions(if needed).
  • The body background color or image can be changed by modifying it in the template(skin) file.
  
  
  
• Editing and Saving:
  
  
  • Once you have a template(skin) file saved as a newsletter in the DB.
  • Select the 'skin name' and choose 'Edit'.
  • Add your newsletter content between the 'remark statements'.
  • Set all of the sending parameters and select an attachment file if any.
  • Then change the 'subject'(name) to the actual 'subject' of your newsletter.
  • Saving the newsletter with the same skin 'subject'(name) will 'update/overwrite' the skin file.
  • But 'saving' with a different 'subject'(name) will create a new file thus archieving your 'sent' newsletter.
  • After checking everything for accuracy by 'previewing' just hit 'Send Newsletter' and its on its way.
  • To add more newsletter/templates you can simply edit any existing one.
  • Saving it with a new 'subject'(name) or create an entirely new one.

• Version4.01 Upgrade - September 20, 2009:
  
  
  • Added attachment uploads and attachment sending.
  • Added 'html2text_include.php' to includes folder for html content conversion to
    'formatted text' for AltBody.
  • Added 'root/includes/phpmailer4_include.php' and 'root/includes/phpmailer5_include.php'
    to facilitate usage of PHP-ver4 or PHP-ver5.
    
  • Added 'spc' button to 'html buttons' code to place a 1x20pixel transparent line for paragraph indents.
  • Added code for inclusion of smiley images in content area.
  • Coding enhanced for individualized emails for all sending methods.
  • Css definitions moved to top of template files.
  • Removed un-needed files in infusions 'include' folder, 'html_header_include.php'
    and 'preview_header_include.php', as css is now located in html template files.
  
  
  
• Version4.00 Upgrade - July 19, 2009:
  
  
  • Added a new semi-automatic template(skin) system with brand-new templates(skins).
  • Added a new table to the db for storing templates(skins).
  • Built a new interface to the newsletter sub-system.
  • Completed coding for sending emails/newsletters to a 'user group'.
  
  
  
• Version3.03 Upgrade - July 12, 2009:
  
  
  • Added the folder 'include' containing 'html_header_include.php' and preview_header_include.php' files.
  • Newsletter html headers and css seperated from main script for ease of editing.
  • Preview newsletter display now picks up css headers and shows proper background color.
  
  
  
• Version3.02 Upgrade - July 04, 2009:
  
  
  • Added the ability to send a message/newsletter to multiple users.
  • Hold down the Ctrl(Control) key when selecting recipients.
  
  
  
• Version3.01 Upgrade - June 06, 2009:
  
  
  • Changed/added coding to be compatible with PHPver5 for sites that are using it already.
  • Fixed all edit/save bugs.
  
  
  
• Version3.00 - May 06, 2009:
  
  
  • Added 'html codes' from ver2 by Yxos and Muscapaul.
  • Created/added code for sending newsletter to a single subscriber.
  • Created a nice sub/unsub side-panel.
  • Changed and enhanced the visual layout for a more intuitive and visually appealing design.
  
  
  

• Future upgrade: Attachments.
  
  
  • Enabling attachment sending that is larger than 700 kilobytes in size.

• Help Needed: Locale Files.
  
  
  • To enhance the 'usability' of this infusion I am in need of assistance.
  • Any locale file translations would be greatly appreciated and added to the archieve immediately !
  
  
  

• The Following People & Scripts Have Contributed To The Successful Creation of My Newsletters Infusion:
  
  
  1. Nick Jones (Digitanium)
     • http://www.php-fusion.co.uk/PHP-Fusion Home
     • http://www.digital-dominion.co.uk/Nicks Digital Dominion
     • Newsletters Script v1.6 For PFver6 - Original Author
       
       
  2. Ole Geismar (Xyos)
     • Update PHP-Fusion v6.01.xx - (v1.60)
       
       
  3. Paul Beuk (muscapaul)
     • http://www.muscapaul.com/Muscapaul
     • Update PHP-Fusion v7.xx - (v2.00) Newsletters
     • Update PHP-Fusion v7.xx - (v2.01) Newsletters
     • Update PHP-Fusion v7.xx - (v2.02) Newsletters
       
       
  4. (Wooya)
     • http://www.2loud.net.pl/2Loud Dot Net
     • Advanced File Uploads ver7
     
     
     
  5. (Dallas)
     • http://dtawebdesigns.com/DTA Web Designs
     • My Newsletters - (v3.00) Testing, Coding Help & Suggestions
     • My Newsletters - (v3.01) Testing, Coding Help & Suggestions
     • My Newsletters - (v3.02) Testing, Coding Help & Suggestions