Установка скрипта «Похожие материалы по ID»

Введение

Установка скриптового решения займет некоторое время. Пожалуйста, внимательно читайте инструкции и старайтесь следовать всем рекомендациям.

С помощью скрипта похожих материалов, вы сможете лично активизировать пользовательский интерес! Возможность нестандартной подборки похожих материалов это не только привлечение интереса, но и ориентирование посетителя ресурса в нужном вам направлении. Таким образом посетитель вашего сайта становится корректно "управляемым". Вам это позволяет достигнуть максимального увеличения посещаемости и повышение лояльности пользователей к вашему проекту, что положительно сказывается на продвижении.

Стандартно в системе присутствует возможность подбора и последующего вывода схожих материалов в зависимости от совпадений в указанных тегах, однако это не всегда удобно. Новое скриптовое решение действует более гибко и надёжно. Вам более не придется вручную указывать похожие материалы через работу с кодом и не заботиться о совпадениях в тегах материалов. Скрипт позволяет владельцу сайта лично составлять подбор похожих материалов для выдачи пользователю с помощью визуального интерфейса.

    Доступно для модулей:
  • новости сайта;
  • блог;
  • каталог файлов;
  • каталог статей;
  • каталог сайтов;
  • доска объявлений;
  • онлайн-игры.

    Требования к установке:
  • активированное PHP;
  • использование API;
  • одно свободное дополнительное поле.


Перед установкой, сделайте полный бэкап шаблонов на случай, если вы в какой-то момент решите вернуть прежний вид сайту или отдельным его элементам. Сделать это можно в Панели управления » Управление дизайном » Backup шаблонов.

Первый шаг: активация uAPI и PHP


Этап 1. Активация uAPI для нужного модуля

Для активации uAPI в том модуле, где нужна работоспособность скрипта, перейдите в настройки этого модуля и напротив пункта «Включить uAPI для модуля» установите галочку, затем прокрутите страницу вниз и сохраните изменения.


Этап 2. Получение токен-доступов для uAPI

Перейдите на страницу http://uapi.ucoz.com/uapi_panel, авторизуйтесь под своим uID-профилем.

После авторизации, вы увидите интерфейс управления uAPI-приложений. Нам нужно создать приложение. Нажмите на «Создать» и введите все те данные, которые запросит форма.
  • В пункте «Название приложения» можно написать свое название (абсолютное любое);
  • В пункте «Consumer key» введите любой набор латинских букв, как например: hFFSJjknfsdgF87T, рекомендуем сгенерировать;
  • В пункте «Consumer secret» оставляем всё как есть;
  • В пункте «Redirect URL» введите ссылку на свой сайт (куда собираетесь подключить скрипт);
  • Нажмите на Сохранить.


Этап 3. Создание токенов

Перейдите на страницу http://api.ucoz.net/ru/join/reg, выберите «Полуавтоматом». Далее вам предложат ввести данные – их вы можете взять со страницы http://uapi.ucoz.com/uapi_panel. Заполните поля, продолжайте следовать инструкциям системы. В результате вы должны получить токены. Пошаговая иллюстрация:








Ура, теперь мы получили токены. Зайдите папку «entry», которая находится в архиве со скриптом, найдите в нём файл uAPImodule.php и откройте его в любом текстовом редакторе. Затем пропишите в этом файле данные ключей, которые вы только получили.


Активация PHP

Убедитесь, что на вашем сайте активна услуга PHP. Для этого перейдите на главную страницу панели управления и обратите внимание на правую часть страницы. В случае наличия активной услуги вы увидите текст "PHP детали".
– перейдите к следующему шагу установки, PHP-услуга у вас активна. Если такой текст отсутствует, значит услуга PHP отключена или просрочена. Для подключения PHP необходимо оплатить премиум пакет, включающий возможность использования PHP-скриптов, либо заказать данную услугу отдельно.

Второй шаг: загрузка скриптов на FTP PHP


Этап 1. Установка пароля

Если у вас задан пароль к FTP PHP, сразу же переходите к следующему этапу.
Перейдите на главную страницу панели управления вашим сайтом, в правой верхней части нажмите на ссылку «PHP детали».
В открывшемся окне кликните на ссылку: «Пароль не установлен.
Мы попадем на страницу установки пароля на FTP PHP. Заполните поля, продолжайте следовать инструкциям системы.

Этап 2. Подключение к PHP FTP серверу

После установки пароля, скачайте FTP-клиент, рекомендуем бесплатный FTP клиент FileZilla. После установки программы, в верхней части вводим параметры подключения:

  • Сервер: s2000.ucoz.net
  • Логин (FTP login): введите свой логин, который указан в меню "PHP детали"
  • Пароль: пароль который вы ввели ранее в специальном разделе

После заполнения полей нажмите на кнопку «Быстрое соединение».


Этап 3. Загрузка скриптов на PHP FTP сервер

После успешного подключения вы увидите каталог под именем «scripts» в правой части окна программы. Обязательно переходим в этот каталог двойным кликом по нему.

Теперь загрузите в этот каталог папку из архива со скриптом «entry». Загрузить легко, просто перетащите эту папку в правый диалог (где отображаются каталоги и файлы хранящиеся на сервере).
Узнать статус передачи файлов вы можете в окне статуса, которое находится в нижней части программы, там отображаются файлы которые ожидают передачи и те, которые не удалось передать, в частности которые были успешно переданы.

Третий шаг: установка кода


В одном из модулей, который поддерживает этот скрипт, в шаблоне «Страница материала и комментариев к нему» после системной переменной $MESSAGE$ (или в другое место, где желаете вывести блок с похожими материалами) разместите код:
<?if($OTHER1$)?><h2>Что говорят другие?</h2>
<script type="text/javascript">
    $(document).ready(function(){ 
	$("#feeds").load("/php/entry/relatedentry.php?module=$MODULE_ID$&id=$OTHER1$");
    }); 
</script>
<div id="feeds">Происходит загрузка...</div><?endif?> 
Выделенное красным – номер дополнительного поля (от 1 до 5). Служит для указания ID-материалов.

В модуле каталоге файлов и каталога статей, например, отсутствуют дополнительные поля, поэтому вместо $OTHER1$ используйте любую другую переменную, соответственно в коде вывода она должна быть заменена. На примере, для каталога файлов воспользуемся полем "Ссылка на источник материала", в коде будет выглядеть так:
<?if($SOURCE_URL$)?><h2>Что говорят другие?</h2>
<script type="text/javascript">
    $(document).ready(function(){ 
	$("#feeds").load("/php/entry/relatedentry.php?module=$MODULE_ID$&id=$SOURCE_URL$");
    }); 
</script>
<div id="feeds">Происходит загрузка...</div><?endif?> 
Для модуля "каталог статей" тоже можно использовать это поле, однако вместо $SOURCE_URL$ установите $SOURCE$.
* Перед использованием этой переменной, перейдите в настройки модуля каталога файлов и активируйте её, также отключите автоматическое добавление префикса "http://" для этого поля.

Четвёртый шаг: установка стилей


Перейдите в Панель управления » Управление дизайном » Общие шаблоны: Таблица стилей (CSS), в самый низ шаблона разместите код:
.rel_div {
    padding: 22px;
    border: 2px solid #B40001;
    border-radius: 10px;
    margin-bottom: 10px;
}
.rel_div_image {
    text-align: center;
}
.rel_image {
    max-width: 90%;
}
    Информация о классах:
  • rel_div – общий блок с материалом;
  • rel_div_image – блок с изображением;
  • rel_image – обращение к изображению.

Пятый шаг: настройка и использование


  • Дополнительное поле
  • В первую очередь нам необходимо активировать дополнительное поле в том модуле, где мы собираемся использовать этот скрипт. Перейдите в настройки модуля, и найдите пункт "Поля для добавления материалов", напротив него установите галочку одного из свободных полей. В инструкции рассматривается пример на дополнительном поле 1, заменить номер дополнительного поля вы можете в том месте, где отмечено красным $OTHER1$
  • Присвоение похожих материалов
  • Чтобы материалу присвоить похожие материалы, перейдите в редактирование материала. Там вы увидите дополнительное поле (его, кстати говоря, можно переименовать в Панели управления » Верхний-бар: Настройки » Замена стандартных надписей). В него вам необходимо вводить ID похожих материалов: например, в виде 1,2,3,27,90 (именно через запятую, без пробелов). Пример:
  • ID материала (уникальный индентификатор)
  • Определить уникальный индентификатор (ID) материала можно двумя способами:
    • разместив системную переменную $ID$ в шаблон "Страница материала и комментария к нему", полученное значение от переменной и будет ID-материала;
    • зайдя на страницу материала, в конце адреса и будет ID этого материала, пример: http://demo.uscript.pro/load/test2/1-1-0-2

Обратите внимание, что шаблон материала формируется непосредственно в файле releatedentry.php в переменной $template (строки 49 (для блога и новостей) и 65 (для доски объявлений)). Стандартный вид:
$template = '<div class="rel_div"><a href="'.$entry_url.'">'.$screenshot2.'</a><h3><a href="'.$entry_url.'">'.$title.'</a><h3>'.$entry_message.'</div>';
  • $entry_url – выводит ссылку на материал
  • $screenshot2 – выводит ссылку на скриншот (изображение) материала
  • $title – выводит название материала
  • $entry_message – выводит описание материала*
* Не всегда хорошо, когда все описание выводится. Поэтому здесь можно воспользоваться следующим решением. Зайдите на FTP PHP в папку «entry», откройте файл relatedentry.php и найдите следующий отрывок:
$entry_message = $getinfofrom['message'];
и после него пропишите:
$entry_message = strip_tags($entry_message, '<p>');
$entry_message = substr($entry_message, 0, 200);
Эти строки выполнят следующие: обрежут html-теги из текста, но оставят параграфы (p), в частности обрежут количество выводимых символов до 200. Цифру 200, разумеется, вы можете менять на своё значение.

В следующих версиях будет расширение модулей, а после этого и расширение функционала + интерфейсная часть.

Установка завершена. Если у вас возникли вопросы, которые не затрагивались в документации, спрашивайте в комментариях к товару.