gníomhartha riaracháinLink to this heading#

Feidhmeanna gníomhaíochtaLink to this heading#

Ar dtús, beidh orainn feidhm a scríobh a ghlaofar nuair a spreagtar an gníomh ón riarachán. Is feidhmeanna rialta iad feidhmeanna gníomhaíochta a thógann trí argóint:

• An reatha: aicme: ModelAdmin

• An:class: ~django.http.httpRequest a léiríonn an t-iarratas reatha,

• A: Class: ~django.db.models.query.querySet ina bhfuil an tacar rudaí a roghnaigh an t-úsáideoir.

Ní bheidh an: class: ModelAdmin nó an réad iarratais ag teastáil ó ár bhfeidhm foilsithe seo, ach úsáidfimid an tacar ceisteanna:

def make_published(modeladmin, request, queryset):
    queryset.update(status="p")

Sin i ndáiríre gach rud atá ann chun gníomh a scríobh! Mar sin féin, glacfaimid céim roghnach ach úsáideach amháin eile agus tabharfaimid teideal “deas” don ghníomh sa riarachán. De réir réamhshocraithe, bheadh an gníomh seo le feiceáil ar an liosta gníomhaíochta mar “Déan foilsithe” - ainm na feidhme, le spásanna ina ionad béim. Tá sé sin go breá, ach is féidir linn ainm níos fearr, níos cairdiúla don duine a sholáthar tríd an maisitheoir: func: ~django.contrib.admin.action a úsáid ar an bhfeidhm ``make_published ``:

from django.contrib import admin

...


@admin.action(description="Mark selected stories as published")
def make_published(modeladmin, request, queryset):
    queryset.update(status="p")

Gníomhartha a chur leis an:class: ModelAdminLink to this heading#

Ansin, beidh orainn ár n:class: ModelAdmin a chur ar an eolas faoin ngníomh. Oibríonn sé seo díreach cosúil le haon rogha cumraíochta eile. Mar sin, bheadh cuma ar an admin.py` iomlán leis an ngníomh agus a chlárú:

from django.contrib import admin
from myapp.models import Article


@admin.action(description="Mark selected stories as published")
def make_published(modeladmin, request, queryset):
    queryset.update(status="p")


class ArticleAdmin(admin.ModelAdmin):
    list_display = ["title", "status"]
    ordering = ["title"]
    actions = [make_published]


admin.site.register(Article, ArticleAdmin)

Tabharfaidh an cód sin liosta athraithe riaracháin dúinn a bhfuil cuma mar seo air:

Sin go léir atá ann i ndáiríre! Má tá tú ag iarraidh do ghníomhartha féin a scríobh, tá a fhios agat anois go leor chun tosú. Clúdaíonn an chuid eile den doiciméad seo teicnící níos airde.

Earráidí láimhseála i ngnLink to this heading#

Má tá coinníollacha earráide intuartha ann a d'fhéadfadh tarlú agus do ghníomh á reáchtáil, ba cheart duit an t-úsáideoir a chur ar an eolas go grásta faoin bhfadhb. Ciallaíonn sé seo eisceachtaí a láimhseáil agus úsáid: meth: django.contrib.admin.modeladmin.message_user chun cur síos atá cairdiúil don úsáideoir ar an bhfadhb sa fhreagra a thaispeáint.

Gníomhartha cosúil:class: ModelAdmin modhannaLink to this heading#

Taispeánann an sampla thuas an gníomh make_published a shainmhínítear mar fheidhm. Tá sé sin go breá, ach níl sé foirfe ó thaobh dearaidh cód: ós rud é go bhfuil an gníomh ceangailte go docht leis an réad Airteagal, tá sé ciallmhar an gníomh a cheangal leis an réad ``ArticleAdMin` féin.

Is féidir leat é a dhéanamh mar seo:

class ArticleAdmin(admin.ModelAdmin):
    ...

    actions = ["make_published"]

    @admin.action(description="Mark selected stories as published")
    def make_published(self, request, queryset):
        queryset.update(status="p")

Tabhair faoi deara ar dtús gur bhogamar make_published isteach i modh agus athainmníomar an paraiméadar modeladmin ``go `self, agus sa dara háit gur chuireamar an teaghrán `make_published'` anois i ``actions in ionad tagairt feidhme díreach. Insíonn sé seo la:class: ModelAdmin breathnú suas ar an ngníomh mar mhodh.

Tugann gníomhartha a shainmhíniú mar mhodhanna rochtain níos idiomatiúla don ghníomhaíocht ar an: class: ModelAdmin féin, rud a ligeann don ghníomh aon cheann de na modhanna a sholáthraíonn an riarachán a ghlaoch.

Mar shampla, is féidir linn féin a úsáid chun teachtaireacht a splancadh chuig an úsáideoir in iúl dóibh gur éirigh leis an ngníomh:

from django.contrib import messages
from django.utils.translation import ngettext


class ArticleAdmin(admin.ModelAdmin):
    ...

    def make_published(self, request, queryset):
        updated = queryset.update(status="p")
        self.message_user(
            request,
            ngettext(
                "%d story was successfully marked as published.",
                "%d stories were successfully marked as published.",
                updated,
            )
            % updated,
            messages.SUCCESS,
        )

Déanann sé seo an gníomh a mheaitseáil leis an méid a dhéanann an riarachán féin tar éis gníomh a dhéanamh go rathúil:

Gníomhartha a sholáthraíonn leathanaighLink to this heading#

De réir réamhshocraithe, tar éis gníomh a dhéanamh atreoraítear an t-úsáideoir ar ais chuig an leathanach liosta athraithe bunaidh. Mar sin féin, beidh ar roinnt gníomhartha, go háirithe cinn níos casta, leathanaigh idirmheánacha a thabhairt ar ais. Mar shampla, iarrann an gníomh scriosta ionsuite deimhniú sula ndéanann siad na rudaí roghnaithe a scriosadh.

Chun leathanach idirghabhála a sholáthar, cuir ar ais an:class: ~django.http.httpResponse (nó fo-aicme) ó do ghníomhaíocht. Mar shampla, d'fhéadfá feidhm onnmhairiúcháin a scríobh a úsáideann django's:doc: feidhmeanna sraitheach chun roinnt rudaí roghnaithe a dhumpáil mar </topics/serialization> JSON:

from django.core import serializers
from django.http import HttpResponse


def export_as_json(modeladmin, request, queryset):
    response = HttpResponse(content_type="application/json")
    serializers.serialize("json", queryset, stream=response)
    return response

Go ginearálta, ní mheastar gur smaoineamh iontach é rud éigin mar an méid thuas. An chuid is mó den am, is é an cleachtas is fearr ná filleadh an:class: ~django.http.http.HttpResponsereDirect agus an t-úsáideoir a atreorú chuig radharc a scríobh tú, ag dul ar liosta na rudaí roghnaithe sa teaghrán ceisteanna GET. Ligeann sé seo duit loighic idirghníomhú casta a sholáthar ar na leathanaigh idir Mar shampla, más mian leat feidhm easpórtála níos iomláine a sholáthar, ba mhaith leat ligean don úsáideoir formáid a roghnú, agus b'fhéidir liosta réimsí le cur san onnmhairiú. Is é an rud is fearr le déanamh ná gníomh beag a scríobh a atreoraíonn chuig do radharc saincheaptha onnmhairithe:

from django.contrib.contenttypes.models import ContentType
from django.http import HttpResponseRedirect


def export_selected_objects(modeladmin, request, queryset):
    selected = queryset.values_list("pk", flat=True)
    ct = ContentType.objects.get_for_model(queryset.model)
    return HttpResponseRedirect(
        "/export/?ct=%s&ids=%s"
        % (
            ct.pk,
            ",".join(str(pk) for pk in selected),
        )
    )

Mar a fheiceann tú, tá an gníomh sách gearr; bheadh an loighic chasta go léir i do dhearcadh onnmhairithe. Bheadh sé seo déileáil le rudaí de chineál ar bith, dá bhrí sin an gnó leis an “ContentType”.

Fágtar an dearcadh seo a scríobh mar chleachtadh don léitheoir.

Gníomhartha a chur ar fáil ar fud an suíomhLink to this heading#

AdminSite.add_action(action, name=None)Link to this definition#

Is fearr roinnt gníomhartha má chuirtear iad ar fáil dó* aon réad ar shuíomh riaracháin - is iarrthóir maith a bheadh an gníomh onnmhairithe a shainmhínítear thuas. Is féidir leat gníomh a chur ar fáil ar fud an domhain ag baint úsáid:meth: `adminsite.add_action () `. Mar shampla:

Code

from django.contrib import admin

admin.site.add_action(export_selected_objects)

Fágann sé seo an gníomh export_selected_objects ar fáil ar fud an domhain mar ghníomh darb ainm “export_selected_objects”. Is féidir leat ainm a thabhairt go sainráite don ghníomh -- go maith más mian leat go cláraitheach níos déanaí:ref: bain an gníomh <disabling-admin-actions>-- tríd an dara argóint a rith chuig:meth: adminsite.add_action ():

Code

admin.site.add_action(export_selected_objects, "export_selected")

Gníomhartha díchumasaitheLink to this heading#

Uaireanta ní mór duit gníomhartha áirithe a dhíchumasú - go háirithe iad siú:ref: cláraithe ar fud an láithreáin <adminsite-actions>- le haghaidh rudaí áirithe. Tá cúpla bealach ann is féidir leat gníomhartha a dhíchumasú:

class MyModelAdmin(admin.ModelAdmin):
    actions = None

Ceadanna a shocrú le haghaidh gníomharLink to this heading#

Féadfaidh gníomhartha a n-infhaighteacht a theorannú d'úsáideoirí a bhfuil ceadanna sonracha acu tríd an bhfeidhm ghníomhaíochta a fhilleadh leis an maisitheoir: func: ~django.contrib.admin.action agus an argóint ceadúna a rith:

@admin.action(permissions=["change"])
def make_published(modeladmin, request, queryset):
    queryset.update(status="p")

Ní bheidh an gníomh ``make_published () ``ar fáil ach d'úsáideoirí a rachaidh an seice:meth: .modeladmin.has_change_permission.

Má tá níos mó ná cead amháin ag ceadúnaí, beidh an gníomh ar fáil chomh fada agus a rachaidh an t-úsáideoir ceann amháin de na seiceálacha ar a laghad.

Is iad na luachanna atá ar fáil le haghaidh `ceadui' agus na seiceálacha modh comhfhreagracha:

• 'add': :meth: .ModelAdmin.has_Add_Permission

• 'athraithe: :meth: .modelAdmin.has_Change_Ceadúnaí

• 'delete': :meth: .modeladmin.has_delete_ceadúnaí

• 'view': :meth: .modeladmin.has_view_permission

Is féidir leat aon luach eile a shonrú chomh fada agus a chuireann tú modh comhfhreagrach hais_ <value>_cead (féin, iarraidh) ``i bhfeidhm ar an `ModelAdmin.

Mar shampla:

from django.contrib import admin
from django.contrib.auth import get_permission_codename


class ArticleAdmin(admin.ModelAdmin):
    actions = ["make_published"]

    @admin.action(permissions=["publish"])
    def make_published(self, request, queryset):
        queryset.update(status="p")

    def has_publish_permission(self, request):
        """Does the user have the publish permission?"""
        opts = self.opts
        codename = get_permission_codename("publish", opts)
        return request.user.has_perm("%s.%s" % (opts.app_label, codename))