The requirements are those that most CGI scripts in general will require. What is required to run EasyList?
The installation of EasyList should be painless. Every measure has been taken to ensure that you get it right the first time. You don't have to edit any files, and only need to supply information via a setup interface.
Follow the steps below exactly as described and you should have EasyList serving you in a couple of minutes. Do the steps as you read through them. The setup instructions looks lengthy but it could actually have been explained in a couple of short lines. The reason for it being a lot of text, is that we are trying to cover all possible situations when doing the setup.
Step 1. (Extract the .zip archive)
Extract the files with their directories that came in the .zip archive.
Step 2. (Create a directory called 'html')
Create a directory called 'html' or anything else you would like to call it. This directory should be created inside your public html directory. It will hold images (.gif files) that will be used inside the EasyList Control Panel.
Step 3. (Transfer image files to the 'html' directory)
The installation .zip archive will contain directories inside it. These directories are 'cgi', 'data' and 'html'
Now transfer the files with directories inside the 'html' directory of the .zip archive to the 'html' directory you have created in step 2.
.
Step 4. (Create a directory called 'data')
Create a directory called 'data' or anything else you would like to call it. This directory should be in a place where you cannot load the contents of it inside a web browser.
A good place to place this directory would be for example:
/home/yourdomain.com/data
where your cgi-bin directory will reside in something like
/home/yourdomain.com/www/cgi-bin
and your public HTML directory in something like
/home/yourdomain.com/www
Step 5. (Transfer data files to the 'data' directory)
The installation .zip archive will contain directories inside it. These directories are 'cgi', 'data' and 'html'
Now transfer the files inside the 'data' directory of the .zip archive to the 'data' directory you have created in step 4.
Step 6. (Set permissions of the 'data' directory and files within it)
Assign the permissions of 777 to the 'data' directory and all the files residing in it. If you don't know how to set permissions then click here to find out.
Step 7. (Transfer files to your 'cgi-bin' directory)
The .zip archive will contain directories inside it. These directories are 'cgi', 'data', and 'html'
Transfer the files in the 'cgi' directory of the .zip installation archive to your 'cgi-bin' directory. You could place the files in for example: http://www.yourdomain.com/cgi-bin/easylist/
Step 8. (Set permissions of the script files inside the 'cgi-bin' directory)
Set the permissions of the .cgi and .pm files to the permission setting of 755. If you don't know how to set permissions then click here to find out.
Step 9. (Set config.cgi to the permission setting of 777)
Assign the permission setting of 777 to config.cgi - config.cgi is one of the files that you copied/transfered into your cgi-bin directory in step 4.
Step 10. (The setup interface)
Load setup.cgi in your browser and follow the instructions from there. setup.cgi is in your 'cgi-bin' directory where you have copied the .cgi and .pm files as explained in step 4.
It should be located at, for example:
http://www.yourdomain.com/cgi-bin/easylist/setup.cgi
The .zip installation archive will contain directories inside it. These directories are 'cgi', 'data' and 'html'
Copy the files in the 'cgi' directory to your 'cgi-bin' directory replacing the old .cgi and .pm files of FM EasyList. Don't replace your config.cgi with the one that comes with the new version.
IMPORTANT CAUTIONARY NOTE: Do not replace the config.cgi of your FM EasyList installation. This file will be located amongst the .cgi and .pm files inside your cgi-bin directory where the .cgi and .pm files of FM SiteSearch Pro resides.
1.3.1 How to place the Mailing List subscription box on your web site.
To start collecting email addresses for your mailing list, go to the EasyList Control Panel and click the 'Get HTML Code' tab. You will be presented with a box containing HTML code. Copy and Paste the HTML code you get from the box into the web pages of your web site. You will probably also want to customize the mailinglist-subscription-box (look and feel) - You should be able to do this with your web editor.
1.3.2 How to customize user responses (templates)
Templates are being used to indicate responses to visitors when they subscribe or unsubscribe from your mailing list. To edit the templates, click the 'Templates' tab in the Control Panel. Then click the 'HTML' or 'WYSIWYG' buttons.
The templates can also be edited by clicking the 'HTML' button and then by copying and pasting the HTML code directly into your web editor. Once you have changed the template contents, you may copy and paste it back into the edit box and save it. When editing with your web editor you must use a URL link to indicate image locations. For example:
<img src="someimage.gif"> will not work. You have to indicate the entire URL where someimage.gif is located. For example:
<img src="http://www.yourdomain.com/someimage.gif">
1.3.2 How to customize default Email messages (Email responders)
Two Email Messages will normally be sent to visitors when they subscribe to the mailing list. These email messages can be customized when you click the 'Templates' tab in the Control Panel.
Confirmation Email
This email message is sent to a potential subscriber (visitor that chose to subscribe to the mailing list). This email asks the potential subscriber to click a link to confirm his/her subscription. Once the potential subscriber has clicked the link, he/she will be subscribed to the mailing list. The confirmation process has been implemented with EasyList so that the person trying to subscribe to the mailing list must confirm that it is indeed he/she that requested to subscribe to the mailing list.
Welcome Email
This email is sent to a subscriber welcoming him/her to the mailing list. It is sent after the subscriber confirmed his/her email address by clicking the link inside the confirmation email.
1.3.3 How to manage Email Addresses
You can easilly export or insert any email addresses to your mailing list by clicking the 'Manage Email Addresses' tab.
1.3.4 Sending Email
You can compose email and send the email to your subscribers by clicking the 'Send Email' tab inside the Control Panel.
