12.04.14, 22:54
0 комментарий
  DLE Модули

Список переменных поддерживаемых в Blockpro

Список и описания переменных поддерживающие модулем 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=150x200
&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


Реклама

Напишите своё мнение

  • acuteaggressiveair_kissangel
    badbbbeachbeee
    biggrinbig_bossblumblush
    boastbombboredombye
    clappingcraycrazycurtsey
    dancedashdeclarediablo
    diroldon-t_mentiondownloaddrinks
    first_moveflirtfocusfool
    friendsgive_heartgive_rosegood
    hangheartheathelp
    hihunterhystericireful
    kingkisslaughlazy
    lolmail1mambaman_in_love
    mdamega_shokmoilmosking
    musicneanegativenew_russian
    okon_the_quietpardonparting
    partypilotpioneerpleasantry
    popcormpranksterprevedpunish
    roflrtfmrussiansad
    sarcasticscarescratchsearch
    secretsensoredshokshout
    slowsmilesmokesoldier
    soldier_girlsorryspitefulspruce_up
    stinkersuicidesunsuperstition
    swoonteasetenderthanks
    thisto_pick_ones_noseto_take_umbragetreaten
    umnikunknwvampirevava
    victorywackowhistlewink
    wizardyahooyesyu
    e101e102e103e104
    e105e106e107e108
    e109e110e111e112
    e113e114e115e116
    e117e118e119e120
    e121e122e123e124
    e125e126e127e128
    e129e130e131e132
    e133e134e135e136
    e137e138e139e140
    e141e142e143e144
    e145e146e147e148
    e149e150e151e152
    e153e154e155e156
    e157e158e159e160
    e161e162e163e164
    e165e166e167e168
    e169e170e171e172
    e173e174e175e176
    e177e178e179e180
    e181e182e183e184
    e185e186e187e188
    e189e190e191e192
    e193e194e195e196
    e197e198e199e200
    e201e202e203e204