#1835 : add documentation + add admin as parameter for edit and show

Resources/doc/reference/events.rst

@@ -30,3 +30,17 @@ ConfigureQueryEvent
 ~~~~~~~~~~~~~~~~~~~
 
 This event is generated when a list query is defined. The event name is: ``sonata.admin.event.configure.query``
+
+BlockEvent
+~~~~~~~~~~~~~~~~~~~
+
+Block events help you customize your templates. Available events are :
+
+ - sonata.admin.dashboard.top
+ - sonata.admin.dashboard.bottom
+ - sonata.admin.list.table.top
+ - sonata.admin.list.table.bottom
+ - sonata.admin.edit.form.top
+ - sonata.admin.edit.form.bottom
+ - sonata.admin.show.top
+ - sonata.admin.show.bottom

Resources/views/CRUD/base_edit_form.html.twig

@@ -1,5 +1,5 @@
 {% block form %}
-    {{ sonata_block_render_event('sonata.admin.edit.form.top', { 'object': object }) }}
+    {{ sonata_block_render_event('sonata.admin.edit.form.top', { 'admin': admin, 'object': object }) }}
 
     {% set url = admin.id(object) is not null ? 'edit' : 'create' %}
 
@@ -106,6 +106,6 @@
         </form>
     {% endif%}
 
-    {{ sonata_block_render_event('sonata.admin.edit.form.bottom', { 'object': object }) }}
+    {{ sonata_block_render_event('sonata.admin.edit.form.bottom', { 'admin': admin, 'object': object }) }}
 
 {% endblock %}

Resources/views/CRUD/base_show.html.twig

@@ -25,7 +25,7 @@ file that was distributed with this source code.
 {% block show %}
     <div class="sonata-ba-view">
 
-        {{ sonata_block_render_event('sonata.admin.show.top', { 'object': object }) }}
+        {{ sonata_block_render_event('sonata.admin.show.top', { 'admin': admin, 'object': object }) }}
 
         {% for name, view_group in admin.showgroups %}
             <table class="table table-bordered">
@@ -47,7 +47,7 @@ file that was distributed with this source code.
             </table>
         {% endfor %}
 
-        {{ sonata_block_render_event('sonata.admin.show.bottom', { 'object': object }) }}
+        {{ sonata_block_render_event('sonata.admin.show.bottom', { 'admin': admin, 'object': object }) }}
 
     </div>
 {% endblock %}

Resources/views/Core/dashboard.html.twig

@@ -15,7 +15,7 @@ file that was distributed with this source code.
 {% block breadcrumb %}{% endblock %}
 {% block content %}
 
-    {{ sonata_block_render_event('sonata.admin.dashboard.top', { 'admin': admin_pool }) }}
+    {{ sonata_block_render_event('sonata.admin.dashboard.top', { 'admin_pool': admin_pool }) }}
 
     <div class="row-fluid">
         {% set has_center = false %}
@@ -52,6 +52,6 @@ file that was distributed with this source code.
         </div>
     </div>
 
-    {{ sonata_block_render_event('sonata.admin.dashboard.bottom', { 'admin': admin_pool }) }}
+    {{ sonata_block_render_event('sonata.admin.dashboard.bottom', { 'admin_pool': admin_pool }) }}
 
 {% endblock %}