Плагин **Bg Az-Counter** обеспечивает работу клиентской части системы подсчета количества посещений страниц на базе Redis-based сервера `https://stat.azbyka.ru`. Код и описание работы сервера [см. здесь](https://gitlab.eterfund.ru/azbyka/stats-server).
Плагин **Bg Az-Counter** обеспечивает работу клиентской части системы подсчета количества посещений страниц на базе Redis-based сервера `https://stat.azbyka.ru`.
Код и описание работы сервера [см. здесь](https://gitlab.eterfund.ru/azbyka/stats-server).
## Плагин выполняет следующие функции:
**Передает на сервер информацию об открытии страницы пользователем*
**Запрашивает сервер и отображает на странице количество пользователей, просматривающих в данный момент страницу и общее количество просмотров страницы.*
### Передает на сервер информацию об открытии страницы пользователем
### Запрашивает сервер и отображает на странице количество пользователей, просматривающих в данный момент страницу и общее количество просмотров страницы.
Для этого на странице должны быть размещена следующая HTML-разметка:
...
...
@@ -23,9 +24,9 @@
Параметры ***type*** и ***ID*** описаны выше, если задан параметр ***now*** с значением ***true*** (или любое значение кроме null, false, 0, ""), то будут отображаться количество пользователей, просматривающих в данный момент страницу и общее количество просмотров страницы.
Если параметры ***type*** и/или ***ID*** не заданы или заданы пустые значения, то будет выведено общее количество просмотров и онлайн-посетителей на сайте.
Если параметрам ***type*** и/или ***ID*** заданы пустые значения, то будет выведено общее количество просмотров и онлайн-посетителей на сайте.
В случае ***now=false** (или 0, "") - только общее количество просмотров страницы.
В случае ***now=false*** (или 0, "") - только общее количество просмотров страницы.
Если этот параметр не задан (или задан как ***now=null***), то используется значение, заданное в настройках плагина.
Задавайте функцию `bg_az_counter_views` в шаблоне страниц так:
...
...
@@ -38,7 +39,7 @@
Параметры для JS-скрипта (в плагине задаются автоматически):
```javascript
```html
<script>
varbg_counter={
"counterurl":"https://stat.azbyka.ru/counters",// Всегда
...
...
@@ -51,7 +52,7 @@
</script>
```
**Выводит на экран список популярных постов.*
### Выводит на экран список популярных постов.
Для этого используйте шорт-код `[bg_counter_top_posts limit='10' number='true']` или php-функцию `getPopularPosts ($limit, $number);`, где ***limit ($limit)*** - количество постов в списке, ***number ($number) = true*** - нумерованный список, ***false*** - ненумерованный.
В настройках плагина можно задать периодичность обновления списка популярных постов: моментально, каждый час, ежедневно, еженедельно, ежемесячно, ежегодно.
...
...
@@ -72,7 +73,9 @@
```
Для вывода списка популярных постов в боковую панель используйте **виджет "Популярные записи"**, который работает аналогично соответствующему шорт-коду.
**Виджет "Сейчас на сайте"**, выводит в боковую панель количество онлайн-посетителей на сайте и общее количество просмотров странц.
**Виджет "Сейчас на сайте"**, выводит в боковую панель количество онлайн-посетителей на сайте и общее количество просмотров страниц.
## Импорт данных, архивирование и валидация данных
Плагин позволяет загрузить на сервер данные из плагинов **Post Views Counter** и/или **WP Popular Posts**, а также из произвольных полей **"views"**.
Кроме того плагин ежедневно сохраняет архив данных в файле `wp-content/uploads/bg_az_counter.json`, которые при необходимости можно также загрузить на сервер.
...
...
@@ -80,7 +83,8 @@
Чтобы удалить лишние записи с сервера достаточно обнулить значения счетчика.
При ежедневном архивировании данных происходит их проверка на валидность.
Проверяется значение **ID**, есть ли в БД WP запись с этим **ID**, является ли тип этой записи *'post'* или *'page'*, а статус - *'publish'*.
Проверяется есть ли в БД WP запись с данным **ID**, имеет ли эта запись тип *'post'*, *'page'* или ползователский тип, а статус - *'publish'*.
Все некорректные записи обнуляются и будут удалены на сервере.
**Внимание!** После удаления плагина файл `wp-content/uploads/bg_az_counter.json`**НЕ будет удален**! При необходимости, удалите его вручную.
