vdshttpx.dll extension HTTPX Extension for Visual DialogScript

Version: 1.7.3.2001
Copyright © 2001 PGWARE
All rights reserved


Description:
This is an extension that provides an http proxy server to your visual dialogscript applications. Within minutes you can start up a proxy server from your local machine. Set the default port and your ready to go. The extension will also trigger events when someone connects and requests a url, as well as when a user disconnects from the server. Http proxy servers usually connect multiple times to retrieve images and disconnect many times after receiving images/files and all of this information is provided. This extension also allows you to filter sites, which allows you to build a filter on your local computer from sites you do not want others to view. This extension is shareware and will not work when the script is compiled until a valid serial number is supplied. eg. external vdshttpx,<serial number>

Commands:
[+] HTTPX DEFAULTPORT,<port>
[+] HTTPX DENYLIST,<filename>
[+] HTTPX DENYTEXT,<html text>
[+] HTTPX EVENTS,<mode>
[+] HTTPX NEXTHOPPROXY,<proxyaddress:port>
[+] HTTPX OFF
[+] HTTPX ON
[+] HTTPX REDIRECTLIST,<filename>


[ Command Explanation ] :

[-] HTTPX DEFAULTPORT,<port>

This command sets the http proxy server port to use. By default the port is 8080. You should only use numeric numbers for the port parameter. If the port is already open no notification is sent to you and the proxy server will not function.

<port> - this is the port number to use. It should be a port that is not already open on your machine and is a numeric number. By default port 8080 is used by most proxy servers.



[-] HTTPX DENYLIST,<filename>

This command sets the filename to look for which is a list of urls to deny clients from viewing. This allows you to block certain objectionable sites from being viewed.

<filename> - this is the file which contains a list of urls/text to deny, using keywords allows you to deny any content/url with that word in it. Use the the following format within the file:

www.whatever.com
www.dontview.com
badwords
badcontent



[-] HTTPX DENYTEXT,<html text>

This command allows you set the text to display to the user when an url has been denied.

<html text> - this parameter is the text to return to the client and should contain standard HTML <tags> and coding. Ex: <HTML><BODY>Error - DENIED</BODY></HTML>



[-] HTTPX EVENTS,<mode>

This command allows you to turn events on or off. By default events are OFF. The use of events allows your application to know when a url has been requested and when a connection has been disconnected. The use of such information is good for statistical log purposes.

<mode> - there are two modes to choose from to modify how events are handled
   NO - no events are generated
   YES - events are generated
   look below to see which events are generated



[-] HTTPX NEXTHOPPROXY,<proxyaddress:port>

This optional command allows you to use a second http proxy server to jump to before returning content back to the client. This allows your proxy server to download files anonymously.

<proxyaddress:port> - this parameter should be in the form of the proxyaddress and then the ':' character followed by the port. Ex: proxy.com:8080



[-] HTTPX OFF

This command turns the http proxy server off. Any client machine that is connected will no longer be able to view urls through your machine.



[-] HTTPX ON

This command turns the http proxy server on. Your machine is now accessible to anyone connected to the internet via your IP address and urls will be accessible through your server.



[-] HTTPX REDIRECTLIST,<filename>

This command sets the filename to look for which is a list of urls to redirect clients to. This allows you to redirect certain sites to another url. Please note that redirection only allows you to point to domains that have an IP address assigned, basically sites that do not use virtual domains.

<filename> - this is the file which contains a list of urls/text to redirect to, using keywords allows you to redirect any content/url with that word in it to another site. You should specify an url/keyboard then the "|" character followed by the new url to redirect to. Use the the following format within the file:

www.whatever.com|newsite.com
www.dontview.com|redirect.com
badwords|www.borland.com
badcontent|www.microsoft.com





Functions:
[+] @HTTPX(CLIENTS)
[+] @HTTPX(DEFAULTPORT)
[+] @HTTPX(KEYWORD)
[+] @HTTPX(RETURNTYPE)
[+] @HTTPX(URL)


[ Function Explanation ] :

[-] @HTTPX(CLIENTS)

This function returns the current number of clients connected to your http proxy server.



[-] @HTTPX(DEFAULTPORT)

This function returns the default port the http proxy server is currently configured to use.



[-] @HTTPX(KEYWORD)

This function returns the keyword that either denied or redirected a client request, which is one of the words you defined in your deny or redirect files.



[-] @HTTPX(RETURNTYPE)

This function returns a numerical value which describes the type of document returned to the client connection.
<return values>
   0 - forwarded url to client
   1 - denied url to client
   2 - redirected url to client




[-] @HTTPX(URL)

This function returns the last url that was passed to the client connection.





Events:
[+] HTTPXCONNECT
[+] HTTPXDISCONNECT
[+] HTTPXDOCUMENT


[ Event Explanation ] :

[-] HTTPXCONNECT

This event occurs when a request to a url has been made. Depending if the user has already connected this event may not be triggered. The event usually occurs when a refresh has been made in the browser to the requested url. The command HTTPX EVENTS,ON must be used inorder for this event to occur.



[-] HTTPXDISCONNECT

This event occurs when a disconnection to the http proxy server has been made. Multiple connections are made when images are retrieved and instantly disconnected once the file has been downloaded to the client machine. These connections are made by the HTTPXDOCUMENT event rather then the HTTPXCONNECT event. The command HTTPX EVENTS,ON must be used inorder for this event to occur.



[-] HTTPXDOCUMENT

This event occurs when a get request has been made to view a url and its corresponding images/files. This event will be triggered numerous times depending on the number of graphics/files available. The command HTTPX EVENTS,ON must be used inorder for this event to occur.





Registration:
This extension is shareware it must be registered within 28 days or you must remove the extension and any application that uses it. Once you register you will receive a personal serial code which will unlock the extension so you can distribute it with your applications. Registering costs $10.00 US Dollars and can be purchased online at [
http://www.reg.net/product.asp?ID=7752 ].



Support:
Please note that only registered users are provided with support. However bug fixes will be made as they are found. Report bugs to [ support@vdsworld.com ].



Copyright © 2001 PGWARE / All rights reserved.