Please take time to read this file carefully, it contains important information.
WAnewsletter requires PHP version 4.1.0 and up, as well as either MySQL or PostgreSQL database managers.
Some optional features might not be available depending on your server's configuration and installed PHP libraries. By 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 includes/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 writing permissions on the folder and on includes/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 setup/install.php file is placed.
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 table's 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. 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 includes/config.inc.php file, and any content located in the upload/ and stats/ folders). Point your web browser to the setup/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 includes/config.inc.php file, and any content located in the upload/ and stats/ folders). It is strongly 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 setup/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.
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.