Admin generator

Diem uses the excellent symfony admin generator. But with some additions.

generator.yml builder

Diem is smart enough to write the generator.yml file for you. When you generate a new module with

php symfony dm:setup  

The admin module is created, with a quite good generator.yml.

Later, if you add fields to the model, Diem will not add the fields to the generator.yml, because it may override your changes. So, if you want Diem to regenerate a generator.yml from the current model, use

php symfony dmAdmin:generate --clear=myModule  

To customize the generator.yml, please see the symfony admin generator documentation and the Diem added configuration.

Override plugin modules

If you override a plugin model in your schema.yml, the admin module will not be generated in your project. You have to copy manually the plugin generator.yml:
dmGreatPlugin/modules/dmGreatModuleAdmin/config/schema.yml
into your project, in
apps/admin/modules/dmGreatModuleAdmin/config/schema.yml
And add the missing fields manually, as you would do in a normal symfony application.

Added features

Diem admin generator comes with more features than the symfony one.

• history interface to manage records versions
• google-like search
• max-per-page selector
• sort on partial ( if the partial has the same name than a database field )
• sort on foreign keys
• markdown editor with droppable links and medias, and ajax preview
• nice theme
• Save, Save and Add, Save and Back to list, Save and Next buttons
• fast navigation between objets ( Previous - Next )
• Bread crumb
• Automatic sort interface with jQuery UI Sortable
• Automatic batch actions : delete, activate, deactivate
• Automatic fixtures called "Loremization" (see Tutorial #1: create dummy posts)
• Foreign objects made automatically clickable
• Drag & drop pages and medias to form fields

One symfony feature has been dropped : the filters. It has been replaced by a single-field search engine, that searches into all model fields.

Diem admin interface is heavily inspired by the Total Usability Blog and the Gmail interface.

• Filter forms are evil
• If it works like email, usability is not a problem

Added configuration

Fields

config:  
  fields:  
    url:  
      is_link:      true  
    title:  
      is_big:       true  
    body:  
      markdown:     true  

is_link

When a field is marked as is_link, it becomes droppable.

• The user can drag&drop pages from the left PAGES panel inside, to link to an internal page.
• The user can drag&drop medias from the right MEDIA panel inside to generate a download link.
• The user can write a full url, to link to an external site.

TIP
When a database field contains a link, it's better to declare it in the schema.yml. This way, not only the admin generators knows how to deal with it, but the whole project too.

is_big

Diem admin forms are displayed in two columns.
When a field is marked as is_big, it uses the two columns.

markdown

When a textarea is marked as markdown, it is transformed into a markdown editor with an ajax preview.

TIP
When a database field contains markdown text, it's better to declare it in the schema.yml. This way, not only the admin generators knows how to deal with it, but the whole project too.

Sort on partials

With symfony only, we can't sort list results by a partial column.
With Diem it's made possible if the partial has the same name than a database field.

For example suppose we have a "Product" model, with a "price" field.
We will create the "_price.php" template to show exclusive of taxes and inclusive of taxes prices.
When clicking on the list "_price" column, list will be sorted using the "price" field.

Show and edit Medias

Show the admin generator section of the Medias documentation.

Versioning

To add versioning to your model, declare which fields are versionned on the
config/schema.yml

Post:  
  actAs:  
    DmVersionable:  

If your model is translatable, use Doctrine nested behaviors to enable versioning on i18n fields:

Post:  
  actAs:  
    I18n:  
      fields:         [ title, body ]  
      actAs:  
        DmVersionable:  

Versioning on i18n fields won't work with PostGreSQL due to a known Doctrine bug

Diem will automatically add an history button on the post admin form. In the history interface, you can:

• browse the post versions
• see the changes between two versions with visual diffs
• revert the post to an older version