Установка скрипта «Следующий\предыдущий материал»

Введение

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

Перед установкой, сделайте полный бэкап шаблонов на случай, если вы в какой-то момент решите вернуть прежний вид сайту или отдельным его элементам. Сделать это можно в Панели управления » Управление дизайном » 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. Заполните поля, продолжайте следовать инструкциям системы. В результате вы должны получить токены. Пошаговая иллюстрация:

Ура, теперь мы получили токены! Откройте папку «nextentry», найдите в нём файл config.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» в правой части окна программы. Обязательно переходим в этот каталог двойным кликом по нему.

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

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

Перейдите в Панель управления » Управление дизайном » Модуль (из списка в описании): Страница материала и комментариев к нему, и в нужное место, где желаете видеть переключатель материалов, разместите код:

<script type="text/javascript" src="/php/nextentry/nextentry.php?module=$MODULE_ID$&id=$ID$&category=$CID$"></script>

и сохраните изменения.

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

Перейдите в Панель управления » Управление дизайном » Общие шаблоны: Таблица стилей (CSS), в самый низ разместите следующий код:

.prew-next { 
    display: inline-block;
    width: 100%;
}
.prew-next_link { 
    float: left;
    padding: 0 3%;
    text-align: center;
    width: 43.7%;
    border-left: 1px dotted #BBBBBB;
    border-right: 1px dotted #BBBBBB;
}
.prew-next_link_st { 
    color: #4B4B4B;
    font: 15px/20px "Arial";
    text-transform: uppercase;
    margin-bottom:10px;
    display:block;
}
.prew-next_link .prew-next_link_st:before {
    content:"« ";
}
.prew-next_next_link .prew-next_link_st:after {
    content:" »";
}
.prew-next_img img{
    width:250px;
}
.prew-next_url {
    font: 700 22px "Arial";
}
.prew-next_url a {
    color: #666;
    text-decoration: none;
}
.prew-next_url a:hover{
    color: #999;
}
.prew-next_desc {
    font-size:11pt;
    text-align:justify;
    margin-top:20px;
}
.prew-next_info {
    padding-top:10px;
}
.prew-next_info span {
    font-size:8pt;
    display:inline;
    margin-right: 10px;
}
.prew-next_info span .e-category {
    background: url(/.s/t/1081/e-category.png) no-repeat left center;
}
.prew-next_info span.e-add {
    background: url(/.s/t/1081/e-author.png) no-repeat left center;
}
.prew-next_next_link { 
    border-left: 0px dotted #BBBBBB;
    border-right: 1px dotted #BBBBBB;
    float: right;
    padding: 0 3%;
    text-align: center;
    width: 43.7%;
}

Информация о классах:

prew-next – весь блок;

prew-next_link – колонка "предыдущий материал";
prew-next_link_st – ссылка "предыдущий\следующий" материал;
prew-next_img img – обращение к изображению;
prew-next_url – заголовок материала;
prew-next_url a – обращение к ссылке заголовка материала;
prew-next_desc – описание материала;
prew-next_info – информация к материалу (дата добавления, имя автора, количество комментариев);

prew-next_info span.e-category – обращение к категории;
prew-next_info span.e-add – обращение к дате добавления материала;
prew-next_info span.e-reads – обращение к количеству комментариев;

prew-next_next_link – колонка "следующий материал".

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

В скрипте можно вывести дополнительную информацию.

Общие переменные.

ID – ID материала;
READS – количество просмотров материала;
TITLE – заголовок материала;
HGU_TITLE – ЧПУ материала;
MESSAGE – описание материала;
DESCRIPTION – краткое описание материала;
ENTRY_URL – полная ссылка на материал;
CATEGORY_NAME – название категории, в которую входит материал;
CATEGORY_URL – ссылку на категорию материала;
COMMENTS_DESCRIPTION – описание категории;
COMMENTS_ID – ID-категории;
AUTHOR – имя добавившего материал;
RATING – рейтинг материала (общая сумма рейтинга/на количество голосов, в формате 2016-03-26 16:23);
READS_NUM – количество голосов (рейтинг);
ADD_DATE – дата добавленного материала (в формате 26-05-2015);
OTHER1 – вывод дополнительного поля 1 (где единица – номер этого поля, как правило от 1 до 10).
FILES_0_FULL – прямая ссылка на ПЕРВОЕ загруженное изображение (полное изображение, где нуль – номер изображения, как правило от 0 до 50).
FILES_0_SMALL – прямая ссылка на ПЕРВОЕ загруженное изображение (маленькое изображение, где нуль – номер изображения, как правило от 0 до 50).

Модуль "каталог файлов".

comments_url – ссылка на страницу материала с комментариями;
comments_num – количество добавленных комментариев к материалу;
author_email – email автора материала;
author_site – ссылка на сайт автора;
loads – количество загрузок файла;
who_add – никнейм пользователя, добавивший материал;
filters – в какие фильтры входит материал;
archlink_direct – ссылка для скачивания архива с другого сервера (чистое значение);
os – значение поля "операционная система";
proglink – ссылка на источник материала;
section_url – ссылка на раздел, в который входит категория материала;
section_name – название раздела;
section_id – ID раздела;
versions – значение поля "Версия материала";
language – выбор из пункта "Язык платформы";
screenshot – прямая ссылка на скриншот;
doclink – ссылка на страницу документации к материалу.

Модуль "каталог сайтов".

comments_url – ссылка на страницу материала с комментариями;
comments_num – количество добавленных комментариев к материалу;
author_email – email автора материала;
author_site – ссылка на сайт автора;
link2site – значение поля "Ссылка на сайт";
who_add – никнейм пользователя, добавивший материал;
redirects – количество переходов на сайт.

Модуль "каталог статей".

author_email – email автора материала;
author_site – ссылка на сайт автора;
link2source – ссылка на источник материала
who_add – никнейм пользователя, добавивший материал;

Модуль "доска объявлений".

comments_url – ссылка на страницу материала с комментариями;
comments_num – количество добавленных комментариев к материалу;
author_email – email автора материала;
author_site – ссылка на сайт автора;
phone – значение поля "Телефон автора";
who_add – никнейм пользователя, добавивший материал;

Модуль "онлайн-игры".

comments_url – ссылка на страницу материала с комментариями;
comments_num – количество добавленных комментариев к материалу;
author_email – email автора материала;
author_site – ссылка на сайт автора;
loads – Количество скачиваний игры;
who_add – никнейм пользователя, добавивший материал;
filters – в какие фильтры входит материал;
link2mob – ссылка на файл игры для Mobile;
plays – количество воспроизведений игры;
link2mac – ссылка на файл игры для Mac;
link2pc – ссылка на файл игры для PC;
scrsize – размер скриншота (Kb);
swf_object_url – ссылка на SWF файл игры;
swf_playground_height – высота SWF игры;
swf_playground_width – прямая ссылка на SWF файл игры;
swf_link2swf – в какие фильтры входит материал;
screenshot – прямая ссылка на скриншот.

В шаблоне вывода можно установить условия, напримере: [ЕСЛИ параметр выдает правду = будет вывод, в ином случае ложь (невывод)] тут что-то [конец условия], в коде это будет:
<?if($NEXT_PHONE):?> текст <?endif;?> – в данном случае, если в материале заполнено поле "Телефон автора", в модуле доска объявлений, будет вывод любого текста внутри условия. Это может быть "ура, вы заполнили поле автора!". Если, конечно, не заполнено поле, то что будет внутри условия - ничего не выведется. Это удобно в том случае, если вы например верстаете и вам нужно чтобы какой-то тег или текст был виден исключительно тогда, когда то или иное поле заполнено (есть что выводить).

Вносить изменения нужно непосредственно в файл template.txt, который мы загружали на FTP PHP. Вывод материалов разделяется на две части. Первый часть кода выводит информацию предыдущего материала, второй участок кода – следующий материал (если есть).

Например, если мы хотим вывести дополнительное поле 1 добавленного материала, откройте файл template.txt и найдите следующий отрывок кода:

<?if($PREV_ENTRY_URL):?>
  <div class="prew-next_link">
    <div class="prew-next_link_st"><a href="<?=$PREV_ENTRY_URL?>"> Предыдущий материал </a></div>
    <?if($PREV_FILES_0_FULL):?><div class="prew-next_img"><img src="<?=$PREV_FILES_0_FULL?>"></div><?endif;?>
    <div class="prew-next_url">
      <a href="<?=$PREV_ENTRY_URL?>"><?=$PREV_TITLE?></a>
    </div>
    <div class="prew-next_desc">
    <?=mb_substr($PREV_MESSAGE,0,200)?><?if(mb_strlen($PREV_MESSAGE)>200):?>...<?endif;?><!-- "' -->
    </div>
    <div class="prew-next_info">
    <?if($PREV_CATEGORY_URL):?><span class="e-category"><a href="<?=$PREV_CATEGORY_URL?>"><?=$PREV_CATEGORY_NAME?></a></span><?endif;?>
    <?if($PREV_AUTHOR):?><span class="e-add"><a href="/index/8-0-<?=$PREV_AUTHOR?>"><?=$PREV_AUTHOR?></a> (<?=$PREV_ADD_DATE?>)</span><?endif;?>
    <?if($PREV_READS):?><span class="e-reads"><?=$PREV_READS?></span><?endif;?>
    </div>
  </div>
<?endif;?>

этот отрывок кода для предыдущего материала. А для следующего материала:

<?if($NEXT_ENTRY_URL):?>
  <div class="prew-next_next_link">
    <div class="prew-next_link_st"><a href="<?=$NEXT_ENTRY_URL?>"> Следующий материал </a></div>
    <?if($NEXT_FILES_0_FULL):?><div class="prew-next_img"><img src="<?=$NEXT_FILES_0_FULL?>"></div><?endif;?>
    <div class="prew-next_url">
      <a href="<?=$NEXT_ENTRY_URL?>"><?=$NEXT_TITLE?></a>
    </div>
    <div class="prew-next_desc">
    <?=mb_substr($NEXT_MESSAGE,0,200)?><?if(mb_strlen($NEXT_MESSAGE)>200):?>...<?endif;?><!-- "' -->
    </div>
    <div class="prew-next_info">
    <?if($NEXT_CATEGORY_URL):?><span class="e-category"><a href="<?=$NEXT_CATEGORY_URL?>"><?=$NEXT_CATEGORY_NAME?></a></span><?endif;?>
    <?if($NEXT_AUTHOR):?><span class="e-add"><a href="/index/8-0-<?=$NEXT_AUTHOR?>"><?=$NEXT_AUTHOR?></a> (<?=$NEXT_ADD_DATE?>)</span><?endif;?>
    <?if($NEXT_READS):?><span class="e-reads"><?=$NEXT_READS?></span><?endif;?>
    </div>
  </div>
<?endif;?>

Отличаются они лишь переменными — $PREV и $NEXT.

Итак, вам нужно сделать код по аналогу — <?=$PREV_TITLE?>. Выделенное красным заменяем на OTHER1. Должно получиться: — <?=$PREV_OTHER1?>. И этот код дублируем и для следующего материала, меняя только с $PREV на $NEXT, в итоге – <?=$NEXT_OTHER1?>.

P.S. в том случае, если вы желаете использовать упрощенный вариант:

откройте файл template.txt, который размещен в папке nextentry на FTP PHP и замените весь код на:

<div class="prew-next">
<?if($PREV_ENTRY_URL):?>
  <div class="prew-next_link">
    <div class="prew-next_link_st">Предыдущий материал</div>
    <div class="prew-next_url">
      <a href="<?=$PREV_ENTRY_URL?>"> <?=$PREV_TITLE?> </a>
    </div>
  </div>
<?endif;?>
<?if($NEXT_ENTRY_URL):?>
  <div class="prew-next_next_link">
    <div class="prew-next_link_st">Следующий материал</div>
    <div class="prew-next_url">
      <a href="<?=$NEXT_ENTRY_URL?>"> <?=$NEXT_TITLE?> </a>
    </div>
  </div>
<?endif;?>
</div>

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