Merge branch 'emve-dev-docs-actions' into docs

doc/advanced.rst

@@ -492,3 +492,37 @@ do with it, so it won't generate a form field. In this case, you would need to m
             form_class.extra = TextField('Extra')
             return form_class
 
+Customizing Batch Actions
+-------------------------
+
+****
+
+If you want to add other batch actions to the list view, besides the default delete action,
+then you can define a function that implements the desired logic and wrap it with the `@action` decorator.
+
+The `action` decorator takes three parameters: `name`, `text` and `confirmation`.
+While the wrapped function should accept only one parameter - `ids`::
+
+    from flask_admin.actions import action
+
+    class UserView(ModelView):
+        @action('approve', 'Approve', 'Are you sure you want to approve selected users?')
+        def action_approve(self, ids):
+            try:
+                query = User.query.filter(User.id.in_(ids))
+
+                count = 0
+                for user in query.all():
+                    if user.approve():
+                        count += 1
+
+                flash(ngettext('User was successfully approved.',
+                               '%(count)s users were successfully approved.',
+                               count,
+                               count=count))
+            except Exception as ex:
+                if not self.handle_view_exception(ex):
+                    raise
+
+                flash(gettext('Failed to approve users. %(error)s', error=str(ex)), 'error')
+