bbclone/0000755000175000001440000000000010557134715011660 5ustar cbrillusersbbclone/css/0000755000175000001440000000000011261776202012444 5ustar cbrillusersbbclone/css/justrobots.css0000644000175000001440000000131711246442246015377 0ustar cbrillusers.dropshadow1 { margin: 3px; padding: 0px; border: 1px #e8ebf4 solid; /* outer shadow */ } .dropshadow2 { background-color: #c5cad9; /* inner shadow */ margin: 0px; padding: 0px; border: 1px #dfe3ef solid; /* mid shadow */ } .shadbox { position: relative; background-color: #fff; margin: 0px; padding: 0px; border: none; top: -2px; left: -2px; } .sh_label p {color:#aaa;} .sh_label { float:left; position:relative; left:4px; bottom:0px; } :root .sh_label {bottom:10px !important; margin-bottom:-10px;} /* Moz sees this, Opera and IE don't. It's valid CSS3. */ tr.human {display:none;} a#robotslink {color:#000;text-decoration:none;} .titlebar{background:url(../images/hdr.jpg) repeat-x center;}bbclone/css/justhumans.css0000644000175000001440000000131711246442246015362 0ustar cbrillusers.dropshadow1 { margin: 3px; padding: 0px; border: 1px #e8ebf4 solid; /* outer shadow */ } .dropshadow2 { background-color: #c5cad9; /* inner shadow */ margin: 0px; padding: 0px; border: 1px #dfe3ef solid; /* mid shadow */ } .shadbox { position: relative; background-color: #fff; margin: 0px; padding: 0px; border: none; top: -2px; left: -2px; } .sh_label p {color:#aaa;} .sh_label { float:left; position:relative; left:4px; bottom:0px; } :root .sh_label {bottom:10px !important; margin-bottom:-10px;} /* Moz sees this, Opera and IE don't. It's valid CSS3. */ tr.robot {display:none;} a#humanslink {color:#000;text-decoration:none;} .titlebar{background:url(../images/hdr.jpg) repeat-x center;}bbclone/css/global.css0000644000175000001440000000126511246442246014423 0ustar cbrillusers.dropshadow1 { margin: 3px; padding: 0px; border: 1px #e8ebf4 solid; /* outer shadow */ } .dropshadow2 { background-color: #c5cad9; /* inner shadow */ margin: 0px; padding: 0px; border: 1px #dfe3ef solid; /* mid shadow */ } .shadbox { position: relative; background-color: #fff; margin: 0px; padding: 0px; border: none; top: -2px; left: -2px; } .sh_label p {color:#aaa;} .sh_label { float:left; position:relative; left:4px; bottom:0px; } :root .sh_label {bottom:10px !important; margin-bottom:-10px;} /* Moz sees this, Opera and IE don't. It's valid CSS3. */ a#bothlink {color:#000;text-decoration:none;} .titlebar{background:url(../images/hdr.jpg) repeat-x center;} bbclone/css/general.css0000644000175000001440000000552311246442246014601 0ustar cbrillusers/* DON'T CHANGE THESE OPTIONS UNLESS YOU KNOW WHAT YOU ARE DOING! SAVE A BACKUP! */ body { margin: 0px; padding: 0px; background-color: #edf0f9; } /* redefined tags */ p { font-family: Arial,Helvetica,sans-serif; color: #3c4154; } /*p {font-size} is defined by $BBC_TEXT_SIZE (config.php)*/ td { font-family: Arial,Helvetica,sans-serif; color: #3c4154; } /*td {font-size} is defined by $BBC_TEXT_SIZE (config.php)*/ input { border: 1px solid #606680; background-color: rgb(237, 240, 249); vertical-align: middle; } select { border: 1px solid #606680; background-color: rgb(237, 240, 249); vertical-align: middle; } /* links styles */ a { text-decoration: underline; color: #e7496b; } a:hover { text-decoration: none; color: #606680; } /* navbar */ a.navbar { padding: 3px; font-family: Arial,Helvetica,sans-serif; text-decoration: none; color: #606680; } /*a.navbar {font-size} is defined by $BBC_SUBTITLE_SIZE (config.php)*/ a.navbar:hover { border: 1px solid #606680; padding: 2px; font-family: Arial,Helvetica,sans-serif; text-decoration: none; background-color: #edf0f9; } /*a.navbar hover {font-size} is defined by $BBC_SUBTITLE_SIZE (config.php)*/ .navbar { margin: 0px; padding: 10px; font-family: Arial,Helvetica,sans-serif; color: #98a3d1; font-weight: bold; vertical-align: middle; } /*.navbar {font-size} is defined by $BBC_SUBTITLE_SIZE (config.php)*/ .navbar img { vertical-align: middle; } /* modpack charts */ .graphbar { background-color: #808ebf; } .graphbarcolor { background-color: #e5f2f7; } /* titlebar */ .titlebar { color: #ffffff; font-weight: bold; } /*.titlebar {font-size} is defined by $BBC_TITLE_SIZE (config.php)*/ /* stats */ .head { padding: 3px; font-family: Arial,Helvetica,sans-serif; text-align: center; font-weight: bold; white-space: nowrap; } /*.head {font-size} is defined by $BBC_TEXT_SIZE (config.php)*/ .graph { padding: 3px; font-family: Arial,Helvetica,sans-serif; color: #606680; } /*.graph {font-size} is defined by $BBC_NUM_SIZE (config.php)*/ .capt { font-weight: bold; color: #ffffff; white-space: nowrap; } /* boxes */ .cntbox { border: 1px solid #606680; background-color: #ffffff; } .detbox { border-style: solid none; border-color: #606680; border-width: 1px; background-color: #ffffff; } .gridbox { border: 1px solid #606680; margin: 0px; } /* border madness */ .brd { border-color: #606680; border-width: 1px; } .collapse { border-collapse: collapse; } /* collapse where 1px borders are needed */ .rows { border: 1px solid #ffffff; margin: 0px; } .sky { border-color: #e5f2f7; border-width: 1px; } table { border-collapse: collapse; } tab\le {border-collapse: separate;} /* evil hack for Opera 7+ */ /* evil hack for IE5 Mac: */ /*\*//*/ td table { width:97%; margin:0px 1px 0px 0px; padding:0px } /**/ /* an internal style hack for IE is also applied. See html.php or the source of any BBClone page */bbclone/css/bbclone.css0000644000175000001440000000003010545763773014570 0ustar cbrillusersa img { border: none; }bbclone/doc/0000755000175000001440000000000011261773554012430 5ustar cbrillusersbbclone/doc/options.txt0000644000175000001440000003144711261773545014675 0ustar cbrillusers/* This file is part of BBClone (The PHP web counter on steroids) * * $Header: /cvs/bbclone/doc/options.txt,v 1.13 2009/08/30 09:35:45 joku Exp $ * * Copyright (C) 2001-2009, the BBClone Team (see file doc/authors.txt * distributed with this library) * * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation; either version 2 of the License, or * (at your option) any later version. * * See doc/copying.txt for details */ 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, id, it, ja, ko, lt, mk, nb, nl, pl, pt, pt-br, ro, ru, sk, sl, sv, th, tr, ua, 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 bbclone/doc/install.txt0000644000175000001440000002116311261773541014636 0ustar cbrillusers/* This file is part of BBClone (The PHP web counter on steroids) * * $Header: /cvs/bbclone/doc/install.txt,v 1.30 2009/08/30 09:35:45 joku Exp $ * * Copyright (C) 2001-2009, the BBClone Team (see file doc/authors.txt * distributed with this library) * * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation; either version 2 of the License, or * (at your option) any later version. * * See doc/copying.txt for details */ The following description applies to a generic BBClone installation, that does not reflect particular weblogs/content management systems. For this purpose it's recommended you take a look at our links page first, which features a listing to external resources. Setup ===== If you are a Windows user you should prefer the *.zip package because its included documentation uses Windows style formatting, which means it will be readable in applications like Notepad, too. If your favorite editor hasn't got a problem with Unix formatted documents, you can also download the *.tar.gz archive. There are two ways to upload BBClone via FTP. Either you upload the package and extract it on the server or you upload the already extracted files. As a rule of thumb, whenever shell access is available, you should extract the archive on the server because it will save you a lot of time and ensures all files are copied to their destination. If there's no shell access or you simply don't know how to operate on such a shell you can upload the single files to your server. But be aware there are a couple of pitfalls: Your FTP client must have been configured to treat *.php, *.inc and *.png files as binary files. Uploading them in ascii mode may break the application or result in broken images. Ask your FTP client's vendor how to configure it, if you feel unsure about it and its documentation doesn't give any hints You have to double check whether really all files have been copied to their destination. Sometimes it happens that FTP servers unexpectedly shut down the connection or runs into a timeout if there's a large amount of files. Your FTP client should offer options to resume incomplete files and skip already existing files of the same size. It will make your life much easier It's a good idea to make something like a sketch about the documents structure on your server. You need to know the path to your BBClone installation directory and how to get there from each point of your site you wish to monitor the traffic. Example: www.example.com | index.php (1) | | |----bbclone/ | | |----subdirectory/ | | | index.php (2) The path to BBClone in document (1) would be "bbclone/", because "index.php" resides in the root directory. But be aware of document (2). It's path is different, because it's path starting from the www-root is actually "subdirectory/index.php". In other words at the same level as the BBClone directory. So in order to get to the BBClone directory we need to move one level up and then enter the BBClone directory. That's why the path to BBClone for document (2) is "../bbclone/. The ".." tell the server to move to the parent directory first. If you browse BBClone's directory you'll notice a directory called "var/". In Unix land, a var directory contains frequently alterred files, typically stuff like logs or data bases would be stored there. BBClone will store its data there, but in order to do so the server needs to be allowed to write to some files. The files are: counter[0-15].inc -> contains the raw connection data of a visitor access.php -> contains the data used for global and time statistics last.php -> contains the data used for detailed statistics .htalock -> lockfile needed while writing to the files mentioned above To make these files writable for the server apply the "chmod" command. If your server doesn't know "chmod" contact your hosting company for getting the appropriate command. If your PHP runs as Apache module then "chmod 666" will be the right command. "644" won't work because the server accesses the file as a different user, which would restrict access to read-only, as "644" would only grant write access for the owner. If your PHP runs as cgi-binary then "chmod 644" may already be sufficient, since the server will use your user id for accessing the files. If unsure, use "chmod 666". Now the code needs to be added to the files you wish to monitor. It's a good idea to create a test file at first to see whether BBClone is already working. To do you can use the following sample and point your browser to it. Attention! You have to customise this snippet to suit your needs. _BBC_PAGE_NAME contains the title you want to use for the page. This title will be displayed in your stats later. _BBCLONE_DIR The path to the BBClone directory. Remember the sketch from 1.3? Now you need the result of your preparation for setting this variable. You may need to change this entry depending on the file's location. If unsure, please reread section 1.3. Don't forget the trailing slash at the end of the directory. You can also use the following snippet: define("_BBCLONE_DIR", "bbclone/"); define("COUNTER", _BBCLONE_DIR."mark_page.php"); if (is_readable(COUNTER)) include_once(COUNTER); ?> This time we left out the page title. If BBClone doesn't find one it will automatically create one derived from the file's path. This is useful if you have a lot of pages and want to automate the naming process. Now that we tested anything and found it working, we can go on to register visits. The "traditional" method requires *.php pages. You also need to have permissions to run PHP (of course). If you want to put your code somewhere else the file needs to be included into a *.php file eventually, so the server recognises it and is able to run the PHP interpreter. Inside of PHP files not everything is necessarily PHP code. Sometimes passages of code alter with pure html. each PHP codeblock is started with "". If you want to add the code within such a PHP code block, you will have to write: define("_BBC_PAGE_NAME", "Test"); define("_BBCLONE_DIR", "bbclone/"); define("COUNTER", _BBCLONE_DIR."mark_page.php"); if (is_readable(COUNTER)) include_once(COUNTER); (or without the page title, see 1.4 for details) If however you're outside of such a block and find nothing but html tags then you need to add the php enclosings so the server knows it has to parse this passage as PHP code. Please note that the server can't run php from within a *.html file. In this case you would see the counter code "as is" in the html source If you run an apache server and are allowed to use .htaccess you can even monitor your *.html pages without ever editing or renaming them. Attention: THE FOLLOWING CODE ISN'T GUARANTUEED TO RUN EVERYWHERE. IF IT DOESN'T WORK FOR YOU THERE'S NOTHING TO BE DONE ABOUT IT. 1. Add the following to your .htaccess: AddType application/x-httpd-php .htm .html php_value auto_append_file "/the/path/that/leads/to/count.php" The path needs to be a local absolute path like the example above. Create the file "count.php" and add the following: In our example "count.php" is situated in the www-root. If your files are located elsewhere you need to modify the paths accordingly (see 1.3). An absolute path is required to make this snippet work. If you don't know the absolute path to your BBClone directory you can do the following: Go to your bbclone directory, open index.php in your favorite editor and add the line: echo "<?php\n" ."define("_BBCLONE_DIR", "" .dirname(__FILE__)."/");\n" ."define("COUNTER", _BBCLONE_DIR."" ."mark_page.php");\n" ."if (is_readable(COUNTER)) include_once(COUNTER);\n" ."?>\n"; Point your browser to it, copy and paste the output and save it into a file as "count.php" (to stick with our example). Don't forget to remove the line from index.php afterwards else it will be displayed each time you call your stats. Now the following will happen: Each time someone calls one of the ".htm" or ".html" pages the code snippet with the counter code will be automatically appended. BBClone will automatically create a page title derived from the file's path which will be used in the page stats then. The BBClone Team (c) 2004 bbclone/doc/thanks.txt0000644000175000001440000000717711261776213014470 0ustar cbrillusers/* This file is part of BBClone (The PHP web counter on steroids) * * $Header: /cvs/bbclone/doc/thanks.txt,v 1.45 2009/08/30 09:35:45 joku Exp $ * * Copyright (C) 2001-2009, the BBClone Team (see file doc/authors.txt * distributed with this library) * * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation; either version 2 of the License, or * (at your option) any later version. * * See doc/copying.txt for details */ Thanks go out to: * paHpa. * Niek Van der Maas for his Dutch translation of BBClone. * Erik Englund for his Swedish translation of BBClone. * Jonathan Fromer for his Danish translation of BBClone. * Andreas Liebschner for his Italian translation of BBClone. * Darek Kramin for his Polish translation of BBClone. * Henrik Sorensen for his bug detection in bbc_plot(). * Matteo Spreafico for his Italian correction. * Hu ChangSong for his Chinese translation * Ciprian Manea for his Romanian translation * Neil Muller for his suggestions on making bbclone work with register_globals off * Carlos Oliva for his Spanish translation * Vilius Simonaitis for his Lithuanian translation * Chad Schmidt for his numerous corrections * Gregori Arjona for his Catalan translation * Engelbert Gruber for his suggestions on correcting fopenlock() * Josef Pinc for his Czech translation * John Marino and Njrd Eriksson for their help in tracking down critical BBClone issues connected with high server load * Thijs Kaper for his valuable suggestions concerning locking and writing to files * Martin Halachev for his Bulgarian translation and his submitted patches * Alexey Rozenvaser for his Russian translation * Ville Pohjanheimo for his Finnish translation * Serkan Sisman for his Turkish translation * Taras Pavliv for his Ukrainian translation * Franois Pradignac for his MacOs X specific detection patterns, bug reports, CSS fixes and French translation updates * Daniele Raffo for updating the Italian translation and his translation of install.txt * Katsunori Shiota for his Japanese translation * Bryant Quan for providing access to an IIS server to study its behavior * Clopy for his Greek translation * Vladislav Korotkov for updating and completing the Russian translation * Sndor Dibuz for his Hungarian translation * Hans Fredrik Nordhaug for his Norwegian (Bokml) translation * Oriol Torra Sellares for fixing and updating the Catalan translation * Luke Woodward for adding missing flags and code suggestions * Rok Potonik for his Slovenian translation * Daniel Bergman for updating the Swedish translation * Zdeno Sekerak for his Slovak translation * Nanna Ellegaard for updating and fixing the Danish translation * Pavel Trefil for updating the Czech translation * Damian at Systrum.net for providing decent background noise whilst being busy with coding * Peter Hou for reviving the Traditional Chinese translation. * Paul Bischoff for updating the Danish translation * Miralem Halilovic for translating BBClone into Bosnian * Georgi Stanojevski for translating BBClone into Macedonian * Dr. Wael for translating BBClone into Arabic * Leppa for updating both Ukrainian and Russian translations * Ionnis Cherouvim for updating the Greek translation * Harald Janssen for updating the Spanish translation * Isriya Paireepairit for translating BBClone into Thai * Firejune for translating BBClone into Korean * Antonio de la Torre for updating and completing the Spanish translation * Yudie Hidayat for translate BBClone into Indonesian * Rui Pinto for translate BBClone into Potruguese * Kaarel Hellakivi for translate BBClone into Estonian bbclone/doc/faqs.txt0000644000175000001440000005244011261773536014130 0ustar cbrillusers/* This file is part of BBClone (The PHP web counter on steroids) * * $Header: /cvs/bbclone/doc/faqs.txt,v 1.22 2009/08/30 09:35:45 joku Exp $ * * Copyright (C) 2001-2009, the BBClone Team (see file doc/authors.txt * distributed with this library) * * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation; either version 2 of the License, or * (at your option) any later version. * * See doc/copying.txt for details */ BBCLONE FAQS ============ I installed BBClone and now it doesn't work ------------------------------------------- The first step should be to activate debug mode in config.php by setting $BBC_DEBUG = 1; Then load your page in your browser once more. You should see some verbose messages, which may already help you solving your problem. READ THE DOCUMENTATION BEFORE GOING AHEAD! Sometimes a particular server configuration may be not yet compatible with BBClone, then you may see messages triggered from the PHP interpreter. Saving them into a file for later reference is a good idea, because this very message can contain valuable informations for the developer in order to address the problem. If you haven't got the latest version of BBClone running, this would be the moment to install it. Sometimes the bug will be mentioned in the Changelog, if not it may have been fixed as side effect of other code changes. If you still see your error, visit the forum and perform a search whether the bug already has been discussed. If you can't find the topic it's likely you found a bug the BBClone team hasn't been aware of and should report it by posting a message in our forums. Don't wait for others doing the job, because chances are the bug has a specific nature and other people usually don't stumble upon it. When reporting, please be descriptive about what exactly you are seeing (exact error message would be great), what you already tried and on what platform BBClone is running. How do I upgrade from BBClone 0.3x? ----------------------------------- The following procedure has proved as a safe and reliable method: - make a backup of access.php which resides in the var/ directory of the BBClone installation. It contains your stat data - Copy all files of the package to your bbclone directory and overwrite all files, including conf/config.php. - Take your backup of access.php and copy it to the var/ directory of your BBClone installation - Make everything except .htaccess writable in the var/ directory. In case you made a backup of some settings, make sure you just insert the values and not variables and values, because some variables were renamed That's it. Your detailed stats will be reset because of some internal changes, but your collected stats will remain intact. How do I upgrade from BBClone 0.4x? ----------------------------------- The following procedure has proved as a safe and reliable method: - Copy all files of the package except the var/ directory and its contents to your bbclone directory and overwrite all files except the var/ directory and its contents, including conf/config.php. - Reconfigure BBClone. There are a couple of options which may be of interest for you that have been recently added and aren't turned on by default. They are listed in the file doc/options.txt. What permissions do I have to set for BBClone? ---------------------------------------------- You need to make counter[0-15].inc, lock, access.php and last.php in the var/ directory of your BBClone installation writable for the server, which is in most cases by applying chmod 666. In case you have shell access, use the following commands: chmod 666 * chmod 666 lock You need to use it twice because the first wildcard will ignore hidden files. IIS may use a different command, please consult your documentation regarding it. Attention Windows users: You have to make the var/ directory writable for the server, else PHP is unable to write to the files inside. This is an inconsistency in the NTFS file system, hence it can't be fixed by the BBClone team. If your PHP installation acts as cgi and scripts are executed under your user id it's sufficient to have them chmod'ed to 644. Rule of thumb: If you see BBClone complaining about read-only files as comment in the generated HTML source you can assume that the current permissions are insufficient. I installed BBClone and now application xxx no longer works and I'm getting --------------------------------------------------------------------------- errors about already defined functions. --------------------------------------- Your application is using the same function names as BBClone. Upgrading to version 0.4.1 solves the issue as a common prefix for all functions will be used. Why is BBClone still not working with application xxxxx though the problem has ------------------------------------------------------------------------------ been around for/since...? ------------------------- Because none of the developers is using application xxxxx and nobody was notifying them that a problem would exist with it. BBClone can only work as good as people participate in reporting problems. BBClone doesn't work and I only see the inclusion in the source --------------------------------------------------------------- You put the inclusion into a *.htm, *.html page. This doesn't work because the server only will use the php interpreter if the file itself is marked as php page. Thus you either have to rename the file to *.php first or add the line: AddType application/x-httpd-php .htm .html to .htaccess in order to make it work with BBClone. Please note, that BBClone does require PHP and doesn't run on accounts which are only allowed to use html. Also you may not be allowed to define options in your .htaccess or to use .htaccess at all. BBClone doesn't work and I can't see any status at all in the source -------------------------------------------------------------------- There are quite a few possibilities: - The directory you specified in your inclusion doesn't contain a trailing slash. This, however, is necessary for getting a valid path to the counter. - The file "config.php" can't be read by the server. Either because it's missing or an invalid path was specified to it - You entered a path like: http://myserver.com/mybbclone/ as _BBCLONE_DIR. This doesn't work because BBClone relies on relative paths. - You are running Solaris with a PHP version older than 4.3.1. Usage of relative paths is broken in these versions. A workaround would be using absolute local paths for both the inclusion and the paths specified in constants.php BBClone prints the following message in debug mode: --------------------------------------------------- File xxxxx is read-only. You may have to check whether it has the right permissions or is even missing It means that BBClone failed to write to a file which is needed for counting. You will have to make that fail writable for the server File demo/var/lock is inaccessible. You may have to check whether it has the right permissions or is even missing. You did not include the file "lock" which is necessary for writing to access.php and last.php. If you upgrade from an older installation, please include all files from the package. BBClone isn't able to read its configuration data. This is likely because you embedded BBClone's code snippet into a function. Please use BBClone as suggested in the documentation You may face this message after you have included the snippet into a header or footer of an content management system which is including its files via functions (often accompanied with a html code cleanup function). In this case you need to place the snippet elsewhere until the message is gone. This is a known limitation of BBClone and will be addressed in later revisions. File xxxxx is inaccessible. You may have to check whether it has the right permissions or is even missing The reasons why files are missing are mostly related to the file transfer. Either the connection was closed from the remote site (also responsible for missing icons) or the FTP client's settings prevented uploading of all files. You have to make sure that the client uploads files from all directories (recursive), updates the remote files even if they are present and that the client automatically creates directories if missing. BBClone isn't able to lock files for writing with its current setting. You may use $BBC_USE_LOCK = "yyy"; in config.php however The standard method of locking files isn't working for you. If an alternative is offered, you only need change the setting according to the printed suggestion and your problem should be solved. If no alternative is offered, however you cannot run BBClone, because flat files need to be locked for writing in order to avoid file corruption. If you are using Win95/98/ME as server OS there's no workaround because these systems don't contain a locking mechanism which is needed for updating the stats. If this is happening with Windows XP check whether "Use simple file sharing" in "Tools" -> "Folder Options" -> "View menu" is checked. If so, uncheck it in order to get the traditional NT security tab in which you can set the permissions. BBClone doesn't count though it states everything would be ok ------------------------------------------------------------- This is a Windows specific problem: Contrary to MacOs X and other Unix like systems, Windows' NTFS file system can't write to files inside of a read-only directory. Unfortunately there's a bug in NTFS which causes the system to return "true" if PHP checks whether a file can be written to where it should return "false". The solution is to make the var/ directory writable for the server. Attention: You'll have to use the "security" tab of your file properties menu to modify the setting. BBClone spits "permission denied" and "failed to open stream" messages ---------------------------------------------------------------------- BBClone checks whether it's allowed to write to a file before doing so. This will work as long as the file system is returning the correct state to PHP. Some filesystems like NTFS however may return flags, that PHP 4.x don't understand and then it will result in error messages despite having an error handler. If this is happening on Windows, you'll need to check, whether you granted write permissions to both BBClone's var directory and the files inside (except .htaccess which should remain readable). Please note that you have to change the settings of the security tab and not the casual file properties dialog. In fact, both tabs can contradict each other and cause unexpected behavior. A workaround for these issues has been implemented in PHP 5.x, so that even on Windows with NTFS PHP will work as expected. My detailed stats only have one entry that gets constantly overwritten ---------------------------------------------------------------------- You set one of the following options to "0" or "": $BBC_MAXHOST, $BBC_MAXKEY, $BBC_MAXORIGIN, $BBC_MAXPAGE, $BBC_MAXVISIBLE. By the time you've set it like this, BBClone assumes you want to reset one of these categories. But each reset requires the reset of last.php as well, because otherwise this file would contain invalid data. I'm using "sem" as locking method and keep getting "Warning: semget() failed for -------------------------------------------------------------------------------- key xxxxx: No space left on device in xxxxx" -------------------------------------------- Your server does not allocate sufficient resources for SysV Semaphores to use them for locking files. In case you have root access you should modify the system settings to increase them. Otherwise you can try whether you can use "dio" or the default "flk" as value for $BBC_USE_LOCK in config.php. If that's not possible either it probably means that BBClone won't work for your server configuration. Some of my visitors are displayed with my server's ip address / hostname ------------------------------------------------------------------------ This problem can occur with some MacOs X configurations. Updating to BBClone 0.4.6b solves the problem. BBClone doesn't display special characters in keywords correctly ---------------------------------------------------------------- This was due to a problem with UTF-8 encoded strings and had been solved in BBClone 0.4.4 and higher. But I do use the latest version and still the keywords are messed up -------------------------------------------------------------------- BBClone doesn't clean up old keywords, because they can't be recovered in a useful way. But you can reset the keyword counter in BBClone 0.4.6b by setting $BBC_MAX_KEY to "0". In case you are seeing messy keywords with a fresh install or newly added keywords, chances are that your PHP version doesn't provide support for either mbstring, iconv or gettext. If Japanese or Chinese is your page's language you probably didn't set the correct value for $BBC_LANGUAGE. I'm randomly losing my stats ---------------------------- If this is happing with 0.33.5 up to 0.33.6pre it means, flock() wasn't able to protect the files from being corrupted by other processes. This usually happens, if multiple servers (not visitors!) try to write to the counter files simultaneously. Upgrading to 0.4.0 and greater adds an additionial layer of locking and will cure the issue in most cases. Remaining issues were related to race conditions triggered by slow name resolving. This problem was first addressed in BBClone 0.4.4 RC4. Note that by its design BBClone isn't suitable and useful for high traffic sites. BBClone slows down my page as hell ---------------------------------- DNS resolving is too slow or unreliable in your network. If it's within a local Windows network: Your machines don't know each other. Adding them in each of the machines' "hosts" file should solve the issue (except you got slow and unreliable DNS servers). If you can't change the configuration set $BBC_NO_DNS to "1", this will turn off hostname lookups. BBclone randomly fails to determine the visitors' country or displays obviously ------------------------------------------------------------------------------- wrong results ------------- You are using the wrong ip2ext database for your BBClone installation. If your version is 0.4.0 RC1 to 0.4.1 you have to use ip2ext-old. BBClone 0.4.2 RC1 and newer will need ip2ext-new. BBclone doesn't resolve ip addresses or extensions to countries --------------------------------------------------------------- Check the permissions of the files inside of the ip2ext directory, whether they are reasable for the server. If this is happening after an upgrade you didn't copy the ip2ext directory, which contains the country information. I want to track htm/html files with the .htaccess method but it doesn't work ---------------------------------------------------------------------------- There can be numerous reasons for it: - Your pages use XHTML or XML and PHP is configured with short_open_tag set to "On". In this case PHP will attempt to parse XML data as PHP which is likely to fail with either a blank page or a parse error. In this case the workaround is to add the following option to .htaccess: php_value short_open_tag "Off" This will instruct PHP to parse tags only - Your path to the BBClone installation is invalid. It has to be an absolute local path - You didn't add: AddType "application/x-httpd-php .htm .html" to your .htaccess - You aren't allowed to use this feature - You don't use an Apache server or aren't allowed to use PHP - A BBClone configuration error (see "BBClone doesn't work and I can't see any status at all" for more details) BBClone doesn't show any referrers from my visitors --------------------------------------------------- Either you are using frames and put the inclusion into one of the frame pages or you put it into an php page which will be bound into the main page (ie. header or footer file). The visitors' referrer from external sites, however, is only kept for the first document requested, which will be either the frameset or the first included php file. Hence all pages loaded afterwards only will refer to local pages (in the order they've been called). Adding the inclusion into the frameset or the first included document should make the problem go away. But my page doesn't use any frames and still I don't get referrers ------------------------------------------------------------------ Some sellers of toplevel domains simply create a framed redirect to your actual location. As a result your page is caught in a frame and therefore referrers can't be fetched. If that's not the case either, there's a huge change that your site is running on a server with a broken iconv implementation. In such cases, the character conversion will be aborted and cause the keywords to be omitted. In case your server has support for mbstring upgrading to BBClone 0.4.6b should solve the problem and make the keywords reappear. I run a couple of different sites and don't want to have them listed in my -------------------------------------------------------------------------- referrer ranking. How do I archieve that? ----------------------------------------- For this constellation BBClone offers $BBC_IGNORE_REFER as feature. It accepts hostname or parts of it as input and whenever a referrer matches the host on that list, they'll be ignored and treated as empty. You can also use a comma separated list if there are more sites you wish to ignore. I'm running a blog and get lots of fake referrers from spam bots. What can I do? -------------------------------------------------------------------------------- See previous point. You can use $BBC_IGNORE_REFER to block unwanted referrers. If the spambot never changes its hostname, you can save a lot of typing by simply adding its ip address (displayed in the page history) to your $BBC_IGNORE_IP list. A spammer completely messed up my referrer ranking. Is there a way to reset it? ------------------------------------------------------------------------------- As of BBClone 0.4.6b you can reset your referrer ranking by setting $BBC_MAX_ORIGIN to "0". My hostname listing in the global stats doesn't contain any entries ------------------------------------------------------------------- You upgraded from BBClone 0.3.x and didn't overwrite your config.php file as suggested. As a result a couple of variables are now missing, and missing variables will be read as if an option has been deactivated. I upgraded BBClone and now I'm getting the error "called to undefined --------------------------------------------------------------------- function..." ------------ You didn't overwrite all files when upgrading or overwrite new files with old versions. When upgrading, however, it's safe to leave your access.php and, if available, last.php in order to keep your collected stats. BBClone doesn't ignore my hostname and put it on the blacklist, though I did ---------------------------------------------------------------------------- enter it correctly ------------------ $BBC_IGNORE_IP only accepts IP addresses or parts of it (read from left to right). If you wish to block a particular hostname you may like to use the following as workaround in your config.php: $BBC_IGNORE_IP = gethostbyname("my.host.name.org"); This way it will be turned into an ip address first and the restriction no longer applies. You may also like to apply this workaround if you haven't got a static IP address but a static hostname (ie. from Dyndns or No-ip) so the correct address is being blocked without the necessity of manually changing it. In case you upgraded from an older BBClone version, you should know that $BBC_IGNOREIP in BBClone 0.3x was renamed to $BBC_IGNORE_IP as of 0.4.0 RC1. Hence you can't simply copy and paste the line without adding an underscore to the variable. It's suggested to copy values only, since variable names are subject to changes in future versions. Why didn't you reply to my inquiry I sent via the contact form? --------------------------------------------------------------- Probably because the mail - was sent with an invalid reply address - was about download problems - server is rejecting the responses - contained questions about subjects already covered in the FAQ - lacked a useful problem description (just "doesn't work" isn't) - sounded like an order what has to be done and/or fixed - abused the support offer for things unrelated to BBClone - sounded like spam and/or social engineering - was of an insulting nature or sounded like a trolling attempt The BBClone download doesn't work --------------------------------- If it's only happening with a particular browser it means it is broken and you either have to update it or use a different product. If it's happening with any tool, however, it means that either an application firewall or proxy server is intercepting your download attempts. Contact your administrator or your vendor's support to discuss the issue. Why doesn't BBClone come along with an install script? ------------------------------------------------------ Because then all files would be owned by the server (except for PHP running as CGI) and cause various issues an ordinary user may not be able to solve on one's own like not being able to edit, replace or delete files. Apart from that, putting the inclusion into your pages can't be automatically done anyway so there's little gained by an install script. The BBClone team bbclone/doc/changelog.txt0000644000175000001440000006461511261773532015130 0ustar cbrillusers/* This file is part of BBClone (The PHP web counter on steroids) * * $Header: /cvs/bbclone/doc/changelog.txt,v 1.178 2009/08/30 09:35:45 joku Exp $ * * Copyright (C) 2001-2009, the BBClone Team (see file doc/authors.txt * distributed with this library) * * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation; either version 2 of the License, or * (at your option) any later version. * * See doc/copying.txt for details */ 0.5.0 ----- * Add support to export the detailed stats to XML * Add experimental SQL backend * Add menu for development features 0.4.9 ------ * add many robots and many browser * add favorite weekend mod from the forums * add regression suite to evaluate correctness of expressions * add most of the mobile browsers out there * add some rare user agents like the PSP * add color in detailed stats for access of the local ip-adress to spot yourself in the log * Updated ip2ext database 0.4.8b ------ * Fixed wrong reference usage in io.php * Fixed broken referrers once they contain multibyte characters * Replaced broken cyrillic detection with mb_detect_encoding * Replaced Javascript redirector with conventional Javascript generated links * Changed processing order in lib/marker.php to block unwanted things as early as possible * Changed behaviour of $BBC_IGNORE_REFER to truly ignore visitors/bots with unwanted referrers * Added Korean and Thai translation * Updated Greek and Spanish translation * Updated a lot of broken detection patterns * Updated W3C validator url * Updated ip2ext database 0.4.8a ------ * Fixed uninitialised variable with $BBC_IGNORE_AGENT set to "1" (Dave) * Fixed language not recognised in Opera if multiple languages are set (Olliver) * Fixed implicit usage of multibyte function in lib/referrer.php (Olliver) * Don't list www*. aliases of multiple frontends as separated referrers (Olliver) * Open external links in new window again (Nanna Ellegaard) * Added