Liquid Frog
FAQ's
Visitors Online
ANSWERS
  1. What is PHP Visitors Online
    PHP Visitors Online is a small script written in PHP that will show you how many people are currently visiting your site.

    Designed primarily for PHP pages, it is configurable (to a degree) and will allow you to change the appearance of the output and how often the script checks to see if new visitors have come into your site. This is acheived via a config.php file.

    Setting up the script is very easy and requires a small handful of changes to one file, uploading the script to the server and running the install routine. Most of the difficult things are already taken care of for you leaving you only to decide where on your page the script should appear.

    Full instructions are included with the script
    [Back to top]
  2. What are the requirements for PHP Visitors Online
    You will need PHP and MySQL enabled on your web server. That's all.
    [Back to top]
  3. How do I set up PHP Visitors Online
    Setting up PHP Visitors Online is a very simple process. Essentially, edit the config.php file, upload the files and structure to your web server, chmod one directory and run the included install script from your browser. That's all.

    We have tried hard to make installation a painless process for you. Provided you enter the correct parameters, the install script will take care of everything and you only need to add 3 simple lines of code to the page where you want the script to appear.
    [Back to top]
  4. I get error messages when I use the script
    If the error messages you get look something like this:

    Warning: main(../online/onlinenow.php) [function.main]: failed to create stream: Operation not permitted
    in /home/httpd/vhosts/yourhost.com/httpdocs/index.php on line 23

    Warning: main() [function.main]: Failed opening '../online/onlinenow.php' for inclusion (include_path='.:/usr/php4/php')
    in /home/httpd/vhosts/yourhost.com/httpdocs/index.php on line 23

    Then the answer is to change the include path on your pages from "include('../online/onlinenow.php');" to "include('http://www.yoursite.com/online/onlinenow.php');
    [Back to top]
  5. I get an open_basedir restriction in effect error message
    If you receive this error message (or something similar that talks about open_basedir restrictions in effect):

    Warning: main() [function.main]: open_basedir restriction in effect. File(/usr/lib/php4/php/language/lang-.php) is not within the allowed path(s): (/home/http/vhost/yourdomain.com/httpdocs)

    Then your hosts have set some restrictions on your server. Most hosts will be happy to turn off this restriction to allow the script to run. Contact your hosts, inform them of the error message you are receiving and request that they remove open basedir restrictions.
    [Back to top]
  6. I can't get the script to work on my HTML pages
    This script only works on php pages. It is entirely possible that you can change the extension of your page from html to php by simply renaming the file so the script works. E.g. Say your index page is called index.html and you have included the script on that page. Just rename the file index.php and both your page and the script should work. If there are any problems you can just rename the file back to html again.

    Another method to get the script working on a HTML page is to use an Iframe like this:

    <iframe src=http://yoursite.com/online/onlinenow.php width=100 height=150 frameborder=0 scrolling=no>. You will need to edit the Iframe to suit.
    [Back to top]
  7. I get errors that say the script cannot connect to my database
    If you are receiving MySQL errors relating to being unable to connect to the database, then it is almost certainly the case that you have entered one of the following incorrectly:-

    $hostname - This is most often localhost but if the script cannot connect to the database and you are certain that all the other settings are correct you must contact your hosts and ask them the name of your database server. Only they can give you this information if localhost doesn't work for you. It might be that your hostname is an IP address for instance.

    $username - If you have set up your database on your host yourself, then this is the user name of the person who is granted access to the database. If your host set it up for you, they will usually have sent you an email containing all the login details. If you have more than one user it is usually best to select the default database admin/user. Some people seem to get confused between this and the name of their database. Be aware that the two are very different.

    $password - This is the password of the username in the section above. Again, if you have set up your own database you are usually prompted to enter a username and password to use to gain access to the database. If you use PhpMyAdmin or something like it, when you connect to your database you will be using the same details that are required for this script so you can check your config.php file in PhpMyAdmin to get the values you need.

    $database - This is the name of the database on your database server. As an example, if your site were called www.widgets4u.com and your database was set up by your host, your database would probably be called something like widgets4u (this is just an example and will probably not reflect your actual settings). This is very different to the database username and you must not confuse the two.

    If you are still having problems connecting to your database, the best answer is to contact your hosts and ask them to provide you with all the info required. They are the only people, other than yourself, who should know these details.
    [Back to top]
  8. How can I remove the link to Liquid Frog from the script
    This is a free script, as such it generates no income for us. In addition, we have to bear the costs associated with download of the script in terms of bandwidth and ongoing development and all our free scripts are very popular with our site visitors meaning a lot of bandwidth!

    We use the link included with the script to generate traffic to this site in the hope that people will purchase one of our paid for scripts or some of our software. Whilst we would love to give away our scripts and not have a link, economic realities dictate otherwise. We give you the script for free - you return that by sending us traffic, we consider this a fair exchange.

    If the link spoils the look of your site or you really don't want the link, you can pay a small fee to have it removed. We charge just $7.99 for removal of the link and you can find instructions on how to do this in the Readme.htm file that comes with the script.
    [Back to top]
  9. Can I suggest a way to improve this script
    Yes of course. We actively encourage users of our software and scripts to suggest improvements so that they can be developed still further. To make a suggestion please use the contact form on the site and send your comments to feedback.
    [Back to top]
  10. My question wasn't answered in these Faq's. What now
    Even though we do not provide support for our free scripts, if you have a problem that doesn't appear in these Faq's, you may email support.

    Please include as much detail as possible about the problem and try to indicate under what circumstances the problem occurs. Please also tell us as much about your server as you can such as the version of PHP and MySQL it is running etc.

    We want to provide as much help as possible to end users via these Faq's and, if your problem is not already listed you could also help others as well as yourself by requesting support.

    Any replies we make to your problem will be mailed directly to you and included in these Faq's for others
    [Back to top]
Jump to:
Powered by ODFaq v2.1.0