CNStats STD/PRO 3.2 / Руководство пользователя

© "CN-Software" Ltd. 2002-2008
support@cn-software.com
www.cnstats.com, www.cn-software.com

Список параметров config.php

Настройки, хранимые в файле config.php:

$STATS_CONF["cnsoftwaredomain"] (обязательный параметр)

$STATS_CONF["cnsoftwaredomain"]="cnstats.com";

$STATS_CONF["sqlserver"] (обязательный параметр)

Программное обеспечение SQL сервера. На данный момент - только MySql.

Пример:

$STATS_CONF["sqlserver"]="MySql";

$STATS_CONF["dbname"] (обязательный параметр)

Имя базы данных, в которой CNStats хранит все данные. Имена таблиц CNStats имеют префикс "cns_", поэтому Вы можете использовать CNStats даже в том случае, если хостинг-провайдер предоставляет Вам только одну базу данных.

Пример:

$STATS_CONF["db_name"]="mysite_cnstats";

$STATS_CONF["sqlprefix"]

Префикс таблиц CNStats; используется при установке нескольких копий CNStats в одну базу данных. Значение по умолчанию - "cns_". При изменении префикса необходимо вручную изменить название всех таблиц CNStats.

Пример:

$STATS_CONF["sqlprefix"]="cns1_";

$STATS_CONF["sqlhost"] (обязательный параметр)

Адрес сервера баз данных. Как правило, предоставляется хостинг-провайдером.

Пример:

$STATS_CONF["sqlhost"]="localhost";

$STATS_CONF["sqluser"] (обязательный параметр)

Логин для доступа к серверу баз данных. Для корректной работы CNStats Вы должны обладать правами на создание и удаление таблиц. Как правило, предоставляется хостинг-провайдером.

Пример:

$STATS_CONF["sqluser"]="root";

$STATS_CONF["sqlpassword"] (обязательный параметр)

Пароль для доступа к серверу баз данных. Пароль может быть пустым (часто для пользователя root). Как правило, предоставляется хостинг-провайдером.

Пример:

$STATS_CONF["sqlpassword"]="";

$COUNTER["savelog"] (обязательный параметр)

Параметр задает период хранения полной статистики в днях. Чем дольше хранится полная статистика, тем больше места занимает база данных; как следствие - тем медленнее будут строиться отчеты.

Контролировать размер базы данных можно с помощью отчета "Размер базы данных".

Рекомендуемое значение - 40.

Пример:

$COUNTER["savelog"]=60;

Вы можете увеличить период хранения в любой момент. Не следует задавать слишком большой период хранения; как правило, для анализа достаточно 30-60 дней.

Вы можете также уменьшить период хранения в любой момент. Записи удаляются в полночь. В зависимости от настроек Вашей базы данных размер базы может не уменьшиться. Для уменьшения размера необходимо провести оптимизацию таблицы sql с помощью команды:

OPTIMIZE TABLE cns_log; 

$COUNTER["type"] (обязательный параметр)

Тип счетчика.

Более подробно о типах счетчиков Вы можете узнать в разделе "Типы счетчиков"

Значение "1" не используется начиная с версии 3.0.


$COUNTER["excludeip"], $COUNTER["excludemask"]

Список исключаемых IP адресов и сетей. Можно задать один или несколько диапазонов. Задавать следует попарно - адрес, затем маска.

Пример:

Для одного адреса:

$COUNTER["excludeip"]="127.0.0.1";
$COUNTER["excludemask"]="255.255.255.255";

Для одного адреса и одной сети:

$COUNTER["excludeip"][]="127.0.0.1";
$COUNTER["excludemask"][]="255.255.255.255";
$COUNTER["excludeip"][]="192.168.0.1";
$COUNTER["excludemask"][]="255.255.255.0";

$COUNTER["disablepassword"]

Отключение авторизации CNStats ("yes" - отключить, "no" - не отключать).

При интеграции CNStats в движок сайта иногда удобнее самостоятельно организовывать авторизацию. В этом случае для предотвращения двойной авторизации можно отказаться от авторизации CNStats.

По умолчанию: "no"

Пример:

$COUNTER["disablepassword"]="yes"

$STATS_CONF["adminemail"]

E-Mail администратора. Используется в следующих моментах:

Пример:

$STATS_CONF["adminemail"]="jonh@example.com"

$COUNTER["senderrorsbymail"]

Если указан параметр "yes", то ошибки, возникающие при работе CNStats, отправляются на E-Mail, указанный с помощью параметра $STATS_CONF["cnsoftwarelogin"].

Если "no", то ошибки по почте не отправляются.

Пример:

$COUNTER["senderrorsbymail"]="yes";

$COUNTER["sqlwritelog"]

Дополнение к SQL запросу записи в лог-таблицу. Вставляется в SQL инструкцию в чистом виде между "INSERT" и именем таблицы.

Примечание: Неверно заданный параметр может повредить базу данных.

Пример:

$COUNTER["sqlwritelog"]="DELAYED";

$STATS_CONF["sqlinstructions"]

Массив SQL инструкций, выполняемых сразу после соединения с сервером баз данных. Как правило, это опция используется для настройки локализации, если сервер баз данных по умолчанию настроен некорректно.

Пример:

$STATS_CONF["sqlinstructions"][]="SET NAMES cp1251";
$STATS_CONF["sqlinstructions"][]="SET CHARACTER SET cp1251";

$STATS_CONF["slow_reports_memory_limit"]

Ограничение на объем используемой памяти для медленных отчетов. К таким отчетам относятся на данный момент только "Точки выхода" и "Пути по сайту".

Если используется integer, значение измеряется байтами. Вы также можете использовать сокращённую запись - K (для Килобайт) и M (для Мегабайт)

Пример:

$STATS_CONF["slow_reports_memory_limit"]="32M";

$STATS_CONF["slow_reports_time_limit"]

Ограничение на время выполнения (в секундах) для медленных отчетов. К таким отчетам относятся на данный момент только "Точки выхода" и "Пути по сайту".

Пример:

$STATS_CONF["slow_reports_time_limit"]=1800;

$STATS_CONF["hello string"]

Параметр задает текстовую строку, которая выводится в диалоге ввода логина и пароля. Можно использовать HTML код. По умолчанию строка пустая.

Пример:

$STATS_CONF["hello string"]="Для просмотра статистики
используйте логин <B>guest</B> и пароль
<B>guest</B>.";

$COUNTER["timeoffset"] (функция работает в экспериментальном режиме)

Смещение времени на сервере в секундах. Параметр задается в случае если сервер, на котором расположен Ваш сайт, находится в другом часовом поясе.

Пример:

$COUNTER["timeoffset"]=-1800;

$COUNTER["HTTPheaders"]

Массив дополнительных HTTP-заголовков, отправляемых клиенту при использовании следующих типов счетчика:

С помощью этого параметра можно установить дополнительные Cookies, язык, P3P данные и другую информацию, передаваемую через HTTP-заголовки.

Пример:

$COUNTER["HTTPheaders"]["Language"]="ru";
$COUNTER["HTTPheaders"]["P3P"]="policyref=\"/w3c/p3p.xml\", CP=\"UNI\"";

$COUNTER["excludeurl"]

Шаблон для исключения страниц из статистики.

Пример:

$COUNTER["excludeurl"][]="PHPSESSID";
$COUNTER["excludeurl"][]="favicon.ico";

В данном примере из статистики исключены адреса, содержащие строки "PHPSESSID" и "favicon.ico".


$STATS_CONF["redirect"]

Тип автоматического перенаправления (редирект) в интерфейсе просмотра статистики CNStats. Возможные значения:

Данная опция была добавлена из-за неверной обработки Cookies во время перенаправлений сервером IIS/5.0. Более подробно об этой проблеме можно прочитать на сервере поддержки Microsoft.


$STATS_CONF["quiet"]

Режим умолчания в SQL запросах; при включении этого режима информация о ошибках SQL сервера не выводится.

Пример:

$STATS_CONF["quiet"]="no";

$STATS_CONF["codegeneration"]

Режим генерации кода счетчика (только при использовании комбинированного типа счетчика).

С помощью значения "variable" Вы можете вызвать PHP-часть счетчика в одном месте, а JavaScript-часть счетчика в другом месте. Например:

<?php

include "config.php";

// Вызов PHP-части кода счетчика
include "/../cnstats/cnt.php";

// Вывод HTTP-заголовка
header("Language: ".GetDocumentLanguage());

// Вывод верхней части документа
include "top.php";

// Вывод JavaScript-части
print $CNSTATS_JAVASCRIPT_CODE;

// Вывод тела документа
print DocumentBody();

// Вывод нижней части документа
include "bottom.php";

?>

С помощью значения "onlyid" Вы можете полностью изменять JavaScript-часть кода счетчика и выводить ее в любом месте. Например, Вы можете использовать JavaScript-код, совместимый с XHTML:

<?php

include "config.php";

// Вызов PHP-части кода счетчика
include "/../cnstats/cnt.php";

// Вывод HTTP-заголовка
header("Language: ".GetDocumentLanguage());

// Вывод верхней части документа
include "top.php";

?>

<a href="http://www.cnstats.com/" id="m">
<SCRIPT language="JavaScript" type="text/javascript">
cnsd=document;
cnsd.cookie='b=b';
cnsc=cnsd.cookie?1:0;
cnst=escape(cnsd.title);
cnst=cnst.replace(/\+/g,'%2B');
cnsa=navigator.appName;
cnsn=(cnsa.substring(0,2)=='Mi')?0:1;
cnss=screen;cnspx=(cnsn==0)?cnss.colorDepth:cnss.pixelDepth;
if (cnsd.getElementById)
{
    var i=cnsd.createElement('img');
    var iurl='/cnstats/cntc.php?i=<?php echo $CNSTATS_JAVASCRIPT_CODE;?>';
    iurl+='&c='+cnsc+'&e='+cnss.width+'.'+cnss.height+'&d='+cnspx;
    iurl+='&r='+escape(cnsd.referrer)+'&p='+escape(cnsd.location)+'&t='+cnst;
    i.src=iurl;
    i.width=1;i.height=1;i.border=0;
    cnsd.getElementById("m").appendChild(i);
}
</SCRIPT>
</a>

<?php

// Вывод тела документа
print DocumentBody();

// Вывод нижней части документа
include "bottom.php";

?>

$STATS_CONF["gdversion"]

Параметр задает версию библиотеки GD:

Пример:

$STATS_CONF["gdversion"]="auto";

$STATS_CONF["code"]

Формат кода счетчика.

Параметр влияет на код счетчика, выдаваемый в разделе "Конфигурация - Код счетчика", а также на код, генерируемый системой при использовании комбинированного типа счетчика.

Пример:

$STATS_CONF["code"]="XHTML";

$STATS_CONF["cnstats_http_path"]

Относительный путь CNStats на Вашем сайте. Путь определяется автоматически во время установки CNStats. После установки эту настройку изменять нельзя.

Пример:

$STATS_CONF["cnstats_http_path"]="/cnstats/";

Пример файла config.php

<?php
// License domain. It should match the register key domain.
$STATS_CONF["cnsoftwaredomain"]="cnstats.com";

// SQL server software. So far only MySql is supported. 

$STATS_CONF["sqlserver"]="MySql"


// Name of the database, where CNStats stores all data. Names of
// CNStats tables have $STATS_CONF["sqlprefix"] prefix, so it is
// possible to use CNStats even if your hosting-provider granted
// you access only to one database. 

$STATS_CONF["dbname"]="my_cnstats";

// CNStats tables prefix

$STATS_CONF["sqlprefix"]="cns3_";

// Database server address. As a rule, it is granted by the
// hosting-provider. 

$STATS_CONF["sqlhost"]="db12c.pair32.com";

// Database server login. You must have rights for creation and deletion
// of database tables for correct functioning of CNStats. These rights
// are usually granted by the hosting-provider. 

$STATS_CONF["sqluser"]="mystats_2";

// Database server password. It may be blank (often for "root" users).
// As a rule, it is granted by the hosting-provider. 

$STATS_CONF["sqlpassword"]="677conduge";



// It sets period of complete statistics storage per days. The longer the
// period, the more space is required for the database. The database size
// influences the system performance, it slows down with larger database. 
// Database size can be monitored in the report "Database size". 

$COUNTER["savelog"]=60;

// Counter type. (For more information, please, refer to 
// http://www.cnstats.com/en/support/manual/countercodehow.php
// 
//   0 - Blank GIF image 
//   2 - PHP-include 
//   3 - Combined (PHP-include + GIF) 

$COUNTER["type"]=3;

// List of excluded IP addresses and networks. It is possible to set one
// or several ranges. It should be set in couples: IP-address first,
// than network mask. 

$COUNTER["excludeip"][]="0.0.0.0";
$COUNTER["excludemask"][]="255.255.255.255";


// CNStats authorization disabling. "Yes" - authorization is disabled,
// "no" - authorization is enabled. Sometimes it is more convenient
// to use "in-house" authorization when you install CNStats into existent
// software engine. In such cases you may switch off CNStats authorization
// to avoid double authorization. 

$COUNTER["disablepassword"]="no";

// E-Mail address for the system errors notifications (provided that
// $COUNTER["senderrorsbymail"] option is enabled).

$STATS_CONF["adminemail"]="admin@cnstats.com";

// If it is set to "yes", then CNStats errors will be reported to the e-mail
// set in $STATS_CONF["adminemail"] parameter. 

$COUNTER["senderrorsbymail"]="yes";

// Addition to the SQL request to write in the log-table. It is inserted in
// the SQL instruction in plain format between "INSERT" and the table name. 
// Note: Incorrect parameter can damage the database. 

// $COUNTER["sqlwritelog"]="";

// Array of SQL-instructions, performed upon connection to the database server.
// As a rule, this option is used to configure localization in case the database
// server has incorrect settings. 

// $STATS_CONF["sqlinstructions"][]="";

// Memory volume limit for slow reports. There are two of them - "Entry pages"
// and "Trace browsing".  If integer is used, the value is measured in bytes.
// It is possible to use abbreviations - K (for kilobytes)
// and M (for megabytes). 

$STATS_CONF["slow_reports_memory_limit"]="8M";

// Time limit for slow reports (seconds). There are two of them - "Entry pages"
// and "Trace browsing". 

$STATS_CONF["slow_reports_time_limit"]="30";

// The parameter sets a text string which is displayed in the login dialogue.
// HTML code may be used. The string is blank by default. 

$STATS_CONF["hello string"]="";

// The parameter sets guest login, which allows viewing statistics and using
// filters (creating, deleting). Other settings are not available for a guest. 

// $STATS_CONF["HTTPheaders"]["0"]="";


// Template for pages exclusion from the statistics. 

// $STATS_CONF["excludeurl"][]="";


// Automatic redirection type at the CNStats statistics interface.
// Possible values: 
//    - header (by default) - Location HTTP-header is used for automatic
//      redirections. 
//    - meta - META-tags are used for automatic redirections; it is
//      recommended in case IIS/5.0 server is used.

$STATS_CONF["redirect"]="meta";

// SQL requests hiding mode; when it is activated, SQL error data are not
// displayed. 
//   yes - the mode is enabled. It is recommended to use only in emergency
//         cases, if SQL server is unstable; 
//   no (by default) - the mode is disabled. 

$STATS_CONF["quiet"]="no";

// Counter code generation mode (only for combined counter type). 
//    html (by default) - JavaScript code is generated and displayed; 
//    variable - JavaScript code is generated and recorded to
//            variable; 
//    onlyid - only request unique identifier is generated and
//           recorded to  variable. 

$STATS_CONF["codegeneration"]="html";

// GD library version
//    "0" - GD is not set
//    "1" - GD version 1.X is set
//    "2" - GD version 2.X is set
//    "auto" - Automatic definition of GD version (by default)

$STATS_CONF["gdversion"]="auto";

// Counter code
//    "HTML" - HTML friendly counter code
//    "XHTML" - XHTML friendly counter code

$STATS_CONF["code"]="HTML";

// The catalogue, in which CNStats is installed.

$STATS_CONF["cnstats_http_path"]="/cnstats/";
?>

Назад | Оглавление | Далее