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. Cannot write configuration file (read only file or directory)
    5. Why not GPL?
    6. Memory problems
    7. How do I install on SourceForge
    8. Can I downgrade FireStats?
    9. How does FireStats stores it's data?
  2. WordPress specific
    1. FireStats does not track the visits to my blog!
    2. After upgrading WordPress FireStats no longer works
    3. I enabled the comment Browser/OS icons in the WordPress settings tab, but …

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

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 (Creates the the config file if missing)
  • 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)

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.

Memory problems

I get a blank FireStats admin page, or an error message like Fatal error: Allowed memory size of X bytes exhausted.
This is most probably caused by a PHP memory issue.
More information is available here.

How do I install on SourceForge

See this.

Can I downgrade FireStats?

Short answer:
no.
Long answer:
if you did not upgrade the FireStats database in the process of upgrading, you should be able to upload the previous version on top of the current one and it should be fine.
if you did upgrade your database, though luck : the old version will not work with your database and you are stuck with the new version.

How does FireStats stores it's data?

Please see the TablesStructure page.

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 WordPress 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.