Download the PHP package randock/adminpress-bundle without Composer

adminpress-bundle

Install:

Add stability directives and repository to composer.json project file:

Install Package:

Configure Encore Webpack :

Copy webpack config file from vendor folder

or add these entries to existing config file:

Ok, you are now ready to build the assets

To use the dashboard template, create a template extending the base one

And voilà!

Now you can see the base layout in action.

Customize:

• Theme
• Blocks
• Menu
• Lang
• Right side panel
• Profile menu
• Notifications Lists

Theme

In webpack.config.js, replace the adminpress_theme entry with scss file what you want

Blocks

• page_content is the content of document, inside the dashboard layout
• section_title will be the visible title of the page
• header_css and header_js are located on the header section of html document
• inline_js is the last block before the body tag is closed
• header_extras is the right place to put all meta-tags you need
• header_title is the content of <title> tag on header
• left_sidebar_user_profile is the section on top of the left sidebar
• right_side_toggle by default is empty, and is the button or element responsible of toggling the right side panel
• footer is self explained
• Other blocks, you can find out on base template

Menu

All you need to create the left menu, is to create a service implementing MenuItemProviderInterface. It has a single method addItems returning a Knp\Menu\ItemInterface as a menu root.

Then, tag the service with randock_admin_press.main_menu_add_items and priority.

Lang Menu

You need to configure routes with {_locale} parameter and tells to adminpress-bundle wich locales you want

Right side panel

Override these two twig blocks

Profile menu

Proced in same mode than the main menu. Implements MenuItemProviderInterface in one or more services. These menu items will be separated by visual dividers on profile menu.

Tag the service with randock_admin_press.profile_menu_add_items and assign priority.

Notification lists

Notifications lists are shown on top bar. You should implement a provider per each type of notifications you want to get in top bar. In example, you can implement a Direc Messages provider, and a Mail Provider. They should implement NotificationProviderInterface. Priority indicates the order in which will be shown.

Family Icons

Main Menu

Main menu item accept an extra parameter named icon. This value should be a mdi icon name, listed Material Design Icons

Country Flag icons comes from Flag Icon CSS. If no icon is especified, Locale code are use to determine which will be used.

Lang Menu

Profile Menu

Same as Main Menu, but Themify Icons used here

Notifications Icons

Material Design Icons, same as Main Menu

Develop:

Create a new clean project

install dependences

Clone repo in a symfony working project, inside lib/ folder

Add namespace to class loader

At the root folder of project, rebuild autoload class

You can run validation, code fixing and phpqa by running inside de repo folder

Get running inside the project

Instance the bundle

Then, proceed with encore and template configuration as was explained at top of this document. You should change the path to entry files replacing ./vendor/randock by ./lib and enabling sass

Run dev-server. You may have some issues running inside a docker container. For better experience, run it on the local machine