worldwide open-source software

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
======Счетчик доступа и плагин популярности для «ДокуВики»====== 
---- plugin ----
description: Экспортируйте количество тех, кто посетил указанную страницу в вашей вики сегодня, вчера или за весь период. Вы также можете отобразить список популярности в соответствии с данными журнала, полученными плагином. Этот плагин портирован из плагинов PukiWiki (с некоторыми настройками).
author     : HokkaidoPerson 
email      : dosankomali@yahoo.co.jp 
type       : Syntax
lastupdate : 2020-06-11
compatible : Hogfather, Igor, Jack Jackrum, Kaos
depends    : 
conflicts  : 
similar    : top
tags       : statistics, users, counter

downloadurl: https://github.com/hokkaidoperson/DokuWiki-AccsCounter-Plugin/zipball/master
bugtracker : https://github.com/hokkaidoperson/DokuWiki-AccsCounter-Plugin/issues
sourcerepo : https://github.com/hokkaidoperson/DokuWiki-AccsCounter-Plugin
donationurl : 
 
screenshot_img : 
----
===Примечания===

:!: [[https://www.dokuwiki.org/ja:plugin:accscounter|このページを日本語でご覧頂けます。(Эта страница также доступна на японском языке.)]]\\ 
:!: Я не являюсь носителем английского языка, поэтому эта страница может содержать некоторые ошибки в английских предложениях.
=====Краткое содержание=====
Этот плагин показывает количество людей, посетивших указанные страницы.
Вы также можете показать список популярных страниц за сегодня, вчера и за весь период.

Я портировал плагин Counter и плагин Popular из PukiWiki.((согласно лицензии оригинального плагина))
=====Монтаж=====
Используйте менеджер плагинов для установки или…

  - скачать zip-файл
  - распаковать его в<dokuwiki>/lib/plugins/
  - войдите как администратор и измените плагин в менеджере конфигурации



=====Применение=====
:!:Пожалуйста, добавьте ''~~NOCACHE~~'' макрос на страницу, на которой вы будете использовать этот плагин, поскольку данные будут изменяться в режиме реального времени, и страница не должна кэшироваться.

====Счетчик доступа====
<code>
{{counter}} человек посетили эту страницу до сих пор.
</code>

Затем экспортируется как ''15 person(s) visited this page until now.'' (если страницу посетило 15 посетителей).

Также вы можете ввести так:

<code>
К этой странице обращались:
Сегодня: {{counter|сегодня}} / Вчера: {{counter|вчера}}
До сих пор: {{counter|total}}
</code>

Другой пример:

<code>
{{counter|total| человек посетил эту страницу до сих пор.| люди посетили эту страницу до сих пор.}}
</code>
==== Популярные страницы ====

:!:Будут перечислены страницы, на которых активен плагин счетчика посещений. Если вы хотите, чтобы популярный плагин проверял все страницы, вы поместите плагин счетчика в боковые панели или шаблоны.

Самый простой пример:

<code>
{{POPULAR}}
</code>

Затем вы увидите список 10 самых посещаемых на данный момент страниц, например:
  * [[:start]](57)
  * [[wiki:syntax]](21)
  * [[plugins]](19)
  * ......

Вы можете изменить параметры:
  {{POPULAR 45 today}}
  {{POPULAR 20 yesterday blacklist1|blacklist2}}

==== Посмотрите, как работает плагин ====

Посмотреть плагин в действии можно [[https://jdwiki.hkdyukkuri.space/|здесь]] (извините, но эта страница доступна только на японском языке).

===== Синтаксис =====
<code php code.php>
{{counter|argument|message A|message B}}
</code>
  {{счетчик|аргумент|сообщение A|сообщение B}}

  * **аргумент**: ''today'', ''yesterday'', или ''total''(по умолчанию)
  * **сообщение A**: текст, следующий за числом (когда число равно 0 или 1)
  * **сообщение B**: текст, следующий за числом (когда число равно 2 или больше)

  {{POPULAR number argument blacklist}}

  * **number**: количество элементов, которые будут показаны
  * **argument**: ''today'', ''yesterday'', или ''allperiod'' (по умолчанию)
  * **blacklist**: страницы, которые не будут показаны в списке (разделить на ''|'')

===== Менеджер данных =====

Вы можете выбрать «Диспетчер данных» в меню администратора вашей вики и легко просматривать и контролировать данные журнала!

===== Конфигурация и настройки =====

Вы можете изменить следующие настройки с помощью [[wiki:plugin:config|диспетчера конфигураций]].

^Параметры^Описание^Тип значения^Значение по умолчанию^
|''timezone''|Часовой пояс (используется для определения изменений даты. Если оставить поле пустым, будет использоваться часовой пояс, установленный на сервере. Идентификаторы, которые можно указать, указаны в [[http://php.net/manual/en/timezones.php|«Списке поддерживаемых часовых поясов» в руководстве по PHP .)]]|Однострочная строка|((empty))|
|''excludeMgAndSp''|Учитывать ли менеджеров и суперпользователей (см. настройки "[[wiki:config:manager|Менеджеры]]" и "[[wiki:config:superuser|Суперпользователи]]|''0'' Выберите из выпадающего меню: (Количество), ''sp'' (Суперпользователи не учитываются), (Менеджеры (включая суперпользователей) не учитываются) ''mg''|''0''|
|''exclusionList''|Исключенные IP-адреса/удалённые хосты\\ Доступ с этих IP-адресов или удаленных хостов учитываться не будет.  Используйте эту функцию, если у вас много роботов, получающих доступ с определенного IP-адреса или удаленного хоста.\\ Удаленный хост получается путем обратного поиска IP-адреса (gethostbyaddr).\\ Введите IP-адреса или удаленные хосты, которые необходимо исключить, по одному в каждой строке.\\ Можно использовать следующие подстановочные знаки:\\ ? = 1 символ (буквы и цифры половинной ширины, точка ".", дефис "-")\\ * = 1 или более символов (буквы и цифры половинной ширины, точка ".", дефис "-")\\ ! = 1 символ (только полуширинные числа)\\ ~ = 1 или более символов (только полуширинные числа)\\ \\ Пример: "123.456.???.123" ⇒ 123.456.789.123 и т. д. (123.456.78.123 не исключается)\\ Пример: "*.example.com" ⇒ 123.456.789.123.example.com, 1-2-3-4.rooter.example.com и т. д.|Текстовая область|((empty))|
|''usrExclusion''|Исключенные пользователи и группы пользователей\\  Доступ от пользователей и пользователей, принадлежащих к указанным здесь группам пользователей, учитываться не будет.\\  Введите пользователей или группы пользователей, которых следует исключить, разделив их запятыми.|Однострочная строка|((empty))|
|''cntrExclusion''|Исключенные страны\\  Визиты из этих стран учитываться не будут. Используйте эту опцию, если у вас много роботов из определенной страны.\\  Код страны получен из DNS-сервиса «cc.wariate.jp» ([[http://cc.wariate.jp/|подробности на японском языке]]).\\ Введите двухбуквенные коды стран (ISO 3166-1 alpha-2), разделенные запятыми.|Однострочная строка|((empty))|
|''cntrInclusion''|Указание стран для подсчета\\  Если вы укажете страны с помощью этой опции, будут учитываться только посещения из этих стран.\\  Код страны получен из DNS-сервиса «cc.wariate.jp» ([[http://cc.wariate.jp/|подробности на японском языке]]).\\ Введите двухбуквенные коды стран (ISO 3166-1 alpha-2), разделенные запятыми.|Однострочная строка|((empty))|
|''reverseLookupFailed''|Если обратный поиск IP → удаленный хост не удается, он будет исключен из счетчика (обратный поиск IP-адресов роботов часто отклоняется)|Булевы типы|''0''|
|''reverseLookupException''|IP-адреса, которые являются исключениями для параметра «reverseLookupFailed» выше\\  Введите целевые IP-адреса, по одному в каждой строке.\\  Можно использовать следующие подстановочные знаки:\\  ? = 1 символ\\  * = 1 или более символов\\  Пример: «123.456.???.123» ⇒ 123.456.789.123 и т.д. (123.456.78.123 не исключается)\\  Пример: «123.*.789.123» ⇒ 123.456.789.123, 123.9.789.123 и т.д.|Текстовая область|((empty))|
|''reverseLookupCntrException''|Исключения из параметра «reverseLookupFailed» выше:\\  Код страны получен из DNS-сервиса «cc.wariate.jp» ([[http://cc.wariate.jp/|подробности на японском языке]]).\\ Введите двухбуквенные коды стран (ISO 3166-1 alpha-2), разделенные запятыми.|string|((empty))|
|''sfsExFreq''|Проверять ли показатель частоты IP-адреса посетителя и исключать спам из счетчика (требуется плагин [[plugin:stopforumspam2|Stopforumspam2]]). Введите «0», чтобы отключить проверку. Проверьте, не равно ли оно 0. Вы можете указать пороговое значение, специфичное для этой опции. Если ввести «-1», то в качестве базового значения будет использоваться значение, указанное в настройке «freqBorder» плагина Stopforumspam2, но если ввести значение больше 0, то это значение будет использоваться в качестве базового значения.|Числа (-1 или больше)|''0''|
|''sfsExConf''|Проверять ли рейтинг доверия IP-адреса посетителя и исключать его из счетчика спама (требуется плагин Stopforumspam2).\\  Введите «0», чтобы отключить проверку. Проверьте, не равно ли оно 0. Вы можете указать пороговое значение, специфичное для этой опции. Если ввести «-1», в качестве контрольного значения будет использоваться значение, указанное в настройке «confidenceBorder» плагина Stopforumspam2, но если ввести значение больше 0 (меньше 100), это значение будет использоваться в качестве контрольного значения.|Числа (1-100)|''0''|
|''saveLog''|Запишите IP-адрес, дату и время доступа к Wiki.\\  Журналы сохраняются для каждой страницы. Пожалуйста, используйте это при принятии решения о том, какие IP-адреса, удаленные хосты или страны следует исключить из счетчика. Файлы журнала хранятся в каталоге, называемом\\  каталогом кэша (который по умолчанию находится в [[wiki:config:savedir|каталоге данных]] ''accscounterlog''). При необходимости извлеките или удалите файлы.|''0'' Выберите из выпадающего меню : (Не записывать), ''ppage'' (Записывать (Не разделять файлы по дате)), ''pdate'' (Записывать (Разделять файлы по дате))|''0''|

===== разработка =====

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

  * **2018-07-02**
  * Первоначальный выпуск
  * **2018-07-17**
  * Исправления ошибок (при работе плагина операции (запись журнала, отображение порядка популярности) иногда выполнялись в завтрашнюю дату)
  * **2018-08-08**
  * Исправлена ошибка (я совершил элементарную ошибку, пытаясь записать файл, не создав предварительно каталог)
  * **2018-08-29**
  * Добавление файла htaccess
  * **2018-10-30**
  * МАСШТАБНОЕ ОБНОВЛЕНИЕ! ! Добавлена функция черного списка и система хранения журналов.
  * **2019-02-10**
    * Изменено место хранения данных плагина для обеспечения совместимости с плагинами, такими как [[wiki:plugin:farmer|farmer]]. Любые данные, оставшиеся в исходном месте хранения, можно переместить или удалить. Пожалуйста, ознакомьтесь с уведомлением, которое появляется после обновления плагина..
    * Добавлен функционал с использованием плагина [[wiki:plugin:stopforumspam2|stopforumspam2]].
  * **2019-03-12**
  * **Чтобы упростить удаление плагинов, мы снова** изменили место хранения данных плагинов . Любые данные, оставшиеся в исходном месте хранения, можно переместить или удалить. Пожалуйста, ознакомьтесь с уведомлением, которое появляется после обновления плагина.
  * Добавлен функционал менеджера данных.
  * **2019-10-21**
  * cntrInclusionДобавлены опции .
  * **2019-11-07**
  * Исправления ошибок.

=== Известные ошибки и проблемы ===

(В настоящее время нет)

=== Список дел и пожеланий ===
Я сделаю все возможное, если вы считаете, что это оставляет желать лучшего.

  * Неплохо было бы использовать форматирование CSS . В моем случае счетчик на широкой боковой панели выглядит плохо, номера страниц отображаются только на боковой панели под названием страницы, а не рядом с ней. Это не имеет никакого отношения к боковой панели. Может быть, конфликтует с форматированием боковой панели шаблона Bootstrap3?
===== Свяжитесь со мной =====

Если вы обнаружите какие-либо проблемы в этом плагине, вы можете создать темы для обсуждения на[[https://github.com/hokkaidoperson/DokuWiki-AccsCounter-Plugin|странице GitHub]], или если вы хотите связаться со мной по другим вопросам, вы можете связаться со мной следующим образом:

  * <dosankomali@yahoo.co.jp>
  * [[https://twitter.com/YukkuriDosanko|Мой Twitter]] (аккаунт на японском языке, но английский язык приемлем)

=====Обновление=====
Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше.
=====Дополнения и Файлы=====
  * {{ :wiki:plugin:hokkaidoperson-dokuwiki-accscounter-plugin-2fea97d.zip |Счетчик доступа и плагин популярности}}
  * [[https://www.dokuwiki.org/plugin:accscounter#access_counter_and_popularity_plugin|Ссылка на оригинальную статью]]
=====Лицензия=====
  * **Author:** [[dosankomali@yahoo.co.jp|HokkaidoPerson]]
  * **License:** [[http://www.opensource.org/licenses/gpl-license.php|GNU GPL v2]]