PHPackages                             randock/adminpress-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. [Admin Panels](/categories/admin)
4. /
5. randock/adminpress-bundle

ActiveSymfony-bundle[Admin Panels](/categories/admin)

randock/adminpress-bundle
=========================

Randock AdminPress Bundle

0.0.12(6y ago)11.4k[3 PRs](https://github.com/randock/adminpress-bundle/pulls)proprietaryCSSPHP ^7.1.3

Since Mar 20Pushed 3y ago1 watchersCompare

[ Source](https://github.com/randock/adminpress-bundle)[ Packagist](https://packagist.org/packages/randock/adminpress-bundle)[ RSS](/packages/randock-adminpress-bundle/feed)WikiDiscussions develop Synced 6d ago

READMEChangelog (9)Dependencies (9)Versions (18)Used By (0)

adminpress-bundle
=================

[](#adminpress-bundle)

Install:
--------

[](#install)

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

```
"repositories": [
    {
        "type": "git",
        "url": "git@github.com:randock/adminpress-bundle.git"
    }
],
"minimum-stability": "dev",
"prefer-stable": true,

```

Install Package:

```
$ composer require randock/adminpress-bundle

```

Configure Encore Webpack :

```
$ yarn add sass-loader node-sass jquery --dev

```

Copy webpack config file from vendor folder

```
$ cp vendor/randock/adminpress-bundle/src/Resources/webpack.config.js.dist ./webpack.config.js

```

or add these entries to existing config file:

```
.addEntry('adminpress_js', './vendor/randock/adminpress-bundle/src/Resources/assets/adminpress.js')
.addStyleEntry('adminpress_css', './vendor/randock/adminpress-bundle/src/Resources/assets/adminpress.scss')
.addStyleEntry('adminpress_theme', './vendor/randock/adminpress-bundle/src/Resources/assets/scss/colors/blue.scss')
.autoProvidejQuery()

```

Ok, you are now ready to build the assets

```
$ yarn build

```

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

```
{# templates/base.html.twig #}
{% extends '@RandockAdminPress/base.html.twig' %}

```

And voilà!

Now you can see the base layout in action.

Customize:
----------

[](#customize)

- [Theme](#theme)
- [Blocks](#blocks)
- [Menu](#menu)
- [Lang](#lang-menu)
- [Right side panel](#right-side-panel)
- [Profile menu](#profile-menu)
- [Notifications Lists](#notifications-lists)

#### Theme

[](#theme)

In webpack.config.js, replace the adminpress\_theme entry with scss file what you want

```
.addStyleEntry('adminpress_theme', './vendor/randock/adminpress-bundle/src/Resources/assets/scss/colors/dark-red.scss')

```

#### Blocks

[](#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 `` 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](src/Resources/views/base.html.twig)

#### Menu

[](#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`.

```
# config/services.yaml

App\Menu\MenuItemProvider\MainMenuItemProvider:
    public: true
    tags:
        - { name: randock_admin_press.main_menu_add_items, priority: 10 }

```

#### Lang Menu

[](#lang-menu)

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

```
# config/packages/admin_press.yaml

randock_admin_press:
  locales:
    - { code: en, name: US, icon: us }
    - { code: es, name: Spain }
    - { code: cn, name: China }
    - { code: in, name: India }

```

#### Right side panel

[](#right-side-panel)

Override these two twig blocks

```
{% block right_side_toggle %}

{% endblock %}

{% block right_sidebar %}
    {% embed "@RandockAdminPress/components/right_sidebar.html.twig" %}
        {% block right_panel_title ''  %}
        {% block right_panel_body %}
        {% endblock %}
    {% endembed %}
{% endblock right_sidebar %}

```

#### Profile menu

[](#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`.

```
# config/services.yaml

App\Menu\MenuItemProvider\AccountMenuItemProvider:
    public: true
    tags:
        - { name: randock_admin_press.profile_menu_add_items, priority: 20 }

```

#### Notification lists

[](#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.

```
App\Notification\DmNotificationProvider:
    public: true
    tags:
        - { name: randock_admin_press.notification_provider, priority: 10 }

App\Notification\MailNotificationProvider:
    public: true
    tags:
        - { name: randock_admin_press.notification_provider, priority: 20 }

```

Family Icons
============

[](#family-icons)

#### Main Menu

[](#main-menu)

Main menu item accept an extra parameter named icon. This value should be a mdi icon name, listed [Material Design Icons](https://dev.materialdesignicons.com/icons)

```
$apps = $menu->addChild('Apps', ['extras' => ['icon' => 'bullseye']]);

```

Country Flag icons comes from [Flag Icon CSS](http://flag-icon-css.lip.is/). If no icon is especified, Locale code are use to determine which will be used.

#### Lang Menu

[](#lang-menu-1)

```
randock_admin_press:
  locales:
    - { code: en, name: US, icon: us }
    - { code: es, name: Spain }

```

#### Profile Menu

[](#profile-menu-1)

Same as Main Menu, but [Themify Icons](http://ws-infinity.ws-theme.com/index.php/features/icons-themify) used here

```
$menu->addChild('Logout', ['uri' => '/logout', 'extras' => ['icon' => 'power-off']]);

```

#### Notifications Icons

[](#notifications-icons)

[Material Design Icons](https://dev.materialdesignicons.com/icons), same as Main Menu

Develop:
========

[](#develop)

Create a new clean project

```
$ composer create-project symfony/skeleton mybackend

```

install dependences

```
$ cd mybackend
$ composer require knplabs/knp-menu-bundle symfony/translation symfony/twig-bundle symfony/validator symfony/webpack-encore-bundle

```

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

```
$ mkdir lib
$ cd lib
$ git clone git@github.com:randock/adminpress-bundle.git

```

Add namespace to class loader

```
# composer.json

"autoload-dev": {
    "psr-4": {
        ...
        "Randock\\AdminPressBundle\\": "lib/adminpress-bundle/src/"
        ...
    }
},

```

At the root folder of project, rebuild autoload class

```
# inside root project folder
$ composer dump-autoload

```

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

```
$ composer install
$ ant validate
$ ant fix
$ ant phpqa

```

#### Get running inside the project

[](#get-running-inside-the-project)

Instance the bundle

```
# config/bundles.php

return [
    ...
    Randock\AdminPressBundle\RandockAdminPressBundle::class => ['all' => true],
    ...
];

```

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

```
.addEntry('adminpress_js', './lib/adminpress-bundle/src/Resources/assets/adminpress.js')
.addStyleEntry('adminpress_css', './lib/adminpress-bundle/src/Resources/assets/adminpress.scss')
.addStyleEntry('adminpress_theme', './lib/adminpress-bundle/src/Resources/assets/scss/colors/blue.scss')
.autoProvidejQuery()
.enableSassLoader()

```

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

```
$ yarn install
$ yarn dev-server

```

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity54

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 84% 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 ~31 days

Recently: every ~64 days

Total

12

Last Release

2274d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/379c3e8306f0f8c89d0b246b347ab4470351202de2dad72487bdff5ecb7450ec?d=identicon)[Mastercoding](/maintainers/Mastercoding)

---

Top Contributors

[![mastercoding](https://avatars.githubusercontent.com/u/306659?v=4)](https://github.com/mastercoding "mastercoding (21 commits)")[![gerfigna](https://avatars.githubusercontent.com/u/2639926?v=4)](https://github.com/gerfigna "gerfigna (4 commits)")

### Embed Badge

![Health badge](/badges/randock-adminpress-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/randock-adminpress-bundle/health.svg)](https://phpackages.com/packages/randock-adminpress-bundle)
```

###  Alternatives

[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M651](/packages/sylius-sylius)[easycorp/easyadmin-bundle

Admin generator for Symfony applications

4.3k16.7M310](/packages/easycorp-easyadmin-bundle)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[kimai/kimai

Kimai - Time Tracking

4.6k7.4k1](/packages/kimai-kimai)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.3M152](/packages/sulu-sulu)[contao/core-bundle

Contao Open Source CMS

1231.6M2.4k](/packages/contao-core-bundle)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)