wiki:FAQ

Version 36 (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 get "Error initializing session directory"
    4. Why not GPL?
    5. Cannot write configuration file (read only file or directory)
    6. FireStats does not work and I get a blank page or my browser tries to download some weird file
    7. How can I prevent unauthorized access to my standalone FireStats installation?
  2. WordPress specific
    1. I installed and activated FireStats in WordPress, but it 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 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 does not work and I get a blank page or my browser tries to download some weird file

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

I installed and activated FireStats in WordPress, but it 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.

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.