spacer
isapilabs
OverviewspacerDownloadsspacerFAQspacerDocumentationisapilabs
banner
spacer
spacerCountryLocator Frequently Asked Questions
General
       What is CountryLocator?
       Who benefits by using CountryLocator?

Compatibility
       What browsers/clients are supported?
       Do I, or my users, need any special hardware or special plugins?
       Does CountryLocator support scripted languages?
       Can I use CountryLocator with my proxy server?
       Does CountryLocator work with other products from ISAPILabs?

How To
       How do I retrieve the user's country in PHP?
       How do I retrieve the user's country in ASP?
       How do I redirect users based on their country information in PHP?
       How do I redirect users based on their country information in ASP?

Installation
       Is CountryLocator easy to install and uninstall?
       I get an error activeds.dll when installing on Windows NT 4.0

Purchasing
       How much does CountryLocator cost?
       Where can I purchase the full-version of CountryLocator?
       How much does it cost to upgrade CountryLocator?
       How do I know if I have the latest version of CountryLocator?
       Are there any discounts for educational or not-for-profit institutions?

General
What is CountryLocator?
CountryLocator is an easy-to-use Internet Server Application Programming Interface (ISAPI) plugin for any web server running IIS. CountryLocator helps detect which country each user is coming from based upon his or her IP address. Then, it produces this information so that you can process it in a scripting language such as PHP, ASP, ASP.NET, Perl, Cold Fusion, and CGI.

Who benefits by using CountryLocator?
Anyone who manages an IIS HTTP server and needs geographic data for the users who visit their site will benefit by using CountryLocator. The information can be used to help detect fraudulent credit card purchases, redirect users to country specific web pages, hide content from users coming from specific countries, provide advertisers with geographical statistics, and meet the needs of many other geographic specific applications.



Compatibility
What browsers/clients are supported?
All browsers including, but not limited, to Internet Explorer, Netscape, Mozilla, and Opera are supported.

Do I, or my users, need any special hardware or special plugins?
No special hardware or special plugins are required by either you or the people who view your website in order for CountryLocator to operate.

Does CountryLocator support scripted languages?
CountryLocator supports scripted languages (such as PHP, ASP, ASP.NET, CGI, Perl, and VBScript) that are able to retrieve HTTP headers.

Can I use CountryLocator with my proxy server?
CountryLocator provides an option that supports proxy servers. This option can be activated using the CountryLocator configuration tool. However, it is normally deactivated because IP addresses from proxy server requests can be masked.

Does CountryLocator work with other products from ISAPILabs?
Yes, all products from ISAPILabs are compatible and work harmoniously with each other to provide you with a reliable solution to all your ISAPI needs.



How To
How do I retrieve the user's country in PHP?
To retrieve the user s country in PHP, use the following code:

    <?php
    if (isset($_SERVER['HTTP_X_COUNTRYNAME']))
        print("You are located in ".$_SERVER['HTTP_X_COUNTRYNAME']);
    if (isset($_SERVER['HTTP-X_COUNTRY']))
        print(" (".$_SERVER['HTTP_X_COUNTRY'].")");
    ?>
                    


How do I retrieve the user's country in ASP?
To retrieve the user's country in ASP, use the following code:

    <%
    Response.Write("You are located in " & Request.ServerVariables("HTTP_X_COUNTRYNAME"))
    Response.Write(" (" & Request.ServerVariables("HTTP_X_COUNTRY") & ")")
    %>
                    


How do I redirect users based on their country information in PHP?
To redirect users to another server based on their country information in PHP, use the following code:

    <? php
    if (isset($_SERVER['HTTP_X_COUNTRY']))
        header("Location: http://".$_SERVER['HTTP_X_COUNTRY'].".mysite.com/");
    ?>
                    
To redirect users to another web page:

    <?php
    if (isset($_SERVER['HTTP_X_COUNTRYNAME']))
        {
        if (strcmp(strtoupper($_SERVER['HTTP_X_COUNTRYNAME']), "CHINA") == 0)
            header("Location: http://www.microsoft.com/");
        }
    ?>
                    
(Note: The use of the header function in PHP requires that no other output be sent out before using it.)

How do I redirect users based on their country information in ASP?
To redirect users to another server based on their country information in ASP, use the following code:

    <%
    Response.Clear
    Response.Redirect("http:// & Request.ServerVariables("HTTP_X_COUNTRY") & ".mysite.com/")
    Response.End
    %>
                    
To redirect users to another webpage:

    <%
    If (StrComp(UCase(Request.ServerVariables("HTTP_X_COUNTRYNAME")), "CHINA") = 0) Then
        Response.Clear
        Response.Redirect("http://www.mysite.com/china.htm")
        Response.End
    Else
        Response.Write(Request.ServerVariables("HTTP_X_COUNTRYNAME"))
    End If
    %>
                    




Installation
Is CountryLocator easy to install and uninstall?
CountryLocator is very easy to install and uninstall. To install CountryLocator, simply double-click on the setup file and follow the setup routine. To uninstall CountryLocator, select the Uninstall icon in the CountryLocator Program Group in your Start menu.

I get an error activeds.dll when installing on Windows NT 4.0
If you get an error "This application has failed to start because ACTIVEDS.dll was not found. Re-installing the application may fix this problem," this is because you do not have Active Directory Services or Windows Script Host installed on your machine. Click on the links below to download the required software from Microsoft.

Download Windows Script Host 5.6 for Windows NT 4.0
Download Active Directory Service Interfaces (ADSI) for Windows NT 4.0



Purchasing
How much does CountryLocator cost?
To find out how much CountryLocator costs check out the price listing at http://www.isapilabs.com/.

Where can I purchase the full-version of CountryLocator?
To purchase the full version of CountryLocator, goto http://www.isapilabs.com/.

How much does it cost to upgrade CountryLocator?
You may find the prices for all ISAPILabs products at http://www.isapilabs.com/.

How do I know if I have the latest version of CountryLocator?
You can identify the version of CountryLocator installed on your server through the CountryLocator configuration tool.

Are there any discounts for educational or not-for-profit institutions?
Accredited organizations can receive CountryLocator at discounted rates. For more information, please contact us.





spacer
     Copyright ©2004 ISAPILabs. All rights reserved. | Sitemap
spacer