Z-ODP Beta Ver. 0.5 Documentation
There is a certain amount of ASP knowledge that would be helpfull to use this script. Although you don't need to be an ASP guru, you do need to know how to edit a web page and etc.
Copyrights Notice:
Copyright 2006 - Sevic Network, Inc (Zoran Sevic) - http://zodp.sevic.net
You may use and change this script as you see fit with the following conditions:
- You do not pass off this script as your own.
- You do not sell this script and only distribute it for free.
- Any changes made to this script to be freely shared with others
- You must leave this copyright notice intact even if you make changes to the script
- You are allowed to add additional copyrights from your own dirivative works of this script
- The link back at the bottom is not removed of each page is not removed..
Minimum Requirements
In order for this script to work, you must run this script on a Windows 2000 or 2003 server. Also, you may need to have a recent Microsoft XML component.
Installation
Unzip the files from the download and upload the files to the directory you wish Z-ODP to reside. There is also an example.asp file that you can open and view to see how the Z-ODP is added.
Please follow the following steps:
- Make sure you have <%@ Language="VBScript" CodePage="65001" %> at the top of your page that Z-ODP will display.
- Before the <head> tag, add: <!--#include file="z-odp.asp"-->
- If you wish the titles of the categories to be a part of your meta title add:
<title>You Website Title <%=strOdpTitle%></title>
- In order to be able to display all languages, your page must be UTF-8, There are a couple of methods this can be done.
- Change or add between <head> </head>, <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
- OR right before step #5 add <% Response.Charset = "utf-8" %>
- To insert the ODP output, add this somewhere in you content. <%Call ZOdp()%>
Features:
- Parses and displays the main catogories pages.
- Parses and displays the category description pages.
- Parses and displays the category FAQ pages.
- Calls and parses the search page of ODP and displays it on your site.
Known Issues:
- Errors from dmoz.org
- This script relies at the moment that there are no errors at dmoz.org. Sometimes dmoz can get very busy. As such, you can have the script hang while it is accessing their website. It may also just fail if their website is down. We will be working on a cache system for later releases of this script. This should resolve many of these problems. Also, it may happen that one day dmoz.org will drastically change the way their pages are formatted. Although this hasn't happened in years, it could happen.
- Error Handling - At the moment, the error handling is limited. So any errors from dmoz or the script may not be very user friendly.
- UTF-8 Issues - Since ODP switched over to UTF-8, many of the old ASP scripts no longer functioned properly. We found a way around this but, if most of your site is a different character set, it could create odd character formats. In some cases we have found that if you use <% Response.Charset = "utf-8" %> right before you make the call in step #5, instead of the meta tag, the problems are less likely to appear.
History:
Z-ODP Beta ver. 0.5 is the first release version.
Support:
We do not offer support for this script. We may change this in the future and have a forum for support.