moderate | false
&moderate=y | Если переменная указана - выводятся только новости на модерации. |
template | blockpro/blockpro
&template=custom | Имя шаблона блока без расширения (по умолчанию шаблон блока берётся из папки blockpro текущего шаблона сайта) |
cachePrefix | news
&cachePrefix=pref | Дефолтный префикс кеша, нужен для автоматической чистки кеша при добавлении на сайте комментария или новости. Автоматически удаляется, если задано время жизни кеша. |
cacheSuffixOff | false
&cacheSuffixOff=y | Отключение суффикса кеша (будет создаваться один кеш-файл для всех пользователей). По умолчанию для каждой группы пользователей создаётся свой кеш (на случай разного отображения контента разным юзерам). Если для всех групп пользователей контент одинаков - можно отключить. |
cacheNameAddon |
&cacheNameAddon=newName | Служебная переменная. Назначает дополнение к имени кеша, если имеются переменные со значениями this, они будут автоматически дописаны в эту переменную, иначе для разных мест будет создаваться один и тот же файл кеша. |
nocache | false
&nocache=y | Отключает кеширование блока |
cacheLive | false
&cacheLive=15 | Задаёт время жизни кеша в минутах |
cacheVars | false
&cacheVars=newsid | Значимые параметры для формирования кеша. В переменную можно передавать через запятую ключи, доступные через $_REQUEST или значения переменной $dle_module . Эта функция полезна, если требуется выводить разное оформление в блоке с новостями для разных страниц сайта. Таким образом, если прописать &caceVars=newsid,category,forum будет создаваться отдельный кеш для каждой новости, для каждой категории и для модуля forum (при интеграции форума). |
startFrom | 0
&startFrom=1 | C какой новости начать вывод (ноль - это первая новость, 3 - четвёртая) |
limit | 10
&limit=2 | Количество новостей в блоке |
fixed | yes
&fixed=only
&fixed=witout
&fixed=ignore | Обработка фиксированных новостей: yes — показ всех (по умолчанию), фиксированные выше остальных; only — показ только фиксированных; without — показ только нефиксированных; ignore new — показ единым списком без учёта признака фиксированных новостей; |
postId |
&postId=1,5,23
&postId=this
&postId=1-10,15-30 | ID новостей для вывода в блоке (через запятую, тире). Если указать this - будет взят ID просматриваемой новости. Может понадобиться для установки кастомизированных метатегов (актуально для киносайтов). При этом будет создаваться отдельный файл кеша для каждой просмотренной новости. Через тире указывается диапазон значений (от-до). |
notPostId |
¬PostId=2,4,6
¬PostId=this
¬PostId=2-6,10-15 | ID игнорируемых новостей (через запятую, тире). Если указать this - будет игнорироваться текущая новость, полезно например для вывода топа из текущей категории, но без текущей новости. При этом будет создаваться отдельный файл кеша для каждой просмотренной новости. Через тире указывается диапазон значений (от-до). |
author |
&author=admin,bot
&author=this | Логины авторов, для показа их новостей в блоке (через запятую). Если указать this - будут браться новости автора из просматриваемого профиля, при этом будет создаваться отдельный файл кеша для каждой страницы профиля |
notAuthor |
¬Author=bot
¬Author=this | Логины игнорируемых авторов (через запятую). Если указать this - будут игнорироваться новости автора из просматриваемого профиля, при этом будет создаваться отдельный файл кеша для каждой страницы профиля. |
xfilter |
&xfilter=image,text
&xfilter=this | Имена дополнительных полей для фильтрации по ним новостей (через запятую). Проверяется только заполненность поля. Если указать this - будут выводиться новости, в которых заполнено допполе, на странице которого находитс пользователь, при этом будет создаваться отдельный файл кеша для каждой страницы допполя. |
notXfilter |
¬Xfilter=image,text
¬Xfilter=this | Имена дополнительных полей для игнорирования показа (через запятую). Проверяется только заполненность поля. Если указать this - будут ирнорироваться новости, в которых заполнено допполе, на странице которого находитс пользователь, при этом будет создаваться отдельный файл кеша для каждой страницы допполя. |
xfSearch |
&xfSearch=name|value||name1|alue1 | Имена и значения допполей для фильтрации новостей по допполям с указанными значениями. синтаксис передачи данных: &xfSearch=имя_поля|значение||имя_поля|значение |
notXfSearch |
¬XfSearch=name|value||name1|alue1 | Имена и значения допполей для игнорирования показа новостей по допполям с указанными значениями. синтаксис передачи данных: ¬XfSearch=имя_поля|значение||имя_поля|значение |
xfSearchLogic | OR
&xfSearchLogic=AND | Логика фильтрации по значениям допполей: "И" - совпадение нескольких значений; "ИЛИ" - совпадение любого из значений Принимает OR или AND. |
catId |
&catId=5,6
&catId=this
&catId=2-6,10-15 | Категории для показа (через запятую). Если указать this - новости будут браться из просматриваемой категории, при этом будет создаваться отдельный файл кеша для каждой категории. Через тире указывается диапазон значений (от-до). |
subcats | false
&subcats=y | Разрешает вывод подкатегорий указанных в предыдущем параметре, категорий. |
notCatId |
¬CatId=3,4
¬CatId=this
¬CatId=8-16,25-155 | Игнорируемые категории (через запятую). Если указать this - новости будут браться из всех, кроме просматриваемой категории, при этом будет создаваться отдельный файл кеша для каждой категории. Через тире указывается диапазон значений (от-до). |
notSubcats | false
¬Subcats=y | Разрешает игнорирование вывода из подкатегорий указанных в предыдущем параметре, категорий. |
thisCatOnly | false
&thisCatOnly=y | Выводить/игнорировать новости только из текущей категории. Вывод новостей только из текущей категории имеет смысл в тех случаях, когда используются мультикатегории и если нужно вывести или исключить из вывода новости, принадлежащие только к просматриваемой категории. К примеру похожие фильмы только из просматриваемой категории, а не из всех категорий, к которым принадлежит просматриваемый фильм. |
tags |
&tags=новости,soametag
&tags=this
&tags=thisNewsTags | Теги новостей, для фильтрации по ним (через запятую). Если указать this - будут браться новости в которых присутствует тег, при просмотре страницы конкретного тега, при этом будет создаваться отдельный файл кеша для каждой страницы тега. Если указать thisNewsTags - будут браться новости в которых присутствуют теги текущей новости (имеет смысл только при при просмотре полной новости). |
notTags |
¬Tags=sometag
¬Tags=this | Аналогично предыдущему пункту, но новости не будут присутствовать в блоке. |
symbols |
&symbols=a,A
&symbols=this | Показ новостей, содержащих указанные символьные коды. Или this - для вывода новостей по просмариваемому символьному коду. |
notSymbols |
¬Symbols=a,A
¬Symbols=this | Аналогично предыдущему пункту, но новости не будут присутствовать в блоке. |
day | false
&day=14 | Временной период для отбора новостей, по умолчанию отсутствует |
dayCount | false
&dayCount=7 | Временной интервал для отбора новостей, по умолчанию отсутствует. Примечание: к примеру нужно вывести новости за прошлую неделю. Код: &day=14&dayCount=7 выведет новости за период 14 дней с интервалом в 7 дней, что и есть прошлая неделя. Для вывода новостей только за сегодня необходимо прописать &day=-1&dayCount=-1 . |
future | false
&future=y | Режим афиши — вывод новостей только на ненаступившую дату. При этом параметры &day и &dayCount не вычитают, а прибавляют дни. Например для вывода афиши на послезавтра нужно прописать ?future=y&day=3&dayCount=1 . Режим афиши не зависит от настроек DLE по выводу новостей на ненаступившую дату. |
sort |
&sort=random | Сортировка новостей в блоке, по умолчанию аналогична выводу ТОП-новостей. Возможные значения: по умолчанию - стандартный для DLE топ новостей none - без сортировки (можно использовать для вывода похожих новостей идентично стандартному выводу таковых в DLE) date - по дате добавления rating - по рейтингу comms - по количеству комментариев views - по количеству просмотров random - в случайном порядке randomLight - в случайном порядке (Light) Предназначен для больших БД и органиченной выборки (с фильтрацией категорий, id новостей, допполей и т.п.) title - в алфавитном порядке hit - Хит. Новости отбираются по формуле: (рейтинг*100 + кол-во комментариев*10 + кол-во просмотров) download - по количеству скачиваний файлов новости symbol - по символьному коду новости editdate - по дате редактирования новости xf|fielname - по значению дополнительного поля, где fielname — название дополнительного поля. Пример строки подключения {include file="engine/modules/base/blockpro.php?xfilter=price&sort=xf|price&order=new"} xfilter=price - для отбрасывания пустых значений. symbol - по символьному коду. p.custom_field - по нестандартному полю БД. Пример: &sort=p.custom_field — поле custom_field из таблицы dle_post &sort=e.price — поле price из таблицы dle_post_extras. |
xfSortType | false
&xfSortType=string | Этот параметр необходимо указывать, если требуется сортировка по значению дополнительного поля, при этом указанное допполе содержит текст, а не цифры. |
order | new
&order=old
&order=asis | Направление сортировки. old - новые в начале old - старые в начале asis - как есть. Выводит новости в том порядке, в котором они указаны в строке подключения. На данный момент она распространяется только на ID новостей. |
avatar | false
&avatar=y | Разрешает вывод аватарки автора новости. |
showstat | false
&showstat=y | Показывать статистику выполнения блока. |
related |
&related=1 &related=this | Включает модуль в режим отображения похожих новостей, переменная принимает id новости и тогда блок похожих новостей можно вывести даже в на странице с краткими новостями. Если же указать значение this - блок будет работать только в полной новости и показывать новости, похожие на просматриваемую |
saveRelated | false
&saveRelated=y | Записывать в БД похожие новости. При первом обращении к старнице в БД будут записаны id выведенных похожих новостей, используя стандартный алгоритм DLE, при повторных обращениях (при отсутсвии кеша) данные будут браться из ранее записанных. Если нужно выводить и стандартные похожие новости и похожие новости через модуль — эту переменную использовать не нужно. |
showNav | &showNav=y | Включить постраничную навигацию в блоке |
pageNum | 1
&pageNum=4 | Текущая страница в блоке при загрузке страницы, при постраничной конфигурации. |
navStyle | classic
&navStyle=digg
&navStyle=arrows | Стиль постраничной навигации. Возможны следующие стили: classic: << Первая < 1 [2] 3 > Последняя >> digg: << Назад 1 2 ... 5 6 7 8 9 [10] 11 12 13 14 ... 25 26 Вперёд >> extended: << Назад | Страница 2 из 11 | Показаны новости 6-10 из 52 | Вперёд >> punbb: 1 ... 4 5 [6] 7 8 ... 15 arrows: << Назад Вперёд >> |
navDefaultGet | false
&navDefaultGet=y | Отслеживать стандартную навигацию DLE При указании этого параметра модуль будет брать значение текущей страницы и формировать постраничную навигацию так же как это делается в DLE. Таким образом вы можете заменить тег {content} на строку подключения модуля в списках новостей, или просто организовать постраничную навигацию с перезагрузкой страницы. |
fields | false
&fields=p.custom,e.custom1 | Колонки, добавляемые в запрос на получение новостей Префикс p. — колонка из таблицы dle_post, a e. — из таблицы dle_post_extras. Таким образом можно выводить данные из новостей даже если в БД DLE вносились дополнения. |
setFilter | &setFilter=p.comm_num|gt|100 | Собственная фильтрация данных Параметр предназначен для создания собственных условий фильтрации. Корректность передачи данных не проверяется, будьте внимательнее при построении условий фильтрации. Передавать каждый параметр фильтрации следует тремя частями разделяя их вертикальной чертой | . Где: первая часть — поле из БД, вторая — оператор (см. ниже), третья — значение. При этом параметры дуг от друга следует отделять двойной вертикальной чертой || Т.к. DLE, в целях безопасности, не позволяет передавать напрямую символы '>' и '<' через строку подключения, было принято решение использовать следующий порядок передачи операторов:
gt или + — >
lt или - — <
eq или = — =
gte или += — >=
lte или -= — <=
not или -+ или +- — !=
SEARCH — LIKE new
NOT_SEARCH — NOT LIKE new Таким образом переданная строка p.comm_num|gt|100||e.news_read|lt|500 превратится в часть запроса: p.comm_num > 100 AND e.news_read < 500 new Если третья часть параметра будет указана как NOW() , то будет подставлен текущий timestamp. Примеры: &setFilter=YEAR(p.date)|eq|2016 — новости, опубликованные в 2016 году. &setFilter=p.event_start|gte|NOW() — новости, у которых дата начала события (нестандартное поле) больше или равна текущему моменту времени. &setFilter=p.title|SEARCH|Добро пожаловать — новости, в заголовке которых содержится словосочетание "Добро пожаловать". &setFilter=p.title|NOT_SEARCH|Добро пожаловать — новости у которых в заголовке нет текста "Добро пожаловать". |
experiment new | false
&experiment=y | Включает экспериментальные функции модуля. Этот параметр включает улучшенные, но не оттестированные до конца, функции модуля. |