corner1.gif (159 bytes) corner2.gif (159 bytes)

TurboSeek » TurboSeek Documentation >> 8. Plug-In's

Turbo Seek Documentation


1. Installation
2. Settings and Options (After installation)
3. The Directory Manager
4. How templates & their variables work
5. Building a Search Index
6. Running your directory
7. Tips, Tricks & Notes
8. Plug-In's

<< Previous Page
Tips, Tricks & Notes



8. Plug-In's

8.1 How to use the banner manager
       8.1.1 Introduction
       8.1.2 How it works (Short Description)
       8.1.3 How to rotate banners in your directory/category listings using the default 'directory HTML template'.
       8.1.4 How to rotate banners in your directory/category by using custom templates.
       8.1.5 How to target banners at content
       8.1.6 Displaying banners with search results
       8.1.7 Rotating banners on normal web pages
8.2 Spam/Keyword filter
       8.2.1 How to add a new keyword filter
8.3 Submissions mailing list management


8.1 How to use the banner manager

8.1.1 Introduction

The banner manager is a banner rotation system that comes with Turbo Seek. This banner system has not only been created to rotate banners but also enables you to target banners at the contents of your directories/categories.

This section of the Turbo Seek documentation assumes that you have already added directories/categories and listings to your search engine. If you are not familiar with the template system in use, it might be a good idea to customize your search engine according to the look and feel you have in mind, and then come back to this section to implement banner rotations.

See 'How templates & their variables work' for complete documentation on how you can customize the look and feel of your directory by using your own HTML and graphics.

8.1.2 How it works (Short Description)

You can rotate banners in your directories/categories by defining/creating banner slots in the directory/category template(s). Groups of banners can be assigned to these banner slots from the 'Directory Manager' on specific categories/directories. You create groups of banners in the 'Banner Manager'.

To make use of banner rotation when end users do searches, you can make use of banner HTML code in the 'search HTML template Plug-in'.

8.1.3 How to rotate banners in your directory/category listings using the default 'directory HTML template'.

The instructions below assumes that you are using the default directory HTML template in your directories/categories. There is more information about custom HTML templates and banners later in this section of the documentation.

To rotate banners in your directory/category listings you can do the following.

Step 1
Go to the template manager and click on 'Default Directory Template 'Plug-In'.

Step 2
Open defdir.html with your web editor or copy and paste the HTML code into your web editor from the 'template manager'.

Step 3
Lets say you have 4 locations in this HTML template where you want to place banners. These 4 locations should each rotate banners. Place the word/variable %%bannerslot1%% in the location where you want the first banner rotated.

Place the word/variable %%bannerslot2%% in the location where you want the second banner rotated.

Place the word/variable %%bannerslot3%% in the location where you want the third banner rotated.

Do the same with the fourth banner you want rotated.
Step 4
Now you have defined banner slots. You may define up to 5 banner slots in a template or the 'default HTML template plug in'. Save defdir.html or copy and paste the HTML code from your web editor into the 'template manager' and click the save button.

Step 5
Click the 'Settings & Options' button and then click 'Banner Manager' to go to the banner manager.

Step 6
In the banner manager you can add groups of banners. Each group can contain banners that are to be rotated. Create a group by filling in a name in the 'group name' box and by clicking the 'add new banner group' button.

Step 7
Click on the group name you have just created to add banners to this group.

Step 8
Add all the banners that you would like to be rotated for this group.

Step 9
Now you should have defined banner slots in your 'default HTML template plug-in' and you should have created a banner group.

Go to the directory manager and to any category that you would like the banners of the group that you created to be rotated. In the 'Banners' column listed next to each directory/category you will see the word/link 'None'. Click on this link and a popup window will appear. The group that you have defined/created will be available for selection for any of the banner slots that you added in the 'default HTML template plugin.' Select the group for the specific banner-slot where you would like the banners rotated.

Step 10
Now you can add more banner groups so that other banners can be rotated in the banner slots that you have defined.

8.1.4 How to rotate banners in your directory/category by using custom templates.

Lets say you have created/defined some custom templates for different categories. You would like banners rotated in the categories that uses these custom templates. To use banners in these custom templates, insert the banner slot variables in these custom templates ( %%bannerslot1%% or %%bannerslot2%%, etc). Once these custom templates has banner slots you can assign banner groups from the 'Directory Manager' to categories/directories that makes use of these custom templates.

8.1.5 How to target banners at content

Targeting banners should be self explanatory. You insert banner slots in the template(s) that is used for your directories/categories. Once the banner slots are present you go to the 'Directory Manager' and assign groups of banners to be displayed in specific directories/categories.

For example: You can create a banner group called 'Entertainment' and just add entertainment related banners to this group. Lets say you have an entertainment category/directory with link listings. Ensure that the template used by the 'Entertainment' category or directory has banner slots. From the 'Directory' manager choose what groups of banners needs to be displayed in Entertainment.

8.1.6 Displaying banners with search results

You will need to define/create a banner group in the 'Banner Manager'. Add the banners that you would like to be rotated when displaying search results.

After you have banners in the group that you plan on using in search results, insert the following code in the 'Search Results Template Plug-in'. (Go to the 'template manager' and click on 'Search Results Template Plug-ins' in the admin control panel)

<!-- Start of Banner Code -->
random = parseInt(Math.random()*10000)
banner = '<a href="'
banner += 'pg=' + random + '" TARGET="_blank">'
banner += '<img src="'
banner += 'pg=' + random + '" alt="Click Here!" BORDER=0></a>'
// -->
<a href="">
<img src=""
alt="Click Here!" BORDER=0></a>
<!-- End of Banner Code -->

Replace the url path that is in red with the path to tclick.cgi on your server/hosting-account. Also replace SomeGroup with the group name you defined/created.

8.1.7 Rotating banners on normal web pages

You may use the HTML code in '8.1.6 Displaying banners with search results'to rotate banners on any web page on your web site.


8.2 Spam Keyword Filter

The Spam/Keyword filter enables you to block submissions which you do not want included in your new submissions area for approval. This can be useful to completely ignore spam, a spammer, or to keep your directory family friendly. Note that once you added keywords here, the submission containing those keywords will be blocked completely and the blocked submission will only show in the 'blocked log'. The submitter will get the idea he submitted successfully but the submission will have been in fact blocked. Use with caution as you can block submissions that you don't want blocked.

8.2.1 How to add a new keyword filter

Click on the 'Add New Keyword' button and supply your keyword and the rest of the details required. You will need to choose how keywords will be matched when new submissions are made.

Whole or Partial Word Match:

Whole Word Matching
Whole word matching matches whole words. For example: Spam
This will only match Spam and not Spammed
Partial Word Matching
Partial matching matches any word in words. Let's say you specified Spam as a keyword. If Spammed was found within a submission the submission will be blocked because Spammed contained the word Spam

You will also need to choose where this keyword will be looked for.

Check For This Keyword in:

Title, Description and Keyword Field
If you choose this to be checked for keyword matches, the title, description and keyword field in the submission form will be checked for matches.

URL Field
URL fields will be checked for keywords/URL's when new submissions is received.

Email Field
Email addresses will be checked for keywords or email addresses when new submissions is received.
If keywords or URL addresses matches a referrer trying to submit data, the submission will be blocked. What is a referrer? In this instance a referrer is a URL address somewhere on internet that is trying to submit data directly to the submission script. The submission form will most probably be bypassed having the effect of receiving a referrer. This is mostly useful if you want to block submissions from certain submission services.


8.3 Submissions Mailing List Management

Email addresses can be captured from users when new submissions are made. The Submissions Mailing List Management section enables you to retrieve email addresses obtained from submissions, so that you can copy and paste it into your mailing list software. There is an excellent free mass emailer called Aureate Group Mail which we found really well suited for the task.

If you are upgrading from a previous version to version 1.60
Look at the sample 'Add Url' template (add_url.html) to see the check box you need to include so that users are able to specify that they would like to subscribe to the mailing list. You will need to include this check box into your current add_url.html for mailing list support. You can also use a hidden variable as explained below.

If you would like to automatically add users to the mailing list without them checking a check box when submitting a link you can do this by using a hidden form variable instead of the check box. You will want to use the line of HTML code below in the form section of the template instead of the check box:
<input type="hidden" name="mlist" value="Y">


<< Previous Page
Tips, Tricks & Notes


ffbotl.gif (1447 bytes) FocalMedia.Net Support ffbotr.gif (1456 bytes)