> For the complete documentation index, see [llms.txt](https://sunshine-team.gitbook.io/sunshineadminbundle/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sunshine-team.gitbook.io/sunshineadminbundle/master.md).

# Sunshine Admin Bundle

SunshineAdminBundle is a bundle designed to help you to create easily a backoffice tool for your application.

## Documentation

This documentation is available with a lot of features on : \
<https://sunshine-team.gitbook.io/sunshineadminbundle/>

### Requierements

| PHP     | 7.0 or later                   |
| ------- | ------------------------------ |
| Symfony | 3.4 or later. SF4 recommended. |

The bundle provides two different level :

* **Entities management** : Very simple to setup, it makes possible to handle CRUD actions very easily.
* **Pages** and **widgets** management : Makes possible for user to go a step further and customize the backoffice application.

### Let's play

* [Setup in your project](https://sunshine-team.gitbook.io/sunshineadminbundle/setup.md)
* [Theme Configuration](https://sunshine-team.gitbook.io/sunshineadminbundle/theme-configuration.md)

### Entities Management

* [YAML Entity description](https://sunshine-team.gitbook.io/sunshineadminbundle/yaml-entity-configuration.md)
* [Field types and overrides](https://sunshine-team.gitbook.io/sunshineadminbundle/field-type-and-overrides.md)
* [Entity Relations](https://sunshine-team.gitbook.io/sunshineadminbundle/entity-relations.md)

### Pages, Widget and menu

* [Menu Configuration](https://sunshine-team.gitbook.io/sunshineadminbundle/menu-configuration.md)
  * [Type : section](https://sunshine-team.gitbook.io/pages/-LAYF5qu7JGl3YuwMhOw#type-:-section)
  * [Type : submenu](https://sunshine-team.gitbook.io/pages/-LAYF5qu7JGl3YuwMhOw#type-:-submenu)
  * [Type : list](https://sunshine-team.gitbook.io/pages/-LAYF5qu7JGl3YuwMhOw#type-:-sunshine-list)
  * [Type : page](https://sunshine-team.gitbook.io/sunshineadminbundle/menu-configuration.md)
  * [Type : route](https://sunshine-team.gitbook.io/pages/-LAYF5qu7JGl3YuwMhOw#type-:-route)
  * [Type : external page](https://sunshine-team.gitbook.io/pages/-LAYF5qu7JGl3YuwMhOw#type-:-external-page)
  * [Roles & Permissions](https://sunshine-team.gitbook.io/sunshineadminbundle/menu-configuration.md#roles-and-permissions-configuration)
* [Theme configuration](https://sunshine-team.gitbook.io/sunshineadminbundle/theme-configuration.md)
* [Page configuration](https://sunshine-team.gitbook.io/sunshineadminbundle/creating-a-page.md)
  * [YAML Configuration](https://sunshine-team.gitbook.io/sunshineadminbundle/creating-a-page.md#yaml-definition)
  * [Conventions](https://sunshine-team.gitbook.io/sunshineadminbundle/creating-a-page.md#conventions)
  * [Title & Description ](https://sunshine-team.gitbook.io/sunshineadminbundle/creating-a-page.md#title-and-description)
  * [Using widgets](https://sunshine-team.gitbook.io/sunshineadminbundle/creating-a-page.md#using-widgets)
* [Widgets](https://sunshine-team.gitbook.io/sunshineadminbundle/untitled.md)
  * [YAML Configuration](https://sunshine-team.gitbook.io/sunshineadminbundle/untitled.md#yaml-configuration)
  * [Service class creation](https://sunshine-team.gitbook.io/sunshineadminbundle/untitled.md#service-class-creation)
  * [The Twig view](https://sunshine-team.gitbook.io/sunshineadminbundle/untitled.md#view-creation)
  * [MessageBag Bus](https://sunshine-team.gitbook.io/sunshineadminbundle/untitled.md#messagebag-send-informations-to-widget)
  * [Using forms](https://sunshine-team.gitbook.io/sunshineadminbundle/untitled.md#forms-inside-a-widget)
  * [Redirect and Forward response](https://sunshine-team.gitbook.io/sunshineadminbundle/untitled.md#redirect-to-current-route)
* [Creation of a new Page with widgets](https://sunshine-team.gitbook.io/sunshineadminbundle/creating-a-page.md)
  * [YAML Configuration](https://sunshine-team.gitbook.io/sunshineadminbundle/creating-a-page.md#yaml-definition)
  * [Using Widgets](https://sunshine-team.gitbook.io/sunshineadminbundle/creating-a-page.md#using-widgets)
* [Creating Widgets](https://sunshine-team.gitbook.io/sunshineadminbundle/untitled.md)
  * [YAML Configuration](https://sunshine-team.gitbook.io/sunshineadminbundle/untitled.md#yaml-configuration)
  * [Service class creation](https://sunshine-team.gitbook.io/sunshineadminbundle/untitled.md#service-class-creation)
  * [The View](https://sunshine-team.gitbook.io/sunshineadminbundle/untitled.md#view-creation)
  * [The messageBag](https://sunshine-team.gitbook.io/sunshineadminbundle/untitled.md#messagebag-send-informations-to-widget)
  * [Using Forms in widgets](https://sunshine-team.gitbook.io/sunshineadminbundle/untitled.md#forms-inside-a-widget)
  * [Redirect to current route](https://sunshine-team.gitbook.io/sunshineadminbundle/untitled.md#redirect-to-current-route)
  * [Using services in widgets](https://sunshine-team.gitbook.io/sunshineadminbundle/untitled.md#how-to-inject-services-in-widget-service)

### Crud Widget

* [Generic Widget : List](https://sunshine-team.gitbook.io/sunshineadminbundle/generic-widgets.md)
  * [YAML Configuration](https://sunshine-team.gitbook.io/sunshineadminbundle/generic-widgets.md#yaml-configuration)
  * [Configuration Inheritance & Overrides](https://sunshine-team.gitbook.io/sunshineadminbundle/generic-widgets.md#configuration-inheritance)
  * [Preset values for Filters](https://sunshine-team.gitbook.io/sunshineadminbundle/generic-widgets.md#override-list-and-filters)
  * [Add/Remove columns or filters](https://sunshine-team.gitbook.io/sunshineadminbundle/generic-widgets.md#configuration-inheritance)
  * [Configure a datasource for a filter](https://sunshine-team.gitbook.io/sunshineadminbundle/filtering-custom-values-in-select2-lists.md)

### Security and Roles

* Enabling Authentication
* [Filtering by user role](https://sunshine-team.gitbook.io/sunshineadminbundle/roles-and-permissions.md)
  * [Widgets](https://sunshine-team.gitbook.io/sunshineadminbundle/roles-and-permissions.md#widget)
  * [Menu](https://sunshine-team.gitbook.io/sunshineadminbundle/roles-and-permissions.md#menu)
  * [Pages](https://sunshine-team.gitbook.io/sunshineadminbundle/roles-and-permissions.md#page)

### Filtering List

* [Default filter value](https://sunshine-team.gitbook.io/sunshineadminbundle/filtering-default-values.md)
* [Multiple filter values](https://sunshine-team.gitbook.io/sunshineadminbundle/filtering-options-multiple.md)

### Ordered list

* How to order lists
