Newsletter Panel Infusion ver5.00

for PHP-Fusion v7.01.xx and v7.02.xx

Retains Compatibility with PHP-Fusion v7.01

Newsletter Panel Infusion v5.00 for PHP-Fusion v7.01 & 7.02 by Grimloch | See includedaGPLver3for licensing information.
  FEATURES:

1) The next level of functionality has been achieved.
  • The long sought after task of coding that will allow MOST webmail clients/systems to properly display the emails has been done. It required a re-sizing of all the templates to a 600pixel width and the use of the old html font commands and a lot of help from a friend; afoster. During my limited amount of experimentation, I discovered that most webmail services/clients, will not honor css coding for [td class='xxx'], OR [span style=''][/span] font settings, OR inline [td style='xxx'] font controls.

  • There is now a fallback for the above; sent newsletters are now archived for static viewing in the new 'archive' folder in the infusion and a 'view as a webpage' link has been added to the templates.

  • New input field added in the form and database which allows the admin to set the text of the newsletter heading (was a static display of 'Newsletter - Month').

  • New template display of the 'Published On' date has been added to the newsletters.

  • New scripts added called 'news_letter_archive.php' and 'news_letter_archive_admin.php' in the infusion folder which allows the admin to delete old newsletters.

  • Two navigation links have been added called 'Newsletter Archive' and 'Subscriptions' set for member access.

  • If public subs are allowed set the 'Subscriptions' link to public access or delete it, as the same thing is accomplished with the side panel.

2) Two new features have been added with this version.
  • The general public(site guests), may now Subscribe/Unsubscribe to your newsletters. The option
    for public subscriptions can be turned on or off.

    • Code added and modified from the Open Newsletter system developed by Paul Beuk (Muscapaul), from Koller Józsefs' (Orosznyet) original version 2.00

  • New template four(4) has been added. Basically a gaming template based on World of Warcraft. The original templates 4, 5 and 6 were removed.

3) PHP-Fusion v7.01.xx and PHP-Fusion v7.02.xx compatibility.
  • A very nice newsletter infusion for PHP-Fusion v7 based on Digitanium's original newsletter script v1.6 for Fusion-v6 and subsequent script upgrades by Yxos and Muscapaul to Fusion-v7 scripts, vers2.00, 2.01 and 2.02.

4) Capability to send multiple attachments with html or plain text newsletters.
  • Sending multiple attachments of almost any filetype without compression needed. Upload your files into the 'news_letter_panel/attach' folder by use of the Upload Files script. Once the uploads have been attached and no longer needed they may be deleted from the attach folder.

5) All sending methods deliver a newsletter with ONLY the recipients email address showing.
  • Generates a text version of your newsletter for non-html email clients by use of the version2 html2text.php script found at howtocreate.com in the 'news_letter_panel/include' folder, which is sent when you choose html or plain text at the bottom of the form.

  • The BCC and CC mail sending is not implemented as it is not needed.

6) Smiley insertion has been added below the html-button code.
  • There are currently 22 smileys to choose from.

7) One, two and three column templates for each of the four styles.
  • The 12 built-in template files have been totally revamped so that font size and color settings will not be rendered invisible by gmail, hotmail and possibly other Web Mail services, thanks to feedback from Diemux.

  • Manual editing of the 12 template files in the 'news_letter_panel/templates' folder, opens up the possibility for using your own templates that are very sophisticated and adaptable for producing very complex newsletters.

  • All templates are 600pixels in width.

8) CSS coding moved into the template files giving control of the body background color and/or image.
  • All templates use a background color for the body. All (a) tags have their own class to prevent interference with the themes css (a) tag settings.

9) Send newsletters to a single or multiple site users, single or multiple guest users or a site user group.
  • To send to multiple users hold down the Control (Ctrl) Key and click on each user name to send to.

10) Nice, simple side panel for site users and guests to Subscribe/Unsubscribe to your newsletters.
  • No surprises with the side panel. Very elegant and functional.


  INSTALLATION:
  • You must defuse/uninstall any previous newsletter infusion before proceeding, as directory naming has changed, plus this avoids possible variable conflicts.


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


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


  • Next Step:


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


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


  • That's it! You are done.



  DE-INSTALLATION:
  • Go to 'System Admin/Infusions' and Defuse News Letters v5.00 infusion.


  • Side-panel removal not required as the Defuse function removes it.


  • That's it! You are done.

  CORE FILE MODIFICATIONS:
  • File modifications: None.


Newsletter Edit Screen (click-fullsize)
Edit Screen

Newsletter Preview Screen (click-fullsize)
Preview Screen

Side-Panel (public view)
Side Panel

  CONFIGURATION & USAGE:
  • Using SMTP:

    • If you use an 'SMTP Host' for email it should work fine out-of-the-box under Fusion v7.02
      though I have not and cannot test it, as I don't use SMTP.


  • Using My Built-In Html Templates:

    • I have included twelve(12) html template files for your newsletters.
    • The files are stored in the 'news_letter_panel/templates' folder.
    • New template number four 'tmpl4' was added with this upgrade. Basically a 'gaming' template based on
      World of Warcraft.
    • Each of the 4 styles has 3 versions: 1, 2 and 3 columns for a total of 12 template possibilities.
    • To see the templates just load each one and click 'Preview Newsletter' at the bottom of the form.
    • Observe the comments in the editor and remove/change the 'text between comments', to your
      desired newsletter content.
    • If you save the loaded template/style without changing the 'Subject' to your newsletter title, then
      that loaded style will be updated with the same name with your changes. Not a good idea.
    • Once you have a newsletter compiled and ready to be sent, save it first if you want to keep it. Then
      just load it back in, set parameters and click 'Send Newsletter'.
    • Later you can load it back in and change the content plus the 'Subject', save and send it again for the
      next month etc. etc. etc.


  • Using Your Own Html Templates:

    • If you choose not to use my template files.
    • You will need to create your own html template(s).
    • Begin by studying my existing templates so you understand how they work.
    • Create the new images for your new template.
    • Include any needed css at the beginning of your template file.
    • Pay close attention to the format of my existing templates.
    • Your templates MUST be built the same way.
    • If you were to add another template file then the database table would have to be manually
      edited to add another row with the code that lives in the db for that template.
    • And also of course, you would have to create a new directory in the 'images folder' for storing
      your new template images: 'images/tmpl5/' and the new template file 'templates/tmpl5-1.php' etc.
    • A far easier way is to choose one of the existing templates that you may not like so well and
      simply edit to your liking and change the images etc. etc. etc.


  • Editing and Saving:

    • Load the template/style you are going to use for your newsletter.
    • Change the Subject(now the template/style name), to your Newsletter Title.
    • Add your newsletter content between the 'comments' statements.
    • Saving it without changing the 'Subject' will simply update that loaded style with your changes.
    • Load back in your saved newsletter, select the sending parameters and attachments if any.
    • Click the 'Send Newsletter' button and SHAZAM!!- your newsletter is on its way.
  CHANGELOG:
  • Version5.00 Release - October 12, 2013:

    • Major version change to 5.00
    • Input field added in form called 'Newsletter Heading Text'.
    • Sent newsletters are now archived in pure html page form for static viewing.
    • Navigation Links added: Newsletter Archive and Subscriptions
    • Scripts added: news_letter_archive.php, news_letter_archive_admin.php


  • Version4.04 Update - September 15, 2013:

    • Streamlined template selection coding in 'news_letter_admin.php'
    • New file added in the include folder, 'styles_include.php'
    • Polish.php and Polish-utf8.php locale files added.
    • Provided by Bogdan: lajkonik44@gmail.com


  • Version4.04 Update - September 03, 2013:

    • Upgraded version to 4.04
    • Code added and modified from Muscapauls OpenNewsletter system.
    • Site visitors and guests may now Subscribe/Unsubscribe to your sites newsletters.
    • New template number six 'tmpl6' was added with this upgrade. Basically a 'gaming'
      template based on World of Warcraft.


  • Version4.03 Update - April 25, 2013:

    • Upgraded version to 4.03
    • Multiple attachment sending of virtually any filetype native format, has been achieved
      without zip compression needed.


  • Version4.02 Update - April 12, 2013:

    • All features updated to be compatible with PHP-Fusion ver7.02.xx
    • Added multiple attachment sending (only compressed files at this time).
    • Re-instated the upload script(updated) and the attach folder.
    • Newsletters v4.02 retains compatibility with PHP-Fusion ver7.01.xx


  • Version4.01 Update - 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 Update - 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 Update - 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 Update - 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 Update - 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 subscribe/unsubscribe side-panel.
    • Changed and enhanced the visual layout for a more intuitive and visually appealing design.


 

  TODO LIST:
  • Future upgrades: As time and resources permit.

    • To allow for 'inline image' attachments.

 

  MISCELLANEOUS:
  • 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 archive immediately !


 

  ACKNOWLEDGMENTS/CREDITS:
  • The Following People & Scripts Have Contributed To The Successful Creation of My Newsletters Infusion:

    1. Bogdan
    2. Nick Jones (Digitanium)
    3. Ole Geismar (Xyos)
      • Update PHP-Fusion v6.01.xx - (v1.60)

    4. Mark "Tarquin" Wilton-Jones
    5. Paul Beuk (muscapaul)
      • http://www.muscapaul.com/Muscapaul
      • Open Newsletters version 2.00 | Original author: Koller József (Orosznyet)
      • Update PHP-Fusion v7.xx - (v2.02) Newsletters
      • Update PHP-Fusion v7.xx - (v2.01) Newsletters
      • Update PHP-Fusion v7.xx - (v2.00) Newsletters

    6. (Wooya)
    7. Darrell (Dallas)
      • http://dtawebdesigns.com/DTA Web Designs
      • My Newsletters - (v3.02) Testing, Coding Help & Suggestions
      • My Newsletters - (v3.01) Testing, Coding Help & Suggestions
      • My Newsletters - (v3.00) Testing, Coding Help & Suggestions




 

E-Mail:    webmaster@whisperwillow.com
Website: www.whisperwillow.com/news
Support: www.whisperwillow.com/forums
PHP-Fusion v7.01.xx
PHP-Fusion v7.02.xx
Newsletter Panel ver5.00
Whisperwillow.Com - Mods, Infusions, Themes Support