Новости: news
Метод news позволяет получить страницы или разделы новостей.
Параметры запроса (передаются в массиве):
| act | определяет действие, которое будет выполнено (получение страниц или разделов новостей) |
|---|---|
| Тип | string |
| Возможные значения |
get (получение страниц новостей), get_part (получение разделов новостей) |
| Значение по умолчанию | get |
| where | условия для выборки из БД |
|---|---|
| Тип | array |
| Возможные значения | любой допустимый набор пар ключ-значение для корректного sql запроса, например array('id' => 1) будет соответствовать записи "WHERE id=1" |
| Значение по умолчанию | нет |
| limit | ограничение по количеству вывода данных |
|---|---|
| Тип | integer |
| Значение по умолчанию | нет |
| offset | сдвиг для построения пагинации |
|---|---|
| Тип | integer |
| Значение по умолчанию | нет |
| order | порядок вывода данных (сортировка) |
|---|---|
| Тип | string |
| Возможные значения | возможные значения – любая допустимая сортировка согласно БД, например 'name asc' будет соответствовать сортировке по имени от А до Я. Для сортировки по возрастанию используется asc, по убыванию – desc |
| Значение по умолчанию | нет |
| extra | дополнительные данные, которые необходимо получить |
|---|---|
| Тип | array |
| Возможные значения | массив с максимальным набором данных выглядит следующим образом array('video', 'files', 'part'), где video – видео новости, files – файлы новости, part – раздел |
| Значение по умолчанию | нет |
Внимание! Для использования параметров where и order, а также для корректной обработки ответа, необходимо знать структуру таблиц, соответствующих данному методу. Для просмотра информации перейдите по ссылке.
Помимо основных данных, выгружаются дополнительные параметры (params) и фото (photo) для каждой новости, а также, список настроек модуля "Новости" (settings) в общем массиве данных (даже если выборка содержит 0 совпадений).
Настройки модуля "Новости" содержат следующие параметры:
| default_photo | фото, которое используется по умолчанию, если фото к новости или разделу новостей не было загружено |
| sort | сортировка новостей по умолчанию |
| timer | отложенный запуск новостей (on/off) |
| watermark | водяной знак, который автоматически накладывается при загрузке фото через админ. панель SE4 |
Похожие методы
Пример простейшего вызова
$this->smartriver->news();
Пример вызова с параметрами
$this->smartriver->news(['act' => 'get', 'where' => ['id' => 91], 'extra' => ['video', 'files', 'part']]);
Пример ответа
Array
(
[status] => ok
[message] => success
[response] => Array
(
[0] => Array
(
[id] => 91
[id_part] => 7
[id_tpl] => -1
[name] => Тестовая новость
[announce] => Тестовый анонс
[content] => Тестовое содержание
[link] =>
[image] => /images/gallery/IkbQSDqL8w8ZywGHmqPc.gif
[date] => 2022-11-02
[time] => 10:26:00
[seo_title] =>
[seo_keywords] =>
[seo_description] =>
[top] => 0
[sort] => 0
[fixed] => 0
[active] => 1
[params] => Array
(
[test] => 2022-11-02
[toggle] =>
[version] =>
)
[photo] => Array
(
[0] => Array
(
[url] => /images/gallery/IkbQSDqL8w8ZywGHmqPc.gif
[caption] =>
)
)
[video] => Array
(
[0] => Array
(
[id] => 199
[name] => Вводный урок
[type] => youtube
[url] => https://www.youtube.com/watch?v=7ufekNACRTk
[codec] =>
[html] =>
)
[1] => Array
(
[id] => 6
[name] => Создание стиля для текста.mp4
[type] => mp4
[url] => /video/9O6cnnEqmhOCed5FefBF.mp4
[codec] => avc1.42E01E, mp4a.40.2
[html] =>
)
)
[files] => Array
(
[0] => Array
(
[id] => 4
[name] => x5Gkh3zUvHH9dOFgDUmj.gif
[size] => 237.49
[extention] => gif
[type] => image
[media] => 1
[mediaType] => image
[url] => /files/8a7699n3j69efp6cds65.gif
)
[1] => Array
(
[id] => 6
[name] => Тестовый документ.txt
[size] => 0.05
[extention] => txt
[type] => document
[media] =>
[mediaType] =>
[url] => /files/usc35tjngb0o2ig3fu9j.txt
)
)
[part] => Array
(
[id] => 7
[id_tpl] => -1
[name] => Тестовый раздел
[link] => testovy_razdel
[announce] =>
[content] =>
[image] =>
[sort] => 0
[active] => 0
[is_index] => 0
)
)
)
[settings] => Array
(
[default_photo] =>
[sort] => date_desc
[timer] => on
[watermark] =>
)
)
Была ли полезна для вас статья?
