extpoint/yii2-megamenu

Configurable site map with auto generate page title, breadcrumbs and navigation

Thursday, July 19, 2018
by Vladimir Kozhin
Repository
8 Watchers
32 Stars
607 Installations

PHP
0 Dependents
0 Suggesters
5 Forks
0 Open issues
32 Versions
10 % Grown

The README.md

yii2-megamenu

Configurable site map with auto generate page title, breadcrumbs and navigation., _(*1)

Install

Install by composer:, _(*2)

$ composer require ExtPoint/yii2-megamenu

After install, add MegaMenu to configuration:, _(*3)

...
'bootstrap' => ['log', 'megamenu'],
...

'components' => [
    'megaMenu'=> [
        'class' => '\extpoint\megamenu\MegaMenu',
        'items' => [
            // sitemap
        ],
    ],
    ...
],

Features

Auto generate page title, breadcrumbs, menus and navigation from site map configuration;
Auto check access for actions (not implemented now) and menu item visible;
Separate rules from UrlManager to modules.

API of component `\extpoint\megamenu\MegaMenu`

setItems(array $items) Add menu items to end of list;
addItems() Add tree menu items;
getItems() Get all tree menu items;
getActiveItem() Returned item with current route and parsed params. Alias \Yii::$app->requestedRoute, but also have params;
getMenu($fromItem = null, $custom = null) Recursive find menu item by param $item (set null for return root) and return tree menu items (in format for \yii\bootstrap\Nav::items). Set param $custom as integer for limit tree levels. For example, getMenu(null, 2) return two-level menu;
getTitle($url = null) Find item by url (ot current page) label and return it;
getFullTitle($url = null, $separator = ' — ') Find item by url (or current page) and return item label with all parent labels;
getBreadcrumbs($url = null) Return breadcrumbs links for widget \yii\widgets\Breadcrumbs;
getItem($item, &$parents = []) Find menu item by item url or route. In param $parents will be added all parent items;
getItemUrl($item) Find item by url or route and return it url.

API of Menu Item (class `\extpoint\megamenu\MegaMenuItem`)

Menu item looks like to item from \yii\bootstrap\Nav::items. Next properties is identical:, _(*4)

label
url
visible
encode
items
linkOptions
active

Additional properties:, _(*5)

urlRule (string, array or \yii\rest\UrlRule instance) Value format is identical to item from \yii\web\UrlManager::rules;
roles (string or array of strings) Value format is identical to \yii\filters\AccessRule::roles. "?", "@" and string role are supported.
order (integer or float) Each menu items sorted by order param. Default is zero.
redirectToChild (boolean, string or integer) Set true or child item id for use link from this item.

How does item search

Each items will be equals with search item (or url/route) by method \extpoint\megamenu\MegaMenu::isUrlEquals. Links are equals as two strings. Routes are equals will be normalized to full route (with controller and module), then routes equals as strings. If routes is equals, then checked url params (if it exists). If param value is null, then compared only it keys. If param value is not null, then compared keys and params values., _(*6)

Examples:, _(*7)

isUrlEquals('http://google.com', 'http://google.com') // true
isUrlEquals(['/qq/ww/ee'], ['/aa/bb/cc']) // false
isUrlEquals(['/aa/bb/cc', 'foo' => null], ['/aa/bb/cc']) // false
isUrlEquals(['/aa/bb/cc', 'foo' => null], ['/aa/bb/cc', 'foo' => null]) // true
isUrlEquals(['/aa/bb/cc', 'foo' => 'qwe'], ['/aa/bb/cc', 'foo' => null]) // true
isUrlEquals(['/aa/bb/cc', 'foo' => 'qwe'], ['/aa/bb/cc', 'foo' => '555']) // false

The Versions

19/07 2018

dev-master

9999999-dev

Configurable site map with auto generate page title, breadcrumbs and navigation

yii2-extension yii2-megamenu

Configurable site map with auto generate page title, breadcrumbs and navigation

extpoint/yii2-megamenu

The README.md

yii2-megamenu

Install

Features

API of component \extpoint\megamenu\MegaMenu

API of Menu Item (class \extpoint\megamenu\MegaMenuItem)

How does item search

The Versions

dev-master

The Requires

The Development Requires

by Kozhin Vladimir

1.7.0

The Requires

The Development Requires

by Kozhin Vladimir

1.6.6

The Requires

The Development Requires

by Kozhin Vladimir

1.6.5

The Requires

The Development Requires

by Kozhin Vladimir

1.6.4

The Requires

The Development Requires

by Kozhin Vladimir

1.6.3

The Requires

The Development Requires

by Kozhin Vladimir

1.6.2

The Requires

The Development Requires

by Kozhin Vladimir

1.6.1

The Requires

The Development Requires

by Kozhin Vladimir

1.6.0

The Requires

The Development Requires

by Kozhin Vladimir

1.5.5

The Requires

The Development Requires

by Kozhin Vladimir

1.5.4

The Requires

The Development Requires

by Kozhin Vladimir

1.5.3

The Requires

The Development Requires

by Kozhin Vladimir

1.5.2

The Requires

The Development Requires

by Kozhin Vladimir

1.5.1

The Requires

The Development Requires

by Kozhin Vladimir

1.5.0

The Requires

The Development Requires

by Kozhin Vladimir

1.4.3

The Requires

The Development Requires

by Kozhin Vladimir

1.4.2

The Requires

The Development Requires

by Kozhin Vladimir

1.4.1

API of component `\extpoint\megamenu\MegaMenu`

API of Menu Item (class `\extpoint\megamenu\MegaMenuItem`)