Block.Pro.2.5

29.03
334
32 063
Block.Pro.2.5


Block.Pro.2 - Расширенный вывод блоков с новостями для DLE

Модуль для удобного и гибкого вывода новостей на любой странице DLE-сайта

Версия DLE: 9.5 (на других не проверялся, но работать должен)

Версия модуля: 2.5

Дата релиза: 29.03.2012

Автор: ПафНутиЙ

Контакты: http://pafnuty.name, Google+ или email

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

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

Основные возможности модуля

  • Вывод популярных (топ по комментариям, рейтингу, просмотрам или как стандартный топ в dle), похожих, случайных (с возможностью отключения кеширования блока) или последних новостей.
  • Подключение модуля одной строкой непосредственно любой в шаблон (через include).
  • Простая и очень гибкая настройка вывода каждого блока.
  • Кеширование каждого блока (обновление кеша при добавлении новости или комментария на сайт) с возможностью отключения кеша для каждого блока.
  • Настройка категорий для вывода новостей (вывод только из определённых категорий, игнорирование определённых категорий, вывод или ингорирование новостей из просматриваемой категории)
  • Вывод уменьшенной копии картинки (в т.ч. и вместе с оригинальной картинкой) из короткой новости или дополнительного поля (картинки берутся только из папки uploads текущего сайта).
  • Автоматическое создание папки для уменьшенных копий изображений и выставление нужных прав.
  • Обрезка заголовка новости до заданного количества символов.
  • Обрезка текста новости (до заданного количества символов или до конца слова).
  • Ввод иконок категории.
  • Можно задать временной интервал для отбора новостей (по умолчанию 30дней).
  • Можно задать каждому блоку свой шаблон, свою картинку-заглушку.
  • Поддержка всех тегов, используемых в шаблонах кратких новостей.
  • Поддержка фильтра (перекрестные ссылки) по допполям, реализованного в DLE9.5
  • Можно указать с какой по счету новости начать вывод (например с 4й по 15ю).
  • Возможность быстрого редактирования новостей прямо из блока, аналогично стандартному функционалу

Установка модуля

  1. Скопировать файл block.pro.2.php в папку engine/modules/
  2. Скопировать содержимое папки THEME в папку с текущим шаблоном сайта
  3. В нужном месте прописать строку подключения модуля с обязательными параметрами:
    {include file="engine/modules/block.pro.2.php?&block_id=BLOCK&template=blockpro"}
    Где: BLOCK - Уникальный идентификатор блока blockpro - имя шаблона, используемого для вывода
  4. Настроить дополнительные параметры строки подключения и шаблон

Для вывода похожих новостей

  1. Отключить стандартный вывод похожих новостей в админке (Настройка системы » Оптимизация запросов к базе данных » Отображение похожих новостей » "нет")
  2. Открыть файл engine/modules/show.full.php перед
    if( $config['related_news']
    вставить
    /*Block.Pro - relatednews*/
    $block_id = 'related_'.$row['id']; //Не трогать!
    $relatedpro = "1"; //Не трогать!
    $template="relatednews"; // Имя шаблона (можно менять)
    include_once ENGINE_DIR . '/modules/block.pro.2.php';		
    /*Block.Pro - relatednews*/
  3. Настроить дополнительные переменные подключения модуля (Переменные приведены в таблице ниже. При вставке необходимо заменять символ & на $) и шаблон
  4. В ШАБЛОНЕ ПОЛНОЙ НОВОСТИ НИЧЕГО ДОПОЛНИТЕЛЬНО ПРОПИСЫВАТЬ НЕ НУЖНО! модуль выводится через стандартный тег похожих новостей.

Переменные строки подключения

Все переменные указываются непосредственно в строке подключения модуля.

В таблице дано описание возможных для использования переменных

Наименование переменной Значение по умолчанию Описание Примечание
&block_id   Обязательная переменная. Уникальный идентификатор блока любое, уникальное для каждого блока значение
&template   Обязательная переменная. Имя шаблона для вывода блока указывается только имя, без расширения .tpl
&day 30 Количество дней, за которое осуществляется отбор новостей. Если указать ноль (0) - будут браться новости за всё время. Переменная автоматически принимает нулевое значение, если в строке подключения определена переменная &last, &relatedpro или &rndom
&show_cat   Категория/категории для отбора новостей.

Категории указываются через запятую.

Если указать &show_cat=this - новости будут браться только из просматриваемой категории.

&ignore_cat   Модификатор переменной &show_cat. превращает указанные в &show_cat категории в игнорируемые. Для активации модификатора достаточно его определить (например &ignore_cat=y)
&start_from 0 Начало диапазона отбора новостей.  
&news_num 10 Количество новостей в блоке  
&img_xfield   Имя дополнительного поля для получения уменьшенного изображения.

Переменную нужно определять только тогда, когда требуется выводить картинку из дополнительного поля.

Одновременный вывод картинки из краткого содержимого и допполя невозможен.

В допполе должна лежать прямая ссылка на изображение.

&img_size 60x60 Размер уменьшенной копии изображения. (Ширина X Высота) Допустимо указывать одну цифру (например 100). тогда изображение будет уменьшено по большей стороне. при указании нуля (&img_size=0) изображение обрезаться не будет.
&noimage noimage.png Имя и расширение для картинки-заглушки, в случаи отсутствия изображения в новости. Картинка-заглушка должна располагаться в папке images текущего шаблона сайта.
&nocache   Модификатор, отключающий использование кеша для блока. Для активации модификатора достаточно его определить (например &nocache=y)

 

&random

&last

&top_comm

&top_rating

&top_views

 

Варианты сортировки новостей.

Случайным образом

По дате добавления

Самые комментируемые

Самые рейтинговые

Самые часто просматриваемые

По умолчанию выводятся топ-новости (по аналогии со стандартным топом DLE)

Недопустимо использование нескольких вариантов сортировки одновременно.

&wordcut   Модификатор, отключающий обрезку текста новости до конца слова и включающий обрезку до заданного количества символов. Для активации модификатора достаточно его определить (например &wordcut=y)
$relatedpro   Модификатор активирует механизм отображения похожих новостей. Указывается только при подключении модуля в файле show.full.php для вывода похожих новостей. Для активации модификатора достаточно его определить (например $relatedpro=y;)


Теги шаблона

В таблице приведены возможные для использования в шаблоне теги и их описание.

Обозначение тега шаблона Описание Примечание
{link-category} Ссылка/ссылки на категории  
{category} Наименование категории  
{category-icon} Иконка/иконки категорий При отсутствии иконки берётся картинка {THEME}/images/no_icon.gif
[xfvalue_name] Значение дополнительного поля "name", где "name" название дополнительного поля  
[xfgiven_name] [xfvalue_name] [/xfgiven_name] Выводится дополнительное поле "name", если поле не пустое, если поле не имеет значения, то текст просто вырезается  
[xfnotgiven_name] текст [/xfnotgiven_name] Выводят текст указанный в тегах, если дополнительное поле не было задано при публикации новости, где "name" это имя дополнительного поля  
{image-X} Выводит URL уменьшенной картинки находящейся в краткой новости, где Х это номер картинки в новости, например {image-1} выведет URL первой картинки в краткой новости  
{image_original} Выводит URL оригинальной картинки, указанной в {image-X}  
[image_original] текст [/image_original] Выводят текст указанный в тегах, если есть {image_original}  
[not_image_original] текст [/not_image_original] Выводят текст указанный в тегах, если нет {image_original}  
{rating} Выводит рейтинг  
{vote-num} Выводит количество проголосовавших  
[profile] текст [/profile] Выводят прямую ссылку на профиль автора публикации, без использования всплывающего окна минипрофиля.  
{login} Выводит логин пользователя добавившего новость в виде обычной текстовой информации без ссылок на профиль и карточку пользователя.  
{author} Ссылка на автора новости  
{date} Дата новости в формате, установленном в настройках движка  
{date=X} Дата новости в пользовательском формате  
Block.Pro.2.5 Заголовок новости  
{title limit="X"} Заголовок новости, обрезанный до X символов.  
{text} Текст новости (аналог {short-story})  
{text limit="X"} Текст новости, обрезанный до указанного X количества символов, при этом обрезание текста происходит до последнего логического слова, а не обрывает текст на середине слова.  
{full-link} URL полной новости  
{comments-num} Количество комментариев к новости  
{views} Количество просмотров новости  
[edit] текст [/edit] Ссылка на редактирование новости  



Техническая поддержка модуля осуществляется только по указанным контактным данным

Но это не означает, что техподдержка будет оказана :)

P.S. Пример использования модуля вы можете лицезреть на этом сайте, прямо чуть ниже ссылки на скачивание выводятся похожие новости.

ВНИМАНИЕ!

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

Похожие материалы

Комментарии

bratoz
bratoz 28 мая 2012 20:10
Ждём, устал от custom с кривыми картинками, хотя с твои модулем тоже уже успел помучаться))
Predator
Predator 29 мая 2012 15:58
Добрый день. Возникла неприятная ситуация. На сайте сделал цифровой рейтинг, получилось что и в блоке тож цифровой рейтинг. Скажите пожалуйста как сделать чтоб и цифровой рейтинг на сайте был и стандартный в блоке?
ПафНутиЙ
ПафНутиЙ 30 мая 2012 07:20
Нужно соответствующим образом переписать либо функционал рейтинга, либо модуля.
bratoz
bratoz 30 мая 2012 15:30
Что на счёт модуля? Смотрел в чём проблема?:)
Поставить хочу уже))
ПафНутиЙ
ПафНутиЙ 30 мая 2012 16:33
Ждите....
я dle-faq переносил в зону .ru
Сёдня смогу посмотреть, если никакой хрени не всплывёт.
bratoz
bratoz 30 мая 2012 20:16
Буду благодарен!)
ПафНутиЙ
ПафНутиЙ 31 мая 2012 01:56
Zidein,
bratoz,
Проверяйте, модуль обновлён на гитхабе.
Так же добавил переменную &showstat, при указании которой, внизу блока для админа будет выведено время, затраченное на выполнение скрипта.
bratoz
bratoz 1 июня 2012 14:32
Спасибо огромное! Всё работает, пока что)))
ПафНутиЙ
ПафНутиЙ 2 июня 2012 20:17
Если что - отписывайтесь, поправим )
bratoz
bratoz 4 июня 2012 00:11
Всё работает пока как часики!:)
ravchik
ravchik 7 июня 2012 19:28
Доброго времени!
Подключаю модуль таким образом:
{include file="engine/modules/block.pro.2.php?&block_id=main&last&template=custmain&noimage=nothumb.gif&img_size=80x80&nocache"}

Но почему-то новости выводятся вразброс, а не по дате добавления, хотя параметр &last указан... Что я делаю не так?
ПафНутиЙ
ПафНутиЙ 7 июня 2012 21:08
Чтобы определить переменную, её нужно чему то приравнять. Как вы думаете, чему равна сейчас переменная &last? Подозреваю, что тому же, чему и &nocache .
Я понимаю, что лень доки читать, но логика должна же присутствовать.
Все переменные чему то равны должны быть, если они указаны в строке подключения.
Assada
Assada 8 июня 2012 21:27
При использовании модуля как замену related_news. Тег {image-1} выводит $noimage

А если использовать как блок (случайных или популярных новостей), то все теги работают отлично.

Есть идеи по решению этой проблемы.
ПафНутиЙ
ПафНутиЙ 9 июня 2012 08:47
скажите версию dle и напишите строку подключения.
Assada
Assada 9 июня 2012 16:33
9.5

строка 514 инклюд, выше настройки, прямо над
if( $config['related_news'] AND $view_template != "print" ) {
ПафНутиЙ
ПафНутиЙ 10 июня 2012 10:12
а что прописываете то перед этой строкой?
Assada
Assada 10 июня 2012 13:44
/*Block.Pro - relatednews*/
$block_id = 'related_'.$row['id']; //Не трогать!
$relatedpro = "1"; //Не трогать!
$template="relatednews"; // Имя шаблона (можно менять)
include_once ENGINE_DIR . '/modules/block.pro.2.php';		
/*Block.Pro - relatednews*/
Predator
Predator 12 июня 2012 18:59
Проблема в следующем.Модуль прекрасно работает но вот что это за ероглифы в 2.6 появились?
ПафНутиЙ
ПафНутиЙ 12 июня 2012 20:10
поменяйте кодировку файлов модуля на windows-1251
Predator
Predator 13 июня 2012 07:21
Скажите пожалуйста.
Как работает кешь этого модуля?
Как вывести аватар автора новости?
ПафНутиЙ
ПафНутиЙ 13 июня 2012 09:25
Кеш создаётся для каждого блока отдельно, если это похожие новости, то для каждой похожей новости отдельно. Если новости пользователя - то для каждого пользователя отдельно.
Чистится кеш всех блоков при добавлении нового комментария, новости, изменении рейтинга.

А где в описании модуля сказано, что он аватар автора новости выводит?
Predator
Predator 13 июня 2012 15:42
Про аватар пользователя нет, но хотелось бы чтоб аварку можно было вывести.Будит реализовано?Было бы плюсом.

В вашем сообщении сказано
Если новости пользователя - то для каждого пользователя отдельно.

Не совсем понятно, можно блок настроить так чтоб выводил новости пользователя отдельно?
В описании не нашел такой возможности, как?
ПафНутиЙ
ПафНутиЙ 13 июня 2012 16:05
https://github.com/pafnuty/Block.Pro.2 качаем, читаем, видим:
Фильтрация новостей по имени автора.
Фильтрация новостей по дополнительным полям (проверяется только заполненность поля).

Чуть ниже:
Указать в строке подключения переменную &author={usertitle} для вывода новостей автора на странице его профиля. Так же {usertitle} можно заменить на имя автора.

ещё ниже:
В фильтр попадают только новости, у которых заполнено указанное дополнительное поле (в строке подключения нужно указать переменную &xfilter=image, text - в этом случаи будут отобранны только те новости, в которых заполненны допполя image и text)

В общем то, если почитать документацию к модулю более внимательно, можно открыть для себя несколько незаявленных возможностей, которыми все уже давно пользуются.
Predator
Predator 13 июня 2012 21:08
В профиль можно поставить, ставлю 1 блок.На чьей я странице профиля нахусь, выводятся только новсти того пользователя, которого я просматриваю профиль.Возможно?
davidozz
davidozz 15 июня 2012 02:52
у меня вместо модуля отображается вот это Указанный С?аблон РЅРµ сущестует
ПафНутиЙ
ПафНутиЙ 16 июня 2012 03:35
перекодируйте файл модуля в ANSI
Alexx
Alexx 17 июня 2012 07:12
Доброго времени суток!

У новости есть дополнительное поле. Возможно ли вывести модулем только новости с одинаковым значением (не названием) этого доп.поля?

Заранее спасибо.
ПафНутиЙ
ПафНутиЙ 17 июня 2012 09:06
Нет, этого сделать не получится. Модуль фильтрует только по названиям.
zzzgame
zzzgame 18 июня 2012 21:03
При выводе новостей из определенной категории возникает ошибка:

{"error":"The file is not the image, or this file is damaged."}


Код вызова
{include file="engine/modules/block.pro.2.php?&block_id=top3&template=igri-top-site&img_size=65x45&news_num=3&show_cat=5"}
ПафНутиЙ
ПафНутиЙ 18 июня 2012 22:11
значит картинки нет или она повреждена.
Это уже не раз обсуждалось.

Добавить комментарий

Комментировать могут только зарегистрированные пользователи

Информация

Посетители, находящиеся в группе Гости, не могут оставлять комментарии к данной публикации.