WAnewsletter requires PHP
version 4.1.0 and up, as well as either MySQL, Microsoft SQL Server or PostgreSQL database managers.
Certain optional features might not be available depending on your server's configuration and
installed libraries.
Example : the statistics module requires that the GD library is installed.
WAnewsletter contains a very simple installation script, so that neophytes
can quickly use the script.
To correctly install WAnewsletter, you first have to upload all of the script's files to your server
or FTP account.
All files should be uploaded in ASCII mode, except for graphics used by the script which are located
in the images/ and templates/images/ folders. These graphics should be uploaded in binary mode.
With your favorite ftp client, set writing permissions on the upload/, tmp/, stats/ and includes/
directories and on config.inc.php file which is into includes/ directory.
Explanations :
The upload/ folder will contain the files which you might attach to your outgoing messages. In order
for the script to correctly put these files in the upload/ folder, it has to have writing permissions.
The script offers the option of having attached files located on a remote ftp server. In this case,
you can remove the upload/ folder.
About the tmp/ folder, please read the corresponding section the script's FAQ.
The stats/ folder will hold the files used by the statistics module. This folder is useless if the
GD library is not available on your server or hosting account.
During the installation, the script creates a configuration file and puts it in the includes/ folder.
This folder must also have writing permissions, but only during the installation phase! Once the
installation has completed, remove wirting permissions on the folder and on config.inc.php file.
Once all files are on the server, and proper writing permissions are set, using your favorite browser,
go to the location where this install.php file is placed.
Example :
You have uploaded the script at your site's root, in a folder named "newsletter". You should
then type "http://www.yourdomain.com/newsletter/setup/install.php" in your web browser's
address bar.
You have now reached the installation form.
Please take note that if you change the language item before clicking the validation button, the same
page will reload, but this time in the chosen language.
Most of the time, the database server's name will be "localhost", but it could be different. If
you do not know your database server's name and/or the necessary access parameters, contact your
hosting service. (Note: the access password is not necessay for the form validation
phase, convenient for local tests).
A tables' prefix is also asked, in order to avoid possible conflicts with other already existing tables
that might have the same name as one of WAnewsletter's tables.
You should the enter parameters for the administration of the script, since its access is protected.
You can later add other users with personnalized access rights.
The site's url corresponds to your site's address, eg : http://www.yourdomain.com
The script's url corresponds to the path to the script's folder, relative to your site's root,
eg : /newsletter/ (Important: please note that the path's name must start and end with a slash (/) )
Once the script is installed, remove writing permissions ont the includes/ folder et remove the
setup/ folder from your host.
To update from version 2.2.x, download the new version and replace files from the old version with
those from the new one (keep the config.inc.php file, and any content located in the upload/ and
stats/ folders).
Point your web browser to the install.php file in its proper location and open it.
Fill in your administrator username and password and let the script finish the installation.
Once the installation is done, remove the setup/ folder.
To update from version 2.0.x or 2.1.x, download the new version and replace files from the old version
with those from the new one (keep the config.inc.php file, and any content located in the upload/ and
stats/ folders).
It is stongly advisable to make a backup of your script's database tables before proceeding with the
update !
Set writing permissions to the includes/ folder for the time you proceed with the update.
Point your web browser to the update.php file in its proper location and open it.
Fill in your administrator username and password and let the script finish the update procedure.
Once the update procedure is done remove the setup/ folder, and remove the writing permissions
from the includes/ folder.
There is no update script from version 1.1 supplied with versions 2.2.x and up.
The only way to work around this problem is to first update from version 1.1 to version 2.1.x, and
then from 2.1.x to 2.2.x.
On Free.fr hosting, outgoing emails are limited of 1000 by week.
On multimania/lycos, outgoing emails (in number of recipients) are limited of 150 a day.
If safe mode is activated on your server, the script needs a few minor adjustments.
Please refer to the script's FAQ
This script is freely distributed under the GPL license
This means you can use it or modify it as you like, as long as the copyright
and author's mention stay as they are. Please, carefully read the
GPL license for more details.
This script does not contain any type of publicity (like mentions at the bottom of emails or
elsewhere). However, you can, if you wish and are satisfied with this script, put a link to the
phpcodeur web site anywhere on your site (at the bottom of the registration form for instance).
A 88x31 WAnewsletter button is also available in the images/ folder for those who wish to use it..