Offers a sortable feature for your Symfony admin listing
By default, this extension works with Gedmo DoctrineExtensions, but you can change the position handler or implement your own (There are three implementations: Gedmo, ORM, and ODM):
# app/config/config.yml
sortable_behavior:
position_handler: sortable_behavior.position.orm
position_field:
default: sort # default value: position
entities:
AppBundle\Entity\Foobar: order
AppBundle\Entity\Baz: rang
sortable_groups:
entities:
AppBundle\Entity\Baz: [ group ]
In order to use this bundle on sonata, you need to configure an action with a custom template.
<?php
// ClientAdmin.php
protected function configureListFields(ListMapper $listMapper)
{
$listMapper
->addIdentifier('name')
->add('enabled')
->add('_action', null, array(
'actions' => array(
'move' => array(
'template' => '@SortableBehavior/sort.html.twig',
'enable_top_bottom_buttons' => true, //optional
),
),
))
;
}
In order to use a draggable list instead of up/down buttons, change the template in the move
action to @SortableBehavior/sort_drag_drop.html.twig
.
<?php
// ClientAdmin.php
protected function configureListFields(ListMapper $listMapper)
{
$listMapper
->addIdentifier('name')
->add('enabled')
->add('_action', null, array(
'actions' => array(
'move' => array(
'template' => '@SortableBehavior/sort_drag_drop.html.twig',
'enable_top_bottom_buttons' => true, // optional
),
),
))
;
}
Also include the JavaScript needed for this to work, in your theme.yml
file, add these two lines:
//...
javascripts:
- bundles/sortablebehavior/js/jquery-ui.min.js // if you haven't got jQuery UI yet.
- bundles/sortablebehavior/js/init.js
Adding the JavaScript and the template, will give you the possibility to drag items in a tablelist.
In case you need it, this plugin fires to jQuery events when dragging is done on the $(document)
element, so if you want to add custom notification, that is possible. Also, when dragging the <body>
gets an is-dragging
class. This class is removed when you stop dragging. This could by quite handy if you have some custom js/css.
SortableBehaviorBundle.success
SortableBehaviorBundle.error