Новая версия модуля, предыдущая версия которого была
опубликована у нас ранее, для загрузки полной новости в DLE средствами AJAX.
Особенности:
- Не требует каких-либо правок движка.
- Учёт прав доступа к новости.
- Подсчёт количества просмотров, если это разрешено.
- Корректная очистка кеша модуля.
- Поддержка всех тегов.
- Кеширование на стороне клиента (модуль отдаёт правильные заголовки).
Установка:
1. Установить как обычный плагин, т.к. файл архива содержит всё необходимое для автоматической установки.
2. В нужном месте шаблона прописать стили и скрипты модуля:
<link href="{THEME}/ajax/fullstory.css" type="text/css" rel="stylesheet">
<link href="{THEME}/ajax/magnificpopup.css" type="text/css" rel="stylesheet">
<script src="{THEME}/ajax/magnificpopup.js"></script>
<script src="{THEME}/ajax/fullstory.js"></script>
*если у вас уже подключен
magnificpopup, то второй раз прописывать не нужно.
В нужном месте любого шаблона вставить минимальный код:
<span data-afs-id="{news-id}">Быстрый просмотр</span>
Где
{news-id} - ID новости (обязательный параметр).
Готово!
Так же можно использовать дополнительные атрибуты:
<span data-afs-id="{news-id}" data-afs-template="mytemplate" data-afs-preset="mypreset">Быстрый просмотр</span>
Где
data-afs-template="mytemplate" - путь к шаблону модуля относительно текущей папки с шаблоном сайта (необязательный параметр). Если на сайте разрешена смена скина, то путь будет построен относительно активного в данный момент шаблона сайта. По умолчанию:
{THEME}/ajax/fullstory.
Где
data-afs-preset="mypreset" - путь к файлу с настройками модуля. По умолчанию не используется.
Модуль принимает через GET-запросы следующие параметры:
- newsId - обязательный параметр. ID новости для показа.
- template - путь к шаблону модуля относительно текущей папки с шаблоном сайта. Если на сайте разрешена смена скина, то путь будет построен относительно активного в данный момент шаблона сайта. По умолчанию: {THEME}/ajax/fullstory.
- preset - путь к файлу с настройками модуля. По умолчанию не используется.
Настройки модуля хранятся в отдельном файле. Это сделано для безопасной передачи настроек и уменьшения нагрузки на хостинг. Для хранения настроек был выбран формат шаблона т.к. его можно отредактировать через админ панель.
При формировании настроек необходимо соблюдать следующий синтаксис:
- Параметры необходимо писать по одному в строке.
- Имя параметра и его значение необходимо разделять знаком равенства.
На данный момент возможно использование следующих параметров:
- fields - поля, отбираемые из БД. Доступны следующие поля для запроса:
- short_story, full_story, xfields, comm_num, fixed, tags
- Так же можно использовать поле all, тогда будут отобраны все возможные поля новости из БД. Аналогичный результат будет, если не передавать в модуль переменную preset или передать пустую.
- cachePrefix - префикс кеша, создаваемого модулем. По умолчанию full. Если вы хотите, чтобы кеш модуля автоматически не чистился - можно изменить этот параметр.
Для того, чтобы стилизовать разные ошибки, выводимые модулем, в соответствии с вашими пожеланиями, необходимо использовать следующие css-классы:
- .afs-error - общий стиль для всех ошибок.
- .afs-news-error - стиль ошибки, если новость не найдена.
- .afs-tpl-error - стиль ошибки, если не найден шаблон.
- .afs-perm-error - стиль ошибки, если не достаточно прав для просмотра полной новости.
•
Версия DLE: 14.х
•
Кодировка: utf-8
•
Автор: ПафНутиЙ
Посетители, находящиеся в группе Гость, не могут оставлять комментарии к данной публикации.