Configuration Options ===================== The following is a listing of all configuration options in config.php all along with explanations and example settings. Note, that most options can also be read in a localised version by selecting the "Configuration" link on top of your statistics page. Options affecting the visual presentation ----------------------------------------- $BBC_MAINSITE If this variable has been set, a link to the specified location will be generated. The default value is pointing to the parent directory. In case your main site is located elsewhere, you probably want to adjust the value to suit your needs. $BBC_MAINSITE = "http://www.example.com/"; => Link to the specified URL $BBC_MAINSITE = ".." => Link to parent directory $BBC_MAINSITE = ""; => Show no link $BBC_SHOW_CONFIG BBClone defaults to revealing the stats' settings. In case this behavior isn't desired you can deny access to it by deactivating the option. $BBC_SHOW_CONFIG = 1; => Display show_config.php $BBC_SHOW_CONFIG = ""; => Don't display show_config.php $BBC_TITLEBAR The title being displayed in the navigation bar of all bbclone pages. The following macros are recognised: %SERVER => server name %DATE => the current date $BBC_TITLEBAR = "Statistics for %SERVER generated on %DATE"; $BBC_LANGUAGE BBClone's default language, in case it hasn't been specified by the browser. It's strongly recommended you set your language (if listed) because will encode search engine keywords according to $BBC_LANGUAGE. You can, however, overwrite the default. See explanation of $BBC_CUSTOM_CHARSET for details. The following languages are supported: ar, bg, bs, ca, cs, da, de, el, en, es, fi, fr, hu, it, ja, ko, lt, mk, nb, nl, pl, pt-br, ro, ru, sk, sl, sv, th, tr, zh-cn and zh-tw. $BBC_LANGUAGE = "en"; $BBC_MAXTIME This variable defines the length of an unique visit in seconds. Each hit from the same visitor within this period will be considered as one visit, as long as two successive hits don't exceed the specified limit. Default is the de facto web standard of 30 minutes (1800 seconds), but depending on your needs you may wish to assign a different value. $BBC_MAXTIME = 0; => Treat each single hit as unique $BBC_MAXTIME = 1800; => Treat every hit within 30 minutes by the same visitor as unique visit $BBC_MAXVISIBLE How many entries you want to have listed in the detailed stats? The default value is 100. It's recommended not to set it higher than 500 to avoid too heavy load. A value of "0" will reset the detailed stats. $BBC_MAXVISIBLE = 100; $BBC_MAXBROWSER Defines the number of browsers to be displayed on the global stats. The figures represent unique visits. $BBC_MAXBROWSER = 10; $BBC_MAXEXTENSION Defines the number of countries/extensions to be displayed. The figures represent unique visits. $BBC_MAXEXTENSION = 10; $BBC_MAXHOST Defines the number of hosts to be displayed. Only the actual domain is taken, any prefixes will be omitted. So in most cases this may be a representative listing of the internet access providers your visitors are using as well. The figures are based on unique visits but do not necessarily represent them all (see $BBC_PURGE_SINGLE for details). This listing can be reset any time by changing $BBC_MAXHOST to "0". $BBC_MAXHOST = 10; $BBC_MAXKEY Defines the number of search engine keywords to be displayed. Although the words were extracted from unique visitors, they don't represent the number of unique visits, because one query may contain multiple keywords and not all visitors will come from a search engine. This listing can be reset any time by changing $BBC_MAXKEY to "0". $BBC_MAXKEY = 10; $BBC_MAXORIGIN Defines the number of referrers left by visitors (if any). The figures represent unique visits unless the referrer is changing during a visit. Referrers listed there may also come from spambots or otherwise bad behaving bots. The referrer links are flagged with rel="nofollow" to make bots ignore them, thus taking away the original goal of spamming, which is to boost one's search engine ranking. BBClone omits referrers from identified bots so the noise signal shouldn't be too high. This listing can be reset any time by changing $BBC_MAXORIGIN to "0". $BBC_MAXORIGIN = 10; $BBC_MAXOS Defines the number of operating systems. The figures represent unique visits. The detection depends on the user agent string, so there may be occasions, where BBClone cannot determine an operating system. $BBC_MAXOS = 10; $BBC_MAXPAGE Defines the number of page views. Unlike most other settings this one represents pure hits. This listing can be reset any time by changing $BBC_MAXORIGIN to "0". $BBC_MAXPAGE = 10; $BBC_MAXROBOT Defines the number of bots. Bot is defined as any program or script that does any sort of task automation without any human interaction. So this definition also applies to download managers, feedreaders or bookmark checkers. The figures represent unique visits $BBC_MAXROBOT = 10; $BBC_DETAILED_STAT_FIELDS Contains a comma separated list of all columns to be displayed in the detailed stats. You can choose from: id => The x-th visitor since you've started counting time => The time at which the last hit was registerred visits => The hits of one unique visitor dns => visitor's hostname ip => visitor's ip address os => The operating system (if available and/or no robot) browser => The software used for establishing the connection ext => visitor's country or extension referer => The link from which a visitor came (if available) page => the last visited page search => The search query a visitor used (if available) The order of the list is also representative for the column's arrangement in the detailed stats. $BBC_DETAILED_STAT_FIELDS = "id, time, visits, ip, ext, os, browser"; $BBC_DETAILED_STAT_FIELDS = "date, ext, browser, os, ip"; $BBC_DETAILED_STAT_FIELDS = "id, time, ext, dns, visits, os, referer"; $BBC_TITLE_SIZE BBClone's top title bar. Size is in "pt". $BBC_TITLE_SIZE = 14; $BBC_SUBTITLE_SIZE BBClone's subtitles. Size is in "pt". $BBC_SUBTITLE_SIZE = 9; $BBC_TEXT_SIZE Ordinary text and column names in time stats. Size is in "pt". $BBC_TEXT_SIZE = 8; $BBC_NUM_SIZE Numeric data within the time stats' charts. Size is in "pt". $BBC_NUM_SIZE = 7; Options affecting BBClone's functionality ----------------------------------------- $BBC_TIME_OFFSET In case the server time doesn't match your local timezone, you can adjust the time in minutes by using this switch. Negative values will set back the time, positive ones will set it forth. $BBC_TIME_OFFSET = 300; => Set time forth by 5 hours (5 x 60 min) $BBC_TIME_OFFSET = -300; => Set time back by 5 hours (5 x 60 min) $BBC_TIME_OFFSET = 0; => Use the server time "as is" $BBC_NO_DNS This options defines, whether IP addresses should be resolved to hostnames or not. While hostnames tell a lot more about the visitor, resolving them may considerably slow down your site, if the DNS servers used are slow, limited in their capacity or otherwise unreliable. Setting this variable may solve the problem. $BBC_NO_DNS = ""; => resolve addresses to hostnames $BBC_NO_DNS = 1; => turn off name resolving $BBC_NO_HITS BBClone's default is to show hits in the time stats, because it gives a quite useful Impression from the actual server load. If, however, you prefer to use unique visits as base for your time stats, you can change the way of counting by setting this variable. $BBC_NO_HITS = ""; => Show hits in time stats $BBC_NO_HITS = 1; => Show unique visits in time stats $BBC_IGNORE_IP This option can be used to exclude particular IP addresses or address ranges from counting. In case you want to add several expressions, use a comma as separator. This option does not accept any hostnames, you first have to convert them to ip addresses. You can, however, leave off octetts from right to left in order to block ip ranges (as illustrated in the example below). $BBC_IGNORE_IP = "127., 192.168."; => Ignore specified ranges $BBC_IGNORE_IP = ""; => Don't ignore anything $BBC_IGNORE_REFER In case you don't want to have particular referrers from your visitors listed in your ranking or detailed stats, you can define a comma separated list of keywords, each referrer will be checked against with. BBClone uses two variants of detection: If the expression starts with a slash, it will be considered a part of the referrer uri. This is useful for blocking unwanted sites on freehosts If the expression doesn't start with a slash, it will be compared with the referrer host only. This is useful for specifying unwanted hosts without accidentally blocking legitimate referrers from visitors $BBC_IGNORE_REFER = "spambot.org, /v1agr4/"; => Ignore specified matches $BBC_IGNORE_REFER = ""; => Don't ignore anything $BBC_IGNORE_BOTS You can use this option to determine the treatment of robots. The default is to ignore them in the top hosts ranking but leave them in the remaining stats. If you don't want to see any robots at all you can set this option to "2", then only human visits will be taken into account. $BBC_IGNORE_BOTS = 2; => Completely ignore robots $BBC_IGNORE_BOTS = 1; => Don't list hostnames of robots $BBC_IGNORE_BOTS = ""; => Treat robots as normal visitors $BBC_IGNORE_AGENT This option defines how BBClone tells one visitor from another. Default is to use the IP address only, which provides realistic figures in most cases. If, however, your visitors often are hidden behind proxy servers, deactivation of this option could provide more realistic figures, since a new visitor will be assumed by the time the user agent has changed. $BBC_IGNORE_AGENT = 1; => Ignore different user agents of one visitor $BBC_IGNORE_AGENT = ""; => Treat each user agent change of one visitor as separate visit Miscellaneous Options --------------------- $BBC_DEBUG BBClone doesn't display any messages in its counting mode. Time and again, however you may wish to see what BBClone is doing or why it no longer is working. That's what the debug mode is for: If you activate it, you'll get a lot of lengthy messages, which should help you with your problem in most cases. Remember to turn this mode off again, as it isn't meant to run permanently. $BBC_DEBUG = ""; => Run BBClone in its counting mode $BBC_DEBUG = 1; => Turn on debugging for troubleshooting $BBC_KILL_STATS Whenever you wish to reset your stats you can activate this switch and have them deleted by the next visit. Don't forget to deactivate it afterwards, else you'll probably experience unusually low traffic ;). $BBC_KILL_STATS = 1; => Erase all collected data $BBC_KILL_STATS = ""; => Keep all collected data $BBC_USE_LOCK Before BBClone writes to a file it attempts to lock the file to prevent it from being corrupted. Should BBClone complain that it would not be able to lock files you can set an alternative method by using this switch. As a rule of thumb you should use the method BBClone is suggesting unless you have a very good reason not to use it. Possible options are "dio", "flk" and "sem" $BBC_USE_LOCK = "flk"; => flock() (WinNT/2k/XP/2k3, Unix/MacOs X) $BBC_USE_LOCK = "sem"; => SysV Semaphores (PHP >= 4.1.0 and Unix/MacOs X only) $BBC_USE_LOCK = "dio"; => Direct I/O (PHP >= 4.2.0 and Unix/MacOs X only) $BBC_PURGE_SINGLE Host, referrer and keyword stats can generate a huge amount of data, however mostly caused by one time visitors. By enabling this switch you can purge these entries and considerably shrink access.php in its size without affecting your actual visible host and referrer ranking. $BBC_PURGE_SINGLE = 1; => Purge single host, referrer and keyword entries $BBC_PURGE_SINGLE = ""; => keep all entries $BBC_CUSTOM_CHARSET In case there's no translation for your language or you want to use a particular character set, you can overwrite the language used for converting keywords by setting your desired encoding here. $BBC_CUSTOM_CHARSET = "UTF-8"; => Use UTF-8 as encoding $BBC_CUSTOM_CHARSET = ""; => Use the default charset of the translation The BBClone team