Block. Pro.2 - Расширенный вывод блоков с новостями для DLE
Модуль для удобного и гибкого вывода новостей на любой странице DLE-сайта
Модуль распространяется бесплатно для частного и коммерческого использования
Основные возможности модуля
- Вывод популярных (топ по комментариям, рейтингу, просмотрам или как стандартный топ в dle), похожих, случайных (с возможностью отключения кеширования блока) или последних новостей.
- Подключение модуля одной строкой непосредственно любой в шаблон (через include).
- Простая и очень гибкая настройка вывода каждого блока.
- Кеширование каждого блока (обновление кеша при добавлении новости или комментария на сайт) с возможностью отключения кеша для каждого блока.
- Настройка категорий для вывода новостей (вывод только из определённых категорий, игнорирование определённых категорий, вывод или ингорирование новостей из просматриваемой категории)
- Вывод уменьшенной копии картинки (в т. ч. и вместе с оригинальной картинкой) из короткой новости или дополнительного поля (картинки берутся только из папки uploads текущего сайта).
- Автоматическое создание папки для уменьшенных копий изображений и выставление нужных прав.
- Обрезка заголовка новости до заданного количества символов.
- Обрезка текста новости (до заданного количества символов или до конца слова).
- Ввод иконок категории.
- Можно задать временной интервал для отбора новостей (по умолчанию 30дней).
- Можно задать каждому блоку свой шаблон, свою картинку-заглушку.
- Поддержка всех тегов, используемых в шаблонах кратких новостей.
- Поддержка фильтра (перекрестные ссылки) по допполям, реализованного в DLE9.5
- Можно указать с какой по счету новости начать вывод (например с 4й по 15ю).
- Возможность быстрого редактирования новостей прямо из блока, аналогично стандартному функционалу
Установка модуля
- Скопировать файл block. pro.2.php в папку engine/modules/
- Скопировать содержимое папки THEME в папку с текущим шаблоном сайта
- В нужном месте прописать строку подключения модуля с обязательными параметрами: Где: BLOCK - Уникальный идентификатор блока blockpro - имя шаблона, используемого для вывода
- Настроить дополнительные параметры строки подключения и шаблон
Переменные строки подключения
Теги шаблона
- Модуль адаптирован под DLE 9.6
- Функция показа похожих новостей временно не работает.
- Финальная версия, больше изменений делать не планирую.
- Исправленны все заявленные ошибки.
v.2.5 (RC от 16.03.2012) - проверены окончательно не все функции!
- В очередной раз всё перелопатил, исправил косяки и неровности, и немалую лепту внёс опять Роман (Giseg), за что ему опять ещё большее спасибо!
- Добавлена возможность вывода новостей только из той категории, в которй находится пользователь, либо из всех, кроме текущей (при указании переменной &ignore_cat, каждый блок по преждему кешируется.
- Добавлена возможность быстрого радактирования новостей прямо из блока, аналогично стандартному функционалу.
- Добавлена поддержка фильтра (перекрестные ссылки) по допполям, реализованного в DLE9.5.
- Немного улучшена процедура формирования запросов в БД.
- Можно указать с какой новости начать вывод, для этого в строке подключения нужно указать переменную &start_from=1 (в этом случаи вывод начнётся со второй, попавшей в диапазон, новости). По умолчанию переменная равна нулю и выводятся все новости. Это может понадобиться, когда нужно вывести одну или две новости с одним шаблоном, а остальные с другим).
- Устранены ошибки при обработке картинок в новости (добавлена дополнительная проверка, что бы картинки со сторонних сайтов уж точно не пролазили и не вызывали глюков))).
- Добавлена возможность выводить оригинальную картинку, не обрезая её (в строке подключения достаточно указать &img_size=0).
- Добавлен вывод оригинальной картинки, если происходит её уменьшение. Для этого в шаблон нужно вставить тег . Так же доступны теги которые выводят текст если есть или нет картинки.
- Добавлен вывод рейтинга.
- Добавлена возможность более тонкой сортировки новостей - по количеству комментариев (в строке подключения указываем &top_comm=y), по рейтингу (&top_rating=y), по просмотрам (&top_views=y). ВНИМАНИЕ! - не указывайте одновременно несколько вариантов сортировки
- Добавлена возможность отключать кеширование блока непосредственно в строке подключения, для этого в строке подключения нужно указать переменную &nocache=y (пригодится в процессе настройки блока).
- Для картинки-заглушки введена переменная &noimage в которой можно задать название файла (имя и расширение) для картинки-заглушки (по умолчанию эта переменная имеет вид: &noimage=noimage. png). картинка-заглушка по прежнему должна лежать в папке images текущего шаблона.
- Переменная &category заменена на &show_cat (обнаружил, что в DLE есть глобальная переменная $category, переименовал на всякий случай).
- Переменная &bad заменена на &ignore_cat для большей внятности кода.
- Исправлена переменная на как она пишется в стандартных шаблонах DLE.
- [админам] Возможность выводить время выполнения модуля. Пригодится для отладки (видеть будет только группа id=1) Смотрите закомментрованные строки ниже в коде и в самом конце файла.
- Добавлено автоматическое создание папки blockpro и установка необходимых прав, даже если они были сбиты (например при переезде на новый хостинг).
- Изменена методика создания уменьшенных копий картинок - теперь скрипт берёт только те картинки, которые лежат в папке uploads сайта (все картинки, которые загружаются на сайт обычно туда и попадают). Если картинка будет лежать на сторонем сайте она будет проигнорирована и вместо неё выведется заглушка. Это сделано в целях безопасности сайта и устраниения проблемы с белым листом (Not Supported File! Thumbnails can only be made from. jpg, gif and. png images!), которая возникала при определённых обстоятельствах.
- За изменения в этой версии отдельное спасибо отличному пограммисту Роману (Giseg), если бы не он - врядли были бы эти важные исправления!
- Исправлена ошибка, работы с категориями. При указании категорий, из которых следует выводить новости, они наоборот скрывались.
- Изменен синтаксис перечисления категорий для вывода/скрытия. Теперь категории нужно перечислять через запятую, по аналогии с тем же custom к примеру.
- Добавлена возможность подключить модуль для вывода похожих новостей (отдельное спасибо Sander`у за исправление моих косяков при перелопачивании кода).
- Переписаны имена "модульных" переменных, чтоб не было конфликтов при выводе похожих новостей.
v.2.1(релиза не было)
- Исправлена и оптимизирована функция обрезания содержимого новостей (в некоторыx, непонятныx для меня случаяx содержимое обрезалось полностью). За доработку спасибо nowheremany.
- Изменён вывод блока с новостями. Теперь блок выводится без "обёртки" в общий div с id равным переменной &block_id. (исправлено на случай использования в шаблоне для обёртки новости тегов и оборачивания строки подключения в. В этом случаи блок не проxодил валидацию и не корректно обрабатывался в качестве слайдера (плагин jcarousel)
- Исправлены мелкие ошибки, допущенные в прошлой версии по невнимательности или лени )))
- код модуля переработан.
- модуль переведён на работу с шаблонами.
- убраны лишние комментарии, тот кто разбирается и так поймёт, а чайнику дорога на www. dle-faq. pro