Merge pull request #19 from maestrofjp/master

Documented example of a custom get_object_actions() method

Author: crccheck

Diff for: README.rst

@@ -113,6 +113,37 @@ by adding a Django widget style `attrs` attribute::
         'class': 'addlink',
     }
 
+Programmatically Enabling Object Admin Actions
+``````````````````````````````````````````````
+
+You can programatically enable and disable registered object actions by defining
+your own custom ``get_object_actions()`` method. In this example, certain actions 
+only apply to certain object states (i.e. You should not be able to close an company
+account if the account is already closed)::
+
+   def get_object_actions(self, request, context, **kwargs):
+        objectactions = []
+
+        # Actions cannot be applied to new objects (i.e. Using "add" new obj)
+        if 'original' in context:
+            # The obj to perform checks against to determine object actions you want to support
+            obj = context['original']
+
+            if not obj.verified:
+                objectactions.extend(['verify_company_account_action', ])
+
+            status_code = obj.status_code
+
+            if status_code == 'Active':
+                objectactions.extend(['suspend_company_account_action', 'close_company_account_action', ])
+            elif status_code == 'Suspended':
+                objectactions.extend(['close_company_account_action', 'reactivate_company_account_action', ])
+            elif status_code == 'Closed':
+                objectactions.extend(['reactivate_company_account_action', ])
+
+        return objectactions
+   
+
 
 Alternate Installation
 ``````````````````````