pd-menu's Introduction

pdMenu Bundle

Simple fast object-oriented menu maker for Symfony 5

Installation

Step 1: Download the Bundle

Open a command console, enter your project directory and execute the following command to download the latest stable version of this bundle:

composer require appaydin/pd-menu

This command requires you to have Composer installed globally, as explained in the installation chapter of the Composer documentation.

Step 2: Enable the Bundle

With Symfony 4, the package will be activated automatically. But if something goes wrong, you can install it manually.

Then, enable the bundle by adding it to the list of registered bundles in the config/bundles.php file of your project:

<?php
// config/bundles.php

return [
    //...
    Pd\MenuBundle\PdMenuBundle::class => ['all' => true]
];

Create Your First menu

Step 1: Without Service

You can create menus without service. You can load the necessary parameters using $options

<?php
// src/Menu/FirstMenu.php

namespace App\Menu;

use Pd\MenuBundle\Builder\ItemInterface;
use Pd\MenuBundle\Builder\Menu;

class FirstMenu extends Menu
{
    /**
     * Override
     */
    public function createMenu(array $options = []): ItemInterface
    {
        // Create Root Item
        $menu = $this
            ->createRoot('settings_menu', true) // Create event is "settings_menu.event"
            ->setChildAttr(['data-parent' => 'admin_account_list']); // Add Parent Menu to Html Tag

        // Create Menu Items
        $menu->addChild('nav_config_general', 1)
            ->setLabel('nav_config_general')
            ->setRoute('admin_settings_general')
            ->setLinkAttr(['class' => 'nav-item'])
            ->setRoles(['ADMIN_SETTINGS_GENERAL'])
                // Contact
                ->addChildParent('nav_config_contact', 5)
                ->setLabel('nav_config_contact')
                ->setRoute('admin_settings_contact')
                ->setLinkAttr(['class' => 'nav-item'])
                ->setRoles(['ADMIN_SETTINGS_CONTACT'])
                // Email
                ->addChildParent('nav_config_email', 10)
                ->setLabel('nav_config_email')
                ->setRoute('admin_settings_email')
                ->setLinkAttr(['class' => 'nav-item'])
                ->setRoles(['ADMIN_SETTINGS_EMAIL'])
                // Template
                ->addChildParent('nav_config_template')
                ->setLabel('nav_config_template')
                ->setRoute('admin_settings_template')
                ->setLinkAttr(['class' => 'nav-item'])
                ->setRoles(['ADMIN_SETTINGS_TEMPLATE'])
                // Account
                ->addChildParent('nav_config_user')
                ->setLabel('nav_config_user')
                ->setRoute('admin_settings_user')
                ->setLinkAttr(['class' => 'nav-item'])
                ->setRoles(['ADMIN_SETTINGS_USER']);

        return $menu;
    }
}

Rendering Menu

The creation process is very simple. You can specify additional options.

{{ pd_menu_render('App\\Menu\\FirstMenu', {
    'custom': 'variable or options'
}) }}

You can change the default options.

{{ pd_menu_render('App\\Menu\\FirstMenu', {
    'template': '@PdMenu/Default/menu.html.twig',
    'depth': null,
    'currentClass': 'active',
    'trans_domain': 'admin',
    'iconTemplate' => '<i class="material-icons">itext</i>'
}) }}

You can change the default options globally.

config/packages/pd_menu.yaml

pd_menu:
    template: '@PdMenu/Default/menu.html.twig',
    depth: null,
    currentClass: active
    trans_domain: admin,
    iconTemplate: '<i class="fa&text"></i>'

Create Menu Event & Event Listener

Step 1: Create Menu Event

All menus automatic events are generated. Example : "menu_name.event"

Step 2: Create Menu Listener

Now let's create a listener for the event.

<?php
// src/Listener/MenuListener.php

namespace App\Listener;

use Pd\MenuBundle\Event\PdMenuEvent;

class MenuListener
{
    public function onCreate(PdMenuEvent $event)
    {
        // Get Menu Items
        $menu = $event->getMenu();

        // Add New Item
        $menu->addChild('demo_item', 5)
            ->setLabel('Home Page')
            ->setRoute('home_route');
    }
}

Let's create a service for the listener.

App\Menu\MenuListener:
    tags:
        - { name: kernel.event_listener, event: settings_menu.event, method: onCreate }

pd-menu's People

Contributors

Stargazers

Watchers

pd-menu's Issues

Allow setting menu defaults

It's great being able to set Link and List attributes on individual items, however it would be great if we could set defaults for them.
The classes I need on the links and lists are different to you, and currently I need to set them on each menu item. Either being able to set defaults at render time, or at menu build time would be good. (And if you already can, improving the docs would be good)

        // Create Menu Items
        $menu->addChild('nav_config_general', 1)
            ->setLabel('Config General')
            ->setRoute('nav_config_general')
            ->setListAttr(['class' => 'nav-item'])
            ->setLinkAttr(['class' => 'nav-link'])
            // Contact
            ->addChildParent('nav_config_contact', 5)
            ->setLabel('Contact')
            ->setRoute('nav_config_contact')
            ->setListAttr(['class' => 'nav-item'])
            ->setLinkAttr(['class' => 'nav-link'])
            // Email
            ->addChildParent('nav_config_email', 10)
            ->setLabel('Email')
            ->setRoute('nav_config_email')
            ->setListAttr(['class' => 'nav-item'])
            ->setLinkAttr(['class' => 'nav-link'])
            ;

Could either become

        $menu->setDefaultListAttr(['class' => 'nav-item'])
            ->setDefaultLinkAttr(['class' => 'nav-link'])
        // Create Menu Items
        $menu->addChild('nav_config_general', 1)
            ->setLabel('Config General')
            ->setRoute('nav_config_general')
            // Contact
            ->addChildParent('nav_config_contact', 5)
            ->setLabel('Contact')
            ->setRoute('nav_config_contact')
            // Email
            ->addChildParent('nav_config_email', 10)
            ->setLabel('Email')
            ->setRoute('nav_config_email')
            ;

Or It could become

        // Create Menu Items
        $menu->addChild('nav_config_general', 1)
            ->setLabel('Config General')
            ->setRoute('nav_config_general')
            // Contact
            ->addChildParent('nav_config_contact', 5)
            ->setLabel('Contact')
            ->setRoute('nav_config_contact')
            // Email
            ->addChildParent('nav_config_email', 10)
            ->setLabel('Email')
            ->setRoute('nav_config_email')
            ;

and at render time

{{ pd_menu_render('App\\Menu\\FirstMenu', {
    'defaultLinkAttr': {'class': 'nav-link'},
    'defaultListAttr': {'class': 'nav-item'}
}) }}

Recommend Projects

cesurapp / pd-menu Goto Github PK