Список и описания переменных поддерживающие модулем Blockpro.
Типичная строка подключения:
{include file=»engine/modules/blockpro/block.pro.3.php»}
Визуальные обозначения:
Имя переменной
Значение по умолчанию
Пример подключенияОписание переменной
1.1 template — Имя шаблона блока без расширения (по умолчанию шаблон блока берётся из папки blockpro текущего шаблона)
1.2 blockpro/blockpro
&template=custom
2.1 prefix — Дефолтный префикс кеша, нужен для автоматической чистки кеша при добавлении на сайте комментария или новости. Автомтически удаляется, если задано время жизни кеша
2.2 news_
&prefix=pref_
3.1 nocache -Отключает кеширование блока
3.2 false
&nocache=y
4.1 cacheLive — Задаёт время жизни кеша в минутах
4.2 false
&cacheLive=15
5.1 startFrom — C какой новости начать вывод (ноль — это первая новость, 3 — четвёртая)
5.2 0
&startFrom=1
6.1 limit -Количество новостей в блоке
6.2 10
&limit=2
7.1 postId — ID новостей для вывода в блоке (через запятую). Если указать this — будет выведена просматриваемая новость. Может понадобиться для установки кастомизированных метатегов (актуально для киносайтов). При этом будет создаваться отдельный файл кеша для каждой просмотренной новости. Можно указывать диапазон ID через тире.
&postId=1,5,23&postId=this
&postId=1-10,15-30
8.1 notPostId — ID игнорируемых новостей (через запятую). Если указать this — будет игнорироваться текущая новость, полезно например для вывода топа из текущей категории, но без текущей новости. При этом будет создаваться отдельный файл кеша для каждой просмотренной новости. Можно указывать диапазон ID через тире.
8.2 —
¬PostId=2,4,6¬PostId=this
¬PostId=2-6,10-15
9.1 author — Логины авторов, для показа их новостей в блоке (через запятую). Если указать this — будут браться новости автора из просматриваемого профиля, при этом будет создаваться отдельный файл кеша для каждой страницы профиля
9.2 —
&author=admin,bot
&author=this
10.1 notAuthor — Логины игнорируемых авторов (через запятую). Если указать this — будут игнорироваться новости автора из просматриваемого профиля, при этом будет создаваться отдельный файл кеша для каждой страницы профиля.
10.2 —
¬Author=bot
¬Author=this
11.1 tags — Теги новостей, для фильтрации по ним (через запятую). Если указать this — будут браться новости в которых присутствует тег, при просмотре страницы конкретного тега, при этом будет создаваться отдельный файл кеша для каждой страницы тега
11.2 —
&tags=новостии,soametag
&tags=this
12.1 notTags -Аналогично предыдущему пункту, но новости не будут присутствовать в блоке.
12.2 —
¬Tags=sometag
¬Tags=this
13 xfilter (Имена дополнительных полей для фильтрации по ним новостей (через запятую))
&xfilter=image,text
14. notXfilter — Имена дополнительных полей для игнорирования показа (через запятую)
¬Xfilter=image,text
15. catId — Категории для показа (через запятую). Если указать this — новости будут браться из просматриваемой категории, при этом будет создаваться отдельный файл кеша для каждой категории. Можно указывать диапазон ID через тире.
&catId=5,6&catId=this
&catId=2-6,10-15
16. notCatId — Игнорируемые категории (через запятую). Если указать this — новости будут браться из всех, кроме просматриваемой категории, при этом будет создаваться отдельный файл кеша для каждой категории. Можно указывать диапазон ID через тире.
¬CatId=3,4¬CatId=this
¬CatId=8-16,25-155
17. noicon — Заглушка для иконок категорий. Указывать необходимо только имя и расширение картинка, предварительно положив картинку в папку /blockpro/ текущего шаблона.
&noicon=myicon.gif
18. day — Временной период для отбора новостей, по умолчанию отсутствует
&day=14
19. dayCount — Временной интервал для отбора новостей, по умолчанию отсутствует.
Примечание: к примеру нужно вывести новости за прошлую неделю. Код: &day=14&dayCount=7 выведет новости за период 14 дней с интервалом в 7 дней, что и есть прошлая неделя.
&dayCount=7
20. fixed — Показ только фиксированных новостей &fixed=y или показ только не фиксированных новостей &fixed=n
&fixed=y
&fixed=n
21. sort — Сортировка новостей в блоке, по умолчанию аналогична выводу ТОП-новостей.
Возможные значения:по умолчанию — стандартный для DLE топ новостей
hit — Эксперименталный топ. Новости отбираются по формуле рейтинг+(комментарии*0.5)+(просмотры*0.1) 3.3.4
date — по дате добавления
comms — по количеству комментариев
rating — по рейтингу
views — по количеству просмотров
title — в алфавитном порядке
random — в случайном порядке
none — без сортировки (можно использовать для вывода похожих новостей идентично стандартному выводу таковых в DLE)
&sort=random&sort=hit&sort=date&sort=comms&sort=rating&sort=views&sort=title
&sort=none
22. order — Направление сортировки. По умолчанию новые на верху, старые внизу. любое другое значение выведет новости в обратном порядке.
По умолчанию так new
&order=old
23. image — Откуда брать картинку для уменьшеия и вывода в новости. Берётся только первая картинка из новости.
Возможные значения:
short_story — из краткой новости
full_story — из плной новости
xfield — из дополнительного поля, где xfield — имя дополнительного поляПо умолчанию стоит из краткой новости short_story !
&image=xfield
24. remoteImages — Включает вывод картинки, если она находится на стороннем ресурсе (уменьшаться она не будет!)
&remoteImages=y
25. grabRemote — Включает возможность скачивания и уменьшения картинки, если она находится на стороннем ресурсе (работает через cURL). При этом должна быть определена переменная remoteImages. Внимание! включения данной настройки может серьёзно замедлить отображение страницы при первом обращении к ней.
&grabRemote=y
26. showSmall — Запрещает использовать для ресайза (или показа) оригинальное изображение, если есть его уменьшенная копия. Это требуется, если в новости лежит уменьшенная копия нужного размера (экономит ресурсы сервера).
&showSmall=y
27. noimage — Картинка-заглушка маленькая. Указывать необходимо только имя и расширение картинка, предварительно положив картинку в папку /blockpro/ текущего шаблона.
По умолчанию noimage.png
&noimage=custom.jpg
28. noimageFull — Картинка-заглушка большая. Указывать необходимо только имя и расширение картинка, предварительно положив картинку в папку /blockpro/ текущего шаблона
По умолчанию noimage-full.png
&noimageFull=big.png
29. imgSize — Размер уменьшенной копии картинки
&imgSize=150×200
&imgSize=150
30. imgQuality — Качество уменьшенной копии картинки, допустимо использовать диапазон от 0 до 100
По умолчанию 80!
&imgQuality=60
31. resizeType — Метод уменьшения копии картинки.
Возможные значения:
exact — уменьшение без сохранения пропорций,
portrait — уменьшение по высоте с сохранением пропорций,
landscape — уменьшение по ширине с сохранением пропорций,
auto — «умное» уменьшение с сохранинием пропорций, при этом размер изображения не выходит за рамки указанной высоты и ширины
crop — кроп (уменьшение по меньшей стороне и обрезка лишнего с краёв большей стороны)
По умолчанию auto
&resizeType=crop
32. showstat — Показывать время выполнения блока.
&showstat=y
33. related — Включает модуль в режим отображения похожих новостей, переменная принимает id новости и тогда блок похожих новостей можно вывести даже в на странице с краткими новостями. Если же указать значение this — блок будет работать только в полной новости и показывать новости, похожие на просматриваемую.
&related=1
&related=this
Дальше список переменных которые проявились после версии 3.3.6.0 за нее взялся Автор RDN.
34. moderation — позволяет выводить новости только на модерации, значение moderation=2 позволяет выводить вообще все новости, без различия на модерации они или нет.
&moderation=1
35. favorites — Позволяет выводить закладки пользователя. В профиле!
&favorites=1
36. related_mode — расширенный режим работы с похожими новостями. Работает только в паре с параметром related. Суть работы расширенного режима работы с похожими новостями:
Стандартный режим поиска похожих новостей постоянно делает поиск в базе данных по тексту в новости, я решил немного оптимизировать это дело.При выводе похожих новостей в новом режиме используется таблица related_ids в которой хранятся стандартные похожие новости от DLE, если стандартных похожих новостей нет (такое бывает при отключенном блоке похожих новостей dle), то сохраняем результаты работы стандартного режима в таблицу related_ids что делает её идентичной той что есть в дле. При таком режиме работы можно отказавшись от использования Block Pro вернуться к стандартному выводу похожих новостей DLE и ссылки при этом не посыпятся.
&related_mode=1
37. subCats -выведет новости из субкатегории.
&subCats=1
38. no_main — выведет новости не попавшие на главную страницу.
&no_main=1
39. no_rating — Отображаем новости с рейтингом 0 или с отключенным рейтингом. (типо оцените пожалуйста).
&no_rating=1
40. no_comm — Отображаем новости с количеством комментариев 0 или с отключенными комментариями. (типо материалы ждут вашего коммента).
&no_comm=1
41. search=значение — Представляет из себя двух-режимный поиск по тексту новостей, заголовкам и xfields. Подробнее об этом:
Поиск в режиме 1: Частичные совпадения слов (через like), для этого укажите &search=%значение%Поиск в режиме 2: Полнотекстовый поиск (через match), для этого укажите &search=значение
Пример работы:
вывод новостей с флеш-роликами:?template=blockpro&day=7&sort=date&search=dle_flash_begin»}вывод новостей в которых есть видео:?template=blockpro&day=7&sort=date&search=dle_media_begin»}вывод новостей в которых есть изображение:?template=blockpro&day=7&sort=date&search=dle_image_begin»}вывод новостей в которых встречается фраза «размер»:
?template=blockpro&day=7&sort=date&search=%размер%»}
42. numtags — перемененная очень специфичная: Добавлена поддержка вывода новостей найденных по тегам текущей новости. Подключение через numtags, параметр принимает два числа через запятую. Первое число начало тегов, второе конец. К примеру если вам нужно выводить новости по тегам первым тегам новости введите значение 0,3
Пример подключения в полной новости:
?template=шаблон&tags=this&numtags=0,3&sort=none
Возможные варианты:
$input = array("a", "b", "c", "d", "e");
$output = array_slice($input, 2, 10); // возвращает последние элементы массива "c", "d", и "e", пропуская первые два
$output = array_slice($input, -2, 1); // возвращает один второй элемент с конца "d"
$output = array_slice($input, 0, 3); // возвращает первые три элемента "a", "b", и "c"Рекомендую использовать поиск по первому тегу из новости &tags=this&numtags=0,1
43. noinfo — Позволяет отключать вывод информации что материалов не найдено
&noinfo=1
44. sort=views_today — новая сортировка под названием Топ для если поставлен мод: Самый просматриваемый материал за текущий день
45. sort=updates выводит новости по дате последнего редактирования
&sort=updates
46. only_edit=1 — выводит только те новости у которых стоит «Отображать информацию о редактировании»
&only_edit=1
47. phase — через который можно указывать имя файла с фразами, если параметр не указан используется rand_phase.txt
&phase
48. phase — В архитектуру добавлена возможность экспорта данных в формате RSS. Ленты хранятся в папке uploads и обновляются раз в час.
Для работы с RSS у модуля появились новые параметры подключения:
&rss=1 — Включает сохранение вывода в формате RSS с картинками&rss=2 — Включает сохранение вывода в формате яндекс новостей.&rss=3 — Включает сохранение вывода в формате RSS без картинок и форматирования текста.&rss_name=top_rating — Позволяет задать человекопонятное имя ленты, иначе будет сгенерировано автоматическое имя которое можно посмотреть в папке uploads. Ссылка на ленту будет выглядеть следующей /uploads/top_rating.xml
&rss_only=1 — Отключает вывод информации на сайт. Можно использовать если необходимо только генерировать rss. Строка подключения должна выглядеть стандартной (т.е. шаблон подключать необходимо как и при обычном выводе, но можно указать на пустой файл)
появилась возможность инжектироваться в посторонние блоки, что позволит залезать в самые труднодоступные места — добавлен параметр: inject указывает модулю выводить результат внедряясь в чужой модуль.- добавлен параметр content, который указывает в какую часть результата модуль должен инжектироваться по умолчанию использует prepend, но можно задать параметр content=append что соотвественно будет выводить модуль после всего блока.
Дальше параметры подключения только для DLE 10.2 и Blockpro 4.6 и выше.
49. navigation — Добавлена поддержка навигации
&navigation=1
50. fixed — принимает параметры only/without показ только фиксированных/без фиксированных новостей
&fixed=
51. stoplist=blockppro_stoplist — через который подключается стоплист фраз из файла datablockppro_stoplist.txt, при совпадении фразы с заголовком новости — эту новость блокпро не выводит. В файле поддерживаются операнды типа %совпадение в середине строки%, %совпадение в конце строки, совпадение в начале строки%.
&stoplist=blockppro_stoplist
52. num_rating — включает режим вывода упрощённого цифрового рейтинга новости.
&num_rating=1
53. min_rating — выводит новости рейтинг которых выше 32.
&min_rating=32