Click Counter от Ozh – счетчик переходов по ссылкам

Это один из первых плагинов, который я установил на сайт themebot.ru для подсчета переходов на страницы тем, количества предпросмотров тем, а также количества скачиваний. Плагин предназначен для подсчета кликов по любым ссылкам на сайте. Данный плагин довольно функционален и в нем много настроек. Админка у него отсутствует, но плагин можно использовать и “по умолчанию”, хотя лучше всего прочитать статью и настроить его как вам угодно.

Содержание:

Создание SQL таблицы
Установка плагина
Как работает плагин
Коды для вставки в шаблон
Остальные функции и настройки плагина Ozh Click Counter
Несколько советов по работе

Автор плагина: Ozh
Страница плагина: http://wordpress.org/extend/plugins/ozh-click-counter
Версия: 1.3
Поддержка WordPress: от 1.5

Создание SQL таблицы:

У данного плагина есть небольшая особенность, чтобы он заработал, необходимо создать SQL таблицу в существующей SQL базе сайта. Данная таблица создается следующим SQL запросом:

CREATE TABLE 'wp_linkclicks' (
'link_id' INT NOT NULL AUTO_INCREMENT,
'link_url' TEXT NOT NULL,
'link_clicks' INT NOT NULL,
'link_date' DATETIME NOT NULL,
'link_title' TEXT NOT NULL,
UNIQUE (
'link_id'
)
);

Установка плагина:

1) Скачиваем плагин отсюда.

2) Заливаем скачанный плагин в папку wp-content/plugins.

3) Внимание! В архиве есть файл go.php (через него осуществляются подсчеты), его необходимо поместить в КОРНЕВОЙ каталог (где находятся папки wp-content, wp-includes,wp-admin).

Как работает плагин:

В принципе всех вышеперечисленных действий по установке плагина достаточно, чтобы плагин работал в режиме “по умолчанию”. А работает он следующим образом. Когда вы вставляете в запись обычную ссылку вида:

<a href="http://yandex.ru">Яндекс</a>

Плагин “на лету” преобразует в ссылку вида:

<a title="(Не было переходов)" onclick="window.location=' http://themebot.ru /go.php?http://yandex.ru'; return false" href="http://yandex.ru">Яндекс</a>

Ссылка может быть как прямой так и через редирект (об этом ниже, см. методы).

Коды для вставки в шаблон:

Автор предусмотрел 2 интересные функции, которые можно вставить в шаблон в любом месте.

1) wp_ozh_click_topclicks($limit, $trim , $pattern) – показывает наиболее популярные ссылки.

2) wp_ozh_click_comment_author_link() – насколько я понял, заменяет стандартный тег comment_author_link(), добавляя к нему счетчик переходов.

Как видим в wp_ozh_click_topclicks есть 3 аргумента:

$limit- сколько ссылок отображать (по умолчанию -5).

$trim – максимальная длина ссылки в символах (по умолчанию -15).

$pattern – html код, используемый для отображения списка ссылок. Это строчка HTML кода со вставленными тегами. По умолчанию имеет вид:

<a title="%%link_title%%" href="%%link_url%%">%%link_title_trim%%</a>: %%link_clicks%%

Тэги заключены между символами %% и %%. Список доступных тегов:

• link_id – ID ссылки в базе SQL.
• link_url- сама ссылка.
• link_clicks - количество переходов по ссылке.
• link_date - дата 1-го клика по ссылке.
• link_title – заголовок страницы, на которую ссылается ссылка.
• link_title_trim - укороченный до величины $trim вариант заголовка

Пример: Воткнув код:

<?php wp_ozh_click_topclicks(5,20, '');?>

в шаблон , получил следующую картину:

Остальные функции и настройки плагина Ozh Click Counter:

Настройка переменных (в начале файла скрипта) :

1) $wp_ozh_click['table'] = ‘wp_linkclicks’ – Название таблицы, куда пишется вся информация.
2) $wp_ozh_click['file'] = get_settings(‘siteurl’) . “/go.php” – имя и адрес файла счетчика.

3) $wp_ozh_click['track_all_links'] = 1 – значение от 0 до 1. Если поставить “1″ то к каждой ссылке автоматически будет приписываться счетчик, если поставить “0″, то счетчик придется прописывать вручную, вот так:

<a href="http://site.com/" count="1">Ссылка</a>

То есть вы как обычно пишите запись в WordPress, вставляете нужную ссылку + дописываете аргумент count=”1″. Во время публикации и отображения записи данный аргумент автоматически убирается, поэтому код не засоряется.

Возможные значения аргумента count:

• count = “1″ : количество переходов будет показываться, так, как будет определено в переменной $wp_ozh_click (см. ниже);
  
• count = “title” : количество переходов добавится в аргумент title ссылки :

  <a href="http://wiki.ru" title="55 переходов">Wiki</a>

• count = “inline” : количество переходов добавится после ссылки в виде обычного текста :

  <a href="http://wiki.ru">Wiki</a> (55 переходов)

• count=”title inline” : количество переходов добавится в аргумент title ссылки и после ссылки в виде обычного текста :

  <a href="http://wiki.ru" title="55 переходов">Wiki</a> (55 переходов)

4) $wp_ozh_click['in_title'] = 1

Значения от 0 до 1.
Отображать количество хитов в аргументе title ссылки (1-отображать;0-не отображать).

5) $wp_ozh_click['in_plain'] = 0

Значения от 0 до 1.
Отображать количество хитов в тексте после ссылки (1-отображать;0-не отображать).

6) $wp_ozh_click['0click'] = ’0 переходов’

Отображает текст “0 переходов” если 0 хитов.

7) $wp_ozh_click['1click'] = ’1 переход’

Отображает текст “1 переход” если 1 хит.

8) $wp_ozh_click['clicks'] = ‘%% переходов’

Отображает текст “%% переходов” если несколько хитов. Вместо %% отображаются цифры.

9) $wp_ozh_click['method'] = 2

Значения от 1 до 3.
Есть разных 3 метода,чтобы прописать счетчик хитов/переходов в ссылке. У каждого есть свои плюсы и минусы. Методы и примеры их работы:

• Method 1:

  <a href="http://yandex.ru"  onclick="window.location='http://вашблог.ру/go.php?http://yandex.ru'; return false">

  “+”: в статусбаре показывается реальная ссылка.
  “-” : счетчик не сработает если выбрать “Открыть ссылку в новом окне/вкладке”

• Method 2:

  <a  href="http://вашблог.ру/go.php?http://yandex.ru">

  “+”: работает если выбрать “Открыть ссылку в новом окне/вкладке”, не использует Javascript;
  “-”: показывает полную ссылку в статусбаре;

• Method 3:

  <a href="http://вашблог.ру/go.php?" part with onmouseover="javascript:window.status='http://site.com';  return  false">

  Совокупность 1 и 2 метода
  “+” : в статусбаре реальная ссылка, работает если выбрать “Открыть ссылку в новом окне/вкладке”.
  “-” : несколько больший код, нужен Javascript.

Лучше использовать 2 или 3 метод, т.к. они работают если выбрать “Открыть ссылку в новом окне/вкладке”.

10) $wp_ozh_click['do_posts'] = 1

Значения от 0 до 1.
Поставьте “1″ если хотите добавить счетчики к ссылкам в постах.

11) $wp_ozh_click['do_comments'] = 1

Значения от 0 до 1.
Поставьте “1″ если хотите добавить счетчики к ссылкам в комментариях.

Now onto the link title features :

12) $wp_ozh_click['get_title'] = 0

Значения от 0 до 1.
Если установить “1″, то счетчик попытается взять заголовок удаленной страницы и записать ее в базу MySQL. Это замедлит работу, но только если клик был самый первый для этой ссылки.
Функция работает при помощи fopen(), поэтому у вашего хостинга должна быть доступна эта функция.

13) $wp_ozh_click['get_title_forcerefresh'] = 50

Значение: любое целое число.
Это количество кликов, через которое нужно обновить заголовок удаленной страницы для данной ссылки.

14) $wp_ozh_click['extensions'] = array ( lots of extensions )

Список расширений не HTML файлов, у которых нет заголовка, поэтому вместо заголовка у них берется название файла (например test.zip).

Параметры для ТОПа ссылок:

15) $wp_ozh_click['top_limit'] = 5

Количество ссылок отображаемых по умолчанию функцией wp_ozh_click_topclicks() (см. выше).

16) $wp_ozh_click['top_pattern'] = ‘<li><a href=”%%link_url%%” title=”%%link_title%%”>%%link_title_trim%%</a>: %%link_clicks%%</li>’

Шаблон по умолчанию для отображения ТОПа ссылок (см. выше).

17) $wp_ozh_click['trim'] = 15

Максимальная длина ссылки по умолчанию (“0″ – если не надо укорачивать)

Несколько советов по работе

1) Используем как счетчик загрузок.

Достаточно вставить аргумент count=”1″ в ссылку и мы получим:

<a href="http://сайт.ру/down.zip" count="1">Скачать файл Down.Zip</a>

2) “Невидимый” счетчик.

Можно использовать счетчик с минимальной нагрузкой на SQL базу, для этого необходимо выставить $wp_ozh_click['track_all_links'], $wp_ozh_click['in_title'] and $wp_ozh_click['in_plain'] на ноль. Теперь количество переходов можно смотреть через phpMyAdmin или с помощью функции wp_ozh_click_topclicks().