Что нового

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

  • Автор темы Rok Friman
  • Дата начала
Rok Friman

Rok Friman

Участник
Регистрация
12 Авг 2021
Сообщения
17
Реакции
77
1611198991 ajax full story 2 0 0 ajax zagruzka polnoj novosti

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


 
Последнее редактирование:

Пользователи, просматривающие данную тему

Верх