wiki:FAQ

Version 40 (modified by omry, 11 years ago) (diff)

--

Frequently asked questions

  1. General
    1. What are the minimal FireStats requirements?
    2. Something does not work!
    3. I Forgot my password, how do I change it?
    4. I get "Error initializing session directory"
    5. Why not GPL?
    6. Cannot write configuration file (read only file or directory)
    7. FireStats admin page is blank
    8. How can I prevent unauthorized access to my standalone FireStats installation?
  2. WordPress specific
    1. FireStats does not track the visits to my blog!
    2. After upgrading to WordPress 2.1 FireStats no longer works
    3. I enabled the comment Browser/OS icons in the WordPress settings tab, but I don't get any icons in my comments
    4. How do I install on SourceForge

General

What are the minimal FireStats requirements?

FireStats is known to run on:

  • PHP 4.4.2 or newer.
  • MySQL:
    • Minimum MySQL 4.0.17 with InnoDB support.
    • MySQL 4.1.14 or newer is highly recommended.
  • Unix-like OS is preferred, but some users are running it successfully on windows.

Something does not work!

Run the diagnostics page and see if if you get any hints.

if you if installed FireStats inside the WordPress plugins directory, firestats_path will typically be wp-content/plugins/firestats/ under your blog root.

I Forgot my password, how do I change it?

Open http://your.server.com/firestats_path/tools.php and follow the link to the password reset page.
For security reasons, You will need to slightly edit the PHP file to enable this functionality. remember to revert your change once you are done!

I get "Error initializing session directory"

See this

Why not GPL?

While I generally like GPL and did release some things under GPL and LGPL (ip2c, JNotify), I chose not to do it with FireStats because I want to keep the option to sell it to blogging platforms later. if I go with GPL, there is no reason for anyone to buy it as they just use it under the terms of GPL.
If I change my mind, GPL is one of the preferred licenses for FireStats.

Cannot write configuration file (read only file or directory)

FireStats need write access to the file php/fs-config.php when you are configuring the database.
Please make sure that the apache user have write access to that file
a quick fix for the those with low unix-fu:

  • cd firestats/php (Change to the php directory)
  • touch fs-config.php (Makes sure the config file exists)
  • chmod o+w fs-config.php (Make sure everyone can write to the file)
  • Configure database in FireStats database tab.
  • chmod o-w fs-config.php (Make sure everyone can't write to the file)

FireStats admin page is blank

This is most probably caused by a PHP memory issue.
More information is available here.

How can I prevent unauthorized access to my standalone FireStats installation?

Currently there is no native support for restricting unauthorized access to your FireStats installation. but you can use htaccess to password protect your FireStats. For more information check this link.

WordPress specific

FireStats does not track the visits to my blog!

Make sure you have a call to wp_head() in your theme header.php file. look in the default theme for an example of how it should be. also, it goes without saying that FireStats must have been activated from the plugins menu.

After upgrading to WordPress 2.1 FireStats no longer works

This is most probably caused by a PHP memory issue.
More information is available here.

I enabled the comment Browser/OS icons in the WordPress settings tab, but I don't get any icons in my comments

FireStats hooks to the function comment_author_link(), and prefix its output with the icons.
if your Theme does not call this function, you will not get the icons.
To see how this function is supposed to used, check the comments.php file in the default theme.

How do I install on SourceForge

See this.