Плагин для Matomo - Отображение статистики Посещений/Просмотров на изображении



Плагин для Matomo (Piwik) который отображает в графическом виде(по умолчанию изображение 80х31) статистику по посещениям и просмотрам сайта.
Так как в исходном дистрибутиве Piwik такого функционала нет, пришлось дописывать самому.

У плагина есть администраторская часть с настройками(о них ниже) и собственно та часть которая отвечает за вывод изображения счетчика. Установка javascript-кода счетчика на сайт обязательна!

Скачать (версия 2.1.1) для Matomo (Piwik) 3.x: plg_counter_2.1.1.zip
MD5: 1a9ea0c348c2a933471f558a76dc0426
SHA1: b047e12ad2e15ee7b4b68d6391f2fbf0ce0e507f

Скачать (версия 2.0.15) для Piwik 2.x: plg_counter_2.0.15.zip
MD5: 25dab3c45f253b45f129708c7ef27e44
SHA1: a3f717b023f693762f7cb93d05ba041dca651d79

Скачать (версия 1.1) для Piwik 1.x: plg_counter_1.1.zip
MD5: ff51c4d586405773dfc049643db558f8
SHA1: 5d7daeb5861e9c5cbd689101cd4a0e4522935f7c

Распространяется по лицензии GNU GPLv3

Репозиторий на Github

Архивные версии здесь.

  1. Требования
  2. Установка
  3. Управление счетчиками
  4. Подключение
  5. Посетители онлайн
  6. Скриншоты
  7. Перевод

Требования

PHP 5.3 и выше
GD2+
FreeType

Установка

Для версии 2.0: Скачиваем плагин и распаковываем содержимое в папку plugins/Counter
Для версии 1.1: Скачиваем плагин и распаковываем содержимое в папку plugins/
Далее в админке Piwik переходим в раздел "Настройки" на вкладку "Плагины" и в списке находим "Counter". Нажимаем ссылку "Активировать".
NB! Если вы устанавливаете плагин вручную, не забудьте установить соответствующие права на папки и файлы.

Управление счетчиками

Переходим на вкладку "Счетчики" в настройках Piwik.

По умолчанию после установки список счетчиков будет пуст. Пользователь может создать новый счетчик только для того сайта, для которого у него есть права администратора. Также нельзя создавать несколько счетчиков для одного и того же сайта.
Если счетчик снят с публикации, то вместо изображения с статистикой будет выведено прозрачное изображение в gif размером 1х1 px.

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

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

Подключение

Для подключения на странице достаточно прописать в том месте где нужен счетчик:

<img src="http://my_piwik_site/index.php?module=Counter&action=show&id=1" border="0" />
где id - номер счетчика из списка

Посетители онлайн

"Счетчик посетителей онлайн" позволяет вывести на страницу количество посетителей в реальном времени, за определенный интервал. Для этого при создании счетчика необходимо указать период за который учитывать пользователя находящимся на сайте, интервал обновления, тип счетчика и id элемента на странице в который будет выводиться статистика. "Статический счетчик" выводит статистику только при запросе страницы пользователем. Если эту опцию отключить, то статистика будет обновляться через указанный период времени. Код счетчика можно получить на странице списка счетчиков.

Скриншоты


Перевод

Если хотите добавить перевод на другой язык или исправить уже имеющиеся: https://github.com/Globulopolis/Counter/pulls

 


В: - Как работает плагин?
О: - Плагин делает запрос к внутреннему API Piwik, а именно к методу "VisitsSummary" с параметрами.

$request = new Request('
	method=VisitsSummary.get
	&idSite='.(int)Common::getRequestVar('idSite', 0).'
	&period=range
	&date='.$params['start_date'].','.date('Y-m-d').'
	&format=php
	&serialize=0
	&token_auth='.$params['token']
);

 

В: - Почему подсчет общей статистики занимает очень много времени?
О: - Подсчет занимает много времени по той причине, что система учитывает все посещения за выбранный период времени. Также если в базе данных нет архивов за какой-то период времени, то система создает таблицы с данными заново и только потом подсчитывает посещения. Для высоконагруженных сайтов рекомендуется устанавливать архивирование и время кеша как можно больше.

История изменений

2.1.1
* Добавлена проверка токена для методов publish/unpublish, save/apply, remove, clearCache.
* Удалены методы publish/unpublish, save/apply, remove из API.
* Удален заголовок X-Powered-By из ответа при запросе изображения счетчика.
* Мелкие исправления.

2.1.0
* Версия для Piwik 3.

2.0.15
* Исправления в тегах(неверный тег).

2.0.14
* Исправлен code style
* Мелкая чистка кода.

2.0.13
* Убрана проверка при добавлении значения посещений
* Убран лишний пробел в коде для вставки
* Добавлены пропущеные колонки в запросе на обновление для метода save()
* Новая опция для форматирования значений.

2.0.12
* Исправлена ошибка с доступом.

2.0.11
* Добавлена возможность указывать стартовые значения посещений/просмотров.
* Новые шаблоны для версии Piwik 2.14+

2.0.10
* https://github.com/Globulopolis/Counter/issues/7
* Минимальная версия Piwik для установки плагина - 2.4.0
* Исправлена отсутствующая иконка загрузки в диалоге "Проверить обновления"

2.0.9
* https://github.com/Globulopolis/Counter/issues/5

2.0.8
* https://github.com/Globulopolis/Counter/issues/4#issuecomment-59620132

2.0.7
* Добавлен пункт "Вчера" для списка периода отчетов.

2.0.6
* Исправлена ошибка если файл изображения был в формате отличном от png или gif. Теперь поддерживается jpg.
* Обновлен плагин выбора цвета.

2.0.5
* Исправлена ошибка с пользовательским меню в Piwik 2.4.0

2.0.4
* Добавлена возможность задавать смещение(больше/меньше) для количества посетителей/просмотров/стран в шаблоне "visitors by countries".

2.0.3
* Исправлена ошибка с недоступным методом Access::isSuperUser.
* Исправлена ошибка с define PIWIK_ENABLE_DISPATCH.
* Добавлена обработка ошибки с getallheaders() если PHP запущен как CGI.
* Исправлен двойной слеш в URL.
+ Добавлен шаблон "visitors by countries".

2.0.2
* Исправлена ошибка с неправильным отображением протокола ссылки на счетчик в списке счетчиков.

2.0.1
* Патч для CORS (спасибо aureq)
* Изменена система нумерации версий

2.0
* Релиз для Piwik 2.х.

1.1
* Исправлена ошибка в sql-запросе для установки.

1.0
! В связи с ограничением(или корявостью) GD2+ название сайта на изображении доступно только для латиницы. При использовании других символов пишите название напрямую на изображении в любом графическом редакторе, а в настройках отключите вывод названия сайта.
* Поле "название сайта" перенесено из json-массива в отдельное поле в таблице для обхода проблемы с кодировкой.
* Добавлена проверка на наличие установленного Fileinfo. Если нет, то используется Mime_magic. Если и его нет, то выводится ошибка.
* Исправлено получение данных о сайтах для списка при создании/редактировании счетчика
* Обновлен метод update для обновления с 0.9 до 1.0

0.9
+ Добавлен список выбора периода подсчета
+ Добавлена проверка новой версии в футере.
* При выборе сайта из списка, в поле даты, если она пуста, автоматически подставляется дата добавления сайта в систему
* При выборе периода "День" срок жизни кэша устанавливается равным 1-им суткам.
* Исправлено отображение шаблона страниц списка счетчиков, добавления и редактирования
* Обновлен метод update для обновления с 0.7 до 0.9

0.8
* Piwik_Query заменен на Zend_Db
- Удален параметр "font_size" и добавлены "sitename_font_size", "visits_font_size", "hits_font_size" для каждой надписи отдельно
* createImage возвращает false если Piwik_API_Request вернул ошибку и если модуль FINFO не загружен
+ Теперь можно просматривать счетчик в окне предпросмотра в режиме редактирования без сохранения изменений.
+ Новый метод update для обновления с версии 0.7 до 0.8
+ Пользователь с соответствующими правами может очищать кэш с изображением счетчика в режиме редактирования.
* Некоторые изменения в языковых файлах
* Улучшена визуализация конфигурации ;)

0.7
* При удалении счетчика стандартное окно заменено диалоговым jQueryUI. Не требуется перезагрузка страницы
- Удален выпадающий список с опциями расположения надписи сайта. Вместо этого настройки для каждой надписи вынесены отдельно.
+ Добавлены опции по скрытию надписей.
NB! Необходимо пересохранить ранее созданные счетчики!

0.6
* исправлена навигация при переходе с страницы редактирования/добавления
+ добавлено предупреждение при отключении кеширования

0.5
+ добавлен пропущенный код для вывода статистики при отключенном кешировании
* мелкие исправления

0.4
Плагин полностью написан заново.
+ разделение прав (зависит от глобальных настроек прав)
+ добавление счетчика для каждого сайта по отдельности
+ добавлена статистика посещений online

0.3
* Экземпляр класса контроллера счетчика назначен переменной и вынесен в конструктор.

0.2
* idSite вынесен из общих настроек в параметры запроса
* date вынесен в параметры запроса. Оставлен в глобальных для тех сайтов, для которых требуется только один счетчик.
+ Добавлена локализация для английского языка.
+ Добавлена автоматическая подстановка пути к файлам image.png и файла шрифта в настройках.
+ Добавлен блок с примером кода для счетчика в настройках.

0.1
Стартовый релиз