11# Signals
22
3- | app| provides the following signals:
3+ {{ app}} provides the following signals:
44
55* [[ #adminaction_requested]]
66* [[ #adminaction_start]]
@@ -13,15 +13,18 @@ Sent when the action is requested (ie click 'Go' in the admin changelist view).
1313The handler can raise a :ref:` actioninterrupted ` to interrupt
1414the action's execution. The handler can rely on the following parameter:
1515
16+
1617* sender: [ django.db.models.Model] [ ]
1718* action: string. name of the action
18- * request: [ HttpRequest ] ( https:// django.readthedocs.io/en/5.1.x/ref/request-response.html#httprequest-objects )
19- * queryset: [ Queryset ] ( https:// django.readthedocs.io/en/5.1.x/ref/ models/querysets.html )
19+ * request: [ django.http.HttpRequest ] [ ]
20+ * queryset: [ django.db. models.query.QuerySet ] [ ]
2021* modeladmin: [ django.contrib.admin.ModelAdmin] [ ]
2122
23+
2224Example::
2325``` python
2426
27+ from adminactions.exceptions import ActionInterrupted
2528from adminactions.signals import adminaction_requested
2629
2730def myhandler (sender , action , request , queryset , modeladmin , ** kwargs ):
@@ -38,11 +41,11 @@ Sent after the form has been validated (ie click 'Apply' in the action Form),
3841The handler can raise a :ref:`actioninterrupted` to avoid the stop execution.
3942The handler can rely on the following parameter:
4043
41- * sender: : class : ` django:django .db.models.Model`
44+ * sender: [ django.db.models.Model][]
4245* action: string. name of the action
43- * request: : class : ` django:django.core.httpd. HttpRequest`
44- * queryset: : class : ` django:django .db.models.query.Queryset`
45- * modeladmin: : class : ` django:django .contrib.admin.ModelAdmin`
46+ * request: [ django.http. HttpRequest][]
47+ * queryset: [ django.db.models.query.QuerySet][]
48+ * modeladmin: [ django.contrib.admin.ModelAdmin][]
4649* form: :class :`django:django.forms.Form`
4750
4851Example
@@ -66,11 +69,39 @@ adminaction_start.connect(myhandler, sender=MyModel, action='export`)
6669Sent ** after** the successfully execution of the action.
6770The handler can rely on the following parameter:
6871
69- * sender: : class : ` django:django .db.models.Model`
72+ * sender: [ django.db.models.Model][]
7073* action: string. name of the action
71- * request: : class : ` django:django.core.httpd. HttpRequest`
72- * queryset: : class : ` django:django .db.models.query.Queryset`
73- * modeladmin: : class : ` django:django .contrib.admin.ModelAdmin`
74- * form: : class : ` django:django .forms.Form`
74+ * request: [ django.http. HttpRequest][]
75+ * queryset: [ django.db.models.query.QuerySet][]
76+ * modeladmin: [ django.contrib.admin.ModelAdmin][]
77+ * form: [ django.forms.Form][]
7578* errors: dict
7679* updated: int
80+
81+
82+
83+
84+ # # mass_update_process
85+
86+
87+ Sent ** before** the record is updated:
88+ The handler can rely on the following parameter:
89+
90+ * sender: [django.db.models.Model][]
91+ * request: [django.http.HttpRequest][]
92+ * queryset: [django.db.models.query.QuerySet][]
93+
94+ Es:
95+ ```python
96+ from django.contrib.auth.models import User
97+ from django.dispatch import receiver
98+ from adminactions.signals import mass_update_process
99+ from adminactions.exceptions import MassUpdateSkipRecordError
100+
101+
102+ @ receiver(mass_update_process, sender = User)
103+ def my_handler(sender, record: User, ** kwargs):
104+ if record.is_superuser:
105+ raise MassUpdateSkipRecordError
106+
107+ ```
0 commit comments