{"title":"Ag scríobh do chéad aip Django, cuid 7","version":"6.1","locale":"ga","docname":"intro/tutorial07","url":"/ga/6.1/intro/tutorial07/","canonical":"https://djangodocs.dev/ga/6.1/intro/tutorial07/","summary":"Tosaíonn an rang teagaisc seo nuair a d'fhág Tutorial 6 as. Táimid ag leanúint leis an bhfeidhmchlár vótaíochta gréasáin agus díreoimid ar shuíomh…","html":"

Ag scríobh do chéad aip Django, cuid 7Link to this heading#

\n

Tosaíonn an rang teagaisc seo nuair a d'fhág Tutorial 6 as. Táimid ag leanúint leis an bhfeidhmchlár vótaíochta gréasáin agus díreoimid ar shuíomh riaracháin Django a ghintear go huathoibríoch a shaincheapadh a rinneamar iniúchadh ar dtús i Teagasc 2.

\n\n
\n

Saincheap an fhoirm riaracháinLink to this heading#

\n

Trí mhúnla Ceist a chlárú le admin.site.register(Question), bhí Django in ann léiriú réamhshocraithe foirme a chruthú. Go minic, beidh tú ag iarraidh conas a bhreathnaíonn agus a oibríonn an fhoirm riaracháin a shaincheapadh. Déanfaidh tú é seo trí na roghanna atá uait a insint do Django nuair a chláraíonn tú an réad.

\n

Feicfimid conas a oibríonn sé seo trí na réimsí ar an bhfoirm eagarthóireachta a athordú. Ionadaigh an líne admin.site.register(Ceist) le:

\n
polls/admin.py
\n
Python
from django.contrib import admin\n\nfrom .models import Question\n\n\nclass QuestionAdmin(admin.ModelAdmin):\n    fields = ["pub_date", "question_text"]\n\n\nadmin.site.register(Question, QuestionAdmin)\n
\n

Leanfaidh tú an patrún seo -- cruthaigh rang admin samhail, ansin cuir ar aghaidh é mar an dara argóint chuig admin.site.register() -- am ar bith is gá duit na roghanna riaracháin do shamhail a athrú.

\n

Fágann an t-athrú áirithe seo thuas go dtagann an "Publication date" roimh an réimse "Question":

\n\"Réimsí\n

Níl sé seo go hiontach le dhá réimse, ach i gcás foirmeacha riaracháin ina bhfuil mórán réimsí, is sonraí inúsáidteachta tábhachtach é ordú iomasach a roghnú.

\n

Agus foirmeacha ag baint le mórán réimsí, b'fhéidir gur mhaith leat an fhoirm a roinnt ina réimsí páirce:

\n
polls/admin.py
\n
Python
from django.contrib import admin\n\nfrom .models import Question\n\n\nclass QuestionAdmin(admin.ModelAdmin):\n    fieldsets = [\n        (None, {"fields": ["question_text"]}),\n        ("Date information", {"fields": ["pub_date"]}),\n    ]\n\n\nadmin.site.register(Question, QuestionAdmin)\n
\n

Is é an chéad eilimint de gach tuple in fieldsets teideal an réimse réimse. Seo an chuma atá ar ár bhfoirm anois:

\n\"Tá\n
\n\n
\n

Saincheap an liosta athraithe adminLink to this heading#

\n

Anois go bhfuil cuma mhaith ar leathanach riaracháin na gCeisteanna, déanaimis roinnt tweaks ar an leathanach "liosta athraithe" - an ceann a thaispeánann na ceisteanna go léir sa chóras.

\n

Seo an chuma atá air ag an bpointe seo:

\n\"Athraítear\n

De réir réamhshocraithe, taispeánann Django an `` str ()`` de gach réad. Ach uaireanta bheadh ​​sé níos cabhrach dá bhféadfaimis réimsí aonair a thaispeáint. Chun é sin a dhéanamh, bain úsáid as an rogha admin list_display, arb é liosta ainmneacha páirce é le taispeáint, mar cholúin, ar an leathanach liosta athruithe don réad:

\n
polls/admin.py
\n
Python
class QuestionAdmin(admin.ModelAdmin):\n    # ...\n    list_display = ["question_text", "pub_date"]\n
\n

Ar mhaithe le beart maith, cuirimis san áireamh freisin an modh foilsíodh_le déanaí() ó Teagasc 2:

\n
polls/admin.py
\n
Python
class QuestionAdmin(admin.ModelAdmin):\n    # ...\n    list_display = ["question_text", "pub_date", "was_published_recently"]\n
\n

Anois tá cuma mar seo ar an leathanach liosta athraithe ceisteanna:

\n\"Leathanach\n

Is féidir leat cliceáil ar na ceanntásca colúin chun iad a shórtáil de réir na luachanna sin -- ach amháin i gcás an chinnteidil foilsíodh_le déanaí_, mar ní thacaítear le sórtáil de réir aschur modha treallach. Tabhair faoi deara freisin gurb é ceanntásc an cholúin le haghaidh foilsíodh_le déanaí, de réir réamhshocraithe, ainm an mhodha (agus spásanna curtha in ionad na bhfostóirí), agus go bhfuil léiriú teaghrán an aschuir i ngach líne.

\n

Is féidir leat é sin a fheabhsú trí úsáid a bhaint as an maisitheoir display() ar an modh sin (ag síneadh leis an gcomhad :comhad:`polls/models.py` a cruthaíodh i Teagasc 2), mar a leanas:

\n
polls/models.py
\n
Python
from django.contrib import admin\n\n\nclass Question(models.Model):\n    # ...\n    @admin.display(\n        boolean=True,\n        ordering="pub_date",\n        description="Published recently?",\n    )\n    def was_published_recently(self):\n        now = timezone.now()\n        return now - datetime.timedelta(days=1) <= self.pub_date <= now\n
\n

Le haghaidh tuilleadh eolais ar na hairíonna is féidir a chumrú tríd an maisitheoir, féach list_display.

\n

Cuir do chomhad ::polls/admin.py in eagar arís agus cuir feabhas ar an leathanach liosta athruithe Ceist: scagairí ag baint úsáide as an list_filter. Cuir an líne seo a leanas le QuestionAdmin:

\n
Code
list_filter = ["pub_date"]\n
\n

Cuireann sé sin barra taoibh "Filter" leis a ligeann do dhaoine an liosta athruithe a scagadh de réir an réimse `` pub_date``:

\n\"Leathanach\n

Braitheann an cineál scagaire a thaispeánfar ar an gcineál réimse a bhfuil tú ag scagadh air. Toisc gur DateTimeField é `` pub_date``, tá a fhios ag Django roghanna cuí scagaire a thabhairt: "Dáta ar bith", "Inniu", "7 lá anuas", "An mhí seo", "I mbliana".

\n

Tá sé seo ag múnlú suas go maith. Cuirimis roinnt cumas cuardaigh leis:

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

Cuireann sé sin bosca cuardaigh ag barr an liosta athruithe. Nuair a chuireann duine téarmaí cuardaigh isteach, déanfaidh Django an réimse question_text a chuardach. Is féidir leat an oiread réimsí agus is mian leat a úsáid -- ach toisc go n-úsáideann sé fiosrú LIKE` taobh thiar de na pictiúir, má chuirtear teorainn le líon na réimsí cuardaigh go líon réasúnta, beidh sé níos éasca do do bhunachar sonraí an cuardach a dhéanamh.

\n

Now's also a good time to note that change lists give you free pagination. The\ndefault is to display 100 items per page.

\n\n
\n
\n

Saincheap cuma agus mothú an riaracháinLink to this heading#

\n

Is léir gur rud ridiciúil é “riarachán Django” ag barr gach leathanach riaracháin. Níl ann ach téacs áitsealbhóra.

\n

Is féidir leat é a athrú, áfach, ag baint úsáide as córas teimpléad Django. Tá an riarthóir Django faoi thiomáint ag Django féin, agus úsáideann a chomhéadain córas teimpléid Django féin.

\n
\n

Saincheapadh do * tionscadail * teimpléidLink to this heading#

\n

Cruthaigh eolaire templates i do eolaire djangotutorial. Is féidir le teimpléid maireachtáil áit ar bith ar do chóras comhad ar féidir le Django rochtain a fháil air. (Ritheann Django mar cibé úsáideoir a ritheann do fhreastalaí.) Mar sin féin, is dea-ghnás é do theimpléid a choinneáil laistigh den tionscadal.

\n

Oscail do chomhad socruithe (:comhad:`mysite/settings.py`, cuimhnigh) agus cuir rogha DIRS leis sa socrú TEMPLATES:

\n
mysite/settings.py
\n
Python
TEMPLATES = [\n    {\n        "BACKEND": "django.template.backends.django.DjangoTemplates",\n        "DIRS": [BASE_DIR / "templates"],\n        "APP_DIRS": True,\n        "OPTIONS": {\n            "context_processors": [\n                "django.template.context_processors.request",\n                "django.contrib.auth.context_processors.auth",\n                "django.contrib.messages.context_processors.messages",\n            ],\n        },\n    },\n]\n
\n

DIRS is ea liosta eolairí córais comhaid le seiceáil agus teimpléid Django á lódáil; is cosán cuardaigh é.

\n\n

Anois cruthaigh eolaire darb ainm `` admin`` taobh istigh de `` teimpléid``, agus cóipeáil an teimpléad `` admin/base_site.html`` ón eolaire réamhshocraithe teimpléid admin Django i gcód foinse Django féin (: foinse:` django/contrib/admin/templates`) isteach san eolaire sin.

\n\n

Ansin, cuir an comhad in eagar agus cuir ainm do shuímh féin in áit {{ site_header|réamhshocraithe:_('Riarachán Django') }} (lena n-áirítear na braces curly) mar is cuí leat. Ba chóir go mbeadh roinn de chód mar:

\n
Django template
{% block branding %}\n<div id="site-name"><a href="{% url 'admin:index' %}">Polls Administration</a></div>\n{% if user.is_anonymous %}\n  {% include "admin/color_theme_toggle.html" %}\n{% endif %}\n{% endblock %}\n
\n

Bainimid úsáid as an gcur chuige seo chun tú a mhúineadh conas teimpléid a shárú. I dtionscadal iarbhír, is dócha go n-úsáidfeá an tréith django.contrib.admin.AdminSite.site_header chun an saincheapadh áirithe seo a dhéanamh níos éasca.

\n

Tá go leor téacs sa chomhad teimpléad seo ar nós {% brandáil bloc %} agus {{ title }}. Is cuid de theanga teimpléid Django iad na clibeanna {% agus {{. Nuair a dhéanann Django admin/base_site.html, déanfar an teanga teimpléid seo a mheas chun an leathanach HTML deiridh a tháirgeadh, díreach mar a chonaic muid i Teagasc 3.

\n

Tabhair faoi deara gur féidir aon cheann de na teimpléid admin réamhshocraithe Django a shárú. Chun teimpléad a shárú, déan an rud céanna a rinne tú le base_site.html -- cóipeáil é ón eolaire réamhshocraithe isteach i do eolaire saincheaptha, agus déan athruithe.

\n
\n
\n

Saincheapadh d'iarratais * teimpléidLink to this heading#

\n

Fiafróidh léitheoirí géara: Ach má bhí: socrú:DIRS <TEMPLATES-DIRS> folamh de réir réamhshocraithe, conas a d'aimsigh Django na teimpléid réamhshocraithe admin? Is é an freagra ná, ós rud é go bhfuil : socrú:APP_DIRS <TEMPLATES-APP_DIRS> socraithe go True, lorgaíonn Django go huathoibríoch fochomhadlann templates/ laistigh de gach pacáiste feidhmchláir, lena úsáid mar chúltaca (don ' ná déan dearmad gur feidhmchlár é django.contrib.admin).

\n

Níl ár bhfeidhmchlár vótaíochta an-chasta agus ní bhíonn teimpléid shaincheaptha riaracháin ag teastáil uaidh. Ach dá bhfásfadh sé níos sofaisticiúla agus go raibh gá le mionathrú a dhéanamh ar theimpléid chaighdeánacha riaracháin Django le haghaidh cuid dá fheidhmiúlacht, bheadh ​​sé níos ciallmhaire teimpléid an fheidhmchláir a mhodhnú, seachas iad siúd sa tionscadal. Ar an mbealach sin, d'fhéadfá an t-iarratas vótaíochta a áireamh in aon tionscadal nua agus a bheith cinnte go bhfaighidh sé na teimpléid saincheaptha a bhí de dhíth air.

\n

Féach an doiciméadú luchtaithe teimpléad le haghaidh tuilleadh eolais faoin gcaoi a n-aimsíonn Django a theimpléid.

\n
\n
\n
\n

Saincheap an leathanach innéacs adminLink to this heading#

\n

Ar nóta comhchosúil, b'fhéidir gur mhaith leat cuma agus mothú an leathanaigh innéacs riaracháin Django a shaincheapadh.

\n

De réir réamhshocraithe, taispeánann sé na haipeanna go léir i: socrú:INSTALLED_APPS atá cláraithe leis an bhfeidhmchlár riaracháin, in ord aibítre. B'fhéidir gur mhaith leat athruithe suntasacha a dhéanamh ar an leagan amach. Tar éis an tsaoil, is dócha gurb é an t-innéacs an leathanach is tábhachtaí den riarthóir, agus ba cheart go mbeadh sé éasca le húsáid.

\n

The template to customize is admin/index.html. (Do the same as with\nadmin/base_site.html in the previous section -- copy it from the default\ndirectory to your custom template directory). Edit the file, and you'll see it\nuses a template variable called app_list. That variable contains every\ninstalled Django app. Instead of using that, you can hardcode links to\nobject-specific admin pages in whatever way you think is best.

\n

Nuair atá tú ar do chompord leis an riarthóir, léigh cuid 8 den rang teagaisc seo chun foghlaim conas pacáistí tríú páirtí a úsáid.

\n
","rootId":"writing-your-first-django-app-part-7","toc":[{"title":"Saincheap an fhoirm riaracháin","anchor":"customize-the-admin-form","children":[]},{"title":"Rudaí gaolmhara a chur leis","anchor":"adding-related-objects","children":[]},{"title":"Saincheap an liosta athraithe admin","anchor":"customize-the-admin-change-list","children":[]},{"title":"Saincheap cuma agus mothú an riaracháin","anchor":"customize-the-admin-look-and-feel","children":[{"title":"Saincheapadh do * tionscadail * teimpléid","anchor":"customizing-your-project-s-templates","children":[]},{"title":"Saincheapadh d'iarratais * teimpléid","anchor":"customizing-your-application-s-templates","children":[]}]},{"title":"Saincheap an leathanach innéacs admin","anchor":"customize-the-admin-index-page","children":[]}],"breadcrumbs":[{"docname":"intro/index","title":"Ag tosnú","url":"/ga/6.1/intro/"}],"prev":{"docname":"intro/tutorial06","title":"Do chéad aip Django a scríobh, cuid 6","url":"/ga/6.1/intro/tutorial06/"},"next":{"docname":"intro/tutorial08","title":"Do chéad aip Django a scríobh, cuid 8","url":"/ga/6.1/intro/tutorial08/"},"formats":{"html":"/ga/6.1/intro/tutorial07/","markdown":"/ga/6.1/intro/tutorial07.md","json":"/ga/6.1/intro/tutorial07.json"},"source":"https://github.com/django/django/blob/stable/6.1.x/docs/intro/tutorial07.txt","official":"https://docs.djangoproject.com/ga/6.1/intro/tutorial07/","inVersions":["6.1","6.0","5.2"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}