Модуль DLE Block.Pro.3.3.5

стандартный топ новостей (алгоритм такой же как в DLE);
топ по комментариям;
топ по просмотрам;
топ по рейтингу;
похожие новости (причём не обязательно в полной новости, но об этом ниже);
последние новости;
новости в алфавитном порядке;
новости в случайном порядке.

Подключение одной строкой в любой шаблон сайта.
Полноценный вывод дополнительных полей.
Полноценный вывод похожих новостей без правок движка.
Гибкое кеширование каждого блока.
Работа с картинками.
Фильтры.

Работа с картинками
Одно из основных преимуществ Block.Pro.3 – гибкая работа с картинками.
У модуля собственный php-класс для работы с изображениями, благодаря которому можно выводить картинки именно так, как это требуется в конкретной ситуации.

Допустим нам нужно вывести картинку, взятую из полной новости, уменьшить её так, чтобы каждая сторона была не более 100px, при этом некоторые картинки у нас лежат на радикале, а для оптимизации изображений качество картинки должно быть 75. Спустя минуту работы с генератором мы имеем вот такую строку подключения:

[quote]image=full_story – берём картинку из полной новости.
remoteImages=y – разрешаем показывать сторонние картинки (в нашем случаи это радикал)
grabRemote=y – разрешаем тянуть сторонние картинки к себе на сайт
imgSize=100 – устанавливаем размер создаваемой миниатюры
imgQuality=75 – устанавливаем требуемое качество изображений
Опытные пользователи заметят, что не хватает параметра, отвечающего за метод ресайза изображений, которых в модуле аж пять штук – авто (вписывание в рамки), уменьшение по ширине, уменьшение по высоте, точный размер и crop (уменьшение до заданных размеров с обрезкой лишнего).
Он не указан, т.к. вписывание в рамки – это значение по умолчанию.
Теперь достаточно прописать в шаблоне модуля тег[/quote]

{image}

– для вывода уменьшенной копии, и

{full-image}

– для вывода оригинала.
Все уменьшенные картинки будут загружены в созданную папку uploads/blockpro/100/{год и месяц новости}/ при первом вызове модуля, и после этого будут браться уже готовые картинки из нужных папок. Создание подобной иерархии папок даёт возможность удалять только те картинки, которые не нужны в данный момент, к примеру вы меняете размер изображений в блоке со 100 на 150 и удаляете всю папку uploads/blockpro/100. К тому же при очень большом количестве картинок сервер не будет тупить, как если бы картинки лежали в одной папке.
В случаи, если вдруг в полной новости не окажется картинки – будет подставлена заглушка, которую также можно легко настроить. Достаточно прописать переменные:
noimage=small.jpg – для маленькой заглушки (вместо уменьшенной копии изображения)
noimageFull=big.png – для большой заглушки (вместо оригинальной картинки)
При этом указанные изображения должны лежать в папке /blockpro/ текущего шаблона сайта.

А вот такая строка:

[quote]{include file="engine/modules/blockpro/block.pro.3.php?&cacheLive=1440&limit=5&catId=1,2,3&sort=date&remoteImages=y&grabRemote=y&imgSize=250x150&imgQuality=80&resizeType=crop&titleLimit=50&textLimit=140"}[/quote]

Пять последних новостей из категорий 1,2,3 с картинкой из краткой новости, уменьшенной по меньшей стороне и обрезанной по большей до размера 250x150px, качества 80% не зависимо от расположения картинки (радикал тоже подтянется на сайт), с обрезанным до 50 символов, заголовком и до 140 символов текстом новости, кеш блока будет обновляться не чаще одного раза в сутки.
При этом в модуле есть защита от кривых рук админа, когда он не склеивает домены с www и без www, картинки всё равно будут отображаться правильно (в предыдущих версиях модуля на одном из сайтов выводились заглушки).

С картинками разобрались, идём дальше…

Похожие новости
Возможность вывода похожих новостей в любом месте сайта – не менее значимая возможность модуля.
Приведу простой пример того, как можно заменить вывод стандартных похожих новостей.
Простая строка подключения, расположенная в fullstory.tpl:

{include file="engine/modules/blockpro/block.pro.3.php?&template=blockpro/relates8&cacheLive=7200&limit=8&sort=none&titleLimit=30&textLimit=150&related=this"}[/quote]

Выведет нам блок с 8-ю новостями, похожими на просматриваемую в данный момент, блок будет обновляться не чаще чем раз в пять дней, для вывода будет использован шаблон {ТЕКУЩИЙ_ШАБЛОН}/blockpro/related8.tpl (его конечно же необходимо предварительно создать).
sort=none - обязательная переменная для того, что бы полностью повторить функционал стандартных похожих новостей
А вот самое интересное начинается в шаблоне:

<div class="related-item">
    <a href="{full-link}" title="{full-title}">{title} [comments]({comments-num})[/comments]</a>
    {category-icon} <span>{date="d.m.Y"}</span> | <span>{short-story}</span>
</div>

Помимо заголовка и текста новости, обрезанных до заданного количества символов (до логического завершения слова) в похожих новостях будет выведено количество комментариев, иконка, или иконки категорий и дата новости, стандартные похожие новости этого пока не умеют. И всё это без каких либо правок движка.

А теперь усложним задачу, и выведем на главной странице блок из трёх новостей, у каждой из которых будет свой блок похожих новостей, примерно как на картинке.

Большой пост о Block.Pro.3 или как с лёгкостью заменить custom, related-news и topnews в DLE 9.6-10.0 всего одной строкой.


Первая строка подключения выведет три основных новости:

{include file="engine/modules/blockpro/block.pro.3.php?&template=advanced&limit=3&sort=date"}


А в шаблоне {ТЕКУЩИЙ_ШАБЛОН}/advanced.tpl прописываем ещё одну строку подключения:

{include file="engine/modules/blockpro/block.pro.3.php?&template= blockpro/relatedmain &cacheLive=7200&limit=3&sort=none &related={news-id}"}


Таким образом переменная: related={news-id} будет принимать значение id новости, а уже по этому id ищутся похожие новости и выводятся отдельным шаблоном {ТЕКУЩИЙ_ШАБЛОН}/blockpro/relatedmain.tpl.

Идём дальше…

Фильтры
Фильтры – основной способ сократить выборку новостей до интересующего диапазона. Block.Pro.3 имеет следующие фильтры:

по авторам
по категориям
по id новостей
по дополнительным полям (заполнено/не заполнено)

Все фильтры могут принимать множественные свойства, перечисляемые через запятую. Могут исключать из вывода указанные значения, а также могут сочетаться исключающие и разрешающие фильтры.

Самый простой пример практического применения фильтров – вывод новостей пользователя при просмотре его профиля. Расположим вот такую строку в файле userinfo.tpl:

{include file="engine/modules/blockpro/block.pro.3.php?&author=this&day=15"}

И выведутся топ 10 новостей за последние 15 дней того пользователя, чей профиль мы в данный момент просматриваем. При этом для каждого просмотренного профиля пользователя будет создан свой кеш-файл, что значительно снижает нагрузку на хостинг, а если указать время жизни кеша – так и вообще сводит её к минимуму.

Рассмотрим пример по сложнее.
Допустим нам необходимо дать возможность модератору самостоятельно регулировать вывод конкретных новостей в блок «Выбор редакции» на сайте, при этом ему запрещен доступ к правке шаблона, но имеется доступ к управлению рекламными материалами. Всё очень просто: создадим баннер с произвольным именем, например newsid и в контент баннера напишем: 1-6,8-15,22-30, а в строке подключения пропишем так:

{include file="engine/modules/blockpro/block.pro.3.php?postId={banner_newsid}"}

таким образом в блоке будет выведен топ 10 новостей, имеющих id с 1 по 6, с 8 по 15 и с 22 по 30 включительно. При этом модератор спокойно может управлять содержимым блока.

Ещё один пример
Требуется вывести самые просматриваемые новости за прошлую неделю. Нет проблем!

{include file="engine/modules/blockpro/block.pro.3.php?cacheLive=10080&day=14&dayCount=7&sort=views&showSmall=y"}


где cacheLive=10080 - время кеширования блока равное одной неделе (60мин*24ч*7д).

И на последок сложный пример:

{include file="engine/modules/blockpro/block.pro.3.php?cacheLive=60&limit=5&catId=14,15&notPostId=1,5&notAuthor=admin,user&sort=random&avatar=y"}

в блоке будут показаны 5 случайных новостей с аватарками авторов, находящихся в категориях 14 и 15, при этом новости авторов admin и user, а также новости с id 1 и 5 не будут выводиться в блоке. Кеш блока будет обновляться не чаще, чем раз в час.

В заключение
Если вы всё же не можете определиться использовать стандартные средства DLE или модуль, для вас есть специальная таблица сравнения функционала custom и Block.Pro.3.

Большой пост о Block.Pro.3 или как с лёгкостью заменить custom, related-news и topnews в DLE 9.6-10.0 всего одной строкой.

В статье рассмотрены далеко не все возможности модуля, а лишь те, что явно выделяют модуль среди других подобных и отличают его от custom, topnews и related-news. Наиболее полная документация по Block.Pro.3 и удобный генератор строк подключения представлена на официальном сайте модуля.