Newsletters v2.04
Author: Nick Jones (Digitanium)  2002-2008
web: http://www.php-fusion.co.uk
email: nick@php-fusion.co.uk
Update PHP-Fusion v6.01.XX: Ole Geismar (Xyos)
Update PHP-Fusion v7.XX: Paul Beuk (muscapaul)
web: http://www.muscapaul.com
email: muscapaul@gmail.com
released: 04 March 2009
-------------------------------------------
Released under the Affero GPL license. You can
redistribute it and/or modify it under the terms of
this license which you can read by viewing the
included agpl.txt or online at
www.gnu.org/licenses/agpl.html. Removal of this
copyright header is strictly prohibited without
written permission from the original author(s).
-------------------------------------------

FEATURES
--------
A system that will alow you to write newsletters, store them and send them. Newsletters can be sent in plain text or HTML formats.
Members can add themselves to the subscribers list by clicking a link in the Newsletter Subscription Panel and can remove themselves in a similar fashion.


INSTALLATION
------------
1. Upload the 'newsletter_panel' folder to the infusions folder on your server.
2. Go to Admin Panel -> System Admin -> Infusions and infuse the Newsletters infusion.
3. Go to Admin Panel -> System Admin -> Panels and add a new panel. Give it an appropriate name (e.g., Newsletters) and select newsletter_panel.php from the Panel Filename drop-down menu. This panel must be installed as a side panel. Set Panel Access to Members and save the panel.
4. Go back to panel management and enable the panel.


UPGRADING FROM PHP-FUSION v6 TO PHP-FUSION v7
---------------------------------------------
Please note, if you want to upgrade your Newsletter Infusion during a PHP-Fusion version upgrade from v6 to v7, there is no need to defuse the infusion. There will be no error messages as long as you upload the infusion files at the same time as the PHP-Fusion files. When you upload the infusion files, you can simply overwrite the existing ones.
PHP-Fusion v7 utilises a somewhat different system for administering admin rights for Infusions. In v6 it used to be a single setting that gave rights to all Infusions. Under the new version every infusion will be given its own code for admin rights. As a result it is necessary to run an upgrade script (../infusions/newsletter_panel/v6-7upgrade.php) that will at least add the rights for the primary Superadministrator. The file has checkboxes to indicate whether all superadmins should be given access rights to the Newsletter Infusion and/or whether all admins with Infusion Administration rights should be given those rights.
This script only needs to be run if a site is upgraded from PHP-Fusion v6 to v7. Even though a check has been built in to prevent the script from being run after the upgrade has already been performed, it is advised to delete the script from your server after upgrading.


NOTES
-----
* The newsletter sends a copy of the sent newsletter to the email address specified in Site Settings. This address will also be used for bouncing email notification.
* Subscribers will recieve their newsletter via bcc (blind carbon copy) so their email address will not be visible to other recipients.
* You can view the members on the list with subscribers by clicking 'Newsletter Subscription Management' from the Newsletters admin panel.
* The system is 'self-cleaning' for removed users. Upon sending a Newsletter, the list of subscribers is compared with the members list and subscribers who have been removed from the members list will also be removed from the list of subscribers.
* Please note that mail is being sent using an SMTP server. If this server is not enable by default (sendmail disbaled; which can be the case with some hosts, especiallly free ones), you'll need to specify your SMTP server under Admin Panel -> System Settings -> Miscellaneous Settings. Also note that this server may refuse requests if they are sent from a different domain than where the server is running itself.

CHANGELOG
---------
v2.04 (muscapaul)
* Subscription panel updated to allow it to be seen by Guests, too. They will get the notice that the Newsletter is for Members only.

v2.03 (muscapaul)
* Newsletters in html format will now be displayed properly when previewed.
* Fixed inserted link for image in newsletter ('fusion_' removed).
* Error fixed: Upgrade script was faulty for updating the admin rights in the admin table. If you experience any problems related to admin rights, please run the code as given in the forum on http://www.muscapaul.com/forum/viewthread.php?thread_id=38.
* Some file headers updated.

v2.02 (muscapaul)
* Some redundant lines removed from v6-7upgrade.php.
* Minor bug fixed: cause of occasional error message upon sending newsletter removed.
* Unclosed input element in ../newsletter_panel.php closed.
* AGPL statement added to readme file.

v2.01 (muscapaul)
* Some stupid errors removed from infusion.php (thx to SiteMaster).

v2.00 (muscapaul)
* Code completely updated for compatibility with PHP-Fusion v7.
* Added code to clean the list of subscribers from deleted members before a newsletter is sent.
* Some improvements to Newsletter Subscription Management

v1.60 (Yxos)
* Addition of code to view deleted members under Newsletter Subscription Management and the possibility to delete them.