/EasyAdminBundle

The new (and simple) admin generator for Symfony applications.

Primary LanguagePHPMIT LicenseMIT

❮ NOTE ❯ This bundle releases new versions on a regular basis. Make sure to update your dependencies frequently to get the latest version. Check out the changelog to learn about the new features and read the UPGRADE guide.


EasyAdmin

Build Status SensioLabsInsight Coverage Status Symfony

Symfony Backends created with EasyAdmin

EasyAdmin lets you create administration backends for Symfony applications with unprecedented simplicity.

Features

  • CRUD operations on Doctrine entities (create, edit, list, delete).
  • Full-text search, pagination and column sorting.
  • Fully responsive design (smartphones, tablets and desktops).
  • Supports Symfony 2.x and 3.x.
  • Translated into tens of languages.
  • Fast, simple and smart where appropriate.

Requirements

  • Symfony 2.3+ or 3.x applications (Silex not supported).
  • Doctrine ORM entities (Doctrine ODM and Propel not supported).
  • Entities with composite keys or using inheritance are not supported.

Documentation

Getting Started Guide

The Getting Started Guide explains how to install the bundle and how to create your first backend. This guide is a must- read before using EasyAdmin.

The Book

Tutorials

Third-party bundles/services integrations

❮ NOTE ❯ you are reading the documentation of the bundle's development version. You can also [read the documentation of the latest stable version ➜] (https://github.com/javiereguiluz/EasyAdminBundle/tree/v1.16.5/).

Demo Application

easy-admin-demo is a complete Symfony application created to showcase EasyAdmin features.

Installation

Step 1: Download the Bundle

$ composer require javiereguiluz/easyadmin-bundle

This command requires you to have Composer installed globally, as explained in the Composer documentation.

Step 2: Enable the Bundle

<?php
// app/AppKernel.php

// ...
class AppKernel extends Kernel
{
    public function registerBundles()
    {
        $bundles = array(
            // ...
            new JavierEguiluz\Bundle\EasyAdminBundle\EasyAdminBundle(),
        );
    }

    // ...
}

Step 3: Load the Routes of the Bundle

# app/config/routing.yml
easy_admin_bundle:
    resource: "@EasyAdminBundle/Controller/"
    type:     annotation
    prefix:   /admin

# ...

Step 4: Prepare the Web Assets of the Bundle

# Symfony 2
php app/console assets:install --symlink

# Symfony 3
php bin/console assets:install --symlink

That's it! Now everything is ready to create your first admin backend.

Your First Backend

Creating your first backend will take you less than 30 seconds. Let's suppose that your Symfony application defines three Doctrine ORM entities called Product, Category and User.

Open the app/config/config.yml file and add the following configuration:

# app/config/config.yml
easy_admin:
    entities:
        - AppBundle\Entity\Product
        - AppBundle\Entity\Category
        - AppBundle\Entity\User

Congratulations! You've just created your first fully-featured backend! Browse the /admin URL in your Symfony application and you'll get access to the admin backend:

Default EasyAdmin Backend interface

Keep reading the rest of the documentation to learn how to create complex backends.

License

This software is published under the MIT License