Данный плагин позволяет создавать новостные блоки из страниц магазина (Магазин > Витрина > Страницы). Вывести новостные блоки можно как внутри определенной страницы, так и в файлах темы дизайна шаблона магазина. Типы возможных новостных блоков:
- новостные блоки с картинками по 2, 3 или 4 в ряд;
- блок состоящий из одной картинки и подробного текста;
- в виде обычного списка публикаций.
Возможности плагина:
- Вывод только выбранных вами страниц (по их id); только страниц являющимися подстраницами первого уровня родительской страницы; одной страницы.
- Можно выводить страницы в почти любой области сайта, например, на главной странице сайта, в списке товаров, карточке товара, а также в самой странице магазина.
- Вывод страниц с картинками - берется первая картинка из страницы или вы можете задать индивидуальную картинку для каждой страницы через Дополнительные настройки (см. Настройки плагина). Если картинки нет - берется картинка-заглушка по умолчанию.
- Возможность ограничивать область вывода страниц структурой (поселением) сайта и его доменом.
- При каждом выводе плагина можно ограничить количество выводимых новостей, ограничить длину текста и заголовков.
- Возможность сортировки выводимых статей, а также вывода кнопки Читать далее и даты создания статьи.
- Адаптивность к мобильным устройствам.
- На одной странице вы можете выводить сколько угодно новостных блоков, каждый со своими настройками.
Быстрый старт
Если у вас на сайте один домен и магазин открывается сразу при его открытии, то вы можете вывести новостной блок в нужном месте дизайна вашего сайта (например, в файле index.html) с помощью хука:
{shopMwnewsPlugin::output()}
В этом случае выведутся все страницы Магазина.
Настройки плагина
Разберем все настройки плагина на такой конструкции:
{shopMwnewsPlugin::output('src', 'domain', 'route', 'type', 'limit', 'limit_title_line', 'limit_text_line', 'order', 'order_method', 'readmore', 'datecreate')}
Параметры данной конструкции находятся внутри output(). Каждый параметр обрамлен одинарными кавычками и отделяется от других параметров запятой.
Наиболее важными являются первые пять параметров.
Если какой-то параметр вам не нужно использовать, просто оставьте его пустым (т.е. две пустые кавычки: '').
src - источник страниц. По умолчанию: пустое значение (т.е. выводятся все страницы)
- если указать один id страницы выведет только его дочерние страницы (первого уровня), например: 240
- если указать id через запятую - выведет только их, например: 2,3,45,12
- если нужно вывести только одну статью, указывайте ее id с запятой на конце, например: 45,
ps Узнать id страницы можно по ее ссылке, если нажать на ней (или навести курсор на ссылку) - в самом конце такой ссылки будет подписан ее номер, например: /webasyst/shop/?action=storefronts#/pages/2
domain - домен, с которого выводить страницы. По умолчанию: пустое значение
- если ничего не передавать, выведет все страницы со всех доменов
- если указать домен, к которому привязаны статьи, выведет только их, например: yourdomain.ru
- Внимание! Если вы установили дистрибутив магазина в поддиректорию, например, yourdomain.ru/myshop. Где myshop является подпапкой, от которой будет работать магазин, то для фильтрации по домену используйте путь вместе с поддиректорией, например: yourdomain.ru/myshop
route - ссылка на магазин в структуре, с которой выводить страницы. По умолчанию: пустое значение
- если у вас магазин открывается сразу при открытии домена сайта, то можно ничего не передавать, только пустое значение внутри кавычек: ''
- если указать принудительно правило (его можно увидеть здесь: Сайт > Структура -> Магазин), выведет только с него, например: shop/*
type - режим вывода страниц: plitka, plitka_two, plitka_three, blog, list. По умолчанию: plitka, возможные значения:
- plitka (plitka_three, plitka_two) - блоками с картинками по 4 (3, 2) в ряд (картинка берется из текста материала или из exception_page_thumb - см. ниже)
- blog - блоками с картинками по 1 в ряд (картинка берется из текста материала или из exception_page_thumb - см. ниже)
- list - обычный список заголовков-ссылок страниц по 1-й ряд
Если вы хотите вывести уникальную миниатюру для страницы, то при ее редактировании нажмите Настройки страницы и в Дополнительные параметры страницы пропишите параметр вида: exception_page_thumb=/wa-data/public/shop/img/new.jpg Где после знака = укажите ссылку на вашу картинку-миниатюру.
limit - сколько записей вывести. По умолчанию: пустое значение (т.е. выводятся все страницы)
- Укажите числом сколько страниц магазина вывести, например: 8
limit_title_line - ограничить заголовок n-м количеством строк. По умолчанию: 2
- Доступные значения: 1-20. (По умолчанию заголовок ограничивается 2 строками. Т.е. если заголовок очень длинный, например на 5 строк, то покажется только первые две).
limit_text_line - ограничить текст статьи n-м количеством строк. По умолчанию: 5
- Доступные значения: 1-20. (По умолчанию текст ограничивается 5 строками. Т.е. если текст очень длинный, например на 20 строк, то покажется только первые пять). Эта настройка взаимосвязана с Лимит текста в настройках плагина. Чем больше вы выставляете значение выводимых строк здесь, тем возможно больше вам придется выставить число символов в Лимит текста.
order - порядок записей. По умолчанию: по дате, возможные значения:
- дата - по дате создания
- алфавит - согласно алфавитному порядку
- сортировка - согласно порядку выставленному вручную, в админке
order_method - тип сортировки записей. По умолчанию по возрастанию, возможные значения:
- убывание - от большего к меньшему
- возрастание - от меньшего к большему
readmore - Читать далее. По умолчанию включено
- если передать readmore, то включится ссылка Читать далее в режимах plitka, plitka_two, plitka_three, blog
datecreate - выводить дату создания страницы. По умолчанию включено
- если передать datecreate, то включится Дата создания в режимах plitka, plitka_two, plitka_three, blog
Примеры вывода:
{shopMwnewsPlugin::output('2', 'yourdomain.com', '', 'blog', '12', '1', '4', 'алфавит', 'возрастание', '', 'datecreate')}
- выводит подстраницы 1-го уровня из страницы с id=2 только с домена yourdomain.com из любого роутинга. Тип вывода материалов - блог; количество выводимых статей до 12, количество видимых строк в заголовке = 1, а в тексте = 4; сортировка по алфавиту в порядке возрастания. Кнопка Читать далее не показывается, но показывается дата создания каждой статьи.
{shopMwnewsPlugin::output('7,8,3,12,45', 'yourdomain.com', 'vegashop/*', 'plitka_two', '', '', '5', 'сортировка', 'возрастание', '', '')}
- выводит страницы с id 7,8,3,12,45, только с домена yourdomain.com и роутинг-правила vegashop/*. Тип вывода материалов - плиткой, по 2 новости в ряд; количество выводимых статей не ограничено, количество видимых строк в заголовке = 2 (значение по умолчанию), а в тексте = 5; сортировка согласно сортировке в админке в порядке возрастания. Кнопка Читать далее и дата создания не показываются.
Внимание! Так как во многих сайтах применяются свои правила оформления стилей (css), они могут перебивать стили, которые прописаны в плагине. В таких случаях вам может потребоваться индивидуальная настройка плагина под вашу тему дизайна. Также если у вас что-то не получается с настройками или выводом плагина в дизайне сайта, то напишите нам на info@mister-green.ru, и мы в кратчайшие сроки ответим и поможем вам.
