TroubleshootingClick on one of the questions below to see the trouble shooting advice. If your question is not answered here please use the contact form.Q. I need my main site address (www.yoursite.com) to automatically send me to one of the destinations sites. A. Before you proceed you should create a rotator portal that you will use to rotate your http://www.yoursite.com/ traffic. For this example let's say you have called that portal 'main', and it's auto-generated link is http://www.yoursite.com/url/rotator/admin_main. There are 3 different methods to choose from: mod_rewrite, meta-refresh, or frames. Method 1: Use a .htaccess file + mod_rewrite Pros: Gives the most efficient (fastest) performance. Cons: Requires your server to have mod_rewrite enabled. This is no big deal, your server is highly likely support it. Create a text file called .htaccess (NOTE: it starts with a dot and has no other file extension) and paste & edit the following lines into it, substituting your own portal url on the bottom line:
# top-level root / redirection to a rotator portal
Then upload that file to the top directory (the document root, usually called /www/ or /htdocs/ or /public_html/) of your website. Make sure you DO NOT OVERWRITE the /www/url/.htaccess in the rotator script's directory as it is a completely different file but shares the same name. Method 2: Use a index.html file with meta-refresh Pros: Works with any server. Will display your destination url in the web-browser location bar (i.e. it doesn't cloak the destination). Create a text file called index.html then copy and paste the following code into it, substituting your own portal url:
<html>
Save the file as index.html and upload it to your main document root of your website (usually the /htdocs/ or /public_html/ or /www/ directory). Method 3: Use a index.html file with frames Pros: Works with any server. Will display your site's main address in the web-browser location bar while displaying your destination's content (i.e. it cloaks the destination). Create a text file called index.html then copy and paste the following code into it, substituting your own portal url:
<html>
Save the file as index.html and upload it to your main document root of your website (usually the /htdocs/ or /public_html/ or /www/ directory). Q. I receive a similar error message to: Site error: the file /home/username/public_html/url/index.php requires the ionCube PHP Loader ioncube_loader_lin_5.2.so to be installed by the site administrator. This is because the server uses PHP 5.2.5 or higher, and the Ioncube loader must be installed in the php.ini file in this case. Your hosting provider should be able to do this if you contact their support, but it may also be possible for you to use a custom php.ini file to install the Loader yourself.
Q. I have installed the script properly, I can set Portals and Destinations without a problem. But when it come to visiting the portals the destinations are not being loaded. Visiting a portal like http://www.mysite.com/url/rotator/admin_portal gives me a 404 error page as if nothing is there at all, or it displays some PHP code. A. Please double-check that you have uploaded the /url/.htaccess file included in the .zip package. The rotator script uses mod_rewrite rules defined in .htaccess to transparently rewrite /rotator/ links into /rotator.php? links.
If you are sure that you have uploaded the /url/.htaccess file to your /url/
folder, and its still not working then the server probably doesn't support
mod_rewrite, and you may have to use the alternative portal url format which
will make your rotator URLs look like this: http://www.mysite.com/url/rotator.php?admin_portalinstead of http://www.mysite.com/url/rotator/admin_portal For this what you will need to do is edit your /url/include/config.inc.php file and look for these lines (around line 148):
Please change those lines into this:
i.e. Just put a # hash mark in front of 3 of the 4 lines as shown. Save and upload the config.inc.php and you should be good to go. But first remember, please double-check that the /url/.htaccess file has been uploaded. Q. Can the word /rotator/ in the portal urls somehow be replaced by another word? I'd use the word "top" rather than "rotator" which is more suitable for me. Sure, what you will need to do is edit your /url/include/config.inc.php file and look for these lines (around line 148):
Please change those lines into this:
Next, inside the /url/ directory you should see a file called .htaccess you will need to edit this file and replace the line
with
Finally, make a copy of the /url/rotator.php file and name it /url/top.php Q. I receive a similar error message to: "The file /home/username/public_html/url/index.php has been encoded with the ionCube PHP Encoder and requires the free ioncube_loader_xxx_x.x.so ionCube PHP Loader to be installed."
A. This error message means that your server is using a PHP version more recent than the loaders the script comes with. To solve the problem you need to visit the linked IonCube loader page at www.ioncube.com/loaders.php and download the relevant .zip file.
The error message shows you which file you need:
If you are unsure wether you need the x86, x86-64, AMD64, ppc, etc. zip file you probably need the x86 as its the most common. Once you have downloaded the .zip open it up and extract the required ioncube_loader_xxx_x.x.so (according to the error message) and upload that to your /url/ioncube/ directory. Q. I receive a similar error message to: "file /httpdocs/url/index.php is corrupted."
A. This error is probably due to an incompatibility between the encoded php files and the version of the ioncube loaders on the server trying to decode them. Basically the old loaders being used can't read the new format of the encoded script so it thinks the files are corrupt.
The script makes use of recent Ioncube features (such as license files, and ascii upload comaptibility) and so the latest version of the loaders must be used.
A suitable loader for the most common server operating systems is included in the script package's /ioncube/ directory. Provided that you have uploaded this directory and your server supports run-time loading then the script should usually be able to use the correct ioncube loader. However, the "file xxx.php is corrupted" message suggests that the correct loader is not being used, and instead an old version of the ioncube loader is trying to decode the php files. This happens when your web host has an old version of the loader already installed server-wide via php.ini, and unfortunately you cannot override this with runtime loading. Please contact your webserver administrator and let them now that they need to upgrade their ioncube loaders. They can be freely downloaded here: http://www.ioncube.com/loaders.php. They should have no problem seeing as they're already using the loader, and the loaders are backwards compatible so nobody else on the server will be inconvienced by the upgrade. Q. I receive a similar error message to: "Warning: main(DB.php): failed to open stream: No such file or directory in /httpdocs/url/include/common.inc.php on line 24".
A. The missing file DB.php is part of the PHP Extension and Application Repository (PEAR) which is basically a standardized library of reusable PHP code.
Most web hosts usually have the PEAR library already installed, but apparently yours may not.
Fortunately, PEAR is completely free and open source and can be downloaded from http://pear.php.net/ Not all components available there need to be installed for the rotator script to work, only the DB and PEAR Base packages. I have included those two packages into a convenient zip file to make things easier for you. What you need to do is download and unzip pear_library.zip and upload all the files and folders to your /url/include/ directory so that you end up with: /url/include/DB/ /url/include/PEAR/ /url/include/DB.php /url/include/PEAR.php and that should take care of that. Q. I receive a similar error message to: "403 Forbidden / You don't have permission to access /url/ on this server."
A. This is an uncommon error and can be hard to diagnose. The first thing to do is rename (or delete) the /url/.htaccess file, then visit the script again to see if the error remains.
If the error has disappeared then the likely cause is the mod_rewrite rules in the .htaccess file. Restore the /url/.htaccess file and insert:
Options +FollowSymLinks
into the first line in the file. Then visit the script again, if the error remains please contact us for technical support. Q. Can the script hide the referer information from each destination site?
Sorry, but no. It is not possible to hide the referrer information, as that is controlled by each visitor's own web browser.
The only option I can think of is to use the script in conjunction with one of the many referrer-hiding services around such as ninjarefer.com
So, for example if I wanted to add "http://www.codefu.net/" as a destination URL I would instead enter in "http://ninjarefer.com/?http://www.codefu.net" as the destination URL.
When the visitor goes to my portal the script will rotate them to ninjarefer.com which will then redirect to codefu.net, the codefu.net server logs will show the visitor's referer was ninjarefer.com and will never know about the original site where the rotator script is installed.
If you have a question relating to Ioncube Loaders you might find Ioncube.com's Loader FAQ helpful. |