Please, take time to read this file attentively, it contains useful information.
|
I. Required configuration |
This script requires PHP4 as well as a data base MySQL or SQL Server Microsoft.
Certain secondary features can not be available according to the configuration of your server and the installed bookshops.
Example: the module of statistics asks that the GD bookshop is installed.
|
II. Install : Fast explanations |
- Upload files contained in the archives on your ftp (please, respect well the structure of directories)
- Please, give right in writing on files admin/upload/, stats/ and includes/ via your favorite customer ftp
- Please, produce you at the address where is the install.php file (eg: http://www.yourdomain.com/newsletter/setup/install.php if the script is installed in the newsletter/ folder in the root of the site)
- On the first page, please, choose "installation", then fill the form which displays and click the validation button
- Once the script was installed, please, remove the rights in writing on the includes/ folder
- To finish, please, delete the setup/ folder of your ftp to avoid a reinstalment
|
III. Install : Detailed explanations |
To install correctly WAnewsletter, you should begin by upload the files of the script on your ftp.
All the files should be upload in ASCII mode, except some images used by the script which are in the images/ folder. The images should be upload in binary mode.
Always in your favorite ftp customer, please, give right in writing on admin/upload/, stats/ and includes/ folders.
Explanations :
The upload/ folder will contain the different files which you will join possibly to your sendings. So that the script can add correctly
these files in the upload/ folder, that this should be accessible in writing.
The stats/ folder will contain files necessary for the statistics module. This file is useless if the GD bookshop is not available on your server.
During the installation, the script create the configuration file and places it in the includes/ folder. This folder thus owes also accessible in writing, but only the time of the installation! Once that this was ended, please, remove the rights in writing on this folder.
Once files in place on the server and the rights in writing were attributed, please, produce you at the address where is the install.php file.
Exemple :
You have upload the script in the root of your site, in a named newsletter folder. You should thus type in your address bar : http://www.votredomaine.com/newsletter/setup/install.php
Once on the page, please, choose the type of installation, in our case, "install".
Please, note that if you change language before clicking the validation button, you will fall again on the same page, but in the chosen language.
You arrive now on the install form.
The name of the data base server, most of the time, is localhost but it can be other thing. If you have no knowledge of the name of your data base and\or the necessary access parameters, inform you with your host. (Note: the access password is not necessary for the validation of the form; practice for the local tests)
A prefixe for tables is also asked to you to avoid possible conflicts with other tables already present, and which would have the same name as one of WAnewsletter's tables.
You should then enter parameters for the administration of the script, it's access being protected. You can later add the other users with rights of personalized access.
The address of sending is then asked to you. It is the address email which will be use as sender of emails sent to the subscribers.
The url of the site corresponds to the url of your site, eg: http://www.votredomaine.com
The url of the script corresponds to the road towards the folder of the script, from the root of the site. eg: / newsletter/ (mattering: please, indeed note that the road begins and ends by a slashe (/) )
When the script is installed, please, remove well the rights in writing on the includes/ folder and delete the setup/ folder of your ftp.
|
IV. Update of a version 1.1
|
Please, begin by making a backup of the tables of your newsletter. (One never knows)
Replace all the files of the version 1.1 by those of this version.
You can replace the config.inc.php file of the version 1.1 in the includes/ folder of the new version
but it' not necessary.
Give right in writing on admin/upload, stats/ and includes/ folders then produce you on the install page.
Please, choose " update of a version 1.1" and validate. Please, fill the form which follows and validate.
Once the update was realized, please, remove the rights in writing on the includes/ folder and delete the folder
setup/ from your ftp server.
An update since the version 1.0 was not foreseen (that this having had an existence of some weeks only).
If however you find you in that case, tempt an update of the version 1.0 to the version 1.1 then the second update of the version 1.1 towards a version 2.x .
|
V. Update of a version 2.x
|
The stats/ folder should be accessible in writing if it is not yet the case.
To make an update from a version 2.x, only your login and administrator's password will be asked you.
Please, watch to replace all the files of your older version by those of the new one.
Please, keep only the config.inc.php file which you should put back in the includes/ folder.
Type the install.php file and please, choose " Update of a version 2.x ".
If you update a 2.0.0 version or previous, give right in writing on the includes/ folder the time of the update.
|
VI. History of the versions
|
Version 2.1.4
- Bug fix : Les administrateurs n'ayant pas les droits pour voir une liste ne reçevaient pas les notifications d'inscription
- Bug fix : Erreur dans le fichier de language lang.php (français), il y a deux index confirm_ok dans le tableau $lang
- Security fix : Faille de sécurité dans le fichier newsletter.php ($waroot) :/
- Bug fix : L'option pour être prévenu d'une nouvelle version ne fonctionnait plus
- Bug fix : Problème dans la classe d'envoi d'emails qui pouvait empecher les envois de démarrer
- Bug fix : Redéfinition de constantes dans iframe.php
- Bug fix : Variable de language erronée dans view.php
Version 2.1.3
- Bug fix : Joined files broken if list is multi-format and sending by bcc
- Bug fix : SQL error if registration was been reconfirmed
Version 2.1.2
- Add function Location() for absolute redirect header (cf spec HTTP /1.1)
- Bug fix : Some problems with extra.php, no display
- Bug fix : Select list not close in admin.php
- Bug fix : Use of $_POST instead of $HTTP_POST_VARS in admin_auth.php (problems with php < 4.1.0)
- Bug fix : Sort by email don't work in subscribers list
- Bug fix : parse error line 1 in config.php on some servers (Because php files wasn't not in unix format but not sure)
- Bug fix : Bad number version of script in database after an installation with 2.1.1
- Bug fix : php errors in stats.php when no subscribers in database (warning mktime() et date() )
- Bug fix : SQL errors when import list of emails contains simple quotes
- Bug fix : If all list wasn't deleted, No access to admin was possible
- Bug fix : INSERT effectué même si le masque est vide dans la section "emails bannis"
- Bug fix : Offset error in stats.php, Subscribing on month no displays
Version 2.1.1
- Bug fix : Charset not specified in lang.php
- Bug fix : incorrect translate date in admin
- Security hole fixed in newsletter.php ($waroot)
- Lost connection to MySQL server after sending emails
Version 2.1.0
- Bug fix : "undefined properties altmessage..." on Nexen
- Bug fix : Emails in a block (without carriage return) under certain environments software
- Bug fix : Ended sending but the script suggested continuing if there was a subscriber who had not confirmed his registration in list
- Bug fix : SQL error if sending to multi-format list
- Bug fix : "Warning undefined variable datalang... " on information or error message in admin
- Bug fix : Potential bug if cookie named "lang", "datetime" or "datalang" present on the client machine
- Bug fix : Potential bug if sending to multi-format list in several streams
- Bug fix : Incorrect generated pagination with more thousand page
- Bug fix : Potential bug with search keyword incorrectly inserted in pagination
- Bug fix : Emails not sent on Online
- Bug fix : Emails received in double during the sending of a newsletter with the smtp system
- Bug fix : Codes subscribers not present in the link of unsuscribe during a sending to a multi-format list
- Management of date formatte
Version 2.1 Beta2
- Bug fix: email of return of error not taken into account during the sending
- Bug fix : Functions of active statistics even if the GD bookshop is not installed on the server
- Bug fix : Link of unsubscribe twice in the sendings on text
- Bug fix : SQL error during the sending in a list containing no subscriber
- Bug fix : Error "cannot redeclare function email() ..." under Nexen
- Bug fix : Newsletter protected even if the subject is empty
- Bug fix : Error "undefined offset" if the extension of a file closes is not listed in mailer.php
- Bug fix : Infinite buckle in envoi.php, result: the subscribers received thousands of emails
- Management of the games of characters (charset) according to the chosen language
- Faq for the most general questions (faq_eng.html, available in the docs/ folder)
- Other different corrections in the code
Version 2.1 Beta
- More aesthetic administration
- Generator of simplified form
- Possibility of using the suscribe.php file instead of generating a form, in in which case, all the lists appear in a unrolling list
- Advanced system of permissions, by list and\or made action
- Confirmation of deletion for the subscribers and the logs
- Option of email sent to an admin during a new registration personalized in every list
- System of banishment of emails or types of email
- System of purge of the table of the subscribers (registration unconfirmed). Possibility of an authomatic purges
- Simplified module of import. Management of upload of the files compressed in the gzip format
- Module of export of addresses emails. Possibility of downloading a file " gziped " if the server allows it
- Module of statistics. Registrations a day according to month and given year or graphic display of the number of subscribers according to lists
- Downloading of the file of configuration at the end of the installation if he was not able to be created on the server
- Management of the returns of error (unknown email, etc.)
- Two engines of sending :
A sending with the addressees in hidden copy, or a typical sending: a subscriber = an email
- Work on Online (with the second engine of sending)
- Possibility of resumption of a sending and a management by the administrator of the number of sending made in a stream
Version 2.0.2
- Bug fix : Not sent email if the admin wants to be warned of a new registration
- Bug fix : Section configuration, the script did not take into account certain changes
- Bug fix : Error message during the registration under certain environments (Warning: Call-time pass-by-reference has been deprecated ...)
- Bug fix : Error when a person confirms its registration (its registration was well confirmed but there was always an error message)
- Bug fix : The registered which had not confirmed their registration received all the same the newsletter
- Bug fix : Incorrect $waroot variable in version.php
- Session table in the fixed format and of type HEAP for MySQL
- Support for SQL data bases server (no test was able to be realized, this support is thus experimental and any return will be welcome!)
- Simplified script of installation, notably for the updates from versions 2.x
Version 2.0.1
- Bug fix : Unrolling list ineffective "to see list of distribution" to modify the format
- Bug fix : Host not taken into account for the sending of mails
- Bug fix : Joined files damaged under Windows
- Bug fix : Links broken in the emails of registration and confirmation
- Bug fix : Error set_to () during the sending in a list in the double format and nobody registers in one of both formats
- Preparation for the support of the other data bases (sql/ folder)
- Management of headers (header ("Refresh: 0; URL = ")) under the Microsoft servers and xitami
Version 2.0.0
- Bug fix : Posting in the administration correct version
- Bug fix : No inclusion of the file mailer.php when there was no confirmation, in newsletter.php
- Bug fix : Spaces too at the head of emails
Version 2.0 Beta
The script was totally rewritten.
- Management of several lists of distribution
- Posting of the number of registered on a list on a page of the site
- Choice of the format for every list
- Form of registration integrated into the site or affichable by a popup
- Confirmation of registration by email (possibility of activating/deactivating this option) for every list
- Possibility of being warned by email of every new registration
- Work on Nexen
- If your host does not arrange function mail() or other, possibility of direct access to a smtp server
- Multi-administration with several levels of accés
- Possibility of saving a newsletter in the course of editorial staff to resume her it later
- Sending of newsletter with attached file(s)
- Connection to the administration via a system of session (cookies are not compulsory any more)
- Utility of mass import
- Small module of search for subscribers in the table of the subscribers
Version 1.1
- Bug fix : Defective posting during the installation
- Bug fix : Defective posting in the section " bug report" (no no, it's not a joke!)
- Possibility of choosing the type of form registration showing
- Possibility of choosing the types of format email authorized (text and\or html)
- Use of a system of templates
- Use of a table in the data base for the configuration of the newsletter
- Possibility of placing itself the links of désinscription and\or of change of size(format) in its newsletter
Version 1.0
|
VII. Hosts putting problem |
Important ! This script does not work on Free hosting, useless to try!
On multimania/lycos, the sendings emails (in number of addressees) are limited to 150 a day.
|
VIII. Author's notes |
This script is freely distributed under license GPL.
Concretely, it means that you can use it or modify it as check seems to you, since
copyright and author's mentions stay as they are. Please, read attentively the license GPL for more details.
This script contains no advertisement (mentions at the bottom of emails or other one). But you can, if you wish it and are satisfied with this script, to put a link towards the site
Phpcodeur somewhere on your site (at the bottom of the form of registration for example) but it is not absolutely compulsory.
|
|