{"title":"Suíomh riaracháin Django","version":"5.2","locale":"ga","docname":"ref/contrib/admin/index","url":"/ga/5.2/ref/contrib/admin/","canonical":"https://djangodocs.dev/ga/5.2/ref/contrib/admin/","summary":"Ceann de na codanna is cumhachtaí de Django ná an comhéadan riaracháin uathoibríoch. Léann sé meiteashonraí ó do mhúnlaí chun comhéadan tapa, samhail-lárnach a…","html":"

Suíomh riaracháin DjangoLink to this heading#

\n

Ceann de na codanna is cumhachtaí de Django ná an comhéadan riaracháin uathoibríoch. Léann sé meiteashonraí ó do mhúnlaí chun comhéadan tapa, samhail-lárnach a sholáthar inar féidir le húsáideoirí iontaofa ábhar ar do shuíomh a bhainistiú. Tá úsáid mholta an riaracháin teoranta d'uirlis bhainistíochta inmheánach eagraíochta. Níl sé beartaithe chun do cheann tosaigh iomlán a thógáil timpeall.

\n

Tá go leor crúcaí ag an riarachán le saincheaptha, ach bí cúramach ort iarracht a dhéanamh na crúcaí sin a úsáid go heisiach Más gá duit comhéadan níos dírithe ar phróiseas a sholáthar a chuireann achoimir sonraí cur chun feidhme táblaí agus réimsí bunachar sonraí, is dócha go bhfuil sé in am do thuairimí féin a scríobh.

\n

Sa doiciméad seo pléimid conas comhéadan riaracháin Django a ghníomhachtú, a úsáid agus a shaincheapadh.

\n
\n

ForbhreathnúLink to this heading#

\n

Tá an riarachán cumasaithe sa teimpléad tionscadail réamhshocraithe a úsáideann: djadmin: startproject.

\n

Mura bhfuil an teimpléad tionscadail réamhshocraithe á úsáid agat, seo na riachtanais:

\n
    \n

  1. Cuir django.contrib.admin' agus a spleáchais -:mod: django.contrib.auth, :mod: django.contrib.contenttypes, :mod: django.contrib.messages, agus:mod: django.contrib.sessions - le duit:setting: `INSTALLED_APP_ `socrú.

    2. \n

  2. <TEMPLATES-OPTIONS>Cumraigh a:class: ~django.template.backends.django.djangoTemplates cúltaca i d:setting: TEMPLATES socrú le django.template.context_processors.request, django.contrib.auth.context_processors.auth`, agus django.contrimessb.ages.context_processors.messages sa rogha ``'context_processors' ``de:setting: `OPTIONS `.

    3. \n

  3. Má tá an socrú:setting: MIDDLEWARE saincheaptha agat, :class: django.contrib.sessions.middleware.sessionMiddleware, :class: django.contrib.auth.middleware.AuthenticationMiddleware, agus:class: django.contrib.messages.middleware.messageMiddleware.

    4. \n

  4. <hooking-adminsite-to-urlconf>:ref: `Ceangail URLanna an riaracháin isteach i do URLConf `.

    5. \n
\n

Tar éis duit na céimeanna seo a ghlacadh, beidh tú in ann an suíomh riaracháin a úsáid trí chuairt a thabhairt ar an URL a chuir tú isteach air (/admin/, de réir réamhshocraithe).

\n

Más gá duit úsáideoir a chruthú le logáil isteach leis, bain úsáid as an ordú:djadmin: createsuperuser. De réir réamhshocraithe, éilíonn logáil isteach sa riarachán go bhfuil an tréith: attr: ~.user.is_staff socraithe go True ag an úsáideoir.

\n

Faoi dheireadh, socraigh cé acu de na samhlacha d'iarratais ba chóir a bheith in-eagarthóireachta sa chomhéadan riaracháin. Maidir le gach ceann de na samhlacha sin, cláraigh iad leis an riarachán mar a thuairiscítear in:class: ModelAdmin.

\n
\n

Ábhair eileLink to this heading#

\n
\n\n
\n\n
\n
\n
\n

``Modeladmin ``rudaíLink to this heading#

\n
\n
\nclass ModelAdminLink to this definition#
\n

Is é an rang ModelAdmin léiriú samhail sa chomhéadan riaracháin. De ghnáth, stóráiltear iad seo i gcomhad darb ainm admin.py i d'iarratas. Breathnaímid ar shampla den ModelAdmin:

\n
Code
from django.contrib import admin\nfrom myapp.models import Author\n\n\nclass AuthorAdmin(admin.ModelAdmin):\n    pass\n\n\nadmin.site.register(Author, AuthorAdmin)\n
\n\n
\n\n
\n

An maisitheoir clárLink to this heading#

\n
\n
\nregister(*models, site=django.contrib.admin.sites.site)Link to this definition#
\n

Tá maisitheoir ann freisin chun do ranganna ``ModelAdmin` a chlárú:

\n
Code
from django.contrib import admin\nfrom .models import Author\n\n\n@admin.register(Author)\nclass AuthorAdmin(admin.ModelAdmin):\n    pass\n
\n

Tugtar rang samhail amháin nó níos mó dó chun clárú leis an ModelAdmin. Má tá saincheap:class: AdminSite á úsáid agat, pas é ag baint úsáide as an argóint eochairfhocal ``láithreach`:

\n
Code
from django.contrib import admin\nfrom .models import Author, Editor, Reader\nfrom myproject.admin_site import custom_admin_site\n\n\n@admin.register(Author, Reader, Editor, site=custom_admin_site)\nclass PersonAdmin(admin.ModelAdmin):\n    pass\n
\n

Ní féidir leat an maisitheoir seo a úsáid má chaithfidh tú tagairt a dhéanamh do rang riaracháin samhail ina mhodh ``__init__ () , m.sh. `super (PersonAdmin, self). __init__ (*args, **kwargs) `. Is féidir leat ``super () a úsáid. __init__ (*args, **kwargs) ``.

\n
\n\n
\n
\n

Faighneadh comhaid riaracháinLink to this heading#

\n

Nuair a chuireann tú django.contrib.admin i do shuíomh: INSTALLED_APPS, lorgaíonn Django modúl ``admin ``go huathoibríoch i ngach feidhmchlár agus déanann Django é a allmhairiú.

\n
\n
\nclass apps.AdminConfigLink to this definition#
\n

Seo an rang réamhshocraithe: class: ~django.apps.appconfig don admin. Glaonn sé: func: `~django.contrib.admin.autoDiscovery () `nuair a thosaíonn Django.

\n
\n\n
\n
\nclass apps.SimpleAdminConfigLink to this definition#
\n

Oibríonn an rang seo cosúil:class: ~django.contrib.admin.apps.adminConfig, ach amháin nach nglaonn sé: func: `~django.contrib.admin.autoDiscovery () `.

\n
\n
\ndefault_siteLink to this definition#
\n

Conair allmhairithe poncanach chuig rang an láithreáin riaracháin réamhshocraithe nó chuig glaoch a thugann sampla láithreáin ar ais. Réamhshocraithe go ``django.contrib.admin.sites.adminsite'. Féach: ref: `overriding-default-admin-site le húsáid.

\n
\n\n
\n\n
\n
\nautodiscover()Link to this definition#
\n

Déanann an fheidhm seo iarracht modúl ``admin ``a allmhairiú i ngach feidhmchlár suiteáilte. Táthar ag súil go gclárfaidh modúil den sórt sin samhlacha leis an riarach

\n

De ghnáth ní bheidh ort an fheidhm seo a ghlaoch go díreach mar: class: ~django.contrib.admin.apps.adminConfig glaonn sé nuair a thosaíonn Django.

\n
\n\n

Má tá tú ag úsáid saincheaptha AdminSite, is coitianta na fo-aicmí ModelAdmin go léir a iompórtáil isteach i do chód agus iad a chlárú chuig an saincheaptha AdminSite. Sa chás sin, d'fhonn uathoibríoch a dhíchumasú, ba chóir duit ``django.contrib.admin.apps.simpleAdminConfig'` a chur in ionad ``django.contrib.admin' i do shuíomh: INSTALLED_APPS.

\n
\n
\n

Roghanna ModelAdminLink to this heading#

\n

Tá an ModelAdmin an-solúbtha. Tá roinnt roghanna aige chun déileáil leis an gcomhéadan a shaincheapadh. Sainmhínítear gach rogha ar an bhfo-aicme ModelAdmin:

\n
Code
from django.contrib import admin\n\n\nclass AuthorAdmin(admin.ModelAdmin):\n    date_hierarchy = "pub_date"\n
\n
\n
\nModelAdmin.actionsLink to this definition#
\n

Liosta de na gníomhartha atá le cur ar fáil ar an leathanach liosta athraithe. Féach: doc: /ref/contrib/admin/actions le haghaidh sonraí.

\n
\n\n
\n
\nModelAdmin.actions_on_topLink to this definition#
\n
\n\n
\n
\nModelAdmin.actions_on_bottomLink to this definition#
\n

Rialuithe áit a bhfuil an barra gníomhartha le feiceáil ar an leathanach. De réir réamhshocraithe, taispeánann an liosta athraithe riaracháin gníomhartha ag barr an leathanaigh (actions_on_top = True; actions_on_bottom = False`).

\n
\n\n
\n
\nModelAdmin.actions_selection_counterLink to this definition#
\n

Rialaíonn sé an bhfuil cuntar roghnúcháin ar taispeáint in aice leis an anuas gníomhaíochta. De réir réamhshocraithe, taispeánfaidh an liosta athraithe riaracháin é (actions_selection_counter = True).

\n
\n\n
\n
\nModelAdmin.date_hierarchyLink to this definition#
\n

Socraigh date_hierarchy ar ainm DateField nó DateTimeField i do mhúnla, agus beidh nascleanúint drilldown bunaithe ar dáta-bhunaithe ag an réimse sin san leathanach liosta athraithe.

\n

Sampla:

\n
Code
date_hierarchy = "pub_date"\n
\n

Is féidir leat réimse a shonrú freisin ar mhúnla gaolmhar ag baint úsáide as an lorg __, mar shampla:

\n
Code
date_hierarchy = "author__pub_date"\n
\n

Déanfaidh sé seo é féin a dhaonrú go cliste bunaithe ar na sonraí atá ar fáil, m.sh. má tá na dátaí go léir i mí amháin, taispeánfaidh sé an druileáil síos ar leibhéal lae amháin.

\n\n
\n\n
\n
\nModelAdmin.empty_value_displayLink to this definition#
\n

Sáraíonn an tréith seo an luach taispeána réamhshocraithe do réimsí an taifead atá folamh (None ``, teaghrán folamh, srl.). Is é an luach réamhshocraithe ``- (sraigh). Mar shampla:

\n
Code
from django.contrib import admin\n\n\nclass AuthorAdmin(admin.ModelAdmin):\n    empty_value_display = "-empty-"\n
\n

Is féidir leat empty_value_display a shárú freisin do gach leathanach riaracháin le:attr: adminsite.empty_value_display, nó le haghaidh réimsí ar leith mar seo:

\n
Code
from django.contrib import admin\n\n\nclass AuthorAdmin(admin.ModelAdmin):\n    list_display = ["name", "title", "view_birth_date"]\n\n    @admin.display(empty_value="???")\n    def view_birth_date(self, obj):\n        return obj.birth_date\n
\n
\n\n
\n
\nModelAdmin.excludeLink to this definition#
\n

Ba chóir go mbeadh an tréith seo, má thugtar, ina liosta d'ainmneacha réimse le eisiamh ón bhfoirm.

\n

Mar shampla, déanaimis machnamh ar an tsamhail seo a leanas:

\n
Code
from django.db import models\n\n\nclass Author(models.Model):\n    name = models.CharField(max_length=100)\n    title = models.CharField(max_length=3)\n    birth_date = models.DateField(blank=True, null=True)\n
\n

Más mian leat foirm don tsamhail Údar nach n-áirítear ach na réimsí ainm agus teideal ``, sonrófaí ``réimsí réimsí nó ``eisiam mar seo:

\n
Code
from django.contrib import admin\n\n\nclass AuthorAdmin(admin.ModelAdmin):\n    fields = ["name", "title"]\n\n\nclass AuthorAdmin(admin.ModelAdmin):\n    exclude = ["birth_date"]\n
\n

Ós rud é nach bhfuil ach trí réimse ag an tsamhail Údair, ainm ``, `teideal, agus dáta_bhreith`, beidh na réimsí céanna go díreach sna foirmeacha a eascraíonn as na dearbhuithe thuas.

\n
\n\n
\n
\nModelAdmin.fieldsLink to this definition#
\n

Úsáid an rogha ``réimsí ``chun athruithe leagan amach simplí a dhéanamh sna foirmeacha ar na leathanaigh “cuir” agus “athraigh” amhail fo-thacar de réimsí atá ar fáil a thaispeáint, a n-ord a mhodhnú, nó iad a ghrúpáil i sraitheanna. Mar shampla, d'fhéadfá leagan níos simplí den fhoirm riaracháin a shainiú don tsamhail:class: django.contrib.flatpages.models.flatpage mar seo a leanas:

\n
Code
class FlatPageAdmin(admin.ModelAdmin):\n    fields = ["url", "title", "content"]\n
\n

Sa sampla thuas, ní thaispeánfar ach na réimsí url ``, `teideal agus ábh`, sa fhoirm, go seicheamhach. Is féidir luachanna a shainmhínítear in:attr: `ModelAdmin.ReadOnly_Fields` a bheith i `fields le taispeáint mar léite amháin.

\n

Le haghaidh riachtanais leagan amach níos casta, féach an rogha: attr: ~ModelAdmin.FieldSets.

\n

Glacann an rogha fields leis na cineálacha céanna luachanna amha:attr: ~ModelAdmin.list_display, ach amháin nach nglactar le glaonna agus __ cuardaigh do réimsí gaolmhara. Ní úsáidfear ainmneacha modhanna riaracháin samhail agus samhail ach amháin má tá siad liostaithe in:attr: ~ModelAdmin.ReadOnly_Fields.

\n

Chun réimsí iolracha a thaispeáint ar an líne chéanna, fillte na réimsí sin ina dtuple féin. Sa sampla seo, taispeánfar na réimsí url agus teideal ``ar an líne chéanna agus taispeánfar an réimse ``content faoina bhun ar a líne féin:

\n
Code
class FlatPageAdmin(admin.ModelAdmin):\n    fields = [("url", "title"), "content"]\n
\n\n

If neither fields nor fieldsets options are present,\nDjango will default to displaying each field that isn't an AutoField and\nhas editable=True, in a single fieldset, in the same order as the fields\nare defined in the model, followed by any fields defined in\nreadonly_fields.

\n
\n\n
\n
\nModelAdmin.fieldsetsLink to this definition#
\n

Socraigh fieldsets chun leagan amach na leathanaigh riaracháin “cuir” agus “athraigh” a rialú.

\n

<fieldset>Is liosta de 2-tuples é fieldsets, ina léiríonn gach 2-tuple ```` ar an leathanach foirm riaracháin. (Is “cuid<fieldset>” den fhoirm é a ```.)

\n

Tá na 2-tuples i bhformáid (ainm, roghanna réimse), ina bhfuil ainm ``teaghrán a léiríonn teideal an tacar réimse agus is foclóir faisnéise faoin tacar réimse é `field_options, lena n-áirítear liosta réimsí atá le taispeáint ann.

\n

Sampla iomlán, tógtha ón múnla:class: django.contrib.flatpages.models.flatpage:

\n
Code
from django.contrib import admin\n\n\nclass FlatPageAdmin(admin.ModelAdmin):\n    fieldsets = [\n        (\n            None,\n            {\n                "fields": ["url", "title", "content", "sites"],\n            },\n        ),\n        (\n            "Advanced options",\n            {\n                "classes": ["collapse"],\n                "fields": ["registration_required", "template_name"],\n            },\n        ),\n    ]\n
\n

Mar thoradh air seo tá leathanach riaracháin a bhfuil cuma air:

\n\"/ga/5.2/_images/fieldsets.png\"\n

Mura bhfuil roghanna fieldsets nor:attr: ~ModelAdmin.fields i láthair, réamhshocróidh Django gach réimse nach autofield a thaispeáint agus a bhfuil Editable=True, i tacar réimse amháin, san ord céanna agus atá na réimsí sainmhínithe sa tsamhail.

\n

Is féidir leis na heochracha seo a leanas a bheith ag an bhfoclóir field_options`:

\n
    \n
  • \n
    ``réimsí ``

    Liosta nó tiúpla d'ainmneacha réimse le taispeáint sa tacar réimse seo. Tá an eochair seo ag teastáil.

    \n

    Sampla:

    \n
    Code
    {\n    "fields": ["first_name", "last_name", "address", "city", "state"],\n}\n
    \n

    Mar is amhlaidh leis an rogha: attr: ~ModelAdmin.Fields, chun réimsí iolracha a thaispeáint ar an líne chéanna, timpail na réimsí sin ina dtuple féin. Sa sampla seo, taispeánfar na réimsí first_name agus last_name ar an líne chéanna:

    \n
    Code
    {\n    "fields": [("first_name", "last_name"), "address", "city", "state"],\n}\n
    \n

    Is féidir luachanna a shainmhínítear in:attr: ~ModelAdmin.ReadOnly_Fields a bheith i fields` le taispeáint mar léite amháin.

    \n

    Má chuireann tú ainm inghlaonta le fields`, tá feidhm ag an riail chéanna leis an roghna:attr: ~ModelAdmin.Fields: ní mór an glaoch a liostáil in:attr: ~ModelAdmin.Readonly_Fields.

    \n
    \n
    \n
    • \n
  • \n
    ranga

    Liosta nó tuple ina bhfuil ranganna breise CSS le cur i bhfeidhm ar an tacar réimse. Féadfaidh sé seo aon rang CSS saincheaptha a shainmhínítear sa tionscadal a áireamh, chomh maith le haon cheann de na ranganna CSS a sholáthraíonn Django. Laistigh de bhileog stíl CSS an láithreáin riaracháin réamhshocraithe, sainmhínítear dhá rang an-úsáideach: tiomp agus wieh.

    \n

    Sampla:

    \n
    Code
    {\n    "classes": ["wide", "collapse"],\n}\n
    \n

    Tabharfar spás cothrománach breise sa chomhéadan riaracháin do thacair réimse leis an stíl ``leathan ``. Titeofar tacair réimsí le hainm agus an stíl ``clise' i dtosach, ag baint úsáide as giuirléid leathnaithe le toggle chun a n-infheictheacht a athrú.

    \n\n
    \n
    \n
    • \n
  • \n
    `Tuairisc

    Sraith téacs breise roghnach le taispeáint ag barr gach tacar réimse, faoi cheannteideal an tacar réimse.

    \n

    Tabhair faoi deara go bhfuil an luach seo* éalaithe ag HTML nuair a thaispeántar é sa chomhéadan riaracháin. Ligeann sé seo duit HTML a áireamh más mian leat. Nó is féidir leat gnáthtéacs agus:func: django.utils.html.escape a úsáid chun éalú aon charachtair speisialta HTML.

    \n
    \n
    \n
    • \n
\n\n
\n\n
\n
\nModelAdmin.filter_horizontalLink to this definition#
\n

<select multiple>De réir réamhshocraithe, taispeántar a:class: ~django.db.models.manyTomanyField ar an suíomh riaracháin le ````. Mar sin féin, is féidir go mbeadh sé deacair boscaí ilroghnaithe a úsáid agus go leor míreanna á roghnú. Ag cur a:class: ~django.db.models.manyToManyField leis an liosta seo úsáidfear comhéadan “scagaire” JavaScript neamh-neamhbhraith ina ionad sin a cheadaíonn cuardach laistigh de na roghanna. Tá na roghanna neamhroghnaithe agus roghnaithe le feiceáil i dhá bhosca taobh le taobh. Féach: attr: ~ModelAdmin.filter_vertical chun comhéadan ingearach a úsáid.

\n
\n\n
\n
\nModelAdmin.filter_verticalLink to this definition#
\n

Mar an gcéanna len:attr: ~ModelAdmin.filter_Horizontal, ach úsáideann sé taispeáint ingearach den chomhéadan scagaire leis an mbosca roghanna neamhroghnaithe atá le feiceáil os cionn an bhosca na roghanna roghnaithe.

\n
\n\n
\n
\nModelAdmin.formLink to this definition#
\n

De réir réamhshocraithe cruthaítear ModelForm go dinimiciúil do do mhúnla. Úsáidtear é chun an fhoirm a chuirtear i láthair ar na leathanaigh cuirte/athraigh a chruthú. Is féidir leat do ModelForm ``féin a sholáthar go héasca chun aon iompar foirme réamhshocraithe ar na leathanaigh cuirte/athraithe a shárú. De rogha air sin, is féidir leat an fhoirm réamhshocraithe a shaincheapadh seachas ceann iomlán nua a shonrú tríd an modh: meth: `ModelAdmin.get_form a úsáid.

\n

Mar shampla féach an rannáit:ref: admin-custom-validation.

\n\n\n
\n\n
\n
\nModelAdmin.formfield_overridesLink to this definition#
\n

Soláthraíonn sé seo bealach tapa agus salach chun cuid de na roghanna: class: ~django.forms.field a shárú le húsáid sa riarachán. Is foclóir é formfield_overrides` ag mapáil rang réimse go dtí argóintí le dul chuig an réimse ag am tógála.

\n

Ós rud é go bhfuil sé sin beagán teibí, féachaimis ar shampla nithiontach. Is é an úsáid is coitianta de formfield_overrides giuirléid saincheaptha a chur le haghaidh cineál áirithe réimse. <textarea>Mar sin, samhlaigh go bhfuil RichTextEditorWidget` scríofa againn ar mhaith linn a úsáid le haghaidh réimsí móra téacs in ionad an réamhshocraithe ```. Seo mar a dhéanfaimis é sin:

\n
Code
from django.contrib import admin\nfrom django.db import models\n\n# Import our custom widget and our model from where they're defined\nfrom myapp.models import MyModel\nfrom myapp.widgets import RichTextEditorWidget\n\n\nclass MyModelAdmin(admin.ModelAdmin):\n    formfield_overrides = {\n        models.TextField: {"widget": RichTextEditorWidget},\n    }\n
\n

Tabhair faoi deara gurb é an eochair sa fhoclóir an rang réimse iarbhír, * ní* teaghrán. Is foclóir eile é an luach; cuirfear na hargóintí seo ar aghaidh chuig modh ``__init__ () ``réimse na foirme. Féach: doc: /ref/forms/api le haghaidh sonraí.

\n\n
\n\n
\n
\nModelAdmin.inlinesLink to this definition#
\n

Féach: aicme: rudaí inlineModelAdmin thíos chomh maith leis: meth: ModelAdmin.get_formSets_with_inlines.

\n
\n\n
\n
\nModelAdmin.list_displayLink to this definition#
\n

Socraigh list_display chun na réimsí a thaispeántar ar leathanach liosta athraithe an riaracháin a rialú.

\n

Sampla:

\n
Code
list_display = ["first_name", "last_name"]\n
\n

Mura socraíonn tú list_display, taispeánfaidh an suíomh riaracháin colún amháin a thaispeánann léiriú ``__str__ () `de gach rud.

\n

Tá cúig chineál luachanna ann is féidir a úsáid i list_display. Féadfaidh gach duine ach an ceann is simplí an maisitheoir: func: ~django.contrib.admin.display a úsáid, a úsáidtear chun an chaoi a gcuirtear an réimse i láthair a shaincheapadh:

\n
    \n

  • Ainm réimse samhail. Mar shampla:

    \n
    Code
    class PersonAdmin(admin.ModelAdmin):\n    list_display = ["first_name", "last_name"]\n
    \n
    • \n

  • Ainm réimse gaolmhar, ag baint úsáide as an nótaí __. Mar shampla:

    \n
    Code
    class PersonAdmin(admin.ModelAdmin):\n    list_display = ["city__name"]\n
    \n
    • \n

  • Inghlaonta a ghlacann le argóint amháin, an tsamhail samhail. Mar shampla:

    \n
    Code
    @admin.display(description="Name")\ndef upper_case_name(obj):\n    return f"{obj.first_name} {obj.last_name}".upper()\n\n\nclass PersonAdmin(admin.ModelAdmin):\n    list_display = [upper_case_name]\n
    \n
    • \n

  • Sreang a léiríonn modh ModelAdmin a ghlacann le argóint amháin, an tsamhail samhail. Mar shampla:

    \n
    Code
    class PersonAdmin(admin.ModelAdmin):\n    list_display = ["upper_case_name"]\n\n    @admin.display(description="Name")\n    def upper_case_name(self, obj):\n        return f"{obj.first_name} {obj.last_name}".upper()\n
    \n
    • \n

  • Sreang a léiríonn tréith nó modh samhail (gan aon argóintí riachtanacha). Mar shampla:

    \n
    Code
    from django.contrib import admin\nfrom django.db import models\n\n\nclass Person(models.Model):\n    name = models.CharField(max_length=50)\n    birthday = models.DateField()\n\n    @admin.display(description="Birth decade")\n    def decade_born_in(self):\n        decade = self.birthday.year // 10 * 10\n        return f"{decade}’s"\n\n\nclass PersonAdmin(admin.ModelAdmin):\n    list_display = ["name", "decade_born_in"]\n
    \n
    • \n
\n\n

Cúpla cás speisialta le tabhairt faoi deara faoi list_display:

\n
    \n

  • Más ForeignKey an réimse, taispeánfaidh Django ``__str__ () ``den réad gaolmhar.

    • \n

  • Ní thacaítear le réimsí ManyTomanyField`, toisc go mbeadh sé sin i gceist leis sin ráiteas SQL ar leithligh a fhorghníomhú do gach sraith sa tábla. Más mian leat é seo a dhéanamh mar sin féin, tabhair modh saincheaptha do do mhúnla, agus cuir ainm an mhodha sin le `list_display`. (Féach thíos le haghaidh tuilleadh faoi mhodhanna saincheaptha i `list_display.)

    • \n

  • Más Booleanfield é an réimse, taispeánfaidh Django deilbhín deas “tá”, “níl”, nó “anaithnid” in ionad True, False`, nó None.

    • \n

  • Más modh den mhúnla é an teaghrán a thugtar, ModelAdmin nó inghlaoithe, éalóidh Django an t-aschur HTML de réir réamhshocraithe. Chun ionchur úsáideora a éalú agus do chlibeanna gan éalú féin a cheadú, bain úsáid as: func: ~django.utils.html.format_html.

    \n

    Seo samhail iomlán sampla:

    \n
    Code
    from django.contrib import admin\nfrom django.db import models\nfrom django.utils.html import format_html\n\n\nclass Person(models.Model):\n    first_name = models.CharField(max_length=50)\n    last_name = models.CharField(max_length=50)\n    color_code = models.CharField(max_length=6)\n\n    @admin.display\n    def colored_name(self):\n        return format_html(\n            '<span style="color: #{};">{} {}</span>',\n            self.color_code,\n            self.first_name,\n            self.last_name,\n        )\n\n\nclass PersonAdmin(admin.ModelAdmin):\n    list_display = ["first_name", "last_name", "colored_name"]\n
    \n
    • \n

  • Mar a léirigh roinnt samplaí cheana féin, agus modh inghlaonta, modh samhail, nó modh ModelAdmin á úsáid agat, is féidir leat teideal an cholúin a shaincheapadh tríd an glaoch a fhilleadh leis an maisitheoir: :func: ~django.contrib.admin.display agus an argóint Description a rith.

    • \n

  • Más é luach réimse None, teaghrán folamh, nó athraitheach gan eilimintí, taispeánfaidh Django - (doic). Is féidir leat é seo a shárú le:attr: adminsite.empty_value_display:

    \n
    Code
    from django.contrib import admin\n\nadmin.site.empty_value_display = "(None)"\n
    \n

    Is féidir leat úsáid freisin: attr: ModelAdmin.empty_value_display:

    \n
    Code
    class PersonAdmin(admin.ModelAdmin):\n    empty_value_display = "unknown"\n
    \n

    Nó ar leibhéal réimse:

    \n
    Code
    class PersonAdmin(admin.ModelAdmin):\n    list_display = ["name", "birth_date_view"]\n\n    @admin.display(empty_value="unknown")\n    def birth_date_view(self, obj):\n        return obj.birth_date\n
    \n
    • \n

  • Más modh den tsamhail é an teaghrán a thugtar, ModelAdmin nó glaoch a thugann ar ais True`, False`, nó None, taispeánfaidh Django deilbhín deas “yes”, “níl”, nó “anaithnid” má fhilleann tú an modh leis an: func: ~django.contrib.admin. argóint olean`` leis an luach socraithe go True:

    \n
    Code
    from django.contrib import admin\nfrom django.db import models\n\n\nclass Person(models.Model):\n    first_name = models.CharField(max_length=50)\n    birthday = models.DateField()\n\n    @admin.display(boolean=True)\n    def born_in_fifties(self):\n        return 1950 <= self.birthday.year < 1960\n\n\nclass PersonAdmin(admin.ModelAdmin):\n    list_display = ["name", "born_in_fifties"]\n
    \n
    • \n

  • Tá an modh __str__ () ``chomh bailí i ``list_display agus aon mhodh samhail eile, mar sin tá sé go foirfe ceart go leor é seo a dhéanamh:

    \n
    Code
    list_display = ["__str__", "some_other_field"]\n
    \n
    • \n

  • De ghnáth, ní féidir eilimintí de list_display` nach réimsí bunachar sonraí iarbhír iad a úsáid i sórtáil (toisc go ndéanann Django an sórtáil go léir ag leibhéal an bhunachar sonraí).

    \n

    Mar sin féin, má léiríonn eilimint de list_display` réimse áirithe bunachar sonraí, is féidir leat an fíric seo a chur in iúl tríd an maisitheoir: func: ~django.contrib.admin.display a úsáid ar an modh, ag rith an argóint ``ordú ``:

    \n
    Code
    from django.contrib import admin\nfrom django.db import models\nfrom django.utils.html import format_html\n\n\nclass Person(models.Model):\n    first_name = models.CharField(max_length=50)\n    color_code = models.CharField(max_length=6)\n\n    @admin.display(ordering="first_name")\n    def colored_first_name(self):\n        return format_html(\n            '<span style="color: #{};">{}</span>',\n            self.color_code,\n            self.first_name,\n        )\n\n\nclass PersonAdmin(admin.ModelAdmin):\n    list_display = ["first_name", "colored_first_name"]\n
    \n

    Inseoidh an méid thuas do Django ordú ag an réimse first_name agus tú ag iarraidh a shórtáil de réir colorred_first_name` sa riarachán.

    \n

    Chun ordú íslitheach a chur in iúl leis an argóint ``ordú ``is féidir leat réimír bhreitheach a úsáid ar ainm an réimse. Ag baint úsáide as an sampla thuas, bheadh an chuma seo mar seo:

    \n
    Code
    @admin.display(ordering="-first_name")\ndef colored_first_name(self): ...\n
    \n

    Tacaíonn an argóint ``ordú ``le cuardaigh fiosrúcháin chun sórtáil de réir luachanna ar mhúnlaí gaolmhara. Cuimsíonn an sampla seo colún “céadainm an údair” i dtaispeáint an liosta agus ceadaíonn sé é a shórtáil de réir chéad ainm:

    \n
    Code
    class Blog(models.Model):\n    title = models.CharField(max_length=255)\n    author = models.ForeignKey(Person, on_delete=models.CASCADE)\n\n\nclass BlogAdmin(admin.ModelAdmin):\n    list_display = ["title", "author", "author_first_name"]\n\n    @admin.display(ordering="author__first_name")\n    def author_first_name(self, obj):\n        return obj.author.first_name\n
    \n

    Query expressions may be used with the\nordering argument:

    \n
    Code
    from django.db.models import Value\nfrom django.db.models.functions import Concat\n\n\nclass Person(models.Model):\n    first_name = models.CharField(max_length=50)\n    last_name = models.CharField(max_length=50)\n\n    @admin.display(ordering=Concat("first_name", Value(" "), "last_name"))\n    def full_name(self):\n        return self.first_name + " " + self.last_name\n
    \n
    • \n

  • Is féidir le heilimintí de list_display` a bheith ina airíonna freisin:

    \n
    Code
    class Person(models.Model):\n    first_name = models.CharField(max_length=50)\n    last_name = models.CharField(max_length=50)\n\n    @property\n    @admin.display(\n        ordering="last_name",\n        description="Full name of the person",\n        boolean=False,\n    )\n    def full_name(self):\n        return self.first_name + " " + self.last_name\n\n\nclass PersonAdmin(admin.ModelAdmin):\n    list_display = ["full_name"]\n
    \n

    Tabhair faoi deara go gcaithfidh @property a bheith os cionn @display. Má tá an seanbhealach á úsáid agat - ag socrú na tréithe a bhaineann le taispeáint go díreach seachas an maisitheoir: func: ~django.contrib.admin.display a úsáid -- bí ar an eolas go gcaithfear an fheidhm property () ``agus **not** an maisitheoir @property ``a úsáid:

    \n
    Code
    def my_property(self):\n    return self.first_name + " " + self.last_name\n\n\nmy_property.short_description = "Full name of the person"\nmy_property.admin_order_field = "last_name"\nmy_property.boolean = False\n\nfull_name = property(my_property)\n
    \n
    • \n

  • <field_name><th>Beidh na hainmneacha réimse i list_display` le feiceáil mar ranganna CSS san aschur HTML, i bhfoirm column- ``ar gach eilimint ``. Is féidir é seo a úsáid chun leithead colún a shocrú i gcomhad CSS mar shampla.

    • \n

  • Déanfaidh Django iarracht gach eilimint de list_display` a léirmhíniú san ord seo:

    \n
      \n

    • Réimse den tsamhail nó ó réimse gaolmhar.

      • \n

    • Is féidir glaoch.

      • \n

    • Sreang a léiríonn tréith ModelAdmin.

      • \n

    • Sreang a léiríonn tréith samhail.

      • \n
    \n

    Mar shampla má tá first_name agat mar réimse samhail agus mar thréith ModelAdmin, úsáidfear an réimse samhail.

    \n
    • \n
\n
\n\n
\n
\nModelAdmin.list_display_linksLink to this definition#
\n

Úsáid list_display_links chun rialú a dhéanamh ar chóir agus cé na réimsí in:attr: list_display a nascadh leis an leathanach “athraigh” le haghaidh réad.

\n

De réir réamhshocraithe, nascfaidh an leathanach liosta athraithe an chéad cholún - an chéad réimse a shonraítear in list_display - leis an leathanach athraithe do gach mír. Ach ligeann list_display_links duit é seo a athrú:

\n
    \n

  • Socraigh é go ``None ```chun aon naisc a fháil ar chor ar bith.

    • \n

  • Socraigh é go liosta nó tuipéar réimsí (san fhormáid chéanna le list_display`) ar mhaith leat a gcolúin a thiontú go naisc.

    \n

    Is féidir leat réimsí amháin nó go leor a shonrú. Chomh fada agus a bhíonn na réimsí le feiceáil in list_display`, ní cúram le Django cé mhéad (nó cé chomh beag) réimse atá nasctha. Is é an t-aon riachtanas ná más mian leat list_display_links a úsáid ar an mbealach seo, ní mór duit list_display a shainiú.

    \n
    • \n
\n

Sa sampla seo, beidh na réimsí first_name agus last_name nasctha ar an leathanach liosta athraithe:

\n
Code
class PersonAdmin(admin.ModelAdmin):\n    list_display = ["first_name", "last_name", "birthday"]\n    list_display_links = ["first_name", "last_name"]\n
\n

Sa sampla seo, ní bheidh aon naisc ag an eangach leathanaigh liosta athraithe:

\n
Code
class AuditEntryAdmin(admin.ModelAdmin):\n    list_display = ["timestamp", "message"]\n    list_display_links = None\n
\n
\n\n
\n
\nModelAdmin.list_editableLink to this definition#
\n

Socraigh list_editable go liosta d'ainmneacha réimse ar an tsamhail a cheadóidh eagarthóireacht ar leathanach an liosta athraithe. Is é sin, taispeánfar réimsí atá liostaithe i list_editable` mar ghuirléidí foirme ar leathanach an liosta athraithe, rud a ligeann d'úsáideoirí sraitheanna iolracha a chur in eagar agus a shábháil ag an am céanna.

\n\n
\n\n
\n
\nModelAdmin.list_filterLink to this definition#
\n

Socraigh list_filter chun scagairí a ghníomhachtú i mbarra taobh na láimhe deise ar leathanach liosta athraithe an riaracháin.

\n

Ag an rud is simplí glacann list_filter liosta nó tuple d'ainmneacha réimse chun scagadh a ghníomhachtú, ach roinnt roghanna níos airde mar atá ar fáil. Féach: ref: modeladmin-list-filters le haghaidh na sonraí.

\n
\n\n
\n
\nModelAdmin.list_max_show_allLink to this definition#
\n

Socraigh list_max_show_all chun a rialú cé mhéad earra is féidir le feiceáil ar leathanach liosta athraithe riaracháin “Taispeáin go léir”. Taispeánfaidh an riarachán nasc “Taispeáin go léir” ar an liosta athraithe ach amháin má tá líon iomlán na dtorthaí níos lú ná nó cothrom leis an socrú seo. De réir réamhshocraithe, tá sé seo socraithe go 200.

\n
\n\n
\n
\nModelAdmin.list_per_pageLink to this definition#
\n

Socraigh list_per_page chun a rialú cé mhéad míreanna atá le feiceáil ar gach leathanach liosta athraithe riaracháin leathanaigh. De réir réamhshocraithe, tá sé seo socraithe go 100.

\n
\n\n
\n
\nModelAdmin.list_select_relatedLink to this definition#
\n

Socraigh list_select_related chun a rá le Django go n-úsáid:meth: ~django.db.models.query.queryset.select_related agus an liosta rudaí ar an leathanach liosta athraithe riaracháin a aisghabháil. Féadann sé seo dornán ceisteanna bunachar sonraí a shábháil duit.

\n

Ba chóir go mbeadh an luach boolean, liosta nó tuple. Is é “False” réamhshocraithe.

\n

Nuair a bhíonn luach True, glaofar ar select_related () ``i gcónaí. Nuair a shocraítear luach go `False, féachfaidh Django ar list_display` agus glaoidh sé ar select_related () ``má tá aon ``ForeignKey i láthair.

\n

Má theastaíonn níos mó rialú mionghráin uait, bain úsáid as tuple (nó liosta) mar luach do list_select_related. Cuirfidh tuple folamh cosc ar Django glaoch ar select_related ar chor ar bith. Cuirfear aon tuple eile ar aghaidh go díreach chuig select_related mar pharaiméadair. Mar shampla:

\n
Code
class ArticleAdmin(admin.ModelAdmin):\n    list_select_related = ["author", "category"]\n
\n

glaoifidh sé ar ``select_related ('author', 'category') ``.

\n

Más gá duit luach dinimiciúil a shonrú bunaithe ar an iarratas, is féidir leat modh a: meth: ~ModelAdmin.get_List_Select_Related a chur i bhfeidhm.

\n\n
\n\n
\n
\nModelAdmin.orderingLink to this definition#
\n

Socraigh ``ordú ``chun a shonrú conas ba chóir liostaí rudaí a ordú i dtuairimí riaracháin Django. Ba chóir go mbeadh sé seo ina liosta nó tuple san fhormáid chéanna le paraiméadar samhail's:attr: ~django.db.Models.Options.Ordering.

\n

Mura gcuirtear é seo ar fáil, úsáidfidh riarachán Django ordú réamhshocraithe an tsamhail.

\n

Más gá duit ordú dinimiciúil a shonrú (mar shampla ag brath ar úsáideoir nó ar theanga) is féidir leat modh a: meth: ~ModelAdmin.get_Ordering a chur i bhfeidhm.

\n\n
\n\n
\n
\nModelAdmin.paginatorLink to this definition#
\n

An rang paginator le húsáid le haghaidh leathanaigh. De réir réamhshocraithe, úsáidtear: class: django.core.paginator.paginator. Mura bhfuil an comhéadan tógála céanna ag an rang paginator saincheaptha las:class: django.core.paginator.paginator, beidh ort cur i bhfeidhm a sholáthar freis:meth: ModelAdmin.get_Paginator.

\n
\n\n
\n
\nModelAdmin.prepopulated_fieldsLink to this definition#
\n

Socraigh prepopulated_fields chuig foclóir ainmneacha réimse a mhapáil chuig na réimsí ba chóir dó a réamhphoiliú ó:

\n
Code
class ArticleAdmin(admin.ModelAdmin):\n    prepopulated_fields = {"slug": ["title"]}\n
\n

Nuair a bheidh sé socraithe, úsáidfidh na réimsí ar leith beagán JavaScript chun líonadh ó na réimsí a shanntar. Is é an príomhúsáid don fheidhmiúlacht seo an luach do réimsí ``Slugfield` a ghiniúint go huathoibríoch ó réimse amháin nó níos mó eile. Déantar an luach a ghintear a tháirgeadh trí luachanna na réimsí foinse a chomhcheangal, agus ansin tríd an toradh sin a athrú ina slug bailí (m.sh. sraitheanna a chur in ionad spásanna agus litreacha ASCII níos ísle).

\n

Ní dhéanann JavaScript réamhphoilte a mhodhnú tar éis luach a shábháil. De ghnáth ní theastaíonn sé go n-athraíonn slóga (rud a d'fhágfadh go n-athródh URL réada má úsáidtear an slug ann).

\n

Ní ghlacann prepopulated_fields le réimsí DateTimeField, ForeignKey`, OneTooneField`, agus `ManyTomanyField.

\n
\n\n
\n
\nModelAdmin.preserve_filtersLink to this definition#
\n

De réir réamhshocraithe, caomhnaítear scagairí feidhme ar amharc an liosta tar éis réad a chruthú, a chur in eagar nó a scriosadh Is féidir leat scagairí a ghlanadh tríd an tréith seo a shocrú go False.

\n
\n\n
\n
\nModelAdmin.show_facetsLink to this definition#
\n

Rialaíonn cibé an dtaispeántar comhaireamh gnéithe do scagairí sa liosta athraithe riaracháin. Réamhshocraithe chuig: attr: .showFacets.allow.

\n

Nuair a thaispeántar, nuashonraíonn comhaireamh gnéithe i gcomhréir leis na scagairí

\n
\n
\nclass ShowFacetsLink to this definition#
\n

Enum na luachanna ceadaithe le haghaidh: attr: .modeladmin.show_facets.

\n
\n
\nALWAYSLink to this definition#
\n

Taispeáin líon gnéithe i gcónaí.

\n
\n\n
\n
\nALLOWLink to this definition#
\n

Taispeáin comhaireamh gnéithe nuair a chuirtear an paraiméadar teaghrán fiosrúcháin _facets ar fáil.

\n
\n\n
\n
\nNEVERLink to this definition#
\n

Ná taispeáin comhaireamh gnéithe riamh.

\n
\n\n
\n\n

Socraigh show_facets go dtí an luach inmhianaithe: class: .showFacets. Mar shampla, chun comhaireamh gnéithe a thaispeáint i gcónaí gan gá duit an paraiméadar ceisteanna a sholáthar:

\n
Code
from django.contrib import admin\n\n\nclass MyModelAdmin(admin.ModelAdmin):\n    ...\n    # Have facets always shown for this model admin.\n    show_facets = admin.ShowFacets.ALWAYS\n
\n\n
\n\n
\n
\nModelAdmin.radio_fieldsLink to this definition#
\n

De réir réamhshocraithe, úsáideann riarachán Django comhéadan bosca roghnaithe (<select>) do réimsí atá ForeignKey nó a bhfuil roghanna ``socraithe acu. Má tá réimse i láthair in `radio_fields, úsáidfidh Django comhéadan cnaipe raidió ina ionad. Ag glacadh leis gur Grúpa is Eochair Foreign ar an tsamhail Duine:

\n
Code
class PersonAdmin(admin.ModelAdmin):\n    radio_fields = {"group": admin.VERTICAL}\n
\n

Tá an rogha agat HORIZONTAL nó VERTICAL a úsáid ón modúl django.contrib.admin.

\n

Ná cuir réimse san áireamh i radio_fields` mura bhfuil ForeignKey ann nó má tá tacar ``roghanna ``ann.

\n
\n\n
\n
\nModelAdmin.autocomplete_fieldsLink to this definition#
\n

Is é autocomplete_fields liosta de réimsí ForeignKey agus/nó ManyTomanyField ar mhaith leat a athrú go Select2 ionchuir uathchomhlánaithe. < https://select2.org/>

\n

De réir réamhshocraithe, úsáideann an riarachán comhéadan bosca roghnaithe (<select>```) do na réimsí sin. Uaireanta níl tú ag iarraidh an lasbhreas a thabhairt faoi na cásanna gaolmhara go léir a roghnú le taispeáint sa anuas.

\n

Breathnaíonn an t-ionchur Select2 cosúil leis an ionchur réamhshocraithe ach tagann sé le gné cuardaigh a luchtaíonn na roghanna go gascrónach. Tá sé seo níos tapúla agus níos éasca le húsáid má tá go leor cásanna ag an tsamhail ghaolmhar.

\n

Ní mór duit: attr: ~ModelAdmin.search_fields a shainiú ar ModelAdmin` an réad gaolmhar toisc go n-úsáideann an cuardach uathchomhlánaithe é.

\n

Chun nochtadh sonraí neamhúdaraithe a sheachaint, caithfidh an cead amharc nó athraithe a bheith ag úsáideoirí don réad gaolmhar chun uathchomhlánú a úsáid.

\n

Rialaítear ordú agus leathanaigh na dtorthaí ag na modhanna gaolmhara ModelAdmin: Meth: ~ModelAdmin.get_Ordering agus:meth: ~ModelAdmin.get_Paginator.

\n

Sa sampla seo a leanas, tá réimse uathchomhlánaithe ag ChoiceAdmin don ForeignKey` chuig an Cheiste`. Déantar na torthaí a scagadh ag an réimse question_text agus ordaítear leis an réimse date_created:

\n
Code
class QuestionAdmin(admin.ModelAdmin):\n    ordering = ["date_created"]\n    search_fields = ["question_text"]\n\n\nclass ChoiceAdmin(admin.ModelAdmin):\n    autocomplete_fields = ["question"]\n
\n\n
\n\n
\n
\nModelAdmin.raw_id_fieldsLink to this definition#
\n

De réir réamhshocraithe, úsáideann riarachán Django comhéadan bosca roghnaithe (<select>) do réimsí atá ForeignKey`. Uaireanta níl tú ag iarraidh an lasbhreas a thabhairt faoi na cásanna gaolmhara go léir a roghnú le taispeáint sa anuas anuas.

\n

Is liosta réimsí é raw_id_fields ar mhaith leat a athrú go giuirléid Input le haghaidh ForeignKey` nó ManyTomanyField:

\n
Code
class ArticleAdmin(admin.ModelAdmin):\n    raw_id_fields = ["newspaper"]\n
\n

Ba chóir go mbeadh eochair phríomh-eochair sa ghuirléid raw_id_fields Input má tá ForeignKey` sa réimse nó liosta luachanna scartha cama-scartha más ManyTomanyField an réimse. Taispeánann an giuirléid raw_id_fields cnaipe gloine formhéadúcháin in aice leis an réimse a ligeann d'úsáideoirí luach a chuardach agus a roghnú:

\n\"/ga/5.2/_images/raw_id_fields.png\"\n
\n\n
\n
\nModelAdmin.readonly_fieldsLink to this definition#
\n

De réir réamhshocraithe taispeánann an riarachán gach réimse mar ineagarthóir. Taispeánfaidh aon réimsí sa rogha seo (ar chóir a bheith ina liost nó tuple) a chuid sonraí mar atá agus neamh-eagarthaithe; tá siad eisiata freisin ó:class: ~django.forms.ModelForm a úsáidtear chun cruthú agus eagarthóireacht. Tabhair faoi deara go gcaithfidh na réimsí léite amháin a bheith i láthair nuair a shonraítear: attr: ModelAdmin.Fields nó: attr: ModelAdmin.FieldSets ní mór na réimsí léite amháin a bheith i láthair le taispeáint (déantar neamhaird orthu ar shlí eile).

\n

Má úsáidtear readonly_fields gan ordú follasach a shainiú trí:attr: ModelAdmin.fields nó: attr: ModelAdmin.FieldSets cuirfear iad go deireanach tar éis gach réimse ineagarthóireachta.

\n

Ní amháin gur féidir le réimse léite amháin sonraí ó réimse samhail a thaispeáint, féadann sé aschur modh samhail nó modh den rang ``ModelAdmin` féin a thaispeáint freisin. Tá sé seo an-chosúil leis an mbealach: attr: ModelAdmin.list_display iompraíonn. Soláthraíonn sé seo bealach chun an comhéadan riaracháin a úsáid chun aiseolas a sholáthar ar stádas na rudaí atá á chur in eagar, mar shampla:

\n
Code
from django.contrib import admin\nfrom django.utils.html import format_html_join\nfrom django.utils.safestring import mark_safe\n\n\nclass PersonAdmin(admin.ModelAdmin):\n    readonly_fields = ["address_report"]\n\n    # description functions like a model field's verbose_name\n    @admin.display(description="Address")\n    def address_report(self, instance):\n        # assuming get_full_address() returns a list of strings\n        # for each line of the address and you want to separate each\n        # line by a linebreak\n        return format_html_join(\n            mark_safe("<br>"),\n            "{}",\n            ((line,) for line in instance.get_full_address()),\n        ) or mark_safe("<span class='errors'>I can't determine this address.</span>")\n
\n
\n\n
\n
\nModelAdmin.save_asLink to this definition#
\n

Socraigh ``save_as ``chun gné “sábháil mar nua” a chumasú ar fhoirmeacha athraithe riaracháin.

\n

De ghnáth, bíonn trí rogha sábhála ag rudaí: “Sábháil”, “Sábháil agus lean ar aghaidh ag eagarthóireacht”, agus “Sábháil agus cuir eile leis”. Más é save_as True`, cuirfear cnaipe “Sábháil mar nua” in ionad “Sábháil agus cuir eile leis” a chruthaíonn réad nua (le ID nua) seachas an réad atá ann cheana a nuashonrú.

\n

De réir réamhshocraithe, socraítear save_as go False.

\n
\n\n
\n
\nModelAdmin.save_as_continueLink to this definition#
\n

When: attr: save_as = True <save_as>, is é an t-atreorú réamhshocraithe tar éis an réad nua a shábháil chuig an radharc athraithe don réad sin. Má shocraíonn tú save_as_continue=False, beidh an t-atreorú chuig an radharc liosta athraithe.

\n

De réir réamhshocraithe, socraítear save_as_continue go True.

\n
\n\n
\n
\nModelAdmin.save_on_topLink to this definition#
\n

Socraigh save_on_top chun cnaipí sábhála a chur ar fud barr d'fhoirmeacha athraithe riaracháin.

\n

De ghnáth, ní bhíonn na cnaipí sábhála le feiceáil ach ag bun na bhfoirmeacha. Má shocraíonn tú save_on_top, beidh na cnaipí le feiceáil ar an mbarr agus ar an mbun araon.

\n

De réir réamhshocraithe, socraítear save_on_top go False.

\n
\n\n
\n
\nModelAdmin.search_fieldsLink to this definition#
\n

Socraigh search_fields chun bosca cuardaigh a chumasú ar an leathanach liosta athraithe riaracháin. Ba chóir é seo a shocrú ar liosta d'ainmneacha réimse a chuardófar aon uair a chuireann duine fiosrúchán cuardaigh isteach sa bhosca téacs sin.

\n

Ba chóir go mbeadh réimse téacs de chineál éigin sna réimsí seo, mar shampla Charfield nó TextField. Is féidir leat cuardach gaolmhar a dhéanamh freisin ar ForeignKey nó ManyTomanyField leis an notáil “lean” API cuardaigh:

\n
Code
search_fields = ["foreign_key__related_fieldname"]\n
\n

Mar shampla, má tá iontráil blag agat le húdar, chuirfeadh an sainmhíniú seo a leanas ar chumas iontrálacha blag a chuardach de réir seoladh ríomhphoist an údair:

\n
Code
search_fields = ["user__email"]\n
\n

Nuair a dhéanann duine cuardach sa bhosca cuardaigh riaracháin, scoilteann Django an fiosrúchán cuardaigh ina bhfocail agus filleann gach rud ina bhfuil gach ceann de na focail, neamh-íogair (ag baint úsáide as an lorga:lookup: icontains lookup), áit a gcaithfidh gach focal a bheith i gceann de search_fields` ar a laghad. Mar shampla, má shocraítear search_fields go ['first_name', 'last_name'] agus má chuardaíonn úsáideoir john lennon, déanfaidh Django an chomhionann leis an gclásal SQL WHERE:

\n
SQL
WHERE (first_name ILIKE '%john%' OR last_name ILIKE '%john%')\nAND (first_name ILIKE '%lennon%' OR last_name ILIKE '%lennon%')\n
\n

Is féidir frásaí luaite le spásanna a bheith san fhiosrúchán cuardaigh. Mar shampla, má dhéanann úsáideoir cuardach ar "john winston" nó `john winston', déanfaidh Django an coibhéis leis an gclásal WHERE SQL seo:

\n
SQL
WHERE (first_name ILIKE '%john winston%' OR last_name ILIKE '%john winston%')\n
\n

Mura dteastaíonn uait icontains a úsáid mar an cuardach, is féidir leat aon chuardach a úsáid tríd an réimse a chur leis. Mar shampla, d'fhéadfá: lookup: exact a úsáid trí search_fields` a shocrú go ['first_name__correct'].

\n

Tá roinnt aicearraí (níos sine) chun cuardach réimse a shonrú ar fáil freisin. <lookup>Is féidir leat réimse réimse a réamhrú in search_fields` leis na carachtair seo a leanas agus tá sé coibhéiseach le ``__ ``a chur leis an réimse:

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Réimír

Cuardaigh

^

istartswith

=

iexact

@

search

Dada

icontains

\n
\n

Más gá duit cuardach a shaincheapadh is féidir leat: meth: ModelAdmin.get_search_results a úsáid chun iompar cuardaigh breise nó malartach a sholáthar.

\n
\n\n
\n
\nModelAdmin.search_help_textLink to this definition#
\n

Socraigh search_help_text chun téacs tuairisciúil a shonrú don bhosca cuardaigh a thaispeánfar faoin mbosca cuardaigh.

\n
\n\n
\n
\nModelAdmin.show_full_result_countLink to this definition#
\n

Socraigh show_full_result_count chun rialú a dhéanamh ar chóir líon iomlán na rudaí a thaispeáint ar leathanach riaracháin scagtha (m.sh. 99 torthaí (103 iomlán) ``). Má tá an rogha seo socraithe go ``False, taispeántar téacs mar ``99 thorthaí (Taispeáin go léir) ``ina ionad.

\n

Gineann réamhshocrú show_full_result_count=True ceist chun comhaireamh iomlán a dhéanamh ar an tábla a d'fhéadfadh a bheith daor má tá líon mór sraitheanna sa tábla.

\n
\n\n
\n
\nModelAdmin.sortable_byLink to this definition#
\n

De réir réamhshocraithe, ceadaíonn an leathanach liosta athraithe a shórtáil de réir gach réimse samhail (agus glaonna a úsáideann an argóint ording leis an maisitheoir: func: ~django.contrib.admin.display nó a bhfuil an tréith admin_order_field` acu) sonraithe in:attr: list_display.

\n

Más mian leat sórtáil a dhíchumasú do roinnt colúin, socraigh sortable_by chuig bailiúchán (m.sh. list`, tuple`, nó set) den fho-thacar de:attr: list_display a theastaíonn uait a shórtáil. Díchumasaíonn bailiúchán folamh sórtáil do gach colún.

\n

Más gá duit an liosta seo a shonrú go dinimiciúil, cuir modh a:meth: ~ModelAdmin.get_sortable_by i bhfeidhm ina ionad.

\n
\n\n
\n
\nModelAdmin.view_on_siteLink to this definition#
\n

Socraigh view_on_site chun rialú a dhéanamh an bhfuil an nasc “Amharc ar an láithreán” a thaispeáint nó nach bhfuil. Ba chóir go dtabharfadh an nasc seo tú chuig URL áit ar féidir leat an réad sábháltha a thaispeáint.

\n

Is féidir leis an luach seo a bheith ina bhratach boolean nó inghlaonta. Má tá True (an réamhshocraithe), úsáidfear an modh object's:meth: ~django.db.models.model.get_absolute_url chun an url a ghiniúint.

\n

Má tá modh a:meth: ~django.db.models.model.get_absolute_url ag do mhúnla ach nach dteastaíonn uait go mbeadh an cnaipe “Amharc ar an láithreán” le feiceáil, ní gá duit ach view_on_site` a shocrú go False:

\n
Code
from django.contrib import admin\n\n\nclass PersonAdmin(admin.ModelAdmin):\n    view_on_site = False\n
\n

Sa chás go bhfuil sé inghlaonta, glacann sé leis an gcás samhail mar pharaiméadar. Mar shampla:

\n
Code
from django.contrib import admin\nfrom django.urls import reverse\n\n\nclass PersonAdmin(admin.ModelAdmin):\n    def view_on_site(self, obj):\n        url = reverse("person-detail", kwargs={"slug": obj.slug})\n        return "https://example.com" + url\n
\n
\n\n
\n

Roghanna teimpléad saincheapLink to this heading#

\n

Déanann roinn:ref: admin-overriding-temples cur síos ar conas na teimpléid riaracháin réamhshocraithe a shárú nó a leathnú. Úsáid na roghanna seo a leanas chun na teimpléid réamhshocraithe a úsáideann na tuairimí: class: ModelAdmin a shárú:

\n
\n
\nModelAdmin.add_form_templateLink to this definition#
\n

Conair chuig teimpléad saincheaptha, a úsáideann: meth: add_view.

\n
\n\n
\n
\nModelAdmin.change_form_templateLink to this definition#
\n

Conair chuig teimpléad saincheaptha, a úsáideann: meth: change_view.

\n
\n\n
\n
\nModelAdmin.change_list_templateLink to this definition#
\n

Conair chuig teimpléad saincheaptha, a úsáideann: meth: changelist_view.

\n
\n\n
\n
\nModelAdmin.delete_confirmation_templateLink to this definition#
\n

Conair chuig teimpléad saincheaptha, a úsáideann: meth: delete_view chun leathanach dearbhaithe a thaispeáint agus réad amháin nó níos mó á scriosadh.

\n
\n\n
\n
\nModelAdmin.delete_selected_confirmation_templateLink to this definition#
\n

Conair chuig teimpléad saincheaptha, a úsáidtear ag an modh gníomhaíochta delete_selected chun leathanach dearbhaithe a thaispeáint agus réad amháin nó níos mó á scriosadh. Féach na:doc: `@@</ref/contrib/admin/actions> doiciméadú gníomhaíochtaí '.

\n
\n\n
\n
\nModelAdmin.object_history_templateLink to this definition#
\n

Conair chuig teimpléad saincheaptha, a úsáideann: meth: history_view.

\n
\n\n
\n
\nModelAdmin.popup_response_templateLink to this definition#
\n

Conair chuig teimpléad saincheaptha, a úsáideann:: meth: response_add, :meth: response_change, agus:meth: response_delete.

\n
\n\n
\n
\n
\n

Modhanna ModelAdminLink to this heading#

\n\n
\n
\nModelAdmin.save_model(request, obj, form, change)Link to this definition#
\n

Tugtar an HttpRequest` don modh save_model`, sampla samhail, sampla ModelForm, agus luach boolean bunaithe ar an bhfuil an réad á chur leis nó ag athrú. Ligeann an modh seo a shárú oibríochtaí réamhshábhála nó iar-shábháil a dhéanamh. Glaoigh ar ``super () .save_model () ``chun an réad a shábháil ag baint úsáid:meth: .model.save.

\n

Mar shampla chun request.user a cheangal leis an réad sula ndéantar é a shábháil:

\n
Code
from django.contrib import admin\n\n\nclass ArticleAdmin(admin.ModelAdmin):\n    def save_model(self, request, obj, form, change):\n        obj.user = request.user\n        super().save_model(request, obj, form, change)\n
\n
\n\n
\n
\nModelAdmin.delete_model(request, obj)Link to this definition#
\n

Tugtar an HttpRequest` agus sampla samhail don modh delete_model`. Ligeann an modh seo a shárú oibríochtaí réamh-scriosta nó iar-scriosta a dhéanamh. Glaoigh ar ``super () .delete_model () ``chun an réad a scriosadh ag baint úsáid:meth: .model.delete.

\n
\n\n
\n
\nModelAdmin.delete_queryset(request, queryset)Link to this definition#
\n

Tugann an modh delete_queryset () ``tugtar an `HttpRequest agus QuerySet de rudaí atá le scriosadh. <actions>Athraigh an modh seo chun an próiseas scriosta a shaincheapadh do na “rudaí roghnaithe a scriosadh”: doc: `gníomhaíocht `.

\n
\n\n
\n
\nModelAdmin.save_formset(request, form, formset, change)Link to this definition#
\n

Tugtar an modh save_formset an HttpRequest`, sampla an tuismitheora ModelForm agus luach boolean bunaithe ar cibé an bhfuil sé ag cur nó ag athrú an tuismitheora réad.

\n

Mar shampla, chun request.user` a cheangal le gach samhail foirmset athraithe:

\n
Code
class ArticleAdmin(admin.ModelAdmin):\n    def save_formset(self, request, form, formset, change):\n        instances = formset.save(commit=False)\n        for obj in formset.deleted_objects:\n            obj.delete()\n        for instance in instances:\n            instance.user = request.user\n            instance.save()\n        formset.save_m2m()\n
\n

Féach freis:ref: saving-objects-in-the-formset.

\n
\n\n\n
\n
\nModelAdmin.get_ordering(request)Link to this definition#
\n

Glacann an modh get_ordering iarraidh mar pharaiméadar agus táthar ag súil go gcuirfidh sé liost` nó tuple` ar ais chun ordú cosúil leis an tréith: attr: ordúna. Mar shampla:

\n
Code
class PersonAdmin(admin.ModelAdmin):\n    def get_ordering(self, request):\n        if request.user.is_superuser:\n            return ["name", "rank"]\n        else:\n            return ["name"]\n
\n
\n\n
\n
\nModelAdmin.get_search_results(request, queryset, search_term)Link to this definition#
\n

Athraíonn an modh get_search_results liosta na rudaí a thaispeántar isteach iad siúd a mheaitseálann an téarma cuardaigh a chuirtear ar fáil. Glacann sé leis an iarratas, tacar cheisteanna a chuireann na scagairí reatha i bhfeidhm, agus an téarma cuardaigh a sholáthraíonn an úsáideoir. Filleann sé tuple ina bhfuil tacar fiosrúcháin arna modhnú chun an cuardach a chur i bhfeidhm, agus boolean a thugann le fios an bhféadfadh dúbailtí a bheith sna torthaí.

\n

Déanann an cur i bhfeidhm réamhshocraithe cuardach ar na réimsí a ainmnítear in:attr: ModelAdmin.search_fields.

\n

Féadfar an modh seo a shárú le do mhodh cuardaigh saincheaptha féin. Mar shampla, b'fhéidir gur mhaith leat cuardach a dhéanamh de réir réimse sláimhir, nó uirlis sheachtrach mar Solr nó Haystack a úsáid. Ní mór duit a fháil amach an bhféadfadh na hathruithe tacar fiosrúcháin a chuirtear i bhfeidhm ag do mhodh cuardaigh dúbailtí a thabhairt isteach sna torthaí, agus True a thabhairt ar ais sa dara gné den luach tuairisceáin.

\n

Mar shampla, chun cuardach a dhéanamh de réir ainm ``agus ``aois`, d'fhéadfá úsáid a bhaint as:

\n
Code
class PersonAdmin(admin.ModelAdmin):\n    list_display = ["name", "age"]\n    search_fields = ["name"]\n\n    def get_search_results(self, request, queryset, search_term):\n        queryset, may_have_duplicates = super().get_search_results(\n            request,\n            queryset,\n            search_term,\n        )\n        try:\n            search_term_as_int = int(search_term)\n        except ValueError:\n            pass\n        else:\n            queryset |= self.model.objects.filter(age=search_term_as_int)\n        return queryset, may_have_duplicates\n
\n

Tá an cur i bhfeidhm seo níos éifeachtaí ná search_fields = ('name', '=age') ``a dtagann comparáid teaghráin don réimse uimhriúil mar thoradh air, mar shampla... NÓ UACHTARACH (“polls_choice”. vótaí” ::text) = UPPER ('4') ``ar PostgreSQL.

\n
\n\n
\n
\nModelAdmin.save_related(request, form, formsets, change)Link to this definition#
\n

Tugtar an modh save_related an HttpRequest`, an tuismitheoir ``ModelForm ``, an liosta foirmeacha inlíne agus luach boolean bunaithe ar an bhfuil an tuismitheoir á chur leis nó á athrú. Anseo is féidir leat aon oibríochtaí réamhshábhála nó iar-shábháil a dhéanamh le haghaidh rudaí a bhaineann leis an tuismitheoir. Tabhair faoi deara go bhfuil an tuismitheoir réad agus a fhoirm sábháilte cheana féin ag an bpointe seo.

\n
\n\n
\n
\nModelAdmin.get_autocomplete_fields(request)Link to this definition#
\n

Tugtar an HttpRequest` don modh get_autocomplete_fields () ``agus táthar ag súil go bhfaighidh sé ``list nó tuple d'ainmneacha réimse a thaispeánfar le giuirléid uathchomhlánaithe mar a thuairiscítear thuas sa ranna:attr: ModelAdmin.autocomplete_fields.

\n
\n\n
\n
\nModelAdmin.get_readonly_fields(request, obj=None)Link to this definition#
\n

Tugtar an modh get_readonly_fields an HttpRequest` agus an obj` atá á chur in eagar (nó None ar fhoirm breise) agus táthar ag súil go bhfaighidh liost` nó tuple` d'ainmneacha réimse a thaispeánfar mar léamh amháin, mar a thuairiscítear thuas san: `Read.Model.rannán ly_fields'.

\n
\n\n
\n
\nModelAdmin.get_prepopulated_fields(request, obj=None)Link to this definition#
\n

Tugtar an modh get_prepopulated_fields an HttpRequest` agus an obj` atá á chur in eagar (nó None ar fhoirm breise) agus táthar ag súil go bhfaighidh sé ``foclóir` ar ais, mar a thuairiscítear thuas sa ranna:attr: ModelAdmin.prePopulated_Fields.

\n
\n\n
\n
\nModelAdmin.get_list_display(request)Link to this definition#
\n

Tugtar an HttpRequest` don modh get_list_display agus táthar ag súil go bhfaighidh sé list nó tuple` d'ainmneacha réimse a thaispeánfar ar an radharc an liosta athraithe mar a thuairiscítear thuas sa ranna:attr: ModelAdmin.list_display.

\n
\n\n
\n
\nModelAdmin.get_list_display_links(request, list_display)Link to this definition#
\n

Tugtar an HttpRequest don modh get_list_display_links agus an list` nó tuple ar ais ar:meth: ModelAdmin.get_list_display. Táthar ag súil go bhfillfidh sé None nó liost nó tuple d'ainmneacha réimse ar an liosta athraithe a bheidh nasctha leis an radharc athraithe, mar a thuairiscítear sa ranna:attr: ModelAdmin.list_display_links.

\n
\n\n
\n
\nModelAdmin.get_exclude(request, obj=None)Link to this definition#
\n

Tugtar an modh get_exclude an HttpRequest` agus an obj` atá á chur in eagar (nó None ar fhoirm breise) agus táthar ag súil go gcuirfidh sé liosta réimsí ar ais, mar a thuairiscítear in:attr: ModelAdmin.exclude.

\n
\n\n
\n
\nModelAdmin.get_fields(request, obj=None)Link to this definition#
\n

Tugtar an modh get_fields an HttpRequest` agus an obj` atá á chur in eagar (nó None ar fhoirm bhreise) agus táthar ag súil go gcuirfidh sé liosta réimsí ar ais, mar a thuairiscítear thuas sa roinn:attr: ModelAdmin.fields.

\n
\n\n
\n
\nModelAdmin.get_fieldsets(request, obj=None)Link to this definition#
\n

<fieldset>Tugtar an modh get_fieldsets an HttpRequest` agus an obj` atá á chur in eagar (nó None ar fhoirm bhreise) agus táthar ag súil go bhfaighidh sé liosta 2-tuples ar ais, ina léiríonn gach 2-tuple ``ar leathanach na foirme riaracháin, mar a thuairiscítear thuas in:attr: Adminmodel.fieldsets rannán.

\n
\n\n
\n
\nModelAdmin.get_list_filter(request)Link to this definition#
\n

Tugtar an HttpRequest` don modh get_list_filter agus táthar ag súil go bhfaighidh sé an cineál céanna seicheamh ar ais leis an tréith: attr: ~ModelAdmin.list_filter.

\n
\n\n
\n
\nModelAdmin.get_list_select_related(request)Link to this definition#
\n

Tugtar an HttpRequest` don modh get_list_select_related agus ba cheart boolean nó liosta a thabhairt ar ais mar: attr: ModelAdmin.list_Select_Related a dhéanann.

\n
\n\n
\n
\nModelAdmin.get_search_fields(request)Link to this definition#
\n

Tugtar an HttpRequest` don modh get_search_fields agus táthar ag súil go bhfaighidh sé an cineál céanna seicheamh ar ais mar thréith: attr: ~ModelAdmin.search_fields.

\n
\n\n
\n
\nModelAdmin.get_sortable_by(request)Link to this definition#
\n

Tá an modh get_sortable_by () ``rith an `HttpRequest agus táthar ag súil go bhfaighidh sé bailiúchán (m.sh. list`, tuple`, nó set) d'ainmneacha réimse a shórtálfar ar an leathanach liosta athraithe.

\n

Filleann a chur i bhfeidhm réamhshocraithe:attr: sortable_by má tá sé socraithe, ar shlí eile cuirtear iarchur chuig: meth: get_list_display.

\n

Mar shampla, chun colún amháin nó níos mó a chosc ó bheith inscartha:

\n
Code
class PersonAdmin(admin.ModelAdmin):\n    def get_sortable_by(self, request):\n        return {*self.get_list_display(request)} - {"rank"}\n
\n
\n\n
\n
\nModelAdmin.get_inline_instances(request, obj=None)Link to this definition#
\n

Tugtar an modh get_inline_instances an HttpRequest` agus an obj` atá á chur in eagar (nó None ar fhoirm breise) agus táthar ag súil go bhfaighidh sé rudaí list nó tuple` o:class: ~django.contrib.admin.inlineModelAdmin, mar a thuairiscítear thíos :class: ~django.contrib.admin.inlineModelAdmin rannán. Mar shampla, chuirfeadh an méid seo a leanas ar ais inlíne gan an scagadh réamhshocraithe bunaithe ar cheadanna a chur leis, a athrú, a scriosadh agus féachaint:

\n
Code
class MyModelAdmin(admin.ModelAdmin):\n    inlines = [MyInline]\n\n    def get_inline_instances(self, request, obj=None):\n        return [inline(self.model, self.admin_site) for inline in self.inlines]\n
\n

Má sháraíonn tú an modh seo, déan cinnte gur cásanna iad na línte a thugtar ar ais de na ranganna atá sainmhínithe in:attr: inlines nó d'fhéadfadh go mbeadh earráid “Droch-iarratas” ort agus rudaí gaolmhara á chur leis.

\n
\n\n
\n
\nModelAdmin.get_inlines(request, obj)Link to this definition#
\n

Tugtar an modh get_inlines an HttpRequest` agus an obj atá á chur in eagar (nó None ar fhoirm bhreise) agus táthar ag súil go bhfaighidh sé athrá inlíne ar ais. Is féidir leat an modh seo a shárú chun inlínte a chur go dinimiciúil bunaithe ar an iarratas nó an samhail samhail in ionad iad a shonrú in:attr: ModelAdmin.inlines.

\n
\n\n
\n
\nModelAdmin.get_urls()Link to this definition#
\n

Tugann an modh get_urls ar ModelAdmin` na URLanna atá le húsáid don ModelAdmin sin ar an mbealach céanna le URLConf. Dá bhrí sin is féidir leat iad a leathnú mar a dhoiciméadaithe in:doc: /topics/http/urls, ag baint úsáide as an fillteán ``adminsite.admin_view () ``ar do thuairimí:

\n
Code
from django.contrib import admin\nfrom django.template.response import TemplateResponse\nfrom django.urls import path\n\n\nclass MyModelAdmin(admin.ModelAdmin):\n    def get_urls(self):\n        urls = super().get_urls()\n        my_urls = [path("my_view/", self.admin_site.admin_view(self.my_view))]\n        return my_urls + urls\n\n    def my_view(self, request):\n        # ...\n        context = dict(\n            # Include common variables for rendering the admin template.\n            self.admin_site.each_context(request),\n            # Anything else you want in the context...\n            key=value,\n        )\n        return TemplateResponse(request, "sometemplate.html", context)\n
\n

Más mian leat an leagan amach riaracháin a úsáid, síneadh ó admin/base_site.html:

\n
Django template
{% extends "admin/base_site.html" %}\n{% block content %}\n...\n{% endblock %}\n
\n\n\n

Má tá an leathanach incháilithe, ach má theastaíonn uait fós go ndéanfaí an seiceáil ceada, is féidir leat argóint cacheable=True a chur ar aghaidh chuig adminsite.admin_view () `:

\n
Code
path("my_view/", self.admin_site.admin_view(self.my_view, cacheable=True))\n
\n

Tá tréithe model_admin ``ag tuairimí ``ModelAdmin. Tá tréithe admin_site ag tuairimí adminSite` eile.

\n
\n\n
\n
\nModelAdmin.get_form(request, obj=None, **kwargs)Link to this definition#
\n

Tuairisceáin a:class: ~django.forms.ModelForm rang le húsáid sa riarachán tuairimí cuir agus athraigh, féach:meth: add_view agus:meth: change_view.

\n

Úsáideann an cur i bhfeidhm bonn:func: ~django.forms.models.modelform_factory go fo-aicme: attr: ~form, modhnaithe ag tréithe mar: attr: ~fields agus:attr: ~fields agus:attr: `~ eisiúint `. Mar sin, mar shampla, dá dteastaíonn uait réimsí breise a thairiscint do sárúsáideoirí, d'fhéadfá malartú i bhfoirm bhonn difriúil mar sin:

\n
Code
class MyModelAdmin(admin.ModelAdmin):\n    def get_form(self, request, obj=None, **kwargs):\n        if request.user.is_superuser:\n            kwargs["form"] = MySuperuserForm\n        return super().get_form(request, obj, **kwargs)\n
\n

Féadfaidh tú rang saincheap:class: ~django.forms.ModelForm a thabhairt ar ais go díreach freisin.

\n
\n\n
\n
\nModelAdmin.get_formsets_with_inlines(request, obj=None)Link to this definition#
\n

Péirí torthaí (FormSet, :class: InlineModelAdmin) le húsáid i riarachán tuairimí a chur leis agus a athrú.

\n

Mar shampla más mian leat inlíne áirithe a thaispeáint sa radharc athraithe amháin, d'fhéadfá get_formsets_with_inlines a shárú mar seo a leanas:

\n
Code
class MyModelAdmin(admin.ModelAdmin):\n    inlines = [MyInline, SomeOtherInline]\n\n    def get_formsets_with_inlines(self, request, obj=None):\n        for inline in self.get_inline_instances(request, obj):\n            # hide MyInline in the add view\n            if not isinstance(inline, MyInline) or obj is not None:\n                yield inline.get_formset(request, obj), inline\n
\n
\n\n
\n
\nModelAdmin.formfield_for_foreignkey(db_field, request, **kwargs)Link to this definition#
\n

Ligeann an modh formfield_for_foreignkey ar ModelAdmin` duit an réimse foirme réamhshocraithe do réimse eochracha eachtracha eachtracha a shárú. Mar shampla, chun fo-thacar rudaí a thabhairt ar ais don phríomhréimse eachtrach seo bunaithe ar an úsáideoir:

\n
Code
class MyModelAdmin(admin.ModelAdmin):\n    def formfield_for_foreignkey(self, db_field, request, **kwargs):\n        if db_field.name == "car":\n            kwargs["queryset"] = Car.objects.filter(owner=request.user)\n        return super().formfield_for_foreignkey(db_field, request, **kwargs)\n
\n

Úsáideann sé seo an tsampla HttpRequest` chun an réimse eochair eachtrach Car a scagadh chun na gluaisteáin atá faoi úinéireacht an ``Úsáideora ``a thaispeáint ach amháin.

\n

Le haghaidh scagairí níos casta, is féidir leat ModelForm a úsáid. Modh __init__ () ``chun scagadh bunaithe ar `instance de do mhúnla (féach:ref: fields-what-handle-reachships). Mar shampla:

\n
Code
class CountryAdminForm(forms.ModelForm):\n    def __init__(self, *args, **kwargs):\n        super().__init__(*args, **kwargs)\n        self.fields["capital"].queryset = self.instance.cities.all()\n\n\nclass CountryAdmin(admin.ModelAdmin):\n    form = CountryAdminForm\n
\n
\n\n
\n
\nModelAdmin.formfield_for_manytomany(db_field, request, **kwargs)Link to this definition#
\n

Cosúil leis an modh formfield_for_foreignkey, is féidir an modh formfield_for_manytomany a athrú chun an réimse foirme réamhshocraithe do réimse go leor réimse a athrú. Mar shampla, más féidir le húinéir ilghluaisteáin a bheith ag úinéir agus is féidir gluaisteáin a bheith bainteach le go leor úinéirí -- d'fhéadfá an réimse eochair eachtrach ``Carr` a scagadh chun na gluaisteáin atá faoi úinéireacht an ``Úsáideora ``a thaispeáint amháin:

\n
Code
class MyModelAdmin(admin.ModelAdmin):\n    def formfield_for_manytomany(self, db_field, request, **kwargs):\n        if db_field.name == "cars":\n            kwargs["queryset"] = Car.objects.filter(owner=request.user)\n        return super().formfield_for_manytomany(db_field, request, **kwargs)\n
\n
\n\n
\n
\nModelAdmin.formfield_for_choice_field(db_field, request, **kwargs)Link to this definition#
\n

Cosúil leis na modhanna formfield_for_foreignkey agus formfield_for_manytomany, is féidir an modh formfield_for_choice_field a athrú chun an réimse foirme réamhshocraithe a athrú do réimse a bhfuil roghanna dearbhaithe aige. Mar shampla, más chóir go mbeadh na roghanna atá ar fáil do sárúsáideoir difriúil ná na roghanna atá ar fáil d'fhoireann rialta, d'fhéadfá dul ar aghaidh mar seo a leanas:

\n
Code
class MyModelAdmin(admin.ModelAdmin):\n    def formfield_for_choice_field(self, db_field, request, **kwargs):\n        if db_field.name == "status":\n            kwargs["choices"] = [\n                ("accepted", "Accepted"),\n                ("denied", "Denied"),\n            ]\n            if request.user.is_superuser:\n                kwargs["choices"].append(("ready", "Ready for deployment"))\n        return super().formfield_for_choice_field(db_field, request, **kwargs)\n
\n\n
\n\n
\n
\nModelAdmin.get_changelist(request, **kwargs)Link to this definition#
\n

Filleann sé an rang Changelist atá le húsáid le haghaidh liostú. De réir réamhshocraithe, úsáidtear django.contrib.admin.views.main.changeList. Trí an rang seo a oidhreacht is féidir leat iompar an liostaithe a athrú.

\n
\n\n
\n
\nModelAdmin.get_changelist_form(request, **kwargs)Link to this definition#
\n

Tuairisceann a:class: ~django.forms.ModelForm rang le húsáid sa FormSet ar an leathanach liosta athraithe. Chun foirm saincheaptha a úsáid, mar shampla:

\n
Code
from django import forms\n\n\nclass MyForm(forms.ModelForm):\n    pass\n\n\nclass MyModelAdmin(admin.ModelAdmin):\n    def get_changelist_form(self, request, **kwargs):\n        return MyForm\n
\n\n
\n\n
\n
\nModelAdmin.get_changelist_formset(request, **kwargs)Link to this definition#
\n

Tuairisceáin a:ref: ModelFormSet <model-formsets>`aicme le húsáid ar an leathanach liosta athraithe má úsáidtear: attr: `~ModelAdmin.list_editable. Chun tacar foirme saincheaptha a úsáid, mar shampla:

\n
Code
from django.forms import BaseModelFormSet\n\n\nclass MyAdminFormSet(BaseModelFormSet):\n    pass\n\n\nclass MyModelAdmin(admin.ModelAdmin):\n    def get_changelist_formset(self, request, **kwargs):\n        kwargs["formset"] = MyAdminFormSet\n        return super().get_changelist_formset(request, **kwargs)\n
\n
\n\n
\n
\nModelAdmin.lookup_allowed(lookup, value, request)Link to this definition#
\n

Is féidir na rudaí ar leathanach an liosta athraithe a scagadh le cuardaigh ó shreang fiosrúcháin an URL. Seo mar a oibríonn: attr: list_filter, mar shampla. Tá na cuardaigh cosúil leis an méid a úsáidtear in:meth: .querySet.filter (m.sh. ``user__email= user@example.com ``). Ós rud é gur féidir leis an úsáideoir na cuardaigh sa sreangán fiosrúcháin a ionramháil, caithfear iad a shláintiú chun nochtadh sonraí neamhúdaraithe a chosc.

\n

Tugtar cosán cuardaigh don modh lookup_allow () ``ón sreang ceisteanna (m.sh. ```user__email'), an luach comhfhreagrach (m.sh. `user@example.com '), agus an t-iarratas, agus tugann sé boolean ag tabhairt le fios an bhfuil ceadaithe ag scagadh QuerySet ag baint úsáide as na paraiméadair. Má fhilleann lookup_allow () ```False,, DisallowedModelAdminlookup`` (fo-aicme de:exc: ~Django.Core.Exceptions.SuspiciousOperation) a ardaítear.

\n

De réir réamhshocraithe, ceadaíonn ``lookup_allow () ``rochtain ar réimsí áitiúla samhail, cosáin réimse a úsáidtear in:attr: ~ModelAdmin.list_filter (ach ní cosáin ó:meth: ~ModelAdmin.get_list_filter), agus cuardaigh atá ag teastáil le haghaidh: attr: ~Django.db.models.foreignkey.limit_choices_to feidhmiú i gceart in:attr: ~django.contrib.admin.modeladmin.raw_id_fields.

\n

Athraigh an modh seo chun na cuardaigh a cheadaítear do d'fho-aicme: ~django.contrib.admin.modelAdmin a shaincheapadh.

\n
\n\n
\n
\nModelAdmin.has_view_permission(request, obj=None)Link to this definition#
\n

Ba chóir True a thabhairt ar ais má cheadaítear féachaint ar obj, False` ar shlí eile. Más é obj None, ba cheart True nó False` a thabhairt ar ais chun a léiriú an bhfuil ceadaithe féachaint ar rudaí den chineál seo go ginearálta (m.sh., léirmhínítear False mar a chiallaíonn nach ceadaítear don úsáideoir reatha aon rud den chineál seo a fheiceáil).

\n

Tugann an cur i bhfeidhm réamhshocraithe True ar ais má tá an cead “athraigh” nó “féachaint” ag an úsáideoir.

\n
\n\n
\n
\nModelAdmin.has_add_permission(request)Link to this definition#
\n

Ba chóir True a thabhairt ar ais má cheadaítear réad a chur leis, False ar shlí eile.

\n
\n\n
\n
\nModelAdmin.has_change_permission(request, obj=None)Link to this definition#
\n

Ba chóir True a thabhairt ar ais má cheadaítear obj eagarthóireacht, False ar shlí eile. Má tá obj None, ba cheart True nó False` a thabhairt ar ais chun a léiriú an bhfuil ceadaithe eagarthóireacht rudaí den chineál seo i gcoitinne (m.sh., léirmhínítear False mar a chiallaíonn nach ceadaítear don úsáideoir reatha aon rud den chineál seo a chur in eagar).

\n
\n\n
\n
\nModelAdmin.has_delete_permission(request, obj=None)Link to this definition#
\n

Ba chóir True a thabhairt ar ais má cheadaítear obj a scriosadh, False ar shlí eile. Má tá obj None, ba cheart True nó False` a thabhairt ar ais chun a léiriú an gceadaítear rudaí den chineál seo a scriosadh go ginearálta (m.sh., léirmhínítear False mar a chiallaíonn nach ceadaítear don úsáideoir reatha aon rud den chineál seo a scriosadh).

\n
\n\n
\n
\nModelAdmin.has_module_permission(request)Link to this definition#
\n

Ba chóir go bhfilleadh True má cheadaítear an modúl a thaispeáint ar leathanach innéacs an riaracháin agus rochtain a fháil ar leathanach innéacs an mhodúil, False ar shlí eile. <django.contrib.auth.models.User.has_module_perms>Úsáid:Meth: User.has_module_perms () `de réir réamhshocraithe. Ní chuireann sé srian ar rochtain ar an radharc, cuir, athrú nó scriosadh radhairc, :meth: `~modeladmin.has_view_permission, :meth: ~modeladmin.has_add_permission, :meth: ~ModelAdmin.has_Change_Permission, agus:meth: ~ModelAdmin.has_delete_permission a úsáid chuige sin.

\n
\n\n
\n
\nModelAdmin.get_queryset(request)Link to this definition#
\n

Tugann an modh get_queryset` ar ModelAdmin` a: class: ~django.db.models.queryset de gach cás samhail is féidir leis an suíomh riaracháin a chur in eagar. Cás úsáide amháin chun an modh seo a shárú is ea rudaí atá faoi úinéireacht an úsáideora logáilte isteach a thaispeáint:

\n
Code
class MyModelAdmin(admin.ModelAdmin):\n    def get_queryset(self, request):\n        qs = super().get_queryset(request)\n        if request.user.is_superuser:\n            return qs\n        return qs.filter(author=request.user)\n
\n
\n\n
\n
\nModelAdmin.message_user(request, message, level=messages.INFO, extra_tags='', fail_silently=False)Link to this definition#
\n

Seolann sé teachtaireacht chuig an úsáideoir ag baint úsáide as an gcúltaca: mod: django.contrib.messages. <custom-admin-action>Féach an:ref: `sampla saincheaptha ModelAdmin `.

\n

Ligeann argóintí eochairfhocal duit leibhéal na teachtaireachta a athrú, clibeanna CSS breise a chur leis, nó teip go ciúin mura bhfuil an creat contrib.messages suiteáilte. Meaitseálann na hargóintí eochairfhocal seo leo siúd le haghaidh: func: django.contrib.messages.add_message, féach doiciméadú na feidhme sin le haghaidh tuilleadh sonraí. Difríocht amháin is ea go bhféadfar an leibhéal a rith mar lipéad teaghrán i dteannta le sláin/tairiseach.

\n
\n\n
\n
\nModelAdmin.get_paginator(request, queryset, per_page, orphans=0, allow_empty_first_page=True)Link to this definition#
\n

Tugann sé sampla den paginator ar ais le húsáid don radharc seo. De réir réamhshocraithe, cruthaíonn sé sampla de:attr: paginator.

\n
\n\n
\n
\nModelAdmin.response_add(request, obj, post_url_continue=None)Link to this definition#
\n

Cinneann sé an:class: ~django.http.httpResponse don chéime:meth: add_view.

\n

Glaofar response_add` tar éis an fhoirm riaracháin a chur isteach agus díreach tar éis an réad agus na cásanna gaolmhara go léir a chruthú agus a shábháil. Is féidir leat é a shárú chun an t-iompar réamhshocraithe a athrú tar éis an réad a chruthú.

\n
\n\n
\n
\nModelAdmin.response_change(request, obj)Link to this definition#
\n

Cinneann sé an:class: ~django.http.httpResponse don chéime:meth: change_view.

\n

Glaofar response_change` tar éis an fhoirm riaracháin a chur isteach agus díreach tar éis an réad agus na cásanna gaolmhara go léir a shábháil. Is féidir leat é a shárú chun an t-iompar réamhshocraithe a athrú tar éis an réad a athrú.

\n
\n\n
\n
\nModelAdmin.response_delete(request, obj_display, obj_id)Link to this definition#
\n

Cinneann sé an:class: ~django.http.httpResponse don chéime:meth: delete_view.

\n

Glaofar ar response_delete` tar éis an réad a scriosadh. Is féidir leat é a shárú chun an t-iompar réamhshocraithe a athrú tar éis an réad a scriosadh.

\n

Is teaghrán é obj_display le hainm an réad scriosta.

\n

Is é obj_id an t-aitheantóir sraitheach a úsáidtear chun an réad atá le scriosadh a aisghabháil.

\n
\n\n
\n
\nModelAdmin.get_formset_kwargs(request, obj, inline, prefix)Link to this definition#
\n

Crúca chun na hargóintí eochairfhocal a shaincheapadh chuig tógálaí foirmshraith. Mar shampla, chun iarrat a chur chuig foirmeacha foirmeacha:

\n
Code
class MyModelAdmin(admin.ModelAdmin):\n    def get_formset_kwargs(self, request, obj, inline, prefix):\n        return {\n            **super().get_formset_kwargs(request, obj, inline, prefix),\n            "form_kwargs": {"request": request},\n        }\n
\n

Is féidir leat é a úsáid freisin chun initial a shocrú d'fhoirmeacha foirmeacha.

\n
\n\n
\n
\nModelAdmin.get_changeform_initial_data(request)Link to this definition#
\n

Croca do na sonraí tosaigh ar fhoirmeacha athraithe riaracháin. De réir réamhshocraithe, tugtar luachanna tosaigh do réimsí ó pharaiméadair GET`. Mar shampla, ? name=initial_value socróidh luach tosaigh an réimse ainm mar luach_inicial.

\n

Ba chóir don modh seo foclóir a thabhairt ar ais sa fhoirm {'fieldname': 'fieldval'}:

\n
Code
def get_changeform_initial_data(self, request):\n    return {"name": "custom_initial_value"}\n
\n
\n\n
\n
\nModelAdmin.get_deleted_objects(objs, request)Link to this definition#
\n

<actions>Crúca chun an próiseas scriostha den: meth: delete_view agus an “scrios roghnaithe”: doc: `action `a shaincheapadh.

\n

Is é an argóint objs ``is athraitheach aonchineálach de rudaí (``QuerySet nó liosta cásanna samhail) atá le scriosadh, agus is é request an:class: ~django.http.httpRequest.

\n

Caithfidh an modh seo 4-tuple de (deleted_objects, model_count, perms_needed, protected) a thabhairt ar ais.

\n

Is liosta de na teaghráin is ea deleted_objects` a léiríonn na rudaí go léir a scriosfar. Má tá aon rudaí gaolmhara le scriosadh, tá an liosta neadaithe agus tá na rudaí gaolmhara sin san áireamh. Déantar an liosta a fhormáidiú sa teimpléad ag baint úsáide as an scagair:tfilter: unordered_list.

\n

Is foclóir é model_count mapáil gach samhail's:attr: ~django.db.models.options.verbose_name_plural ar líon na rudaí a scriosfar.

\n

Is é perms_needed sraith de:attr: ~django.db.models.options.verbose_names de na samhlacha nach bhfuil cead ag an úsáideoir a scriosadh.

\n

Is liosta de na teaghráin a léiríonn na rudaí gaolmhara cosanta go léir nach féidir iad a scriosadh. Taispeántar an liosta sa teimpléad.

\n
\n\n
\n

Modhanna eileLink to this heading#

\n
\n
\nModelAdmin.add_view(request, form_url='', extra_context=None)Link to this definition#
\n

Amharc Django don leathanach breise samhail samhail. Féach an nóta thíos.

\n
\n\n
\n
\nModelAdmin.change_view(request, object_id, form_url='', extra_context=None)Link to this definition#
\n

Amharc Django don leathanach eagarthóireachta sampla samhail. Féach an nóta thíos.

\n
\n\n
\n
\nModelAdmin.changelist_view(request, extra_context=None)Link to this definition#
\n

Amharc Django don leathanach athraithe cásanna samhail liosta/gníomhartha. Féach an nóta thíos.

\n
\n\n
\n
\nModelAdmin.delete_view(request, object_id, extra_context=None)Link to this definition#
\n

Amharc Django do leathanach dearbhaithe scriosadh samhail (í) samhail. Féach an nóta thíos.

\n
\n\n
\n
\nModelAdmin.history_view(request, object_id, extra_context=None)Link to this definition#
\n

Amharc Django don leathanach a thaispeánann stair an mhodhnaithe do shampla samhail ar leith.

\n
\n\n

Murab ionann agus na modhanna ModelAdmin de chineál haca a sonraíodh sa chuid roimhe seo, tá na cúig mhodh seo deartha i ndáiríre chun iad a ghairm mar thuairimí Django ó láimhseálaí seolta URL an fheidhmchláir riaracháin chun na leathanaigh a dhéileálann le cásanna samhail oibríochtaí CRUD a rinneadh. Mar thoradh air sin, athróidh na modhanna seo a shárú go hiomlán iompar an fheidhmchláir riaracháin go suntasach.

\n

Cúis choitianta amháin chun na modhanna seo a shárú is ea na sonraí comhthéacs a chuirtear ar fáil don teimpléad a léiríonn an dearcadh a mhéadú. Sa sampla seo a leanas, cuirtear an dearcadh athraithe a athrú ionas go gcuirtear roinnt sonraí mapála breise ar fáil don teimpléad rindreáilte nach mbeadh ar fáil ar shlí eile:

\n
Code
class MyModelAdmin(admin.ModelAdmin):\n    # A template for a very customized change view:\n    change_form_template = "admin/myapp/extras/openstreetmap_change_form.html"\n\n    def get_osm_info(self):\n        # ...\n        pass\n\n    def change_view(self, request, object_id, form_url="", extra_context=None):\n        extra_context = extra_context or {}\n        extra_context["osm_data"] = self.get_osm_info()\n        return super().change_view(\n            request,\n            object_id,\n            form_url,\n            extra_context=extra_context,\n        )\n
\n

Tugann na tuairimí seo ar ais: class: ~django.template.Response.TemplateResponse cásanna a ligeann duit na sonraí freagartha a shaincheapadh go héasca sula ndéantar iad a rindreáil. Le haghaidh tuilleadh sonraí, féach an:doc: `TemplateResponse doiciméadúcháin </ref/template-response>.

\n
\n
\n
\n

Sainmhínithe sócmhainní ModelAdminLink to this heading#

\n

Tá amanna ann nuair ba mhaith leat beagán CSS agus/nó JavaScript a chur leis na tuairimí a chur leis na tuairimí a chur leis /athraigh. Is féidir é seo a chur i gcrích trí rang istigh Meáin ``a úsáid ar do `ModelAdmin:

\n
Code
class ArticleAdmin(admin.ModelAdmin):\n    class Media:\n        css = {\n            "all": ["my_styles.css"],\n        }\n        js = ["my_code.js"]\n
\n

Tá an aip: doc: staticfiles `réasúnaí:socrú: `STATIC_URL (nó</ref/contrib/staticfiles> :socrú: MEDIA_URL más:socrú: STATIC_URL` ``None) le haon chosáin sócmhainní. <form-asset-paths>Tá na rialacha céanna i bhfeidhm as:ref: `sainmhínithe rialta sócmhainní ar fhoirmeacha `.

\n
\n

jQueryLink to this heading#

\n

Baineann JavaScript admin Django úsáid as an leabharlann `jQuery `_.

\n

Chun coinbhleachtaí a sheachaint le scripteanna nó leabharlanna a sholáthraíonn an úsáideoir, déantar jQuery Django (leagan 3.7.1) spás ainmneacha mar “Django.jQuery”. Más mian leat jQuery a úsáid i do JavaScript riaracháin féin gan an dara cóip a áireamh, is féidir leat an réad Django.jQuery ``a úsáid ar changelist agus tuairimí a chur leis /eagar. <assets-as-a-static-definition>Chomh maith leis sin, ní mór d'fhoirmeacha nó giuirléidí riaracháin féin ag brath ar ``django.jQuery ``js= ['admin/js/jquery.init.js',...] ``a shonrú nuai:ref: `sócmhainní meán foirm a dhearbhú `.

\n

Éilíonn an rang:Class: ModelAdmin jQuery de réir réamhshocraithe, mar sin ní gá jQuery a chur le liosta d'acmhainní meán ``ModelAdmin` mura bhfuil riachtanas sonrach agat. Mar shampla, má theastaíonn uait go mbeidh leabharlann jQuery sa spás ainmneacha domhanda (mar shampla agus breiseáin jQuery tríú páirtí á úsáid agat) nó má theastaíonn leagan níos nuaí de jQuery uait, beidh ort do chóip féin a chur san áireamh.

\n

Soláthraíonn Django leaganacha neamhchomhbhrúite agus 'minified' de jQuery araon, mar jquery.js ``agus ``jquery.min.js faoi seach.

\n

ModelAdmin and InlineModelAdmin have a media property\nthat returns a list of Media objects which store paths to the JavaScript\nfiles for the forms and/or formsets. If DEBUG is True it will\nreturn the uncompressed versions of the various JavaScript files, including\njquery.js; if not, it will return the 'minified' versions.

\n
\n
\n
\n

Bailíochtú saincheaptha a chur leis an riarachánLink to this heading#

\n

Is féidir leat bailíochtú saincheaptha sonraí a chur leis sa riarachán freisin. Athúsáideann an comhéadan riaracháin uathoibrí:mod: django.forms, agus tugann an rang ModelAdmin an cumas duit d'fhoirm féin a shainiú:

\n
Code
class ArticleAdmin(admin.ModelAdmin):\n    form = MyArticleAdminForm\n
\n

Is féidir MyArticleAdminform` a shainiú áit ar bith chomh fada agus a iompórtáil tú nuair is gá. Anois laistigh de d'fhoirm is féidir leat do bhailíochtú saincheaptha féin a chur le haghaidh aon réimse:

\n
Code
class MyArticleAdminForm(forms.ModelForm):\n    def clean_name(self):\n        # do something that validates your data\n        return self.cleaned_data["name"]\n
\n

Tá sé tábhachtach go n-úsáideann tú ``Modelform` anseo ar shlí eile is féidir rudaí briseadh. </ref/forms/index> </ref/forms/validation> <overriding-modelform-clean-method>Féach doiciméadú:doc: foirme ar:doc: `bailíochtú saincheapaithe' agus, níos sonrach, na:ref: `nótaí bailíochtaithe foirm samhail `le haghaidh tuilleadh faisnéise.

\n
\n
\n
\n

InlineModelAdmin rudaíLink to this heading#

\n
\n
\nclass InlineModelAdminLink to this definition#
\n
\n\n
\n
\nclass TabularInlineLink to this definition#
\n
\n\n
\n
\nclass StackedInlineLink to this definition#
\n

Tá sé de chumas ag an gcomhéadan riaracháin samhlacha a chur in eagar ar an leathanach céanna le samhail tuismitheora. Tugtar inlines orthu seo. Cuir i gcás go bhfuil an dá mhúnla seo agat:

\n
Code
from django.db import models\n\n\nclass Author(models.Model):\n    name = models.CharField(max_length=100)\n\n\nclass Book(models.Model):\n    author = models.ForeignKey(Author, on_delete=models.CASCADE)\n    title = models.CharField(max_length=100)\n
\n

Is féidir leat na leabhair a d'údar údar a chur in eagar ar leathanach an údair. Cuireann tú inlines le samhail trí iad a shonrú i ModelAdmin.inlines:

\n
Code
from django.contrib import admin\nfrom myapp.models import Author, Book\n\n\nclass BookInline(admin.TabularInline):\n    model = Book\n\n\nclass AuthorAdmin(admin.ModelAdmin):\n    inlines = [\n        BookInline,\n    ]\n\n\nadmin.site.register(Author, AuthorAdmin)\n
\n

Soláthraíonn Django dhá fho-aicme de InlineModelAdmin agus is iad seo:

\n\n

Níl an difríocht idir an dá cheann seo ach an teimpléad a úsáidtear chun iad a léiriú.

\n
\n\n
\n

Roghanna InlineModelAdminLink to this heading#

\n

Roinneann InlineModelAdmin go leor de na gnéithe céanna le ModelAdmin, agus cuireann sé cuid dá chuid féin leis (sainmhínítear na gnéithe roinnte i ndáiríre sa sáraicme BaseModelAdmin). Is iad na gnéithe roinnte:

\n\n

Cuireann an rang InlineModelAdmin leis nó a shaincheapadh:

\n
\n
\nInlineModelAdmin.modelLink to this definition#
\n

An tsamhail atá ag baint úsáide as an inlíne. Tá sé seo ag teastáil.

\n
\n\n
\n
\nInlineModelAdmin.fk_nameLink to this definition#
\n

Ainm an eochair eachtrach ar an tsamhail. I bhformhór na gcásanna déileálfar leis seo go huathoibríoch, ach caithfear fk_name a shonrú go sainráite má tá níos mó ná eochair eachtrach amháin ann don tsamhail thuismitheora céanna.

\n
\n\n
\n
\nInlineModelAdmin.formsetLink to this definition#
\n

Tá sé seo réamhshocraithe chuig: aicme: ~django.forms.models.baseinlineFormSet. Is féidir go leor féidearthachtaí saincheaptha a thabhairt duit a úsáid do shraith foirme féin. <model-formsets>Tógtar inlínte timpeall: ref: `model formsets `.

\n
\n\n
\n
\nInlineModelAdmin.formLink to this definition#
\n

Tá an luach do foirm ``réamhshocraithe go ``ModelForm`. Seo an rud a chuirtear trí:func: ~django.forms.models.inlineformset_factory agus an foirmset á chruthú don inlíne seo.

\n
\n\n\n
\n
\nInlineModelAdmin.classesLink to this definition#
\n

Liosta nó tuple ina bhfuil ranganna breise CSS le cur i bhfeidhm ar an tacar réimse a rinneadh do na línte inlíne. Réamhshocraithe go None. Mar is amhlaidh le ranganna atá cumraithe in:attr: ~ModelAdmin.FieldSets, titeofar inlínte le rang ``collise` i dtosach ag baint úsáide as giuirléid leathnaithe.

\n\n
\n\n
\n
\nInlineModelAdmin.extraLink to this definition#
\n

Rialaíonn sé seo líon na bhfoirmeacha breise a thaispeánfaidh an tacar foirme chomh maith leis na foirmeacha tosaigh. Réamhshocraithe go 3. Féach na:doc: formsets doiciméadach le haghaidh tuilleadh eolais. </topics/forms/formsets>

\n

Maidir le húsáideoirí a bhfuil brabhsálaithe cumasaithe ag JavaScript acu, cuirtear nasc “Cuir eile leis” ar fáil chun aon líon inlíne breise a chur leis i dteannta leo siúd a chuirtear ar fáil mar thoradh ar an argóint breise.

\n

Ní bheidh an nasc dinimiciúil le feiceáil má sháraíonn líon na bhfoirmeacha atá ar taispeáint faoi láthair max_num, nó mura bhfuil JavaScript cumasaithe ag an úsáideoir.

\n

InlineModelAdmin.get_extra() also allows you to customize the number\nof extra forms.

\n
\n\n
\n
\nInlineModelAdmin.max_numLink to this definition#
\n

Rialaíonn sé seo an líon uasta na bhfoirmeacha atá le taispeáint san inlíne. Ní bhaineann sé seo go díreach le líon na rudaí, ach is féidir má tá an luach beag go leor. Féach: ref: model-formsets-max-num le haghaidh tuilleadh faisnéise.

\n

InlineModelAdmin.get_max_num() also allows you to customize the\nmaximum number of extra forms.

\n
\n\n
\n
\nInlineModelAdmin.min_numLink to this definition#
\n

Rialaíonn sé seo an líon íosta foirmeacha atá le taispeáint san inlíne. Féach: func: ~django.forms.models.modelformset_factory le haghaidh tuilleadh faisnéise.

\n

InlineModelAdmin.get_min_num() also allows you to customize the\nminimum number of displayed forms.

\n
\n\n
\n
\nInlineModelAdmin.raw_id_fieldsLink to this definition#
\n

De réir réamhshocraithe, úsáideann riarachán Django comhéadan bosca roghnaithe (<select>) do réimsí atá ForeignKey`. Uaireanta níl tú ag iarraidh an lasbhreas a thabhairt faoi na cásanna gaolmhara go léir a roghnú le taispeáint sa anuas anuas.

\n

Is liosta réimsí é raw_id_fields ar mhaith leat a athrú go giuirléid Input le haghaidh ForeignKey` nó ManyTomanyField:

\n
Code
class BookInline(admin.TabularInline):\n    model = Book\n    raw_id_fields = ["pages"]\n
\n
\n\n
\n
\nInlineModelAdmin.templateLink to this definition#
\n

An teimpléad a úsáidtear chun an líne a léiriú ar an leathanach.

\n
\n\n
\n
\nInlineModelAdmin.verbose_nameLink to this definition#
\n

Athrú chuig an:attr: ~django.db.models.options.verbose_name ó rang Meta` istigh an tsamhail.

\n
\n\n
\n
\nInlineModelAdmin.verbose_name_pluralLink to this definition#
\n

Athrú chuig an: attr: ~django.db.models.options.verbose_name_plural ó rang Meta` istigh an tsamhail. Mura dtugtar é seo agus mura sainmhínítear an:attr: .inlineModelAdmin.verbose_name, úsáidfidh Django:attr: .inlineModelAdmin.verbose_name + 's'.

\n
\n\n
\n
\nInlineModelAdmin.can_deleteLink to this definition#
\n

Sonraíonn sé cibé an féidir rudaí inlíne a scriosadh sa líne nó nach bhfuil. Réamhshocraithe go True.

\n
\n\n
\n
\nInlineModelAdmin.show_change_linkLink to this definition#
\n

Sonraíonn sé an bhfuil nasc leis an bhfoirm athraithe ag rudaí inlíne is féidir a athrú sa riarachán nó nach bhfuil. Réamhshocraithe go False.

\n
\n\n
\n
\nInlineModelAdmin.get_formset(request, obj=None, **kwargs)Link to this definition#
\n

Tuairisceáin a:class: ~Django.Forms.Models.BaseinlineFormSet rang le húsáid i riarachán tuairimí a chur leis /athraigh. Is é obj an tuismitheoir réad atá á chur in eagar nó ``None ``nuair a chuirtear tuismitheoir nua leis. Féach an sampla le haghaidh: class: ModelAdmin.get_formSets_with_inlines.

\n
\n\n
\n
\nInlineModelAdmin.get_extra(request, obj=None, **kwargs)Link to this definition#
\n

Tugann sé líon na bhfoirmeacha inlíne breise atá le húsáid ar ais. De réir réamhshocraithe, filleann an tréith: attr: InlineModelAdmin.extra.

\n

Athraigh an modh seo chun líon na bhfoirmeacha inlíne breise a chinneadh go cláraitheach. Mar shampla, d'fhéadfadh sé seo a bheith bunaithe ar an samhail samhail (a rith mar an argóint eochairfhocal ``obj ``):

\n
Code
class BinaryTreeAdmin(admin.TabularInline):\n    model = BinaryTree\n\n    def get_extra(self, request, obj=None, **kwargs):\n        extra = 2\n        if obj:\n            return extra - obj.binarytree_set.count()\n        return extra\n
\n
\n\n
\n
\nInlineModelAdmin.get_max_num(request, obj=None, **kwargs)Link to this definition#
\n

Tugann sé an líon uasta na bhfoirmeacha inlíne breise le húsáid ar ais. De réir réamhshocraithe, filleann an tréith: attr: inlineModelAdmin.max_num.

\n

Athraigh an modh seo chun líon uasta na bhfoirmeacha inlíne a chinneadh go cláraitheach. Mar shampla, d'fhéadfadh sé seo a bheith bunaithe ar an samhail samhail (a rith mar an argóint eochairfhocal ``obj ``):

\n
Code
class BinaryTreeAdmin(admin.TabularInline):\n    model = BinaryTree\n\n    def get_max_num(self, request, obj=None, **kwargs):\n        max_num = 10\n        if obj and obj.parent:\n            return max_num - 5\n        return max_num\n
\n
\n\n
\n
\nInlineModelAdmin.get_min_num(request, obj=None, **kwargs)Link to this definition#
\n

Tugann sé an líon íosta foirmeacha inlíne atá le húsáid ar ais. De réir réamhshocraithe, filleann an tréith: attr: inlineModelAdmin.min_num.

\n

Athraigh an modh seo chun líon íosta na bhfoirmeacha inlíne a chinneadh go cláraithe. Mar shampla, d'fhéadfadh sé seo a bheith bunaithe ar an samhail samhail (a rith mar an argóint eochairfhocal ``obj ``).

\n
\n\n
\n
\nInlineModelAdmin.has_add_permission(request, obj)Link to this definition#
\n

Ba chóir go bhfilleadh True má cheadaítear réad inlíne a chur leis, False ar shlí eile. Is é obj an tuismitheoir réad atá á chur in eagar nó ``None ``nuair a chuirtear tuismitheoir nua leis.

\n
\n\n
\n
\nInlineModelAdmin.has_change_permission(request, obj=None)Link to this definition#
\n

Ba chóir go bhfaighidh True a thabhairt ar ais má cheadaítear réad inlíne a chur in eagar, False ar shlí eile. Is é obj an tuismitheoir réad atá á chur in eagar.

\n
\n\n
\n
\nInlineModelAdmin.has_delete_permission(request, obj=None)Link to this definition#
\n

Ba chóir go bhfilleadh True má cheadaítear réad inlíne a scriosadh, False ar shlí eile. Is é obj an tuismitheoir réad atá á chur in eagar.

\n
\n\n\n
\n
\n

Ag obair le samhail le dhá eochracha eachtracha nó níos mó don tsamhail thuismitheora céannaLink to this heading#

\n

Uaireanta is féidir níos mó ná eochair eachtrach amháin a bheith agat don tsamhail chéanna. Tóg an tsamhail seo mar shampla:

\n
Code
from django.db import models\n\n\nclass Person(models.Model):\n    name = models.CharField(max_length=128)\n\n\nclass Friendship(models.Model):\n    to_person = models.ForeignKey(\n        Person, on_delete=models.CASCADE, related_name="friends"\n    )\n    from_person = models.ForeignKey(\n        Person, on_delete=models.CASCADE, related_name="from_friends"\n    )\n
\n

Más mian leat inlíne a thaispeáint ar na leathanaigh riaracháin ``Duine ``a chur leis /athraigh ní mór duit an eochair eachtrach a shainiú go sainráite ós rud é nach féidir leis sin a dhéanamh go huathoibríoch:

\n
Code
from django.contrib import admin\nfrom myapp.models import Friendship, Person\n\n\nclass FriendshipInline(admin.TabularInline):\n    model = Friendship\n    fk_name = "to_person"\n\n\nclass PersonAdmin(admin.ModelAdmin):\n    inlines = [\n        FriendshipInline,\n    ]\n\n\nadmin.site.register(Person, PersonAdmin)\n
\n
\n
\n

Ag obair le go leor samhlachaLink to this heading#

\n

De réir réamhshocraithe, taispeánfar giuirléidí riaracháin le haghaidh caidrimh go leor ar cibé múnla ina bhfuil an tagairt iarbhír don: class: ~django.db.models.manyToManyField. Ag brath ar do shainmhíniú ModelAdmin`, beidh gach réimse go leor i do mhúnla ionadaíocht le HTML ``, caighdeánach, scagaire cothrománach nó ingearach, nó giuirléid raw_id_fields <select multiple>. Mar sin féin, is féidir inlíne a chur in ionad na giuirléidí seo.

\n

Cuir i gcás go bhfuil na samhlacha seo a leanas againn:

\n
Code
from django.db import models\n\n\nclass Person(models.Model):\n    name = models.CharField(max_length=128)\n\n\nclass Group(models.Model):\n    name = models.CharField(max_length=128)\n    members = models.ManyToManyField(Person, related_name="groups")\n
\n

Más mian leat caidreamh go leor a thaispeáint ag baint úsáide as inlíne, is féidir leat é sin a dhéanamh trí réad inlineModelAdmin a shainiú don chaidreamh:

\n
Code
from django.contrib import admin\nfrom myapp.models import Group\n\n\nclass MembershipInline(admin.TabularInline):\n    model = Group.members.through\n\n\nclass GroupAdmin(admin.ModelAdmin):\n    inlines = [\n        MembershipInline,\n    ]\n    exclude = ["members"]\n\n\nadmin.site.register(Group, GroupAdmin)\n
\n

Tá dhá ghné is fiú a thabhairt faoi deara sa sampla seo.

\n

Ar dtús - tagairtí aicme MembershipInline ``Group.Members.Through ``. Is tagairt é an tréith ``trí ``don tsamhail a bhainistíonn an gaol go leor. Cruthaíonn Django an tsamhail seo go huathoibríoch nuair a shainmhíníonn tú réimse go leor.

\n

Ar an dara dul síos, ní mór don Groupadmin` an réimse ``baill ``a eisiamh de láimh. Taispeánann Django giuirléid riaracháin do réimse go leor ar an tsamhail a shainmhíníonn an gaol (sa chás seo, ``Grúpa ``). Más mian leat samhail inlíne a úsáid chun an caidreamh go leor a léiriú, ní mór duit a rá le riarachán Django ná* an giuirléid seo a thaispeáint - ar shlí eile beidh dhá ghuirléid agat ar do leathanach riaracháin chun an gaol a bhainistiú.

\n

Tabhair faoi deara nach spreagtar na comharthaí: data: ~django.db.models.signals.m2m_changed nuair a úsáidtear an teicníc seo. Tá sé seo toisc nach bhfuil ach samhail le dhá phríomhréimse eachtracha eachtrach seachas caidreamh go leor le go leor.

\n

Ar gach bealach eile, tá an InlineModelAdmin` díreach mar an gcéanna le haon cheann eile. Is féidir leat an cuma a shaincheapadh ag baint úsáide as aon cheann de na gnáthairíonna ``ModelAdmin`.

\n
\n
\n

Ag obair le samhlacha idirghabhála go leorLink to this heading#

\n

Nuair a shonraíonn tú samhail idirghabhála ag baint úsáide as an argóint ``through ``chuig a:class: ~django.db.models.manyToManyField, ní thaispeánfaidh an riarachán giuirléid de réir réamhshocraithe. Tá sé seo toisc go dteastaíonn níos mó faisnéise ó gach cás den tsamhail idirghabhálaí sin ná mar a d'fhéadfaí a thaispeáint i ngiuirléid amháin, agus beidh an leagan amach a theastaíonn le haghaidh giuirléidí iolracha

\n

Mar sin féin, ba mhaith linn fós a bheith in ann an fhaisnéis sin a chur in eagar inlíne. Ar ámharaí an tsaoil, is féidir linn é seo a dhéanamh le samhlacha riaracháin inlíne. Cuir i gcás go bhfuil na samhlacha seo a leanas againn:

\n
Code
from django.db import models\n\n\nclass Person(models.Model):\n    name = models.CharField(max_length=128)\n\n\nclass Group(models.Model):\n    name = models.CharField(max_length=128)\n    members = models.ManyToManyField(Person, through="Membership")\n\n\nclass Membership(models.Model):\n    person = models.ForeignKey(Person, on_delete=models.CASCADE)\n    group = models.ForeignKey(Group, on_delete=models.CASCADE)\n    date_joined = models.DateField()\n    invite_reason = models.CharField(max_length=64)\n\n    class Meta:\n        constraints = [\n            models.UniqueConstraint(\n                fields=["person", "group"], name="unique_person_group"\n            )\n        ]\n
\n

Is é an chéad chéim chun an tsamhail idirmheánach seo a thaispeáint sa riarachán ná rang inlíne a shainiú don tsamhail ``Ballraíocht ``:

\n
Code
class MembershipInline(admin.TabularInline):\n    model = Membership\n    extra = 1\n
\n

Úsáideann an sampla seo na luachanna réamhshocraithe InlineModelAdmin don tsamhail ``Ballraíocht ``, agus cuireann sé teorainn leis na foirmeacha breise le ceann amháin. D'fhéadfaí é seo a shaincheapadh ag baint úsáide as aon cheann de na roghanna atá ar fáil do ranganna ``InlineModelAdmin`.

\n

Anois cruthaigh tuairimí riaracháin do na samhlacha Person agus Grúpa:

\n
Code
class PersonAdmin(admin.ModelAdmin):\n    inlines = [MembershipInline]\n\n\nclass GroupAdmin(admin.ModelAdmin):\n    inlines = [MembershipInline]\n
\n

Faoi dheireadh, cláraigh do mhúnlaí Person` agus ``Grúpa leis an suíomh riaracháin:

\n
Code
admin.site.register(Person, PersonAdmin)\nadmin.site.register(Group, GroupAdmin)\n
\n

Anois tá do shuíomh riaracháin bunaithe chun rudaí Ballraíocht ``a chur in eagar inlíne ó na leathanaigh sonraí ``Duine nó Grúpa`.

\n
\n
\n

Ag baint úsáide as caidreamh cineálach mar inlíneLink to this heading#

\n

Is féidir inlíne a úsáid le rudaí a bhaineann go ginearálta. Abair go bhfuil na samhlacha seo a leanas agat:

\n
Code
from django.contrib.contenttypes.fields import GenericForeignKey\nfrom django.contrib.contenttypes.models import ContentType\nfrom django.db import models\n\n\nclass Image(models.Model):\n    image = models.ImageField(upload_to="images")\n    content_type = models.ForeignKey(ContentType, on_delete=models.CASCADE)\n    object_id = models.PositiveIntegerField()\n    content_object = GenericForeignKey("content_type", "object_id")\n\n\nclass Product(models.Model):\n    name = models.CharField(max_length=100)\n
\n

Más mian leat eagarthóireacht agus cruthú sampla Image ar an Product` a cheadú, cuirte/athraigh tuairimí is féidir leat a úsáid:class: ~django.contrib.contentTypes.admin.GenericTabularInline nó:class: ~django.contrib.contentTypes.admin.GenericStackedInline (dá fho-aicme de:class: Django.Contrib.ContentTypes.Admin.GenericStackedInline Jango.Contrib.ContentTypes.Admin.GenericInlineModelAdmin`) arna sholáthar ar:mod: ~django.contrib.contenttypes.admin. Cuireann siad leagan amach amhairc táblaíocha agus cruachta i bhfeidhm do na foirmeacha a léiríonn na rudaí inlíne, faoi seach, díreach cosúil lena gcomhghleacaithe neamh Iompraíonn siad díreach cosúil le haon inlíne eile. I do admin.py` don aip sampla seo:

\n
Code
from django.contrib import admin\nfrom django.contrib.contenttypes.admin import GenericTabularInline\n\nfrom myapp.models import Image, Product\n\n\nclass ImageInline(GenericTabularInline):\n    model = Image\n\n\nclass ProductAdmin(admin.ModelAdmin):\n    inlines = [\n        ImageInline,\n    ]\n\n\nadmin.site.register(Product, ProductAdmin)\n
\n

Féach na:doc: contenttypes doiciméadach le haghaidh faisnéise níos sainiúla. </ref/contrib/contenttypes>

\n
\n
\n
\n

Teimpléid riaracháin forchoitiantaLink to this heading#

\n

Is féidir leat go leor de na teimpléid a úsáideann an modúl riaracháin chun leathanaigh éagsúla suíomh riaracháin a ghiniúint a shárú. Is féidir leat fiú cúpla ceann de na teimpléid seo a shárú le haghaidh aip ar leith, nó samhail ar leith.

\n
\n

Cuir eolairí teimpléad riaracháin do thionscLink to this heading#

\n

Tá na comhaid teimpléad riaracháin suite san eolaire: :source: django/contrib/admin/templates/admin.

\n

D'fhonn ceann amháin nó níos mó díobh a shárú, cruthaigh eolaire admin ``ar dtús in eolaire ``teimpléad do thionscadail. Is féidir é seo a bheith ar aon cheann de na heolairí a shonraigh tú sa roghna:setting: DIRS <TEMPLATES-DIRS>`den chúlcheann ``DjangoTemplates` sa socrúit:setting: TEMPLATES. Má tá an rogha ``'loaders'` shaincheaptha agat, bí cinnte go bhfuil ``django.template.loaders.filesystem.loader'` le feiceáil roimh ``django.template.loaders.app_directories.loader' ionas go bhfaighidh an córas luchtaithe teimpléid do theimpléid saincheaptha roimh iad siúd atá san áireamh la:mod: django.contrier' b.riarachán.

\n

Laistigh den eolaire ``admin ``seo, cruthaigh fo-eolairí ainmnithe i ndiaidh d'aip. Laistigh de na foeolairí aip seo cruthaigh fo-eolairí ainmnithe i ndiaidh Tabhair faoi deara, go ndéanfaidh an aip riaracháin ainm an tsamhail beaga agus tú ag lorg an eolaire, mar sin déan cinnte go n-ainmníonn tú an eolaire i ngach líon beag má tá tú chun d'aip a reáchtáil ar chóras comhaid cás-íogair.

\n

Chun teimpléad riaracháin d'aip ar leith a shárú, cóipeáil agus cuir in eagar an teimpléad ón eolair:source: django/contrib/admin/templates/admin, agus sábháil é i gceann de na heolairí a chruthaigh tú díreach.

\n

Mar shampla, dá mba mhaith linn uirlis a chur leis an amharc liosta athraithe do na samhlacha go léir in aip darb ainm my_app, chóipeáil contrib/admin/templates/admin/change_list.html chuig eolaire templates/admin/my_app/ dár dtionscadal, agus déanfaimis aon athruithe riachtanacha.

\n

Dá dteastaíonn uirlis a chur leis an amharc liosta athraithe amháin le haghaidh samhail shonrach darb ainm 'Page', déanfaimis an comhad céanna sin a chóipeáil chuig eolaire templates/admin/my_app/page dár dtionscadal.

\n
\n
\n

Teimpléad riaracháin a athsholáthar vs. athsholátharLink to this heading#

\n

Mar gheall ar dhearadh modúlach na teimpléid riaracháin, de ghnáth ní gá ná moltar teimpléad iomlán a athsholáthar. Is fearr beagnach i gcónaí ach an chuid den teimpléad a chaithfidh tú a athrú a shárú.

\n

Chun leanúint leis an sampla thuas, ba mhaith linn nasc nua a chur leis in aice leis an uirlis Stair ``don tsamhail ``Leathanach. Tar éis féachaint ar change_form.html socraímid nach gá dúinn ach an bloc object-tools-items ``a shárú. Dá bhrí sin seo ár ``change_form.html` nua:

\n
Django template
{% extends "admin/change_form.html" %}\n{% load i18n admin_urls %}\n{% block object-tools-items %}\n    <li>\n        <a href="{% url opts|admin_urlname:'history' original.pk|admin_urlquote %}" class="historylink">{% translate "History" %}</a>\n    </li>\n    <li>\n        <a href="mylink/" class="historylink">My Link</a>\n    </li>\n    {% if has_absolute_url %}\n        <li>\n            <a href="{% url 'admin:view_on_site' content_type_id original.pk %}" class="viewsitelink">{% translate "View on site" %}</a>\n        </li>\n    {% endif %}\n{% endblock %}\n
\n

Agus sin é! Dá gcuirfimid an comhad seo san eolaire templates/admin/my_app, bheadh ár nasc le feiceáil ar an bhfoirm athraithe do gach samhail laistigh de my_app.

\n
\n
\n

Teimpléid a d'fhéadfaí a shárú in aghaidh an aip nó an tsamhailLink to this heading#

\n

Ní féidir gach teimpléad i `contrib/admin/templates/admin ``a shárú in aghaidh an aip nó in aghaidh an tsamhail. Is féidir leis an méid seo a leanas:

\n\n

Maidir leis na teimpléid sin nach féidir iad a shárú ar an mbealach seo, féadfaidh tú iad a shárú do do thionscadal iomlán tríd an leagan nua a chur i d'eolaire ``teimpléad/admin ``. Tá sé seo úsáideach go háirithe chun leathanach saincheaptha 404 agus 500 a chruthú.

\n\n
\n
\n

Teimpléid fréamh agus logála isteachLink to this heading#

\n

Más mian leat na teimpléid innéacs, logáil isteach nó logáil amach a athrú, is fearr duit do shampla Adminsite féin a chruthú (féach thíos), agus airíonna: attr: Adminsite.index_Template, :attr: Adminsite.login_Template nó: attr: Adminsite.logout_Template a athrú.

\n
\n
\n
\n

Tacaíocht téamaíLink to this heading#

\n

Úsáideann an riarachán athróga CSS chun dathanna agus clónna a shainiú. Ligeann sé seo téamaí a athrú gan go leor rialacha CSS aonair a shárú. Mar shampla, más fearr leat corcra in ionad gorm d'fhéadfá teimpléad admin/base.html a chur le do thionscadal:

\n
Django template
{% extends 'admin/base.html' %}\n\n{% block extrastyle %}{{ block.super }}\n<style>\nhtml[data-theme="light"], :root {\n  --primary: #9774d5;\n  --secondary: #785cab;\n  --link-fg: #7c449b;\n  --link-selected-fg: #8f5bb2;\n}\n</style>\n{% endblock %}\n
\n

Sainmhínítear liosta na n-athróg CSS ag:source: django/contrib/admin/static/admin/css/base.css.

\n

Sainmhínítear athróga mód dorcha, ag meas an cheist meán prefers-color-scheme, a:source: django/contrib/admin/static/admin/css/dark_mode.css. Tá sé seo nasctha leis an doiciméad i ``{% block dark-mode-vars%} `.

\n
\n
\n

extrabody blockLink to this heading#

\n\n

You can add custom HTML, JavaScript, or other content to appear just before the\nclosing </body> tag of templates that extend admin/base.html by\nextending the extrabody block. For example, if you want an alert to appear\non page load you could add a admin/base.html template override to your\nproject:

\n
Django template
{% extends 'admin/base.html' %}\n\n{% block extrabody %}\n    {{ block.super }}\n    <script>\n        document.addEventListener('DOMContentLoaded', function() {\n            window.alert('Welcome!');\n        });\n    </script>\n{% endblock extrabody %}\n
\n
\n
\n

rudaí Admin SiteLink to this heading#

\n
\n
\nclass AdminSite(name='admin')Link to this definition#
\n

Léirítear suíomh riaracháin Django le sampla de django.contrib.admin.sites.adminSite; de réir réamhshocraithe, cruthaítear sampla den rang seo mar django.contrib.admin.site agus is féidir leat do mhúnlaí agus cásanna ``ModelAdmin` a chlárú leis.

\n

<overriding-default-admin-site>Más mian leat an suíomh riaracháin réamhshocraithe a shaincheapadh, is féidir leat: ref: `é a shárú `.

\n

Agus sampla de ``Adminsite' á thógáil agat, is féidir leat ainm sampla uathúil a sholáthar ag baint úsáide as an argóint ``ainm ``don tógálaí. <admin-reverse-urls>Úsáidtear an t-ainm sampla seo chun an cás a aithint, go háirithe nuair:ref: URLanna riaracháin a aisiompú `. Mura gcuirtear aon ainm sampla ar fáil, úsáidfear ainm sampla réamhshocraithe de ``admin `. Féach: ref: customizing-adminsite le haghaidh sampla den aicme: class: adminSite a shaincheapadh.

\n
\n\n
\n
\ndjango.contrib.admin.sites.all_sitesLink to this definition#
\n

A: Class: ~ WeakRef.WeakSet tá gach cás láithreáin riaracháin.

\n
\n\n
\n

AdminSite tréitheLink to this heading#

\n

Is féidir le teimpléid teimpléid riaracháin bonn a shárú nó a leathnú mar a thuairiscítear in:ref: admin-overriding-temples.

\n
\n
\nAdminSite.site_headerLink to this definition#
\n

An téacs le cur ag barr gach leathanach riaracháin, mar <div> (teaghrán). De réir réamhshocraithe, is é seo “riarachán Django”.

\n
\n\n
\n
\nAdminSite.site_titleLink to this definition#
\n

An téacs le cur ag deireadh gach leathanach riaracháin <title>```(teaghrán). De réir réamhshocraithe, is é seo “Riarachán láithreáin Django”.

\n
\n\n
\n
\nAdminSite.site_urlLink to this definition#
\n

An URL don nasc “Féach ar an suíomh” ag barr gach leathanach riaracháin. De réir réamhshocraithe, is é site_url ``/``. Socraigh é go ``None ``chun an nasc a bhaint.

\n

Maidir le suíomhanna atá ag rith ar fho-chosán, seiceálann an modh:meth: each_context an bhfuil request.meta ['SCRIPT_NAME'] ``socraithe sa iarraidh reatha agus úsáideann sé an luach sin mura bhfuil ``site_url` socraithe ar rud éigin seachas /.

\n
\n\n
\n
\nAdminSite.index_titleLink to this definition#
\n

An téacs le cur ag barr an leathanaigh innéacs riaracháin (sreang). De réir réamhshocraithe, is é seo “Riarachán láithreáin”.

\n
\n\n
\n
\nAdminSite.index_templateLink to this definition#
\n

Conair chuig teimpléad saincheaptha a úsáidfidh príomh-amharc innéacs an láithreáin riaracháin.

\n
\n\n
\n
\nAdminSite.app_index_templateLink to this definition#
\n

Conair chuig teimpléad saincheaptha a úsáidfidh amharc innéacs aip an láithreáin riaracháin.

\n
\n\n
\n
\nAdminSite.empty_value_displayLink to this definition#
\n

An teaghrán le húsáid chun luachanna folmha a thaispeáint i liosta athraithe an láithreáin riaracháin. Réamhshocraithe go sraitheanna. Is féidir an luach a shárú freisin ar bhonn ModelAdmin agus ar réimse saincheaptha laistigh de ModelAdmin trí thréith empty_value_display a shocrú ar an réimse. Féach: attr: ModelAdmin.empty_value_display le haghaidh samplaí.

\n
\n\n
\n
\nAdminSite.enable_nav_sidebarLink to this definition#
\n

Luach boolean a chinneann an dtaispeánfar an barra taobh nascleanúna ar scáileáin níos mó. De réir réamhshocraithe, tá sé socraithe go True.

\n
\n\n
\n
\nAdminSite.final_catch_all_viewLink to this definition#
\n

Luach boolean a chinneann an gcuirfear dearcadh deiridh catch-all a chur leis an riarachán a atreoraíonn úsáideoirí neamhfhíordheimhnithe chuig an leathanach logála isteach. De réir réamhshocraithe, tá sé socraithe go True.

\n\n
\n\n
\n
\nAdminSite.login_templateLink to this definition#
\n

Conair chuig teimpléad saincheaptha a úsáidfidh amharc logála isteach an láithreáin riaracháin.

\n
\n\n
\n
\nAdminSite.login_formLink to this definition#
\n

Fo-aicme de:class: ~django.contrib.auth.forms.AuthenticationForm a úsáidfidh amharc logála isteach an láithreáin riaracháin.

\n
\n\n
\n
\nAdminSite.logout_templateLink to this definition#
\n

Conair chuig teimpléad saincheaptha a úsáidfidh amharc logáil amach an láithreáin riaracháin.

\n
\n\n
\n
\nAdminSite.password_change_templateLink to this definition#
\n

Conair chuig teimpléad saincheaptha a úsáidfidh amharc athraithe pasfhocal an láithreáin riaracháin.

\n
\n\n
\n
\nAdminSite.password_change_done_templateLink to this definition#
\n

Conair chuig teimpléad saincheaptha a úsáidfidh athrú pasfhocal an láithreáin riaracháin amharc déanta.

\n
\n\n
\n
\n

Modhanna AdminsiteLink to this heading#

\n
\n
\nAdminSite.each_context(request)Link to this definition#
\n

Tugann foclóir athróg ar ais le cur i gcomhthéacs an teimpléid do gach leathanach ar an suíomh riaracháin.

\n

Cuimsíonn sé na hathróga agus na luachanna seo a leanas de réir

\n
    \n

  • site_header: :attr: Adminsite.site_header

    • \n

  • site_title: :attr: Adminsite.site_title

    • \n

  • site_url: :attr: Adminsite.site_url

    • \n

  • has_ceadúna: :meth: adminsite.has_ceadúna

    • \n

  • available_apps: liosta d'iarratais óna:doc: clárú iarrataich atá ar fáil don úsáideoir reatha </ref/applications/>. Is é gach iontráil sa liosta ina dhiaidh sin a léiríonn feidhmchlár leis na heochracha seo a leanas:

    \n
      \n

    • app_label: an lipéad iarratais

      • \n

    • ``app_url ``: URL an innéacs iarratais sa riarachán

      • \n

    • has_module_perms: boolean a léiríonn an bhfuil leathanach innéacs an mhodúil ceadaithe don úsáideoir reatha a thaispeáint agus rochtain a fháil ar leathanach innéacs an mhodúil

      • \n

    • ``samhlacha ``: liosta de na samhlacha atá ar fáil san iarratas

      • \n
    \n

    Is dict é gach samhail leis na heochracha seo a leanas:

    \n
      \n

    • ``samhail ``: an rang samhail

      • \n

    • object_name: ainm aicme an tsamhail

      • \n

    • ``ainm ``: ainm iolra an tsamhail

      • \n

    • perms: rianú dict ceadanna ``add`, athraithe`, scrios`, agus féach

      • \n

    • admin_url: URL liosta athraithe riaracháin don tsamhail

      • \n

    • add_url: URL riaracháin chun samhail nua a chur leis

      • \n
    \n
    • \n

  • is_popup: cibé an bhfuil an leathanach reatha ar taispeáint i bhfuinneog aníos

    • \n

  • is_nav_sidebar_enabled: :attr: Adminsite.enable_nav_sidebar

    • \n

  • log_entries: :meth: .adminsite.get_log_entries

    • \n
\n
\n\n
\n
\nAdminSite.get_app_list(request, app_label=None)Link to this definition#
\n

Tugann liosta iarratais ar ais ó:doc: clár iarrataich atá ar fáil don úsáideoir </ref/applications/> reatha. Is féidir leat argóint app_label a rith go roghnach chun sonraí a fháil d'aip amháin. Is foclóir é gach iontráil sa liosta a léiríonn feidhmchlár leis na heochracha seo a leanas:

\n
    \n

  • app_label: an lipéad iarratais

    • \n

  • ``app_url ``: URL an innéacs iarratais sa riarachán

    • \n

  • has_module_perms: boolean a léiríonn an bhfuil leathanach innéacs an mhodúil ceadaithe don úsáideoir reatha a thaispeáint agus rochtain a fháil ar leathanach innéacs an mhodúil

    • \n

  • ``samhlacha ``: liosta de na samhlacha atá ar fáil san iarratas

    • \n

  • ``ainm ``: ainm an iarratais

    • \n
\n

Is foclóir é gach samhail leis na heochracha seo a leanas:

\n
    \n

  • ``samhail ``: an rang samhail

    • \n

  • object_name: ainm aicme an tsamhail

    • \n

  • ``ainm ``: ainm iolra an tsamhail

    • \n

  • perms: rianú dict ceadanna ``add`, athraithe`, scrios`, agus féach

    • \n

  • admin_url: URL liosta athraithe riaracháin don tsamhail

    • \n

  • add_url: URL riaracháin chun samhail nua a chur leis

    • \n
\n

Déantar liostaí iarratais agus samhlacha a shórtáil in ord aibítre de réir a n-ainmneacha. Is féidir leat an modh seo a athrú chun an t-ordú réamhshocraithe a athrú ar an leathanach innéacs riaracháin.

\n
\n\n
\n
\nAdminSite.has_permission(request)Link to this definition#
\n

Tugann True ar ais má tá cead ag an úsáideoir don HttpRequest` a thugtar leathanach amháin ar a laghad a fheiceáil ar an suíomh riaracháin. <django.contrib.auth.models.User.is_active><django.contrib.auth.models.User.is_staff>Réamhshocraithe chun a cheangal go mbeadh an bheirt: attr: User.is_Active `agus: attr: `User.is_staff a bheith True.

\n
\n\n
\n
\nAdminSite.register(model_or_iterable, admin_class=None, **options)Link to this definition#
\n

Cláraíonn sé an rang samhail tugtha (nó athraitheach ranganna) leis an admin_class` a thugtar. Réamhshocraithe admin_class to:class: ~django.contrib.admin.modelAdmin (na roghanna riaracháin réamhshocraithe). Má thugtar argóintí eochairfhocal - m.sh. list_display -- cuirfear i bhfeidhm iad mar roghanna ar an rang riaracháin.

\n

Reass:class: ~django.core.exceptions.imProperlyConfigured má tá samhail teib. agus django.contrib.admin.exceptions.alreadyRegistered má tá samhail cláraithe cheana féin.

\n
\n\n
\n
\nAdminSite.unregister(model_or_iterable)Link to this definition#
\n

Díchláraigh an rang samhail a thugtar (nó athraitheach ranganna).

\n

Ardaíonn sé django.contrib.admin.exceptions.notRegistered mura bhfuil samhail cláraithe cheana féin.

\n
\n\n
\n
\nAdminSite.get_model_admin(model)Link to this definition#
\n

Tugann sé rang riaracháin ar ais don rang samhail ar leith. Ardaíonn sé django.contrib.admin.exceptions.notRegistered mura bhfuil samhail cláraithe.

\n
\n\n
\n
\nAdminSite.get_log_entries(request)Link to this definition#
\n

Tugann sé tacar fiosrúcháin ar fáil do na cásanna gaolmha:class: ~django.contrib.admin.models.logEntry, a thaispeántar ar leathanach innéacs an láithreáin. Is féidir an modh seo a shárú chun na hiontrálacha logála a scagadh de réir critéir eile.

\n
\n\n
\n
\n

Cásanna AdminSite a chur isteach i do URLConfLink to this heading#

\n

Is é an chéim dheireanach chun riarachán Django a bhunú ná do shampla ``AdminSite` a cheangal isteach i do URLConf. Déan é seo trí URL ar leith a chur in iúl ag an modh Adminsite.urls. Ní gá a úsáid:func: `~django.urls.include () `.

\n

Sa sampla seo, cláraímid an sampla réamhshocraithe adminSite django.contrib.admin.site ag an URL /admin/:

\n
Code
# urls.py\nfrom django.contrib import admin\nfrom django.urls import path\n\nurlpatterns = [\n    path("admin/", admin.site.urls),\n]\n
\n
\n
\n

Saincheapadh an ranga:class: adminSiteLink to this heading#

\n

Más mian leat do shuíomh riaracháin féin a bhunú le hiompar saincheaptha, tá saor ort fo-aicme Adminsite' agus aon rud is mian leat a shárú nó a chur leis. Ansin, cruthaigh sampla de do fho-aicme ``AdminSite (ar an mbealach céanna a chuirfeá aon rang Python eile) agus cláraigh do mhúnlaí agus fo-aicmí ModelAdmin leis in ionad leis an suíomh réamhshocraithe. Faoi dheireadh, nuashonraigh: file: myproject/urls.py chun tagairt a dhéanamh d'fho-aicme: class: adminSite.

\n
myapp/admin.py
\n
Python
from django.contrib import admin\n\nfrom .models import MyModel\n\n\nclass MyAdminSite(admin.AdminSite):\n    site_header = "Monty Python administration"\n\n\nadmin_site = MyAdminSite(name="myadmin")\nadmin_site.register(MyModel)\n
\n
myproject/urls.py
\n
Python
from django.urls import path\n\nfrom myapp.admin import admin_site\n\nurlpatterns = [\n    path("myadmin/", admin_site.urls),\n]\n
\n

Tabhair faoi deara go mb'fhéidir nach dteastaíonn uait modúil admin ``uathoibríoch agus tú ag úsáid do shampla ``adminSite féin ós rud é gur dócha go mbeidh tú ag iompórtáil na modúil admin gach aip in aghaidh an aip i do mhodúl myproject.admin ``. Ciallaíonn sé seo go gcaithfidh tú ``django.contrib.admin.apps.simpleAdminConfig'` a chur in ionad ```django.contrib.admin' i do shuíomh: INSTALLED_APPS.

\n
\n
\n

Sárú ar an suíomh riaracháin réamhshocraitheLink to this heading#

\n

Is féidir leat an réamhshocraithe django.contrib.admin.site a shárú trí:attr: ~.simpleAdminConfig.default_site tréith saincheaptha AppConfig a shocrú chuig an gcosán allmhairithe poncair de fho-aicme AdminSite nó inghlaoch a thugann sampla láithreáin.

\n
myproject/admin.py
\n
Python
from django.contrib import admin\n\n\nclass MyAdminSite(admin.AdminSite): ...\n
\n
myproject/apps.py
\n
Python
from django.contrib.admin.apps import AdminConfig\n\n\nclass MyAdminConfig(AdminConfig):\n    default_site = "myproject.admin.MyAdminSite"\n
\n
myproject/settings.py
\n
Python
INSTALLED_APPS = [\n    # ...\n    "myproject.apps.MyAdminConfig",  # replaces 'django.contrib.admin'\n    # ...\n]\n
\n
\n
\n

Láithreáin riaracháin iolracha sa URLConf céannaLink to this heading#

\n

Is féidir leat cásanna iolracha den suíomh riaracháin a chruthú ar an suíomh Gréasáin céanna faoi thiomáint Django. Cruthaigh cásanna iolracha de Adminsite agus cuir gach ceann acu ag URL difriúil.

\n

Sa sampla seo, cuimsíonn na URLanna /basic-admin/ agus /advanced-admin/ leaganacha ar leithligh den suíomh riaracháin -- ag baint úsáide as na cásanna adminSite myproject.admin.basic_site agus ``myproject.admin.advanced_`site`, faoi seach:

\n
Code
# urls.py\nfrom django.urls import path\nfrom myproject.admin import advanced_site, basic_site\n\nurlpatterns = [\n    path("basic-admin/", basic_site.urls),\n    path("advanced-admin/", advanced_site.urls),\n]\n
\n

Tógann cásanna Adminsite argóint amháin dá dtógálaí, a n-ainm, ar féidir a bheith ina rud ar bith is mian leat. <admin-reverse-urls>Is é an argóint seo an réimír d'ainmneacha URL chun críocha:ref: iad a aisiompú `. Níl sé seo riachtanach ach má tá níos mó ná `Adminsite amháin á úsáid agat.

\n
\n
\n

Tuairimí a chur le suíomhanna riaracháinLink to this heading#

\n

Díreach cosúil:class: ModelAdmin, :class: adminSite soláthraíonn a:meth: `~django.contrib.admin.modeladmin.get_urls () `modh is féidir a athshealbhú chun tuairimí breise a shainiú don láithreán. Chun radharc nua a chur le do shuíomh riaracháin, leathnaigh an modh bon:meth: `~django.contrib.admin.modeladmin.get_urls () `chun patrún a áireamh do d'amharc nua.

\n\n
\n
\n

Gné athshocraithe pasfhocal a chur leisLink to this heading#

\n

Is féidir leat gné athshocraithe pasfhocal a chur leis an suíomh riaracháin trí chúpla líne a chur le do URLConf. Go sonrach, cuir na ceithre phatrún seo leis:

\n
Code
from django.contrib import admin\nfrom django.contrib.auth import views as auth_views\n\npath(\n    "admin/password_reset/",\n    auth_views.PasswordResetView.as_view(\n        extra_context={"site_header": admin.site.site_header}\n    ),\n    name="admin_password_reset",\n),\npath(\n    "admin/password_reset/done/",\n    auth_views.PasswordResetDoneView.as_view(\n        extra_context={"site_header": admin.site.site_header}\n    ),\n    name="password_reset_done",\n),\npath(\n    "reset/<uidb64>/<token>/",\n    auth_views.PasswordResetConfirmView.as_view(\n        extra_context={"site_header": admin.site.site_header}\n    ),\n    name="password_reset_confirm",\n),\npath(\n    "reset/done/",\n    auth_views.PasswordResetCompleteView.as_view(\n        extra_context={"site_header": admin.site.site_header}\n    ),\n    name="password_reset_complete",\n),\n
\n

(Glacann sé seo leis gur chuir tú an riarachán leis ag admin/` agus éilíonn tú go gcuirfidh tú na URLanna ag tosú le ^admin/ roimh an líne a chuimsíonn an aip riaracháin féin).

\n

Beidh an URL ainmnithe admin_password_reset mar thoradh ar “dearmad ar do phasfhocal?” nasc le feiceáil ar an leathanach logála isteach riaracháin réamhshocraithe faoin mbosca pasfhocal.

\n
\n
\n
\n

Rudaí LogentryLink to this heading#

\n
\n
\nclass models.LogEntryLink to this definition#
\n

Rianaíonn an rang `LogEntry ``breiseanna, athruithe agus scriosadh rudaí a dhéantar tríd an gcomhéadan riaracháin.

\n
\n\n
\n

Logentry tréitheLink to this heading#

\n
\n
\nLogEntry.action_timeLink to this definition#
\n

Dáta agus am an ghníomhaíochta.

\n
\n\n
\n
\nLogEntry.userLink to this definition#
\n

An t-úsáideoir (an:setting: AUTH_USER_MODEL) a rinne an gníomh.

\n
\n\n
\n
\nLogEntry.content_typeLink to this definition#
\n

An: Class: ~django.contrib.contentTypes.Models.ContentType an réad modhnaithe.

\n
\n\n
\n
\nLogEntry.object_idLink to this definition#
\n

Léiriú téacsúil phríomh-eochair an réad modhnaithe.

\n
\n\n
\n
\nLogEntry.object_reprLink to this definition#
\n

An réad ``repr () ``tar éis na modhnaithe.

\n
\n\n
\n
\nLogEntry.action_flagLink to this definition#
\n

An cineál gníomhaíochta logáilte: BREISE, ATHRAÍ`, SCRIOSADH `.

\n

Mar shampla, chun liosta de na breiseanna go léir a dhéantar tríd an riarachán a fháil:

\n
Code
from django.contrib.admin.models import ADDITION, LogEntry\n\nLogEntry.objects.filter(action_flag=ADDITION)\n
\n
\n\n
\n
\nLogEntry.change_messageLink to this definition#
\n

An cur síos mionsonraithe ar an modhnú. I gcás eagarthóireachta, mar shampla, tá liosta de na réimsí eagarthóireachta sa teachtaireacht. Formálaíonn suíomh riaracháin Django an t-ábhar seo mar struchtúr JSON, ionas gur féidir le: meth: get_change_message teachtaireacht a aistrítear sa teanga úsáideora reatha a athchóiriú. D'fhéadfadh cód saincheaptha é seo a shocrú mar shreang simplí áfach. Moltar duit an modh: meth: get_change_message a úsáid chun an luach seo a aisghabháil in ionad rochtain a fháil go díreach air.

\n
\n\n
\n
\n

Modhanna LogentryLink to this heading#

\n
\n
\nLogEntry.get_edited_object()Link to this definition#
\n

Aicearra a thugann an réad tagartha ar ais.

\n
\n\n
\n
\nLogEntry.get_change_message()Link to this definition#
\n

Formáidí agus aistriúcháin:attr: change_message isteach sa teanga úsáideora reatha. Taispeánfar teachtaireachtaí a cruthaíodh roimh Django 1.10 i gcónaí sa teanga ina raibh siad logáilte.

\n
\n\n
\n
\n
\n

URLanna riaracháin a aisiompúLink to this heading#

\n

<naming-url-patterns>Nuair a imscartar an:class: AdminSite, is féidir na tuairimí a sholáthraíonn an láithreán sin inrochtana ag baint úsáide as django's:ref: córas aisiompthe URL.

\n

Soláthraíonn an:class: adminSite na patrúin URL ainmnithe seo a leanas:

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Leathanach

Ainm URL

Paraiméadair

Innéacs

Innéacs

Logáil isteach

``Logáil isteach ``

Logáil amach

``logáil isteach ``

Athrú focal faire

athraithe_pasfhocal

Athrú pasfhocal déanta

pasfhocal_athraithe_déanaith

i18n JavaScript

jsi18n

Leathanach innéacs iarratais

liosta_aipe

app_label

Atreorú chuig leathanach an réada

amharc_ar an láithreán

`id_cineál_ábha, id_réad`

\n
\n

Soláthraíonn gach cás: Class: ModelAdmin sraith breise URLanna ainmnithe:

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Leathanach

Ainm URL

Paraiméadair

Liosta athraithe

{{app_label}} _ {{ainm mhúnla}} _changelist

Cuir le

{{app_label}} _ {{nomnamh samhail}} _cuir leis

Stair

{{app_label}} _ {{ainm samhail}} _stair

id_réad

Cealaigh

{{app_label}} _ {{nomnamh samhail}} _scrios

id_réad

Athraigh

{{app_label}} _ {{nomnamh samhail}} _athraithe

id_réad

\n
\n

Soláthraíonn an UserAdmin URL ainmnithe:

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n

Leathanach

Ainm URL

Paraiméadair

Athrú focal faire

Auth_úsáideor_athraithe_pasfhocal_athraithe

``ID úsáideora ``

\n
\n

Tá na URLanna ainmnithe seo cláraithe leis an spás ainmneacha feidhmchláir ``admin ``, agus le spás ainmneacha sampla a fhreagraíonn d'ainm an tSuímh.

\n

Mar sin - dá dteastaíonn uait tagairt a fháil don radharc Athraigh do réad áirithe Roghna (ón bhfeidhmchlár poballaí) sa riarachán réamhshocraithe, ghlaoifeá ar:

\n
Python console
>>> from django.urls import reverse\n>>> c = Choice.objects.get(...)\n>>> change_url = reverse("admin:polls_choice_change", args=(c.id,))\n
\n

Gheobhaidh sé seo an chéad shampla cláraithe den fheidhmchlár riaracháin (cibé ainm an sampla), agus réiteoidh sé an dearcadh maidir le cásanna Poll.Choice a athrú sa chás sin.

\n

Más mian leat URL a aimsiú i gcás riaracháin ar leith, tabhair ainm an chás sin mar leid current_app don ghlao droim. Mar shampla, dá dteastaíonn uait go sonrach an dearcadh riaracháin ón gcás riaracháin darb ainm ``sain`, bheadh ort glaoch ar:

\n
Python console
>>> change_url = reverse("admin:polls_choice_change", args=(c.id,), current_app="custom")\n
\n

<topics-http-reversing-url-namespaces>Le haghaidh tuilleadh sonraí, féach an doiciméadú ar:ref: `URLanna spaced ainmneacha a aisiompú `.

\n

Chun na urls riaracháin a aisiompú níos éasca i dteimpléid, soláthraíonn Django scagaire admin_urlname a ghlacann gníomh mar argóint:

\n
Django template
{% load admin_urls %}\n<a href="{% url opts|admin_urlname:'add' %}">Add user</a>\n<a href="{% url opts|admin_urlname:'delete' user.pk %}">Delete this user</a>\n
\n

Meaitníonn an gníomh sna samplaí thuas leis an gcuid deireanach de na hainmneacha URL le haghaidh cásanna: class: ModelAdmin a thuairiscítear thuas. Is féidir leis an athróg opts a bheith ina rud ar bith a bhfuil tréithe app_label agus model_name aige agus is gnách go soláthraíonn na tuairimí riaracháin don tsamhail reatha.

\n
\n
\n

An maisitheoir taispeánLink to this heading#

\n
\n
\ndisplay(*, boolean=None, ordering=None, description=None, empty_value=None)Link to this definition#
\n

Is féidir an maisitheoir seo a úsáid chun tréithe sonracha a shocrú ar fheidhmeanna taispeána saincheaptha is féidir a úsáid le:attr: ~django.contrib.admin.modeladmin.list_display nó:attr: ~django.contrib.admin.modelAdmin.ReadOnly_Fields:

\n
Code
@admin.display(\n    boolean=True,\n    ordering="-publish_date",\n    description="Is Published?",\n)\ndef is_published(self, obj):\n    return obj.publish_date is not None\n
\n

Tá sé seo comhionann le roinnt tréithe (leis na hainmneacha bunaidh, níos faide) a shocrú go díreach ar an bhfeidhm:

\n
Code
def is_published(self, obj):\n    return obj.publish_date is not None\n\n\nis_published.boolean = True\nis_published.admin_order_field = "-publish_date"\nis_published.short_description = "Is Published?"\n
\n

Tabhair faoi deara freisin go léarscálann paraiméadar maisitheora empty_value leis an tréith empty_value_display` a shanntar go díreach don fheidhm. Ní féidir é a úsáid i gcomhar le boolean - tá siad frithpháirteach.

\n

Níl sé éigeantach an maisitheoir seo a úsáid chun feidhm taispeána a dhéanamh, ach d'fhéadfadh sé a bheith úsáideach é a úsáid gan argóintí mar mharcóir i do fhoinse chun cuspóir na feidhme a aithint:

\n
Code
@admin.display\ndef published_year(self, obj):\n    return obj.publish_date.year\n
\n

Sa chás seo ní chuirfidh sé aon tréithe leis an bhfeidhm.

\n
\n\n
\n
\n

An maisitheoir staff_member_requredLink to this heading#

\n
\n
\nstaff_member_required(redirect_field_name='next', login_url='admin:login')Link to this definition#
\n

Úsáidtear an maisitheoir seo ar na tuairimí riaracháin a éilíonn údarú. Beidh an t-iompar seo a leanas ag radharc maisithe leis an bhfeidhm seo:

\n
    \n

  • Má tá an t-úsáideoir logáilte isteach, gur ball foirne é (user.is_staff=true), agus má tá sé gníomhach (user.is_active=true), déan an radharc a fhorghníomhú de ghnáth.

    • \n

  • Seachas sin, atreorófar an t-iarratas chuig an URL a shonraítear leis an bparaiméadar login_url ``, leis an gcosán a iarrtar ar dtús in athróg teaghrán fiosrúcháin a shonraítear le ``redirect_field_name. Mar shampla: /admin/login/? next =/admin /polls/ceist/3/.

    • \n
\n

Úsáid sampla:

\n
Code
from django.contrib.admin.views.decorators import staff_member_required\n\n\n@staff_member_required\ndef my_view(request): ...\n
\n
\n\n
","rootId":"module-django.contrib.admin","toc":[{"title":"Forbhreathnú","anchor":"overview","children":[{"title":"Ábhair eile","anchor":"other-topics","children":[]}]},{"title":"``Modeladmin ``rudaí","anchor":"modeladmin-objects","children":[{"title":"An maisitheoir clár","anchor":"the-register-decorator","children":[]},{"title":"Faighneadh comhaid riaracháin","anchor":"discovery-of-admin-files","children":[]},{"title":"Roghanna ModelAdmin","anchor":"modeladmin-options","children":[{"title":"Roghanna teimpléad saincheap","anchor":"custom-template-options","children":[]}]},{"title":"Modhanna ModelAdmin","anchor":"modeladmin-methods","children":[{"title":"Modhanna eile","anchor":"other-methods","children":[]}]},{"title":"Sainmhínithe sócmhainní ModelAdmin","anchor":"modeladmin-asset-definitions","children":[{"title":"jQuery","anchor":"jquery","children":[]}]},{"title":"Bailíochtú saincheaptha a chur leis an riarachán","anchor":"adding-custom-validation-to-the-admin","children":[]}]},{"title":"InlineModelAdmin rudaí","anchor":"inlinemodeladmin-objects","children":[{"title":"Roghanna InlineModelAdmin","anchor":"inlinemodeladmin-options","children":[]},{"title":"Ag obair le samhail le dhá eochracha eachtracha nó níos mó don tsamhail thuismitheora céanna","anchor":"working-with-a-model-with-two-or-more-foreign-keys-to-the-same-parent-model","children":[]},{"title":"Ag obair le go leor samhlacha","anchor":"working-with-many-to-many-models","children":[]},{"title":"Ag obair le samhlacha idirghabhála go leor","anchor":"working-with-many-to-many-intermediary-models","children":[]},{"title":"Ag baint úsáide as caidreamh cineálach mar inlíne","anchor":"using-generic-relations-as-an-inline","children":[]}]},{"title":"Teimpléid riaracháin forchoitianta","anchor":"overriding-admin-templates","children":[{"title":"Cuir eolairí teimpléad riaracháin do thionsc","anchor":"set-up-your-projects-admin-template-directories","children":[]},{"title":"Teimpléad riaracháin a athsholáthar vs. athsholáthar","anchor":"overriding-vs-replacing-an-admin-template","children":[]},{"title":"Teimpléid a d'fhéadfaí a shárú in aghaidh an aip nó an tsamhail","anchor":"templates-which-may-be-overridden-per-app-or-model","children":[]},{"title":"Teimpléid fréamh agus logála isteach","anchor":"root-and-login-templates","children":[]}]},{"title":"Tacaíocht téamaí","anchor":"theming-support","children":[]},{"title":"extrabody block","anchor":"extrabody-block","children":[]},{"title":"rudaí Admin Site","anchor":"adminsite-objects","children":[{"title":"AdminSite tréithe","anchor":"adminsite-attributes","children":[]},{"title":"Modhanna Adminsite","anchor":"adminsite-methods","children":[]},{"title":"Cásanna AdminSite a chur isteach i do URLConf","anchor":"hooking-adminsite-instances-into-your-urlconf","children":[]},{"title":"Saincheapadh an ranga:class: adminSite","anchor":"customizing-the-adminsite-class","children":[]},{"title":"Sárú ar an suíomh riaracháin réamhshocraithe","anchor":"overriding-the-default-admin-site","children":[]},{"title":"Láithreáin riaracháin iolracha sa URLConf céanna","anchor":"multiple-admin-sites-in-the-same-urlconf","children":[]},{"title":"Tuairimí a chur le suíomhanna riaracháin","anchor":"adding-views-to-admin-sites","children":[]},{"title":"Gné athshocraithe pasfhocal a chur leis","anchor":"adding-a-password-reset-feature","children":[]}]},{"title":"Rudaí Logentry","anchor":"logentry-objects","children":[{"title":"Logentry tréithe","anchor":"logentry-attributes","children":[]},{"title":"Modhanna Logentry","anchor":"logentry-methods","children":[]}]},{"title":"URLanna riaracháin a aisiompú","anchor":"reversing-admin-urls","children":[]},{"title":"An maisitheoir taispeán","anchor":"the-display-decorator","children":[]},{"title":"An maisitheoir staff_member_requred","anchor":"the-staff-member-required-decorator","children":[]}],"breadcrumbs":[{"docname":"ref/index","title":"Tagairt API","url":"/ga/5.2/ref/"},{"docname":"ref/contrib/index","title":"Pacáistí contrib","url":"/ga/5.2/ref/contrib/"}],"prev":{"docname":"ref/contrib/index","title":"Pacáistí contrib","url":"/ga/5.2/ref/contrib/"},"next":{"docname":"ref/contrib/admin/actions","title":"gníomhartha riaracháin","url":"/ga/5.2/ref/contrib/admin/actions/"},"formats":{"html":"/ga/5.2/ref/contrib/admin/","markdown":"/ga/5.2/ref/contrib/admin.md","json":"/ga/5.2/ref/contrib/admin.json"},"source":"https://github.com/django/django/blob/stable/5.2.x/docs/ref/contrib/admin/index.txt","official":"https://docs.djangoproject.com/ga/5.2/ref/contrib/admin/","inVersions":["6.1","6.0","5.2"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}