--- title: "Suíomh riaracháin Django" version: 6.1 locale: ga source: https://docs.djangoproject.com/ga/6.1/ref/contrib/admin/ canonical: https://djangodocs.dev/ga/6.1/ref/contrib/admin/ --- # Suíomh riaracháin Django 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. 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. Sa doiciméad seo pléimid conas comhéadan riaracháin Django a ghníomhachtú, a úsáid agus a shaincheapadh. ## Forbhreathnú Tá an riarachán cumasaithe sa teimpléad tionscadail réamhshocraithe a úsáideann: djadmin: startproject. Mura bhfuil an teimpléad tionscadail réamhshocraithe á úsáid agat, seo na riachtanais: 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: socrú. 2. \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. 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. \:ref: Ceangail URLanna an riaracháin isteach i do URLConf . 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). 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. 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. ### Ábhair eile - [gníomhartha riaracháin](/ga/6.1/ref/contrib/admin/actions/) - [`ModelAdmin` Scagairí Liosta](/ga/6.1/ref/contrib/admin/filters/) - [Gineadóir doiciméadaithe riaracháin Django](/ga/6.1/ref/contrib/admin/admindocs/) - [Saincheaptha JavaScript sa riarachán](/ga/6.1/ref/contrib/admin/javascript/) > **See also** > > Le haghaidh faisnéise maidir le freastal ar na comhaid statacha (íomhánna, JavaScript, agus CSS) a bhaineann leis an riarachán atá i dtáirgeadh, féach:ref: serving-files. > > Ag fadhbanna agat? Bain triail as: doc: /faq/admin . ## Modeladmin rudaí #### `class ModelAdmin` 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`: ``` from django.contrib import admin from myapp.models import Author class AuthorAdmin(admin.ModelAdmin): pass admin.site.register(Author, AuthorAdmin) ``` > **An dteastaíonn réad ModelAdmin uait ar chor ar bith?** > > Sa sampla roimhe seo, ní shainmhíníonn an rang `ModelAdmin` aon luachanna saincheaptha (fós). Mar thoradh air sin, cuirfear an comhéadan riaracháin réamhshocraithe ar fáil. Má tá tú sásta leis an gcomhéadan riaracháin réamhshocraithe, ní gá duit réad ModelAdmin\` a shainiú ar chor ar bith - is féidir leat an rang samhail a chlárú gan cur síos ModelAdmin\` a sholáthar. D'fhéadfaí an sampla roimhe seo a shimpliú go: > > ``` > from django.contrib import admin > from myapp.models import Author > > admin.site.register(Author) > ``` ### An maisitheoir `clár` #### `register(*models, site=django.contrib.admin.sites.site)` Tá maisitheoir ann freisin chun do ranganna ModelAdmin\` a chlárú: ``` from django.contrib import admin from .models import Author @admin.register(Author) class AuthorAdmin(admin.ModelAdmin): pass ``` 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\`: ``` from django.contrib import admin from .models import Author, Editor, Reader from myproject.admin_site import custom_admin_site @admin.register(Author, Reader, Editor, site=custom_admin_site) class PersonAdmin(admin.ModelAdmin): pass ``` 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) . ### Faighneadh comhaid riaracháin 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ú. #### `class apps.AdminConfig` This is the default [`AppConfig`](/ga/6.1/ref/applications/#django.apps.AppConfig) class for the admin. It calls [`autodiscover()`](#django.contrib.admin.autodiscover) when Django starts. #### `class apps.SimpleAdminConfig` This class works like [`AdminConfig`](#django.contrib.admin.apps.AdminConfig), except it doesn't call [`autodiscover()`](#django.contrib.admin.autodiscover). #### `default_site` 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. #### `autodiscover()` 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 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. 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. ### Roghanna `ModelAdmin` 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`: ``` from django.contrib import admin class AuthorAdmin(admin.ModelAdmin): date_hierarchy = "pub_date" ``` #### `ModelAdmin.actions` 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í. #### `ModelAdmin.actions_on_top` #### `ModelAdmin.actions_on_bottom` Controls where on the admin changelist page the actions bar appears. By default, the admin changelist displays actions at the top of the page (`actions_on_top = True; actions_on_bottom = False`). #### `ModelAdmin.actions_selection_counter` 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`). #### `ModelAdmin.date_hierarchy` 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. Sampla: ``` date_hierarchy = "pub_date" ``` Is féidir leat réimse a shonrú freisin ar mhúnla gaolmhar ag baint úsáide as an lorg `__`, mar shampla: ``` date_hierarchy = "author__pub_date" ``` 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. > **Note** > > \Úsáideann `date_hierarchy`: meth: QuerySet.dateTimes () go hinmheánach. \Féach dá dhoiciméadú le do thoil le haghaidh roinnt rabhaidh nuair a chumasaítear tacaíocht crios ama (:setting: USE\_TZ = True ). #### `ModelAdmin.empty_value_display` 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: ``` from django.contrib import admin class AuthorAdmin(admin.ModelAdmin): empty_value_display = "-empty-" ``` 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: ``` from django.contrib import admin class AuthorAdmin(admin.ModelAdmin): list_display = ["name", "title", "view_birth_date"] @admin.display(empty_value="???") def view_birth_date(self, obj): return obj.birth_date ``` #### `ModelAdmin.exclude` Ba chóir go mbeadh an tréith seo, má thugtar, ina liosta d'ainmneacha réimse le eisiamh ón bhfoirm. Mar shampla, déanaimis machnamh ar an tsamhail seo a leanas: ``` from django.db import models class Author(models.Model): name = models.CharField(max_length=100) title = models.CharField(max_length=3) birth_date = models.DateField(blank=True, null=True) ``` 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: ``` from django.contrib import admin class AuthorAdmin(admin.ModelAdmin): fields = ["name", "title"] class AuthorAdmin(admin.ModelAdmin): exclude = ["birth_date"] ``` Ó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. #### `ModelAdmin.fields` Ú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: ``` class FlatPageAdmin(admin.ModelAdmin): fields = ["url", "title", "content"] ``` 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. Le haghaidh riachtanais leagan amach níos casta, féach an rogha: attr: ~ModelAdmin.FieldSets. 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. 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: ``` class FlatPageAdmin(admin.ModelAdmin): fields = [("url", "title"), "content"] ``` > **Mearbhall féideartha leis an rogha ModelAdmin.FieldSets** > > Níor chóir an rogha `fields` seo a mheascadh leis an eochair foclóra `fields` atá laistigh den rogha: attr: ~ModelAdmin.FieldSets, mar a thuairiscítear sa chéad chuid eile. If neither `fields` nor [`fieldsets`](#django.contrib.admin.ModelAdmin.fieldsets) options are present, Django will default to displaying each field that isn't an `AutoField` and has `editable=True`, in a single fieldset, in the same order as the fields are defined in the model, followed by any fields defined in [`readonly_fields`](#django.contrib.admin.ModelAdmin.readonly_fields). #### `ModelAdmin.fieldsets` Socraigh `fieldsets` chun leagan amach na leathanaigh riaracháin “cuir” agus “athraigh” a rialú. \Is liosta de 2-tuples é fieldsets, ina léiríonn gach 2-tuple \`\` ar an leathanach foirm riaracháin. (Is “cuid\” den fhoirm é a .) 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. Sampla iomlán, tógtha ón múnla:class: django.contrib.flatpages.models.flatpage: ``` from django.contrib import admin class FlatPageAdmin(admin.ModelAdmin): fieldsets = [ ( None, { "fields": ["url", "title", "content", "sites"], }, ), ( "Advanced options", { "classes": ["collapse"], "fields": ["registration_required", "template_name"], }, ), ] ``` Mar thoradh air seo tá leathanach riaracháin a bhfuil cuma air: ![](ref/contrib/admin/_images/fieldsets.png) 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. Is féidir leis na heochracha seo a leanas a bheith ag an bhfoclóir field\_options\`: - **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. Sampla: ``` { "fields": ["first_name", "last_name", "address", "city", "state"], } ``` 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: ``` { "fields": [("first_name", "last_name"), "address", "city", "state"], } ``` 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. 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. - **`ranga`** A list or tuple containing extra CSS classes to apply to the fieldset. This can include any custom CSS class defined in the project, as well as the CSS class provided by Django: `collapse`. Sampla: ``` { "classes": ["collapse"], } ``` Fieldsets with a name and the `collapse` style will be initially collapsed, using an expandable widget with a toggle for switching their visibility. > **Changed in Django 6.1** > > The `wide` class has been removed, as it was made obsolete by the > new admin layout. - **`` `Tuairisc ``** Sraith téacs breise roghnach le taispeáint ag barr gach tacar réimse, faoi cheannteideal an tacar réimse. 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. > **TabularInline has limited > support for fieldsets** > > Tá feidhmiúlacht theoranta ag baint úsáide as fieldsets\` le: class: ~django.contrib.admin.tabularInline. Is féidir leat a shonrú cé na réimsí a thaispeánfar agus a n-ord laistigh den leagan amach `TabularInline` trí réimsí \`\`a shainiú sa fhoclóir \`field\_options\`. > > Ní thacaítear le gach gné eile. Áirítear leis seo úsáid `ainm` chun teideal a shainiú do ghrúpa réimsí. #### `ModelAdmin.filter_horizontal` \`. Mar sin féin, is féidir inlíne a chur in ionad na giuirléidí seo. Cuir i gcás go bhfuil na samhlacha seo a leanas againn: ``` from django.db import models class Person(models.Model): name = models.CharField(max_length=128) class Group(models.Model): name = models.CharField(max_length=128) members = models.ManyToManyField(Person, related_name="groups") ``` 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: ``` from django.contrib import admin from myapp.models import Group class MembershipInline(admin.TabularInline): model = Group.members.through class GroupAdmin(admin.ModelAdmin): inlines = [ MembershipInline, ] exclude = ["members"] admin.site.register(Group, GroupAdmin) ``` Tá dhá ghné is fiú a thabhairt faoi deara sa sampla seo. 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. 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ú. 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. 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\`. ### Ag obair le samhlacha idirghabhála go leor 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 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: ``` from django.db import models class Person(models.Model): name = models.CharField(max_length=128) class Group(models.Model): name = models.CharField(max_length=128) members = models.ManyToManyField(Person, through="Membership") class Membership(models.Model): person = models.ForeignKey(Person, on_delete=models.CASCADE) group = models.ForeignKey(Group, on_delete=models.CASCADE) date_joined = models.DateField() invite_reason = models.CharField(max_length=64) class Meta: constraints = [ models.UniqueConstraint( fields=["person", "group"], name="unique_person_group" ) ] ``` 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 : ``` class MembershipInline(admin.TabularInline): model = Membership extra = 1 ``` Ú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\`. Anois cruthaigh tuairimí riaracháin do na samhlacha `Person` agus `Grúpa`: ``` class PersonAdmin(admin.ModelAdmin): inlines = [MembershipInline] class GroupAdmin(admin.ModelAdmin): inlines = [MembershipInline] ``` Faoi dheireadh, cláraigh do mhúnlaí ```Person` agus ``Grúpa``` leis an suíomh riaracháin: ``` admin.site.register(Person, PersonAdmin) admin.site.register(Group, GroupAdmin) ``` 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\`. ### Ag baint úsáide as caidreamh cineálach mar inlíne Is féidir inlíne a úsáid le rudaí a bhaineann go ginearálta. Abair go bhfuil na samhlacha seo a leanas agat: ``` from django.contrib.contenttypes.fields import GenericForeignKey from django.contrib.contenttypes.models import ContentType from django.db import models class Image(models.Model): image = models.ImageField(upload_to="images") content_type = models.ForeignKey(ContentType, on_delete=models.CASCADE) object_id = models.PositiveIntegerField() content_object = GenericForeignKey("content_type", "object_id") class Product(models.Model): name = models.CharField(max_length=100) ``` 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: ``` from django.contrib import admin from django.contrib.contenttypes.admin import GenericTabularInline from myapp.models import Image, Product class ImageInline(GenericTabularInline): model = Image class ProductAdmin(admin.ModelAdmin): inlines = [ ImageInline, ] admin.site.register(Product, ProductAdmin) ``` Féach na:doc: contenttypes doiciméadach le haghaidh faisnéise níos sainiúla. \ ## Bailíochtú saincheaptha a chur leis an riarachán The admin uses [`ModelForm`](/ga/6.1/topics/forms/modelforms/#django.forms.ModelForm). To add custom validation, provide your own `ModelForm`: ``` class ArticleForm(forms.ModelForm): def clean_name(self): # do something that validates your data return self.cleaned_data["name"] ``` Then configure the [`ModelAdmin`](#django.contrib.admin.ModelAdmin) to use the form: ``` class ArticleAdmin(admin.ModelAdmin): form = ArticleForm ``` Or configure an [`InlineModelAdmin`](#django.contrib.admin.InlineModelAdmin) to use the form: ``` class ArticleInline(admin.TabularInline): model = Article form = ArticleForm ``` It is important that you use a `ModelForm`; otherwise things can break. See the [forms](/ga/6.1/ref/forms/) documentation on [custom validation](/ga/6.1/ref/forms/validation/) and, more specifically, the [model form validation notes](/ga/6.1/topics/forms/modelforms/#overriding-modelform-clean-method) for more information. ## Teimpléid riaracháin forchoitianta 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. ### Set up your project's admin template directories Tá na comhaid teimpléad riaracháin suite san eolaire: :source: django/contrib/admin/templates/admin. 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 \\`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. 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. 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. 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. 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. ### Teimpléad riaracháin a athsholáthar vs. athsholáthar 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ú. 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: ```html+django {% extends "admin/change_form.html" %} {% load i18n admin_urls %} {% block object-tools-items %}
  • {% translate "History" %}
  • My Link
    • {% if has_absolute_url %}
  • {% translate "View on site" %}
    • {% endif %} {% endblock %} ``` 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. ### Teimpléid a d'fhéadfaí a shárú in aghaidh an aip nó an tsamhail 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: - `Actions.html` - `app_index.html` - `athraithe_foirm.html` - `change_form_actions.html` - `athraithe_foirm_object_tools.html` - `liosta_athraithe.html` - `athraithe_liosta_object_tools.html` - `athraí_liosta_results.html` - `date_hierarchy.html` - `delete_confirmation.html` - `Object_Histor.html` - `pagination.html` - `popup_response.html` - `réamh-phoilds_js.html` - `foirme_cuardach.html` - submit\_line.html \`\` 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ú. > **Note** > > Úsáidtear cuid de na teimpléid riaracháin, mar shampla `change_list_results.html` chun clibeanna cuimsithe saincheaptha a rinneadh. D'fhéadfaí iad seo a shárú, ach i gcásanna den sórt sin is dócha gur fearr duit do leagan féin den chlib atá i gceist a chruthú agus ainm difriúil a thabhairt dó. Ar an mbealach sin is féidir leat é a úsáid go roghnach. ### Teimpléid fréamh agus logála isteach 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ú. ## Tacaíocht téamaí Ú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: ```html+django {% extends 'admin/base.html' %} {% block extrastyle %}{{ block.super }} {% endblock %} ``` Sainmhínítear liosta na n-athróg CSS ag:source: django/contrib/admin/static/admin/css/base.css. Sainmhínítear athróga mód dorcha, ag meas an cheist meán [prefers-color-scheme](https://developer.mozilla.org/en-US/docs/Web/CSS/@media/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%} . ## `extrabody` block You can add custom HTML, JavaScript, or other content to appear just before the closing `` tag of templates that extend `admin/base.html` by extending the `extrabody` block. For example, if you want an alert to appear on page load you could add a `admin/base.html` template override to your project: ```html+django {% extends 'admin/base.html' %} {% block extrabody %} {{ block.super }} {% endblock extrabody %} ``` ## rudaí `Admin Site` #### `class AdminSite(name='admin')` 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. \Más mian leat an suíomh riaracháin réamhshocraithe a shaincheapadh, is féidir leat: ref: é a shárú . 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í. \Ú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. #### `django.contrib.admin.sites.all_sites` A: Class: ~ WeakRef.WeakSet tá gach cás láithreáin riaracháin. ### `AdminSite` tréithe 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. #### `AdminSite.site_header` An téacs le cur ag barr gach leathanach riaracháin, mar `
    ` (teaghrán). De réir réamhshocraithe, is é seo “riarachán Django”. #### `AdminSite.site_title` An téacs le cur ag deireadh gach leathanach riaracháin \\`\`\`(teaghrán). De réir réamhshocraithe, is é seo “Riarachán láithreáin Django”. #### `AdminSite.site_url` 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. 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 `/`. #### `AdminSite.index_title` 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”. #### `AdminSite.index_template` Conair chuig teimpléad saincheaptha a úsáidfidh príomh-amharc innéacs an láithreáin riaracháin. #### `AdminSite.app_index_template` Conair chuig teimpléad saincheaptha a úsáidfidh amharc innéacs aip an láithreáin riaracháin. #### `AdminSite.empty_value_display` 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í. #### `AdminSite.enable_nav_sidebar` 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`. #### `AdminSite.final_catch_all_view` 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`. > **Warning** > > Ní mholtar é seo a shocrú go False toisc go gcosnaíonn an dearcadh i gcoinne saincheist phríobháideachta féideartha líonta samhail. #### `AdminSite.login_template` Conair chuig teimpléad saincheaptha a úsáidfidh amharc logála isteach an láithreáin riaracháin. #### `AdminSite.login_form` Fo-aicme de:class: ~django.contrib.auth.forms.AuthenticationForm a úsáidfidh amharc logála isteach an láithreáin riaracháin. #### `AdminSite.logout_template` Conair chuig teimpléad saincheaptha a úsáidfidh amharc logáil amach an láithreáin riaracháin. #### `AdminSite.password_change_form` > **New in Django 6.0** Subclass of [`PasswordChangeForm`](/ga/6.1/topics/auth/default/#django.contrib.auth.forms.PasswordChangeForm) that will be used by the admin site password change view. #### `AdminSite.password_change_template` Conair chuig teimpléad saincheaptha a úsáidfidh amharc athraithe pasfhocal an láithreáin riaracháin. #### `AdminSite.password_change_done_template` Conair chuig teimpléad saincheaptha a úsáidfidh athrú pasfhocal an láithreáin riaracháin amharc déanta. ### Modhanna `Adminsite` #### `AdminSite.each_context(request)` Tugann foclóir athróg ar ais le cur i gcomhthéacs an teimpléid do gach leathanach ar an suíomh riaracháin. Cuimsíonn sé na hathróga agus na luachanna seo a leanas de réir - `site_header`: :attr: Adminsite.site\_header - `site_title`: :attr: Adminsite.site\_title - `site_url`: :attr: Adminsite.site\_url - `has_ceadúna`: :meth: adminsite.has\_ceadúna - `available_apps`: liosta d'iarratais óna:doc: clárú iarrataich atá ar fáil don úsáideoir reatha \. Is é gach iontráil sa liosta ina dhiaidh sin a léiríonn feidhmchlár leis na heochracha seo a leanas: - `app_label`: an lipéad iarratais - app\_url : URL an innéacs iarratais sa riarachá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 - samhlacha : liosta de na samhlacha atá ar fáil san iarratas Is dict é gach samhail leis na heochracha seo a leanas: - samhail : an rang samhail - `object_name`: ainm aicme an tsamhail - ainm : ainm iolra an tsamhail - `perms`: rianú `dict` ceadanna \`\`add\`, athraithe\`, scrios\`, agus `féach` - `admin_url`: URL liosta athraithe riaracháin don tsamhail - `add_url`: URL riaracháin chun samhail nua a chur leis - `is_popup`: cibé an bhfuil an leathanach reatha ar taispeáint i bhfuinneog aníos - `is_nav_sidebar_enabled`: :attr: Adminsite.enable\_nav\_sidebar - `log_entries`: :meth: .adminsite.get\_log\_entries #### `AdminSite.get_app_list(request, app_label=None)` Tugann liosta iarratais ar ais ó:doc: clár iarrataich atá ar fáil don úsáideoir \ 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: - `app_label`: an lipéad iarratais - app\_url : URL an innéacs iarratais sa riarachá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 - samhlacha : liosta de na samhlacha atá ar fáil san iarratas - ainm : ainm an iarratais Is foclóir é gach samhail leis na heochracha seo a leanas: - samhail : an rang samhail - `object_name`: ainm aicme an tsamhail - ainm : ainm iolra an tsamhail - `perms`: rianú `dict` ceadanna \`\`add\`, athraithe\`, scrios\`, agus `féach` - `admin_url`: URL liosta athraithe riaracháin don tsamhail - `add_url`: URL riaracháin chun samhail nua a chur leis 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. #### `AdminSite.has_permission(request)` 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. \\Réamhshocraithe chun a cheangal go mbeadh an bheirt: attr: User.is\_Active \`agus: attr: \`User.is\_staff a bheith `True`. #### `AdminSite.register(model_or_iterable, admin_class=None, **options)` 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. Raises [`ImproperlyConfigured`](/ga/6.1/ref/exceptions/#django.core.exceptions.ImproperlyConfigured) if a model is abstract, and `django.contrib.admin.exceptions.AlreadyRegistered` if a model is already registered. #### `AdminSite.unregister(model_or_iterable)` Díchláraigh an rang samhail a thugtar (nó athraitheach ranganna). Ardaíonn sé `django.contrib.admin.exceptions.notRegistered` mura bhfuil samhail cláraithe cheana féin. #### `AdminSite.get_model_admin(model)` 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. #### `AdminSite.get_log_entries(request)` 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. ### Cásanna `AdminSite` a chur isteach i do URLConf The last step in setting up the Django admin is to hook your `AdminSite` instance into your URLconf. Do this by pointing a given URL at the `AdminSite.urls` method. It is not necessary to use [`include()`](/ga/6.1/ref/urls/#django.urls.include). Sa sampla seo, cláraímid an sampla réamhshocraithe `adminSite` `django.contrib.admin.site` ag an URL `/admin/`: ``` # urls.py from django.contrib import admin from django.urls import path urlpatterns = [ path("admin/", admin.site.urls), ] ``` ### Saincheapadh an ranga:class: adminSite 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. *`myapp/admin.py`* ```python from django.contrib import admin from .models import MyModel class MyAdminSite(admin.AdminSite): site_header = "Monty Python administration" admin_site = MyAdminSite(name="myadmin") admin_site.register(MyModel) ``` *`myproject/urls.py`* ```python from django.urls import path from myapp.admin import admin_site urlpatterns = [ path("myadmin/", admin_site.urls), ] ``` 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. ### Sárú ar an suíomh riaracháin réamhshocraithe 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. *`myproject/admin.py`* ```python from django.contrib import admin class MyAdminSite(admin.AdminSite): ... ``` *`myproject/apps.py`* ```python from django.contrib.admin.apps import AdminConfig class MyAdminConfig(AdminConfig): default_site = "myproject.admin.MyAdminSite" ``` *`myproject/settings.py`* ```python INSTALLED_APPS = [ # ... "myproject.apps.MyAdminConfig", # replaces 'django.contrib.admin' # ... ] ``` ### Láithreáin riaracháin iolracha sa URLConf céanna 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. 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: ``` # urls.py from django.urls import path from myproject.admin import advanced_site, basic_site urlpatterns = [ path("basic-admin/", basic_site.urls), path("advanced-admin/", advanced_site.urls), ] ``` 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. \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. ### Tuairimí a chur le suíomhanna riaracháin Just like [`ModelAdmin`](#django.contrib.admin.ModelAdmin), [`AdminSite`](#django.contrib.admin.AdminSite) provides a [`get_urls()`](#django.contrib.admin.ModelAdmin.get_urls) method that can be overridden to define additional views for the site. To add a new view to your admin site, extend the base [`get_urls()`](#django.contrib.admin.ModelAdmin.get_urls) method to include a pattern for your new view. > **Note** > > Ba chóir d'aon radharc a rindreann tú a úsáideann na teimpléid riaracháin, nó a leathnaíonn an teimpléad riaracháin bonn, request.current\_app \`\`a shocrú sula ndéantar an teimpléad a rindreáil. Ba chóir é a shocrú go \`\`self.name\` má tá do thuairim ar `Adminsite` nó `self.admin_site.name` má tá do thuairim ar `ModelAdmin`. ### Gné athshocraithe pasfhocal a chur leis 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: ``` from django.contrib import admin from django.contrib.auth import views as auth_views path( "admin/password_reset/", auth_views.PasswordResetView.as_view( extra_context={"site_header": admin.site.site_header} ), name="admin_password_reset", ), path( "admin/password_reset/done/", auth_views.PasswordResetDoneView.as_view( extra_context={"site_header": admin.site.site_header} ), name="password_reset_done", ), path( "reset///", auth_views.PasswordResetConfirmView.as_view( extra_context={"site_header": admin.site.site_header} ), name="password_reset_confirm", ), path( "reset/done/", auth_views.PasswordResetCompleteView.as_view( extra_context={"site_header": admin.site.site_header} ), name="password_reset_complete", ), ``` (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). 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. ## Rudaí `Logentry` #### `class models.LogEntry` Rianaíonn an rang LogEntry breiseanna, athruithe agus scriosadh rudaí a dhéantar tríd an gcomhéadan riaracháin. ### `Logentry` tréithe #### `LogEntry.action_time` Dáta agus am an ghníomhaíochta. #### `LogEntry.user` An t-úsáideoir (an:setting: AUTH\_USER\_MODEL) a rinne an gníomh. #### `LogEntry.content_type` An: Class: ~django.contrib.contentTypes.Models.ContentType an réad modhnaithe. #### `LogEntry.object_id` Léiriú téacsúil phríomh-eochair an réad modhnaithe. #### `LogEntry.object_repr` An réad repr () tar éis na modhnaithe. #### `LogEntry.action_flag` An cineál gníomhaíochta logáilte: `BREISE`, ATHRAÍ\`, SCRIOSADH \`. Mar shampla, chun liosta de na breiseanna go léir a dhéantar tríd an riarachán a fháil: ``` from django.contrib.admin.models import ADDITION, LogEntry LogEntry.objects.filter(action_flag=ADDITION) ``` #### `LogEntry.change_message` 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. ### Modhanna `Logentry` #### `LogEntry.get_edited_object()` Aicearra a thugann an réad tagartha ar ais. #### `LogEntry.get_change_message()` 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. ## URLanna riaracháin a aisiompú \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. Soláthraíonn an:class: adminSite na patrúin URL ainmnithe seo a leanas: | 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\` | Soláthraíonn gach cás: Class: ModelAdmin sraith breise URLanna ainmnithe: | 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` | Soláthraíonn an `UserAdmin` URL ainmnithe: | Leathanach | Ainm URL | Paraiméadair | | --- | --- | --- | | Athrú focal faire | `Auth_úsáideor_athraithe_pasfhocal_athraithe` | ID úsáideora \`\` | 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. 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: ```pycon >>> from django.urls import reverse >>> c = Choice.objects.get(...) >>> change_url = reverse("admin:polls_choice_change", args=(c.id,)) ``` 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. 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: ```pycon >>> change_url = reverse("admin:polls_choice_change", args=(c.id,), current_app="custom") ``` \Le haghaidh tuilleadh sonraí, féach an doiciméadú ar:ref: URLanna spaced ainmneacha a aisiompú . 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: ```html+django {% load admin_urls %} Add user Delete this user ``` 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. ## An maisitheoir `taispeán` #### `display(* (Keyword-only parameters separator (PEP 3102)), boolean=None, ordering=None, description=None, empty_value=None)` 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: ``` @admin.display( boolean=True, ordering="-publish_date", description="Is Published?", ) def is_published(self, obj): return obj.publish_date is not None ``` Tá sé seo comhionann le roinnt tréithe (leis na hainmneacha bunaidh, níos faide) a shocrú go díreach ar an bhfeidhm: ``` def is_published(self, obj): return obj.publish_date is not None is_published.boolean = True is_published.admin_order_field = "-publish_date" is_published.short_description = "Is Published?" ``` 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í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: ``` @admin.display def published_year(self, obj): return obj.publish_date.year ``` Sa chás seo ní chuirfidh sé aon tréithe leis an bhfeidhm. ## An maisitheoir `staff_member_requred` #### `staff_member_required(redirect_field_name='next', login_url='admin:login')` Ú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: - 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. - 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/`. Úsáid sampla: ``` from django.contrib.admin.views.decorators import staff_member_required @staff_member_required def my_view(request): ... ```