PHPackages                             survos/bootstrap-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. survos/bootstrap-bundle

ActiveSymfony-bundle[Utility & Helpers](/categories/utility)

survos/bootstrap-bundle
=======================

Integrates a bootstrap theme with many extras in a Symfony application

2.0.182(1mo ago)36.6k—6.3%3MITTwigPHP ^8.4

Since Sep 15Pushed 2mo ago2 watchersCompare

[ Source](https://github.com/survos/bootstrap-bundle)[ Packagist](https://packagist.org/packages/survos/bootstrap-bundle)[ GitHub Sponsors](https://github.com/kbond)[ RSS](/packages/survos-bootstrap-bundle/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (36)Versions (889)Used By (3)

Bootstrap Bundle
================

[](#bootstrap-bundle)

A common bootstrap layout, including menus and several components.

This bundle leverages several Symfony components, and as such loads several dependencies, and is a fairly opinionated bundles. Adhering to the coding suggestions offers several benefits.

Layout
------

[](#layout)

All of the themes are based on Bootstrap 5.3, and tabler is the recommended one. The base layout has various menus: navbar, footer, page\_header

Menus
-----

[](#menus)

The menu system is based on event listeners. While these are a bit complicated at first, benefits include:

- Context-specific menus (e.g. a separate menu for each entity, e.g. a Project menu, with its own navbar and footer.
- Automatic security -- does not render a menu item if IsGranted attribute blocks the user
- Automatic translation: uses the controller name (rather than route name) as the default label.

```
bin/console survos:make:menu App
```

```
    #[AsEventListener(event: KnpMenuEvent::NAVBAR_MENU2, priority: 50)]
    public function navarButtonsMenu(KnpMenuEvent $event): void
    {
        $menu = $event->getMenu();
        $this->add($menu, 'app_homepage');
        $this->add($menu, 'event_index');
    }

    #[AsEventListener(event: KnpMenuEvent::NAVBAR_MENU)]
    public function navbarMenu(KnpMenuEvent $event): void
    {
        if (!$this->supports($event)) {
            return;
        }
    }
```

Pass context-specific menu data by first configuring the allowable fields in menu\_options of survos\_bootstrap.yaml

```
survos_bootstrap:
  routes:
      login: app_login
      logout: app_logout
      register: app_register
      homepage: app_homepage
  menu_options:
      entityClass: null
      project: null
      frontPage: false
      showAppMenu: false
```

```
{% block footer %}

```

Entity Routes
-------------

[](#entity-routes)

Entity routes can be generated in the menu component without having to remember the parameters.

```
            if ($this->isGranted('ROLE_SUPER_ADMIN')) {
                $subMenu = $this->addSubmenu($menu, 'super_admin_index');
                $this->add($subMenu, 'owner_references', $owner);
                $this->add($subMenu, 'owner_dump', $owner, external: true);
```

the $owner class must implement getUniqueParameters(), which is used by the getRp() method. At the moment, this requires implementing the listener which is clumbsy :-(

)

```
symfony new my-app --webapp && cd my-app
composer req survos/bootstrap-bundle
composer req survos/maker-bundle --dev

bin/console importmap:require @tabler/core
echo "import '@tabler/core';
import '@tabler/core/dist/css/tabler.min.css';
" >> assets/app.js

@todo:
{% extends "@SurvosBootstrap/%s/base.html.twig"|format(theme_option('theme')) %}

bin/console make:controller App
sed  -i "s|'/app'|'/'|" src/Controller/AppController.php # the landing page controller
cat > templates/app/index.html.twig > templates/app/index.html.twig
symfony server:start -d
```

Knp Menu Bundle
---------------

[](#knp-menu-bundle)

```
symfony new menu7 --webapp --version=next && cd menu7
composer config minimum-stability dev
composer config prefer-stable false
composer config extra.symfony.allow-contrib true
#sed -i 's/"6.4.*"/"^7.0"/' composer.json
composer update
#composer config repositories.knp_menu_bundle '{"type": "vcs", "url": "git@github.com:tacman/KnpMenuBundle.git"}'
composer require knplabs/knp-menu-bundle
composer req symfony/asset-mapper
bin/console make:controller -i Menu

cat > templates/menu.html.twig createItem('root');

        $menu->addChild('Home', ['route' => 'app_app']);

        return $menu;
    }
}
END

symfony server:start -d
symfony open:local --path=/menu

```

twig bug
========

[](#twig-bug)

```
symfony new test --webapp --version=7.0 && cd test
composer require symfony/ux-twig-component symfony/asset-mapper
composer req survos/bootstrap-bundle
composer req survos/api-grid-bundle
composer req survos/crawler-bundle
composer req survos/command-bundle
composer req survos/barcode-bundle
echo "import 'bootstrap/dist/css/bootstrap.min.css'" >> assets/app.js

bin/console make:controller App
sed  -i "s|'/app'|'/'|" src/Controller/AppController.php # the landing page controller
cat > templates/app/index.html.twig