Block.Pro 2.4 - расширенный вывод блоков с новостями для DLE (устарел)

4.12

159

36 409

Модуль предназначен для вывода неограниченного числа блоков с новостями у себя на сайте.

Модуль распространяется бесплатно, и как следствие (а так же по причине отсутствия желания оказывать бесплатную теxподдежку модуля) не ждите от меня исполнения каждого вашего чиxа, возможно исправлю какие то глюки (если таковые найдутся). Будет желание - сделаю несколько прмеров вывода новостей через модуль.
Демо от меня не будет! Если Вам лень установить и посмотреть модуль на своём сайте - ваши проблемы.
В остальном модуль прост и непритязателен для знающиx людей, а новичку не нужно в него соваться, всё равно не поймёт. Достаточно того, что будет написано ниже.

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

- Лёгкая установка модуля, подключение через include.
- Все настройки модуля являются необязательными, указываются непосредственно в строке подключения блока.
- Кеширование каждого блока в отдельный файл, картинки кешируются в отдельную папку.
- Произвольное количество блоков с топами, случайными новостями или последними новостями на страницах.
- Неограниченное количество вариантов вывода блоков за счёт использования шаблонов.
- Расширенная работа с дополнительными полями.
- Оформление модуля производится через tpl и CSS.
- UPD 03.01.2012 Вывод похожих новостей.

Возможности модуля:

Параметры строки подключения:
Минимальная строка подключния должна выглядеть так:

{include file="engine/modules/block.pro.2.php?&block_id=XXX&template=blockpro"}

где XXX - уникальное для каждого блока значение.

&block_id=block1 - Обязательная переменная! Идентификатор блока, уникальное значение для каждого блока.
&template=blockpro - Обязательная переменная! Имя шаблона.

&day=30 - Берём новости за последние 30 дней, Если указать ноль - будут браться новости за всё время (параметр не учитывается, если выводятся последние новости).
&category=1,2,3 - Будут браться новости только с категорий 1, 2 и 3 (начиная с версии 2.3 категории указываются через запятую как например в custom) по умолчанию выводятся все категории.
&bad=y - Превращает список категорий в список исключаемыx категорий.
&news_num=10 - количество новостей в блоке.
&img_xfield=imgae - Имя дополнительного поля с картинкой для создания уменьшенной копии. В данном дополнительном поле должна быть ТОЛЬКО прямая ссылка на изображение формата jpg, jpeg, gif или png.
&img_size=60x60 - Размер уменьшенной копии изображения, возможно задавать как максимальный размер по большей стороне (тогда картинка будет пропорционально уменьшена), так и конкретный размер в формате "шмрина"x"высота" (тогда картинка будет уменьшенна, а излишки обрезаны).
&random=y - Вывод новостей в случайном порядке.
&last=y - Последние новости.
&wordcut=y - Содержимое новости будет обрезано до определённого количества символов (по умолчанию - 80), а если не определять эту переменную, то до конца слова, попадающего в диапазон символов (другими словами конец строки будет не "прив..." а "привет..."

Теги шаблона:
{title limit="30"} - Заголовок, обрезанный до 30 символов.
Block.Pro 2.4 - расширенный вывод блоков с новостями для DLE (устарел) - Полный заголовок.
{text limit="50"} - Краткое содержимое, обрезанное до 50 символов.
{text} - Содержимое краткой новости как есть.
{category-icon} - выводит иконку или иконки (если несколько категорий) новости.

Остальные теги аналогичны таковым в шаблоне shortstory.tpl (все, возможные для использования, теги указаны в шаблоне blockpro.tpl)

Установка:

1. Копируем файл block.pro.2.php в папку /engine/modules/.
2. Копируем файл blockpro.tpl в папку с шаблоном.
~~3. Создаём в папке /uploads/ папку blockpro и прописываем ей CHMOD 777~~ создание папки не обязательно начиная с врсии 2.4
Это для картинок к новостям.
4. Подключаем модуль строкой
{include file="engine/modules/block.pro.2.php?&block_id=XXX&template=blockpro"}

где XXX - уникальный для каждого блока идентификатор, цифры или буквы, разницы нет.

4.Всё готово! Далее настраиваем шаблон и CSS под себя и радуемся жизни.

UPD 03.01.2012

Подключение модуля для показа похожих новостей

1. Идём в админку отключаем вывод похожих новостей на сайте.
2. Открываем файл engine/modules/show.full.php
Находим строку:

if( $config['related_news'] ) {

и ВЫШЕ вставляем:

/*Block.Pro - relatednews*/
$template="relatednews";
$block_id = 'related_'.$row['id'];
$relatedpro = "1";

include_once ENGINE_DIR . '/modules/block.pro.2.php';
/*Block.Pro - relatednews*/

Где:
relatednews - имя шаблона, который будет использоваться для вывода похожих новостей, ожно заменить на свой.
$block_id и $relatedpro крайне не желательно трогать и менять, можно и поломать весь вывод новостей.
Сразу после $relatedpro = "1"; можно писать дополнительные параметры вызова модуля в соответствии с правилами написания php. Например для изменения количества новостей в блоке, пропишите $news_num = 5;

UPD 14.01.2012

- Исправлена ошибка, работы с категориями. При указании категорий, из которых следует выводить новости, они наоборот скрывались.
- Изменен синтаксис перечисления категорий для вывода/скрытия. Теперь категории нужно перечислять через запятую, по аналогии с тем же custom к примеру.

UPD 28.01.2012

- Добавлено автоматическое создание папки blockpro и установка необходимых прав, даже если они были сбиты (например при переезде на новый хостинг).
- Изменена методика создания уменьшенных копий картинок - теперь скрипт берёт только те картинки, которые лежат в папке uploads сайта (все картинки, которые загружаются на сайт обычно туда и попадают). Если картинка будет лежать на сторонем сайте она будет проигнорирована и вместо неё выведется заглушка. Это сделано в целях безопасности сайта и устраниения проблемы с белым листом (Not Supported File! Thumbnails can only be made from .jpg, gif and .png images!), которая возникала при определённых обстоятельствах.
За изменения в этой версии отдельное спасибо отличному пограммисту Роману (Giseg), если бы не он - вряд ли были бы эти важные исправления!

ВНИМАНИЕ!

Все обсуждения модуля теперь только в этой теме или на сайте blockpro.ru