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

Saincheap an fhoirm riaracháinLink to this heading#

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.

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:

from django.contrib import admin

from .models import Question


class QuestionAdmin(admin.ModelAdmin):
    fields = ["pub_date", "question_text"]


admin.site.register(Question, QuestionAdmin)

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ú.

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

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ú.

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:

from django.contrib import admin

from .models import Question


class QuestionAdmin(admin.ModelAdmin):
    fieldsets = [
        (None, {"fields": ["question_text"]}),
        ("Date information", {"fields": ["pub_date"]}),
    ]


admin.site.register(Question, QuestionAdmin)

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

Rudaí gaolmhara a chur leisLink to this heading#

Ceart go leor, tá ár leathanach riaracháin Question, againn, ach tá roghanna iolracha ag Choices, agus ní thaispeánann an leathanach riaracháin roghanna.

Fós féin.

Tá dhá bhealach ann chun an fhadhb seo a réiteach. Is é an chéad cheann ná Choice a chlárú leis an riarthóir díreach mar a rinneamar le Question:

from django.contrib import admin

from .models import Choice, Question

# ...
admin.site.register(Choice)

Anois tá "Choices" ina rogha atá ar fáil sa riarthóir Django. Breathnaíonn an fhoirm ""Add choice" mar seo:

San fhoirm sin, is bosca roghnaithe é an réimse "Ceist" ina bhfuil gach ceist sa bhunachar sonraí. Tá a fhios ag Django gur cheart ForeignKey a léiriú sa admin mar bhosca `` <roghnaigh>``. Inár gcás, níl ach ceist amháin ann ag an bpointe seo.

Tabhair faoi deara freisin an nasc "Cuir ceist eile" in aice le "Ceist." Faigheann gach réad a bhfuil gaol ForeignKey aige le duine eile é seo saor in aisce. Nuair a chliceálann tú "Cuir ceist eile leis", gheobhaidh tú fuinneog aníos leis an bhfoirm "Cuir ceist leis". Má chuireann tú ceist sa bhfuinneog sin agus cliceáil "Sábháil", sábhálfaidh Django an cheist sa bhunachar sonraí agus cuirfidh sé go dinimiciúil é mar an rogha roghnaithe ar an bhfoirm "Cuir rogha leis" a bhfuil tú ag féachaint air.

Ach, i ndáiríre, is bealach neamhéifeachtúil é seo chun réada Choice a chur leis an gcóras. Bheadh ​​sé níos fearr dá bhféadfá braon Roghanna a chur leis go díreach nuair a chruthaíonn tú an réad Ceist. Déanaimis é sin a tharlóidh.

Bain an glao clár() don tsamhail Choice. Ansin, cuir in eagar an cód clárúcháin Ceist le léamh:

from django.contrib import admin

from .models import Choice, Question


class ChoiceInline(admin.StackedInline):
    model = Choice
    extra = 3


class QuestionAdmin(admin.ModelAdmin):
    fieldsets = [
        (None, {"fields": ["question_text"]}),
        ("Date information", {"fields": ["pub_date"], "classes": ["collapse"]}),
    ]
    inlines = [ChoiceInline]


admin.site.register(Question, QuestionAdmin)

Insíonn sé seo do Django: "Cuirtear rudaí Choice in eagar ar an leathanach riaracháin Ceist. De réir réamhshocraithe, cuir go leor réimsí ar fáil le haghaidh 3 rogha."

Luchtaigh an leathanach "Cuir ceist leis" chun a fheiceáil conas mar atá sé sin:

Oibríonn sé mar seo: Tá trí shliotán le haghaidh Roghanna gaolmhara -- mar atá sonraithe ag `` breise `` -- agus gach uair a thagann tú ar ais go dtí an leathanach "Athraigh" le haghaidh réad a cruthaíodh cheana féin, gheobhaidh tú trí shliotán breise eile.

Ag deireadh na dtrí shliotán reatha gheobhaidh tú nasc "Cuir Rogha eile leis". Má chliceálann tú air, cuirfear sliotán nua leis. Más mian leat an sliotán breise a bhaint, is féidir leat cliceáil ar an X ar bharr na sliotán breise. Taispeánann an íomhá seo sliotán breise:

Fadhb bheag amháin, áfach. Tógann sé go leor spáis scáileáin chun na réimsí go léir a thaispeáint chun rudaí gaolmhara Choice a iontráil. Ar an ábhar sin, cuireann Django bealach táblach chun rudaí inlíne gaolmhara a thaispeáint. Chun é a úsáid, athraigh an dearbhú ChoiceInline chun a léamh:

class ChoiceInline(admin.TabularInline): ...

Leis an TabularInline sin (in ionad `` StackedInline``), taispeántar na cuspóirí gaolmhara i bhformáid tábla-bhunaithe níos dlúithe:

Tabhair faoi deara go bhfuil breise "Scrios?" colún a cheadaíonn sraitheanna a cuireadh leis a bhaint ag baint úsáide as an gcnaipe "Cuir Rogha eile leis" agus sraitheanna atá sábháilte cheana féin.

Saincheap an liosta athraithe adminLink to this heading#

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.

Seo an chuma atá air ag an bpointe seo:

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:

class QuestionAdmin(admin.ModelAdmin):
    # ...
    list_display = ["question_text", "pub_date"]

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

class QuestionAdmin(admin.ModelAdmin):
    # ...
    list_display = ["question_text", "pub_date", "was_published_recently"]

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

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.

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:

from django.contrib import admin


class Question(models.Model):
    # ...
    @admin.display(
        boolean=True,
        ordering="pub_date",
        description="Published recently?",
    )
    def was_published_recently(self):
        now = timezone.now()
        return now - datetime.timedelta(days=1) <= self.pub_date <= now

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

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:

list_filter = ["pub_date"]

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

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".

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

search_fields = ["question_text"]

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.

Is dea-am é anois freisin le tabhairt faoi deara go dtugann liostaí athraithe leathanach saor in aisce duit. Is é an réamhshocrú ná 100 mír a thaispeáint in aghaidh an leathanaigh. Athraigh leathanach an liosta, boscaí cuardaigh, scagairí, ordlathais dáta, agus column-header-ordering ar fad oibriú le chéile mar a cheapann tú ba chóir dóibh.

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

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

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.

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

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

Saincheap an leathanach innéacs adminLink to this heading#

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

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.

Is é admin/index.html an teimpléad atá le oiriúnú. (Déan mar an gcéanna le `` admin/base_site.html`` sa rannán roimhe seo -- cóipeáil é ón eolaire réamhshocraithe chuig do eolaire teimpléid saincheaptha). Cuir an comhad in eagar, agus feicfidh tú go n-úsáideann sé athróg teimpléid ar a dtugtar `` app_list``. Tá gach aip Django suiteáilte san athróg sin. In ionad é sin a úsáid, is féidir leat naisc a chódú go crua chuig leathanaigh riaracháin a bhaineann go sonrach leis an oibiacht ar bith cibé bealach is fearr leat.

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.