Skip to content

Latest commit

 

History

History
47 lines (36 loc) · 2.53 KB

create-admin.md

File metadata and controls

47 lines (36 loc) · 2.53 KB

Create an admin generator

go back to Table of contents

There are two possibilities when creating an admin generator, namely creating a complete new Bundle with the new generator or adding a generator to an existing bundle. Both are done using the same command line command.

To keep your bundle structure clean, it is recommended to create a bundle specific for all your admin generator, for example called Acme\AdminGeneratorBundle. This bundle then holds the complete configuration for your admin generators. The bundle creation can be done with a simple command from this bundle.

Create an admin

To create an admin, simply execute the following command:

php app/console admin:generate-admin

It will ask a few simple questions to be able to configure the new admin correctly. Below are the questions with possible answers, we use the Acme/AdminBundle with an Article model:

  1. Fully qualified bundle name: Acme/AdminBundle
  • Use this field to indicate the target bundle. Make sure the name ends on Bundle and that you use a forward slash for the namespace. If the bundle does not exist, it will be created.
  1. Bundle name: (use suggestion)
  • This will probably not different than the suggestion.
  1. Target directory: (use default)
  • If you have another location to generate/look for the new bundle, give it now.
  1. Generator: doctrine/doctrine_odm/propel
  • Choose the correct model manager for your model.
  1. Model name: Article
  • The complete name of the model you want to manage. Note that you want to give the fully qualified name if the model is not located in the same bundle.
  1. Prefix of yaml: AdminArticle
  • This text will be added as prefix to the generator config file for easy recognition.

Command options

If you do not want to use the step-by-step command, you can also directly use the parameters.

--namespace=NAMESPACE      The namespace of the bundle to create
--dir=DIR                  The directory where to create the bundle
--bundle-name=BUNDLE-NAME  The optional bundle name
--structure                Whether to generate the whole directory structure
--format=FORMAT            Do nothing but mandatory for extend [default: "annotation"]
--generator=GENERATOR      The generator service (propel, doctrine, doctrine_odm) [default: "doctrine"]
--model-name=MODEL-NAME    Base model name for admin module, without namespace. [default: "YourModel"]
--prefix=PREFIX            The generator prefix ([prefix]-generator.yml)