Software Search
Search For:
In Price Range (GBP) :
£ - £

or: all BigYellowZone software
HELP/FAQs?

Got questions/problems? Take a look through our FAQs (frequently asked questions), or email us at: support@bigyellowkey.com. We shall do our best to get back to you promptly.

Want Discounts?

Are your prices for multiple domains too large? Are you trying to get licences for test domains but being asked to pay full cost? Don't worry; we can add test domains to your licences manually. Just purchase a single domain addon/upgrade for what it is that you need, and then email us about your situation regarding the remaining domains and we'll liaise with you over the options. email us at: support@bigyellowkey.com. We shall do our best to get back to you promptly. click here for more information regarding multiple domains, upgrades, and discount policies.

BYZ044 - Domain Tools for VP-ASP
<< back to previous screen

This very handy tool can be used to help solve lots of domain related
problems (such as losing sessions when a visitor is directed back from a payment gateway, or avoiding dropped carts due to www or non-www urls or using mirrors/aliases).


Compatibility, Bundling, and Status Notes:
Compatible with VPASP V4.5 to V7

Before installing, you must have installed:
BYZ038
BYZ036

This product includes:
BYZ038
BYZ036
Latest version:08/26-FEB-2010
From vendor:BigYellowZone
Price:£25.00
add to cart

Here are some of the applications/options that you can use it for:

1. Direct visitors on/off your SSL (https) area for specified pages
There's a config option which holds the list of which pages you want to use SSL for; whenever one of those pages is being viewed the addon will automatically redirect the user to the corresponding SSL area (if they're not on it already) for that page, and it'll automatically transfer them back off the SSL area when they land on a non-ssl-listed page. This means that you don't need to change any of the links on your site (either ones you've created in your header/trailer files, or links which are created by vpasp functions) to point to your SSL area as the system will automatically transfer the user when appropriate.

2. Direct visitors onto a specific domain
If someone lands on one of your domain aliases, or lands on "http://mydomain.com" instead of "http://www.mydomain.com" then you can setup the config options to automatically transfer them to the relevant domain on the same page that they were originally trying to view.

3. Set your gateway return URL correctly
Use the BYZ_DMT_CURRENT_DOMAIN function in your gateway config file to ensure that the return url is set to the same domain that the user was originally on so that when they return their session is still active.

All of the above are fully configurable/optional, and if using them you can help to dramatically reduce the number of dropped carts that your site gets.
"Why are these relevant/needed?" you may ask. Here's why:

The domain "http://mydomain.com" is seen as an entirely different domain to "http://www.mydomain.com" as far as your server/host is concerned, so if people land on one of those domains and then the cart later moves them to the other area (eg via your gateway or from your own links) then the user will lose all their session info. This problem leads to lots of dropped carts, because some people just type in "mydomain.com" into their url line, whereas other people will use "www.mydomain.com". This is why this addon is useful for people who have just one domain as well as for people who use domain aliases.


Technical/Developer Information:
In addition to those redirection options, there are also some useful functions built into the addon which you can use elsewhere in your vpasp asp files:

1. BYZ_DMT_CURRENT_DOMAIN()

This will return the full domain (including the protocol) that is currently being viewed.

Example call:

<% Response.Write "I am currently on: "&BYZ_DMT_CURRENT_DOMAIN() %>

Would return values like this:

I am currently on: http://www.mydomain.com
I am currently on: http://mysubdomain.mydomain.com

This might be useful in something like your gateway config file so that you can set your return url to the same domain that the user originally landed on.


2. BYZ_DMT_CURRENT_DOMAIN_NO_PROTOCOLS()

This will return the main domain (not including the protocol) that is currently being viewed.

Example call:

<% Response.Write "I am currently on: "&BYZ_DMT_CURRENT_DOMAIN_NO_PROTOCOLS() %>

Would return values like this:

I am currently on: mydomain.com
I am currently on: mysubdomain.mydomain.com

This might be useful if you want to check which domain people are on and show different headers for different domains etc.


3. BYZ_DMT_CURRENT_FULLURL()

This will return the full url, including the protocol and arguments for the page that is currently being viewed.

Example call:

<% Response.Write "I am currently on: "&BYZ_DMT_CURRENT_FULLURL() %>

Would return values like this:

I am currently on: http://www.mydomain.com/shopexd.asp?id=100
I am currently on: http://mysubdomain.mydomain.com/shopexd.asp?id=100

This might be useful if you want to hold the current full url in a variable so that you can return to it later.


4. BYZ_DMT_CURRENT_FILEBEINGVIEWED()

This will return the page name that is currently being viewed, not including the protocol, arguments, or relative directory (ie just the actual asp filename)

Example call:

<% Response.Write "I am currently on: "&BYZ_DMT_CURRENT_FILEBEINGVIEWED() %>

Would return values like this:

I am currently on: shopexd.asp
I am currently on: Default.asp

This might be useful if you want to display certain elements for certain pages. For example, you could change your header file to only show a certain graphic while on a certain page. Note that this function is case-sensitive; it shows the filename in the same case that the user is browsing on their browser address line.


5. BYZ_DMT_CURRENT_FILEBEINGVIEWED_LOWERCASE()

This will return the page name that is currently being viewed, not including the protocol, arguments, or relative directory (ie just the actual asp filename)

Example call:

<% Response.Write "I am currently on: "&BYZ_DMT_CURRENT_FILEBEINGVIEWED_LOWERCASE() %>

Would return values like this:

I am currently on: shopexd.asp
I am currently on: default.asp

This might be useful if you want to display certain elements for certain pages. For example, you could change your header file to only show a certain graphic while on a certain page. Note that this function is not case-sensitive; it shows the filename in lower case always.


6. BYZ_DMT_IS_THIS_FILE_BEING_VIEWED(arg_in_filename)

This will return "Y" or "N" depending on whether or not the file which is passed across as "arg_in_filename" is currently being viewed. Note that this always forces lower case, so if using it you should always pass across the filename argument in lower case. Also, you should not supply the relative path or protocol or domain, you should only pass across the asp file name.

Example call:

<% Response.Write "Am I on default.asp?: "&BYZ_DMT_IS_THIS_FILE_BEING_VIEWED("default.asp") %>

Would return values like this:

Am I on default.asp?: Y
Am I on default.asp?: N

This might be useful if you want to display certain elements for certain pages. For example, you could change your header file to only show a certain graphic while on a certain page.




For further information from the vendor about this product, please visit:
http://www.bigyellowzone.com/shopexd.asp?id=64

Full Version History:
VerNo Version Date Release Notes
01 04-OCT-2004 Initial version - Big Yellow Zone Domain Tools For VP-ASP.
02 17-NOV-2005 Various extra functions/tools added to return files being run etc.
03 24-FEB-2006 Changed to be more generic and packaged up for sale as an addon. (This is the first publicly available version of this addon)
04 31-MAY-2007 Upgraded BYZ038 (Licensing) module to cater for VP-ASP V6.5.
Effected files:
byz044_install.asp (changed file)
README.htm (changed file)
05 05-OCT-2008 Upgraded BYZ038 from V07 to V09.
Upgraded BYZ036 from V02 to V04.
Effected files:
byz044_install.asp (deleted file)
README.htm (changed file)
06 27-NOV-2008 Enhanced to cater for shared ssl which has a different directory compared to the corresponding non-ssl area.
Changed to ignore case for domain redirection checking.
Changed, commented, and rearranged configuration settings.
Added more help notes and tips to the readme file.
Effected files:
README.htm (changed file)
byz_domaintools_$config.asp (changed file)
byz_domaintools_inc.asp (changed file)
07 12-DEC-2008 Enhanced to cater for sub-domains redirecting to/from main domains with differing folders (in a similar way to how additional folders on shared ssl is dealt with).
Effected files:
README.htm (changed file)
byz_domaintools_$config.asp (changed file)
byz_domaintools_inc.asp (changed file)
byz_domaintools_system.asp (changed file)
08 26-FEB-2010 Changed installation notes and program files to cater for VPASP V7.
Added more files to the default SSL page list (for VPASP V7+ only).
Upgraded BYZ038 (from V09 to V12)
Upgraded BYZ036 (from V04 to V07)
Note: If upgrading BYZ044 from a previous version on VPASP 6.5 or below, please note that you need to now have includes for the byz_domaintools_vars_inc.asp file and for the byz_domaintools_inc.asp file, so these includes have been moved (no longer in shop$db.asp) and there are now 2 of them instead of just 1 - see installation notes for more details.
Effected files:
README*.htm (changed files)
byz$044_version.asp (new file for all vpasp versions)
byz_domaintools_$config.asp (changed file for vpasp v7+ only)
byz_domaintools_inc.asp (changed file for all vpasp versions)
byz_domaintools_vars_inc.asp (new file for all vpasp versions)