README

Русский | English

Виджет «Навигационная цепочка»

Виджет «Хлебные крошки» (breadcrumb‑навигация) предназначен для визуализации пути к текущей странице в виде последовательности ссылок, отражающих её положение в иерархической структуре веб‑сайта.

Например, структура вида «Главная / Категория / Статья», где «Статья» выступает в качестве активного элемента, обозначающего текущую страницу, а все предшествующие элементы представлены в виде гиперссылок.

Для использования, необходимо указать параметр «links» в конфигурации виджета. Пример:

echo $this->widget('rg.wd.breadcrumbs', [
     'links' => [
         [
             'label' => 'Категория статьи',
             'url'   => 'post-category'
         ],
         [
              'label' => 'Статья'
          ]
     ]
 ]);
// или
echo $this->widget('rg.wd.breadcrumbs:main', ['ui' => 'bootstrap5'])

Пример применения

с менеджером виджетов:

$breadcrumbs = Ge::$app->widgets->get('rg.wd.breadcrumbs', ['ui' => 'bootstrap5']);
$breadcrumbs->run();

в шаблоне:

echo $this->widget('rg.wd.breadcrumbs', ['ui' => 'bootstrap5']);

с namespace:

use Rg\Widget\Breadcrumbs\Widget as Breadcrumbs;
echo Breadcrumbs::widget(['ui' => 'bootstrap5']);

если namespace ранее не добавлен в PSR, необходимо выполнить:

Ge::$loader->addPsr4('Rg\Widget\Breadcrumbs\\', Ge::$app->modulePath . '/rg/rg.wd.breadcrumbs/src');

Установка

Для добавления виджета в ваш проект, вы можете просто выполнить команду ниже:

$ composer require rosgear/rg-wd-breadcrumbs

или добавить в файл composer.json вашего проекта:

"require": {
    "rosgear/rg-wd-breadcrumbs": "*"
}

или скачать архив на странице виджета в каталоге приложений RosGear.

После добавления виджета в проект выполните его установку в редакцию веб‑приложения с помощью Панели управления GePanel.

Widget «Breadcrumbs»

The Breadcrumb navigation widget is designed to visualize the path to the current page as a sequence of links reflecting its position in the hierarchical structure of the website.

For example, a structure like «Home / Category / Article», where «Article» acts as the active element denoting the current page, and all previous elements are presented as hyperlinks.

Installation

To add the widget to your project, you can simply run the command below:

$ composer require rosgear/rg-wd-breadcrumbs

or add to your project's composer.json file:

"require": {
    "rosgear/rg-wd-breadcrumbs": "*"
}

or download the archive from the widget page in the RosGear application catalog.

After adding the widget to the project, install it into the web application edition using the GePanel Control Panel.