AJAX FULL-STORY 2.0.0 : AJAX-загрузка полной новости

[Rok Friman]

​

Новая версия модуля, для загрузки полной новости в 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
Автор: ПафНутиЙ

Для просмотра скрытого содержимого вы должны войти или зарегистрироваться.