Moresuitable installation is extremely easy. Just follow these simple steps.
For cron (scheduled) version see cron version Manual.
- Download the Moresuitable package:
- Moresuitable.exe -- as selfextracting archive for Microsoft users, or
- Moresuitable.zip -- for UNIX users;
- Edit the script's file.
- Open up the downloaded package.
- Open up '
moresuitable.cgi' with NOTEPAD (or any other text editor) and change the first line to the correct path to Perl on your server.
If you are not sure what is the path, take a look at your webhosting provider's FAQ. Probably it would be '/usr/bin/perl' or '/usr/local/bin/perl'. - Choose the desirable news category from the News Category List (also contained in the package). Cut-n-paste your category's URL to the line 19.
- Set the number of news headlines you want to embed at the line 23 (must be between 1 and 20). The default is 5.
- Edit your target HTML file. (where you want news to appear)
- Open it with your text editor and put this string to the
place where news should appear:Change '
../cgi-bin/' to appropriate relative path to 'moresuitable.cgi' from you HTML file. - Most web servers require '
.shtml' extension for your HTML file to execute SSI. So you may need to save it with such one (e.g. 'news.shtml'). Check your webhosting help or FAQ page to figure out what extension is acceptable for SSI. - If your server doesn't handle SSI, just edit the template file '
news_SSI_html.tpl' to make it suitable to the layout of your site. Then you can put a link to 'moresuitable.cgi' as your regular HTML file. In that case you may want to give it another name.
- Open it with your text editor and put this string to the
place where news should appear:Change '
- Edit the template file.
- Open up '
news_SSI_html.tpl' with your text editor. - Note a few uncommon elements:
- Special comment tags:
<!-- %%Repeating_part_begin%% -->
and<!-- %%Repeating_part_end%% -->
Please don't edit these two tags. The script will look for them in you template to find the code for your news lines, which is between the tags. - Special characters in the news lines code. The script will put the real data instead of
the following pieces of code:
%%Article_URL%%-- Article URL, including the unique Moreover article ID number;
%%Headline%%-- Headline text itself;
%%Source_URL%%-- the front page URL of the source;
%%Source%%-- the name of the online publication the article is from;
%%Reg_URL%%-- the URL for registration/subscription if needed;
%%Access_status%%-- possible values: 'reg' - registration needed, 'sub' - subscription needed, blank - neither;
%%Extraction_time%%-- the time the article was added to Moreover database.
You may skip any field that you don't want to appear in your news.
- Special comment tags:
- Change the template to suit your website's look and feel. Please don't remove the links to morover.com (which provides the newsfeeds) and moresuitable.com. This is the condition of free licence.
- Open up '
- Upload the files to your server:
- upload your new edited HTML file (your news page). Sometimes it must have
'
.shtml' extension to execute SSI; - upload '
moresuitable.cgi' and 'news_SSI_html.tpl' in ASCII mode, NOT binary to your 'cgi-bin/' or other directory enable to run CGI scripts; - upload '
lib' dir from the package to the same dir as 'moresuitable.cgi' - chmod '
moresuitable.cgi' to 755;
'news_SSI_html.tpl' to 777 and
'lib' dir to 777;
- upload your new edited HTML file (your news page). Sometimes it must have
'
Good luck!