91 lines
2.5 KiB
PHP
Executable file
91 lines
2.5 KiB
PHP
Executable file
<?php
|
|
/**
|
|
* Piwik - free/libre analytics platform
|
|
*
|
|
* @link http://piwik.org
|
|
* @license http://www.gnu.org/licenses/gpl-3.0.html GPL v3 or later
|
|
*
|
|
*/
|
|
namespace Piwik\Menu;
|
|
|
|
/**
|
|
* Contains menu entries for the User menu (the menu at the very top of the page).
|
|
* Plugins can implement the `configureUserMenu()` method of the `Menu` plugin class to add, rename of remove
|
|
* items. If your plugin does not have a `Menu` class yet you can create one using `./console generate:menu`.
|
|
*
|
|
* **Example**
|
|
*
|
|
* public function configureUserMenu(MenuUser $menu)
|
|
* {
|
|
* $menu->add(
|
|
* 'MyPlugin_MyTranslatedMenuCategory',
|
|
* 'MyPlugin_MyTranslatedMenuName',
|
|
* array('module' => 'MyPlugin', 'action' => 'index'),
|
|
* Piwik::isUserHasSomeAdminAccess(),
|
|
* $order = 2
|
|
* );
|
|
* }
|
|
*
|
|
* @method static MenuUser getInstance()
|
|
*/
|
|
class MenuUser extends MenuAbstract
|
|
{
|
|
|
|
/**
|
|
* See {@link add()}. Adds a new menu item to the manage section of the user menu.
|
|
* @param string $menuName
|
|
* @param array $url
|
|
* @param int $order
|
|
* @param bool|string $tooltip
|
|
* @api
|
|
* @since 2.5.0
|
|
*/
|
|
public function addPersonalItem($menuName, $url, $order = 50, $tooltip = false)
|
|
{
|
|
$this->addItem('UsersManager_MenuPersonal', $menuName, $url, $order, $tooltip);
|
|
}
|
|
|
|
/**
|
|
* See {@link add()}. Adds a new menu item to the manage section of the user menu.
|
|
* @param string $menuName
|
|
* @param array $url
|
|
* @param int $order
|
|
* @param bool|string $tooltip
|
|
* @api
|
|
* @since 2.5.0
|
|
*/
|
|
public function addManageItem($menuName, $url, $order = 50, $tooltip = false)
|
|
{
|
|
$this->addItem('CoreAdminHome_MenuManage', $menuName, $url, $order, $tooltip);
|
|
}
|
|
|
|
/**
|
|
* See {@link add()}. Adds a new menu item to the platform section of the user menu.
|
|
* @param string $menuName
|
|
* @param array $url
|
|
* @param int $order
|
|
* @param bool|string $tooltip
|
|
* @api
|
|
* @since 2.5.0
|
|
*/
|
|
public function addPlatformItem($menuName, $url, $order = 50, $tooltip = false)
|
|
{
|
|
$this->addItem('CorePluginsAdmin_MenuPlatform', $menuName, $url, $order, $tooltip);
|
|
}
|
|
|
|
/**
|
|
* Triggers the Menu.User.addItems hook and returns the menu.
|
|
*
|
|
* @return Array
|
|
*/
|
|
public function getMenu()
|
|
{
|
|
if (!$this->menu) {
|
|
foreach ($this->getAllMenus() as $menu) {
|
|
$menu->configureUserMenu($this);
|
|
}
|
|
}
|
|
|
|
return parent::getMenu();
|
|
}
|
|
}
|