AJAX FULLSTORY

Категория: Модули DLE » Модуль для DLE 11.2, 11.1, 11.0, 10.6, 10.5, 10.4, 10.3, 10.2, 10.1, 10.0, 9.8, 9.7, 9.6, 9.5, 9.4, 9.3, 9.2, 9.0
AJAX FULLSTORY
Представляем на http://www.dle9.com/ все для портала dle новый бесплатный модуль для DLE AJAX-загрузки полной новости {AJAX FULL-STORY}, позволяет сделать быстрый просмотр полной новости на AJAX. {AJAX FULL-STORY} — модуль AJAX-загрузки полной новости для DLE (под управлением DataLife Engine ) позволяет организовать на сайте быстрый просмотр полной новости на AJAX. Благодаря кешированию и продуманному коду он работает очень эффективно. Модуль для дле получился в процессе работы над другим модулем и обладает рядом преимуществ по сравнению с аналогами.



Требования к установке

- Версия : DLE 10.2 + (на более старых не проверялся, но должен работать вплоть до 9.6)
- Прямые руки.

Установка

- Скачать актуальную версию модуля
- Если сайт работает в кодировке windows-1251, необходимо перекодировать файлы модуля в эту кодировку.
- Распаковать содержимое папки upload в корень сайта.
- В нужном месте любого шаблона вставить минимальный код:

<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" - Путь к файлу с настройками модуля. По умолчанию не используется.


- В js файл шаблона вставить:

$(document).on('click', '[data-afs-id]', function () {
    var $this = $(this),
        $data = $this.data();

    $.ajax({
            url: dle_root + 'engine/ajax/full-story.php',
            type: 'GET',
            dataType: 'html',
            data: {
                newsId: $data.afsId, // Обязательная переменная
                preset: ($data.afsPreset) ? $data.afsPreset : '', // Название файла с настройками (необязательно)
                template: ($data.afsTemplate) ? $data.afsTemplate : '', // Название файла с шаблоном (необязательно)
            },
        })
        .done(function (data) {
            var $html = $(data);

            // Данные получены, можно заняться разбором и показать их в диалоге
            // Ниже простейший пример вывода контента в стандартном модальном окне DLE

            var modalId = 'afs-' + $data.afsId + '-' + $data.afsPreset + '-' + $data.afsTemplate;
            modalId = modalId.replace(/\//g, "-");

            var $modalBlock = $('<div style="display: none;"><div id="' + modalId + '"></div></div>');

            $modalBlock
                .appendTo('body') // Добавляем блок на страницу
                .find('#' + modalId) // Ищем интересующий нас селектор
                .html($html) // Вставляем в него полученный код
                .dialog({ // Показываем модальное окно
                    width: 800
                });

        })
        .fail(function () {
            console.log("full-story error");
        });
});


- В CSS-файл шаблона вставить код для стилизации выводимых ошибок:

.afs-error {
    /*Общий стиль для всех ошибок*/
    padding: 20px;
    background: #fff;
    color: #424242;
}
.afs-news-error {
    /*Стиль ошибки, если новость не найдена*/
    background: #eceff1;
}
.afs-tpl-error {
    /*Стиль ошибки, если не найден шаблон*/
    color: #b71c1c;
}
.afs-perm-error {
    /*Стиль ошибки, если не достаточно прав для просмотра полной новости*/
    background: #e65100;
    color: #F5F5F5;
}

- Не забудьте подправить JS и CSS код под свой сайт smile.

Параметры, принимаемые модулем

Модуль принимает через GET-запросы следующие параметры:
- newsId - Обязательный параметр. ID новости для показа.
- template - Путь к шаблону модуля относительно текущей папки с шаблоном сайта. Если на сайте разрешена смена скина, то путь будет построен относительно активного в данный момент шаблона сайта. По умолчанию:
{THEME}/ajax/fullstory

- preset - Путь к файлу с настройками модуля. По умолчанию не используется.

Настройки модуля

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

При формировании настроек необходимо соблюдать следующий синтаксис:
- Параметры необходимо писать по одному в строке.
- Имя параметра и его значение необходимо разделять знаком равенства.

На данный момент возможно использование следующих параметров:

- fields - Поля, отбираемые из БД.
Доступны следующие поля для запроса:
- short_story, full_story, xfields, comm_num, fixed, tags
- Так же можно использовать поле all, тогда будут отобраны все возможные поля новости из БД. Аналогичный результат будет, если не передавать в модуль переменную preset или передать её пустой.
- cachePrefix - Префикс кеша, создаваемого модулем. По умолчанию full. Если вы хотите, чтобы кеш модуля автоматически не чистился - можно изменить этот параметр.
Из
Подробнее о настройках и работе с модулем читайте в обновляемой документации github.

Автор: Pavel Belousov (pafnuty)

Надеюсь модуль будет полезен не только мне. Жду ваших отзывов! Скачать из раздела модули для dle новый скрипт у нас
  • 60
Рубрика: DLE модули » Бесплатные
Ранее » Модуль Трансляции Stream-info для DLE 10.x-10.4« Далее DLE модификация ShowMore
Добавление комментарияОставить комментарий