PHPackages wucdbm/menu-builder-bundle - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. wucdbm/menu-builder-bundle ActiveSymfony-bundle[Utility & Helpers](/categories/utility) wucdbm/menu-builder-bundle ========================== A simple, standalone Menu Builder for Symfony 2 Applications v3.0.3(9y ago)06322GPL-2.0PHPPHP ~5.5|~7.0 Since Jun 16Pushed 8y ago1 watchersCompare [ Source](https://github.com/wucdbm/menu-builder-bundle)[ Packagist](https://packagist.org/packages/wucdbm/menu-builder-bundle)[ RSS](/packages/wucdbm-menu-builder-bundle/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependencies (2)Versions (21)Used By (2) menu-builder-bundle =================== [](#menu-builder-bundle) A simple, standalone Menu Builder for Symfony 2 Applications Upcoming / TODO --------------- [](#upcoming--todo) - TODO: Introduce cache. Use either WucdbmBundle or Symfony's Cache component, if it finally gets native Memcached impl. Minor TODO ---------- [](#minor-todo) - Put docs inside of this bundle, this is the Core and is for developers only. The Client one is meant to be your base client, if that does not satisfy you, build your own with your own user experience - TODO: Static config with system routes - upon import, always make all of these system Usage ----- [](#usage) Having properly configured uglifycss and uglifyjs is a requirement for production. Add this bundle to your AppKernel.php `new \Wucdbm\Bundle\MenuBuilderBundle\WucdbmMenuBuilderBundle()` In your config.yml, add `WucdbmMenuBuilderBundle` to your assetic bundles, as well as your doctrine mapping (if not automatic) Execute `app/console doctrine:schema:update --dump-sql` and after verifying what is being executed, execute again with --force. Alternatively, use doctrine migrations via the DoctrineMigrations bundle. Execute `app/console wucdbm_menu_builder:import_routes` to import your current routes from your symfony application into the tables created by the bundle. Alternatively, add `Wucdbm\\Bundle\\MenuBuilderBundle\\Composer\\ScriptHandler::importRoutes` to your composer.json's `post-install-cmd` or `post-update-cmd` command list and this will be executed after every install or update Once this has been done, you can start using the bundle. Simply register it in your routing.yml like so: ``` wucdbm_builder: resource: "@WucdbmMenuBuilderBundle/Resources/config/routing.yml" prefix: /admin/builder ``` Assuming that /admin is protected by a firewall, the builder should be secure and inaccessible to random people. You can create a link to the builder using `{{ path('wucdbm_menu_builder_dashboard') }}`, or embed it into your admin UI via an iframe like so `` The User Interface is pretty anemic as this bundle only implements the core functionality and the administrative (for developers) functionality. If you want to let users (non-developers) manipulate menus, check out the `WucdbmMenuBuilderClientBundle()`Once you have created a menu, you can access it in your application by calling the `getMenu`twig function, which will return `Wucdbm\Bundle\MenuBuilderBundle\Entity\Menu` or `null`. A menu contains `Wucdbm\Bundle\MenuBuilderBundle\Entity\MenuItem`s. Menu items can be nested, ie they have a parent and children. A good idea when listing the top-level menu is to only list items whose parent is null: ``` {# New: You can use the menuTopLevelItems filter to get all top-level items: #} {% for item in getMenu(1)|menuTopLevelItems %} ``` ``` {% if getMenu(1) %} {# You could also use any constant with the constant() function or any other way of referencing the menu ID #} {% for item in getMenu(1).items if item.parent is null %} {# You can recursively include your templates to list the sub-menus #} {% include '@Some/location/template.html.twig' with {items: item.children} %} {% endfor %} {% endif %} ``` ``` {% if getMenu(1) %} {% for item in getMenu(1).items if item.parent is null %} {{ item.name }} {% endfor %} {% endif %} ``` Printing a link for a menu is done via the `menuItemPath` twig filter/function, like so: ``` {{ item.name }} ``` Or for absolute links ``` {{ item.name }} ``` You can also use the second (optional) parameter for `menuItemUrl` and set the type of address (one of the `Symfony\Component\Routing\Generator\UrlGeneratorInterface` constants) Dynamic Default Parameters -------------------------- [](#dynamic-default-parameters) If you want to have a dynamic default parameter for some of your routes, for instance, routes with a dynamic locale: In config.yml: ``` parameters: locale: en framework: default_locale: %locale% ``` In routing.yml: ``` some_resource: resource: "@SomeBundle/Resources/config/routing.yml" prefix: /{_locale} schemes: [https] requirements: _locale: "en|de|ru" defaults: _locale: %locale% ``` Generally, you do NOT need the `defaults: {_locale: %locale%}` part because you already have the default locale configured in your framework bundle config, but this will only work for `_locale`However, with this approach the default value for the `_locale` route parameter will be available to the menu builder when importing routes. When building a link, you may choose to leave the field blank if there is a default parameter. This will allow you to change the default value for that parameter at a later point, WITHOUT having to update menu items. When routes are updated during the deployment of your application, the default value for that parameter of your route will also be updated. The current value of the default parameter will always be saved upon menu item edit anyway, but the menu builder will always try to use the current default value for that route parameter. If the default value for any parameter has been removed, it will fallback to the route default parameter as has been on the last menu item save. Not to be confused with symfony internal parameters such as `_locale` that may have another default value in the current context -------------------------------------------------------------------------------------------------------------------------------- [](#not-to-be-confused-with-symfony-internal-parameters-such-as-_locale-that-may-have-another-default-value-in-the-current-context) An example would be a site with default locale of "en", but the user is browsing the "fr" version. You want your links to always point to the current locale and not to a pre-selected one or the default for your site. Which is a feature that has not yet been developed, but this would allow you to completely ignore a parameter and not provide it if it already exists in the router context? To be researched. See TODOs for more information on this. ### Health Score 31 — LowBetter than 68% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity13 Limited adoption so far Community11 Small or concentrated contributor base Maturity67 Established project with proven stability Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~7 days Recently: every ~21 days Total 20 Last Release 3483d ago Major Versions v2.8.10 → v3.0.02016-07-26 v2.8.11 → v3.0.12016-08-06 v2.8.12 → v3.0.22016-08-09 v2.8.13 → v3.0.32016-08-12 PHP version history (2 changes)v2.8.0PHP ~5.5 v2.8.9PHP ~5.5|~7.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/56129a0e9c0044d2857f405e0cf44b1c8f53bc86503dfc1c0ac3829401333c5e?d=identicon)[wucdbm](/maintainers/wucdbm) --- Top Contributors [![wucdbm](https://avatars.githubusercontent.com/u/1559022?v=4)](https://github.com/wucdbm "wucdbm (109 commits)") --- Tags Symfony2buildermenumenu-builderwucdbm ### Embed Badge ![Health badge](/badges/wucdbm-menu-builder-bundle/health.svg) ``` [![Health](https://phpackages.com/badges/wucdbm-menu-builder-bundle/health.svg)](https://phpackages.com/packages/wucdbm-menu-builder-bundle) ``` ### Alternatives [optimistdigital/nova-menu-builder This Laravel Nova package allows you to create and manage menus and menu items. 243369.4k](/packages/optimistdigital-nova-menu-builder)[outl1ne/nova-menu-builder This Laravel Nova package allows you to create and manage menus and menu items. 243246.0k3](/packages/outl1ne-nova-menu-builder) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)