FM EasyList >> Documentation

EasyList Documentation

1.1 Requirements to run EasyList
1.2.1 Installation instructions
1.2.2 How to upgrade EasyList
1.3 Using EasyList


1.1 Requirements

The requirements are those that most CGI scripts in general will require. What is required to run EasyList?

  • Your own standard cgi-bin directory.
    This is the directory where the cgi scripts are executed from. An example of a standard cgi-bin directory:
    http://www.yourdomain.com/cgi-bin     

  • Perl Ver 5+    

  • FTP access to transfer files and to set permissions of files and directories.    

  • Linux/Unix based host/server  

If you are new to CGI Scripts or don't know what it is, click here to find out!


1.2.1 Installation Instructions

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.


movie.gif (975 bytes) Watch Video on how to do Step 2 using CuteFTP FTP client.

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.

.


movie.gif (975 bytes) Watch Video on how to do Step 3 using CuteFTP FTP client.

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


movie.gif (975 bytes) Watch Video on how to do Step 4 using CuteFTP FTP client.

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.


movie.gif (975 bytes) Watch Video on how to do Step 5 using CuteFTP FTP client.

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.


movie.gif (975 bytes) Watch Video on how to do Step 6 using CuteFTP FTP client.

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/


movie.gif (975 bytes) Watch Video on how to do Step 7 using CuteFTP FTP client.

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.


movie.gif (975 bytes) Watch Video on how to do Step 8 using CuteFTP FTP client.

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.


movie.gif (975 bytes) Watch Video on how to do Step 9 using CuteFTP FTP client.

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  


1.2.2 How to Upgrade EasyList

Upgrading your copy of FM EasyList should be painless. Follow the instructions as you read through them below. Upgrading basically involves replacing all old .cgi and .pm files with the new .cgi and .pm files that comes with the new version.

If your copy of FM EasyList is registered then it will stay registered if you upgraded it with the shareware version.

Step 1. (Extract the .zip archive)

Download the shareware version of FM EasyList and extract the files with their directories that came in the .zip installation archive archive.

Step 2. (Replace all .cgi and .pm files)

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 How to Use EasyList

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.

Site Map | PowerSeek | Turbo Seek | HTML Rotate | Quick Polls | FM SiteSearch Pro | Download Monitor | SiteNet BBS | More...
Products | Support Desk | Affiliate Program | Web Hosting | FocalMedia.Net Featured On | Contact us