{AJAX FULL-STORY} — модуль AJAX-загрузки полной новости для DLE

Особенности модуля

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

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

Установка

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

   <span data-afs-id="{news-id}">Быстрый просмотр</span>

   
   где

   {news-id}

   - ID новости (обязательный параметр).
   
   
5. Так же можно использовать дополнительные атрибуты:
   
   

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

   
   
   
   
7. В 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;
   }

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

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

{THEME}/ajax/fullstory

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

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