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

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

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

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

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

Пример:

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

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

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

Пример:

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

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

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

Пример:

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

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

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

Пример:

$STATS_CONF["sqlpassword"]="";

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

Пароль для просмотра статистики. Используется в паре с E-Mail'ом, который задается с помощью опции $STATS_CONF["cnsoftwarelogin"] .

Пароль хранится в зашифрованном виде. Для шифрования используется алгоритм MD5.

Пример:

$STATS_CONF["adminpassword"]="ecb4cb24043cf723b4a5458da5f02";

Для смены пароля, заданного при инсталляции:

$STATS_CONF["adminpassword"]=md5("mypassword");

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

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

Пример:

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

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

Данный E-Mail используется для просмотра статистики CNStats в качестве логина. Кроме того, в случае если данная версия полная и куплена, это поле должно совпадать с E-Mail, на который зарегистрирована лицензия. E-Mail вместе с паролем ($STATS_CONF["cnsoftwarepassword"]) передается на сервер cnstats.com для получения обновленных файлов данных и расширенных отчетов.

Пример:

$STATS_CONF["cnsoftwarelogin"]="admin@site.com";

Если после покупки Вы захотите изменить этот E-Mail, его также необходимо будет поменять для этой лицензии в интерфейсе редактирования лицензий.

$STATS_CONF["cnsoftwarepassword"] (обязательный параметр для купленной полной версии)

Пароль на данную лицензию для доступа к обновлениям и расширенным отчетам. Пароль задается в открытом виде. После покупки Вам придет письмо, содержащее данные для входа в Закрытую область для клиентов (member area). В интерфейсе редактирования лицензий будет отображен пароль на данную лицензию; следует вставить его в это поле.

Пример:

$STATS_CONF["cnsoftwarepassword"]="mypassword";

Изменить пароль можно на сайте www.cnstats.com с помощью интерфейса редактирования лицензий; далее вставить новый пароль в config.php .

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

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

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

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

Пример:

$COUNTER["savelog"]=60;

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

$COUNTER["domain"]

Адрес главной страницы сайта, на котором установлен CNStats (без завершающего слеша ("/")). Используется для генерации кода счетчика.

Если параметр не задан, то он строится по данным, полученным из переменной среды окружения HTTP_HOST. Если вы обсчитываете несколько доменов, используя при этом комбинированный счетчик, то этот параметр нужно указать обязательно, иначе код счетчика для не основных доменов будет создан неверно.

Пример:

$COUNTER["domain"]="http://www.cnstats.com";

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

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

0 - Невидимое GIF изображение
1 - PNG изображение
2 - PHP-Include
3 - Комбинированный (PHP-Include + GIF)

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

$COUNTER["inkR"], $COUNTER["inkG"], $COUNTER["inkB"]

Цвет символов на картинке, отображающей счетчик. Каждый параметр может принимать значение от 0 до 255.

По умолчанию: черный.

Пример:

Черный:

$COUNTER["inkR"]=0;
$COUNTER["inkG"]=0;
$COUNTER["inkB"]=0;

Красный:

$COUNTER["inkR"]=255;
$COUNTER["inkG"]=0;
$COUNTER["inkB"]=0;

Белый:

$COUNTER["inkR"]=255;
$COUNTER["inkG"]=255;
$COUNTER["inkB"]=255;

$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"

$COUNTER["senderrorsbymail"]

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

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

Пример:

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

$COUNTER["resolution"]

Задает разрешение, используемое при просмотре статистики. Может быть 800 или 1024, для 800x600 и 1024x768 соответственно. Влияет не только на ширину таблиц, но и на размеры графиков.

По умолчанию: 800

Пример:

$COUNTER["resolution"]=800;

$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["color"]

Задает цветовую гамму интерфейса статистики сайта. Девять цветов используемых для отображения статистики хранятся в элементах массива от 0 до 8 (от темного к светлому). Нулевой элемент хранит значение самого темного цвета. Восьмой элемент хранит значение самого светлого цвета.

Значения по умолчанию:

$STATS_CONF["color"][0]="#489153";
$STATS_CONF["color"][1]="#88C591";
$STATS_CONF["color"][2]="#B8E1BD";
$STATS_CONF["color"][3]="#D4F3D7";
$STATS_CONF["color"][4]="#DAF5DE";
$STATS_CONF["color"][5]="#CFEDD3";
$STATS_CONF["color"][6]="#E7F9EA";
$STATS_CONF["color"][7]="#F2FCF4";
$STATS_CONF["color"][8]="#FEFEFE";

Пример для серого цвета:

$STATS_CONF["color"][0]="#606060";
$STATS_CONF["color"][1]="#808080";
$STATS_CONF["color"][2]="#C0C0C0";
$STATS_CONF["color"][3]="#D0D0D0";
$STATS_CONF["color"][4]="#E0E0E0";
$STATS_CONF["color"][5]="#F0F0F0";
$STATS_CONF["color"][6]="#E0E0E0";
$STATS_CONF["color"][7]="#F0F0F0";
$STATS_CONF["color"][8]="#FFFFFF";

$STATS_CONF["hello string"]

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

Пример:

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

$STATS_CONF["guestlogin"]

Задает гостевой логин.

Гостевой вход позволяет смотреть статистику и работать с фильтрами (создавать, удалять). Остальные настройки гостю недоступны.

Если данного параметра нет или он закомментирован, то гостевой вход отключен.

Пример:

$STATS_CONF["guestlogin"]="guest";

$STATS_CONF["guestpassword"]

Задает гостевой пароль. Используется вместе с $STATS_CONF["guestlogin"].

Пример:

$STATS_CONF["guestpassword"]="guest";

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

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

Пример:

$COUNTER["timeoffset"]=-1800;

$COUNTER["HTTPheaders"]

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

Комбинированный;
GIF 1x1;
PNG 88x31.

С помощью этого параметра можно установить дополнительные 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. Возможные значения:

header (по умолчанию) - использовать HTTP-заголовок Location для автоматических перенаправлений.
meta - использовать META-теги для автоматических перенаправлений; рекомендуется при использовании сервера IIS/5.0.

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

$STATS_CONF["sqlprefix"]

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

Пример:

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

$STATS_CONF["quiet"]

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

Yes - режим включен. Рекомендуется использовать только в крайних случаях, при нестабильной работе SQL сервера;
No (по умолчанию) - режим выключен.

Пример:

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

$STATS_CONF["codegeneration"]

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

html (по умолчанию) - генерировать и выводить JavaScript код;
variable - генерировать JavaScript код, и записывать его в переменную $CNSTATS_JAVASCRIPT_CODE;
onlyid - генерировать только уникальный идентификатор обращения и записывать его в переменную $CNSTATS_JAVASCRIPT_CODE.

С помощью значения "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";

?>

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

<?
// Данные для подключения к серверу баз данных
$STATS_CONF["dbname"]="cnstats";
$STATS_CONF["sqlhost"]="localhost";
$STATS_CONF["sqluser"]="root";
$STATS_CONF["sqlpassword"]="";

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

// Пароль для входа в интерфейс просмотра статистики
$STATS_CONF["adminpassword"]="1cb4cb24043c45f74b8da5a523f02";

// E-Mail, указанный в настройках лицензии
// (он же используется для входа в CNStats)
$STATS_CONF["cnsoftwarelogin"]="admin@site.com";

// Пароль, указанный в настройках лицензии
$STATS_CONF["cnsoftwarepassword"]="mypassword";

// Хранит полную статистику 30 дней
$COUNTER["savelog"]=30;

// Корневой каталог сайта без завершающего слеша (/)
$COUNTER["domain"]="http://www.cnstats.com";

// Тип счетчика - PHP-Include
$COUNTER["type"]=1;

// Цвет символов на PNG-картинке
$COUNTER["inkR"]=0;
$COUNTER["inkG"]=255;
$COUNTER["inkB"]=0;

// Не засчитывать свои переходы 
$COUNTER["excludeip"][]="127.0.0.1";
$COUNTER["excludemask"][]="255.255.255.255";

// Не отключать авторизацию CNStats
$COUNTER["disablepassword"]="no";

// Отправлять сообщения об ошибках на E-Mail
$COUNTER["senderrorsbymail"]="yes";

// Подстраивать таблицы и графики под 800x600
$COUNTER["resolution"]=1024;

// Использовать серую гамму
$STATS_CONF["color"][0]="#606060";
$STATS_CONF["color"][1]="#808080";
$STATS_CONF["color"][2]="#C0C0C0";
$STATS_CONF["color"][3]="#D0D0D0";
$STATS_CONF["color"][4]="#E0E0E0";
$STATS_CONF["color"][5]="#F0F0F0";
$STATS_CONF["color"][6]="#E0E0E0";
$STATS_CONF["color"][7]="#F0F0F0";
$STATS_CONF["color"][8]="#FFFFFF";

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

// Гостевой логин
$STATS_CONF["guestlogin"]="guest"; 

// Гостевой пароль
$STATS_CONF["guestpassword"]="guest"; 

// Использовать DELAYED INSERT при добавлении в лог таблицу
$CONFIG["sqlwritelog"]="DELAYED";

// Ограничения ресурсов
$STATS_CONF["slow_reports_memory_limit"]="32M";
$STATS_CONF["slow_reports_time_limit"]=1800;
?>

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