{"title":"Pisanie pierwszej aplikacji Django, część 7.","version":"4.1","locale":"pl","docname":"intro/tutorial07","url":"/pl/4.1/intro/tutorial07/","canonical":"https://djangodocs.dev/pl/4.1/intro/tutorial07/","summary":"This tutorial begins where Tutorial 6 left off. We’re continuing the web-poll application and will focus on customizing Django’s automatically-generated…","html":"

Pisanie pierwszej aplikacji Django, część 7.Link to this heading#

\n

This tutorial begins where Tutorial 6 left off. We’re\ncontinuing the web-poll application and will focus on customizing Django’s\nautomatically-generated admin site that we first explored in Tutorial 2.

\n\n
\n

Dostosuj formularz panelu administracyjnegoLink to this heading#

\n

Rejestrując model Question przez admin.site.register(Question), umożliwiłeś Django skonstruowanie domyślnej reprezentacji formularza. Często będziesz chciał zmienić to jak formularz panelu administracyjnego wygląda i działa. Będziesz to robił mówiąc Django, jakie wybierasz opcje, rejestrując obiekt.

\n

Zobaczmy jak to działa zmieniając kolejność pól w formularzu edycji. Zamień linię admin.site.register(Question) na:

\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\nadmin.site.register(Question, QuestionAdmin)\n
\n

Będziesz realizował ten wzorzec stworzenie klasy model admin, następnie przekazanie jej jako drugiego argumentu do admin.site.register() – w dowolnym momencie, kiedy potrzebujesz zmienić opcje admina dla modelu.

\n

Konkretnie ta zmiana powyżej powoduje, że „Publication date” jest przed polem „Question”:

\n\"Fields\n

Nie robi to wrażenia z tylko dwoma polami, ale dla formularzy admina z tuzinami pól, wybranie intuicyjnego porządku jest ważnym szczegółem użyteczności.

\n

A mówiąc o formularzach z tuzinami pól, możesz chcieć podzielić formularz na fieldsety:

\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\nadmin.site.register(Question, QuestionAdmin)\n
\n

Pierwszym elementem każdej krotki w fieldsets jest tytuł fieldsetu. Tak wygląda teraz nasz formularz:

\n\"Form\n
\n\n
\n

Dostosuj widok listy panelu administracyjnegoLink to this heading#

\n

Teraz, kiedy strona admina dla pytania wygląda dobrze, poprawmy nieco stronę „change list” – tę, która wyświetla wszystkie pytania w systemie.

\n

Tak ona wygląda w tym momencie:

\n\"Polls\n

Domyślnie Django wyświetla str() każdego obiektu. Ale czasem bardziej pomocne byłoby wyświetlanie poszczególnych pól. Aby to zrobić, użyj list_display

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

Na wszelki wypadek dodajmy też metodę was_published_recently() z Tutoriala 2:

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

Teraz strona „change list” pytań wygląda w ten sposób:

\n\"Polls\n

Możesz klikać w nagłówki kolumn, aby sortować po tych wartościach – z wyjątkiem przypadku nagłówka was_published_recently, ponieważ sortowanie po wyniku arbitralnej metody nie jest wspierane. Zwróć też uwagę, że nagłówek kolumny dla was_published_recently jest domyślnie nazwą metody (z podkreślnikami zamienionymi na spacje) i każda linia zawiera reprezentację w ciągu znaków wyniku.

\n

Możesz to poprawić używając dekoratora display() na tej metodzie (w polls/models.py), w następujący sposób:

\n
polls/models.py
\n
Python
from django.contrib import admin\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

Po więcej informacji na temat właściwości konfigurowalnych przez ten dekorator, zobacz list_display.

\n

Zmień znów swój plik polls/admin.py i dodaj ulepszenie do strony „change list” Questions: filtry, z użyciem list_filter. Dodaj następującą linię do QuestionAdmin:

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

Doda to sidebar „Filter”, który pozwala ludziom filtrować listę obiektów używając pola pub_date:

\n\"Polls\n

Typ wyświetlanego filtru zależy od typu pola, po którym filtrujesz. Ponieważ pub_date to DateTimeField, Django wie, aby dać odpowiednie opcje w filtrze: „Any date”, „Today”, „Past 7 days”, „This month”, „This year”.

\n

Dobrze się to zarysowuje. Dodajmy trochę możliwości wyszukiwania:

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

To dodaje pole wyszukiwania na górze „change listy”. Kiedy ktoś wprowadzi wyrażenie wyszukiwania, Django przeszuka pole question_text. Możesz użyć tyle pól, na ile masz ochotę – choć z powodu, że pod maską użyje to zapytania LIKE, ograniczenie liczby pól wyszukiwania do rozsądnej liczby ułatwi twojej bazie danych wykonać wyszukiwanie.

\n

Teraz jest dobry moment, by zwrócić uwagę, że „change lista” daje ci wolną paginację. Domyślnie wyświetla ona 100 elementów na stronę. Zmień paginację listy, pola wyszukiwania, filtry, hierarchie dat i:attr:kolejność kolumn nagłówków <django.contrib.admin.ModelAdmin.list_display> tak, aby wspólnie współgrały tak, jak uważasz, że powinny.

\n
\n
\n

Dostosuj wygląd i pracę z panelem administracyjnymLink to this heading#

\n

Oczywiście, wyświetlanie napisu „Django administration” na górze każdej strony panelu administracyjnego jest bez sensu. To tylko tekst zastępczy.

\n

Możesz go zmienić przy użyciu systemu szablonów Django. Panel administracyjny Django jest napędzany przez samo Django i jego interfejsy używają własnego systemu szablonów Django.

\n
\n

Dostosowywanie szablonów twojego projektuLink to this heading#

\n

Stwórz katalog templates w katalogu twojego projektu (tym, który zawiera manage.py). Szablony mogą być składowane w dowolnym miejscu twojego systemu plików, do którego może mieć dostęp Django. (Django jest uruchomione na tym samym użytkowniku co serwer.) Jednakże trzymanie szablonów wewnątrz projektu jest dobrą konwencją.

\n

Otwórz swój plik ustawiń (mysite/settings.py, pamiętaj) i dodaj opcję DIRS w ustawieniu 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.debug',\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 jest listą katalogów systemu plików, które należy sprawdzić ładując szablony Django; jest ścieżką wyszukiwania.

\n\n

Teraz stwórz katalog o nazwie admin wewnątrz templates i skopiuj szablon admin/base_site.html z katalogu domyślnych szablonów panelu administracyjnego z kodu źródłowego Django (django/contrib/admin/templates) do tego katalogu.

\n\n

Następnie zmień plik i zamień {{ site_header|default:_('Django administration')  }} (wliczając nawiasy klamrowe) na nazwę swojej strony, która będzie pasować. Powinieneś skończyć z sekcją kodu typu:

\n
Django template
{% block branding %}\n<h1 id="site-name"><a href="{% url 'admin:index' %}">Polls Administration</a></h1>\n{% endblock %}\n
\n

Używamy tego podejścia, aby nauczyć cię jak nadpisywać szablony. W prawdziwym projekcie, prawdopodobnie użyłbyś atrybutu django.contrib.admin.AdminSite.site_header, aby w prostszy sposób zrobić tę konkretną zmianę.

\n

Ten plik szablonu zawiera pełno tekstów typu {% block branding %} i {{ title }}. Tagi {% i {{ są częścią języka szablonów Django. Kiedy Django renderuje admin/base_site.html, ten język szablonów jest ewaluowany i produkuje ostateczną stronę HTML, tak jak widzieliśmy w Tutorialu 3.

\n

Zwróć uwagę, że każdy domyślny szablon panelu administracyjnego Django może być nadpisany. Aby nadpisać szablon, zrób tę samą czynność, którą zrobiłeś z base_site.html – skopiuj je z domyślnego katalogu do swojego własnego katalogu i zrób zmiany.

\n
\n
\n

Zmiana szablonów twojej aplikacjiLink to this heading#

\n

Bystrzy czytelnicy zapytają: Ale skoro DIRS było domyślnie puste, jak Django odnajdywało domyślne szablony admina? Odpowiedzią jest, tak długo jak APP_DIRS jest ustawione na True, Django automatycznie szuka podkatalogu templates/ w każdym pakiecie aplikacji, aby użyć go jako fallback (nie zapomnij, że django.contrib.admin jest aplikacją).

\n

Nasza aplikacja ankietowa nie jest bardzo złożona i nie potrzebuje customowych szablonów admina. Lecz gdyby urosła do bardziej skomplikowanej i wymagała modyfikacji standardowych szablonów admina do jakiś swoich funkcjonalności, byłoby bardziej rozsądne modyfikować szablony aplikacji niż te w projekcie. W ten sposób mógłbyś zawrzeć aplikację ankietową w dowolnym nowym projekcie i miałbyś pewność, że odnajdzie customowe szablony, których potrzebuje.

\n

W dokumentacji ładowania szablonów więcej informacji o tym, jak Django odnajduje swoje szablony.

\n
\n
\n
\n

Dostosuj stronę indeksu panelu administracyjnegoLink to this heading#

\n

W podobnym tonie możesz chcieć zmienić wygląd i odbiór strony indeksu panelu admina Django.

\n

Domyślnie wyświetla ona wszystkie aplikacje w INSTALLED_APPS, które zostały zarejestrowane z aplikacją admin, w kolejności alfabetycznej. Możesz chcieć dokonać istotnych zmian w wyglądzie. W końcu, strona główna jest prawdopodobnie najważniejszą stroną admina i powinna być łatwa w użyciu.

\n

Szablon do dostosowania to admin/index.html. (Zrób to samo co z admin/base_site.html w poprzedniej sekcji – skopiuj go z domyślnego katalogu do swojego katalogu zmienionych szablonów). Zedytuj plik. Zobaczysz, że używa on zmiennej szablonu o nazwie app_list. Ta zmienna zawiera wyszystkie zainstalowane aplikacje Django. Zamiast jej używać możesz zahardcode’ować linki do adminowych stron obiektów w dowolny sposób, który uznasz za najlepszy.

\n
\n
\n

Co dalej?Link to this heading#

\n

Tutorial dla początkujących kończy się tutaj. W międzyczasie możesz chcieć sprawdzić niektóre z kierunków wskazanych w gdzie iść dalej.

\n

Jeśli jesteś zaznajomiony z pakietowaniem w Pythonie i zainteresowany jak uczynić ankiety „aplikacją reusable”, sprawdź Zaawansowany tutorial: Jak pisać aplikacje do ponownego wykorzystania.

\n
","rootId":"writing-your-first-django-app-part-7","toc":[{"title":"Dostosuj formularz panelu administracyjnego","anchor":"customize-the-admin-form","children":[]},{"title":"Dodawanie powiązanych obiektów","anchor":"adding-related-objects","children":[]},{"title":"Dostosuj widok listy panelu administracyjnego","anchor":"customize-the-admin-change-list","children":[]},{"title":"Dostosuj wygląd i pracę z panelem administracyjnym","anchor":"customize-the-admin-look-and-feel","children":[{"title":"Dostosowywanie szablonów twojego projektu","anchor":"customizing-your-project-s-templates","children":[]},{"title":"Zmiana szablonów twojej aplikacji","anchor":"customizing-your-application-s-templates","children":[]}]},{"title":"Dostosuj stronę indeksu panelu administracyjnego","anchor":"customize-the-admin-index-page","children":[]},{"title":"Co dalej?","anchor":"what-s-next","children":[]}],"breadcrumbs":[{"docname":"intro/index","title":"Pierwsze kroki","url":"/pl/4.1/intro/"}],"prev":{"docname":"intro/tutorial06","title":"Pisanie pierwszej aplikacji Django, część 6.","url":"/pl/4.1/intro/tutorial06/"},"next":{"docname":"intro/reusable-apps","title":"Zaawansowany tutorial: Jak pisać aplikacje wielokrotnego użytku","url":"/pl/4.1/intro/reusable-apps/"},"formats":{"html":"/pl/4.1/intro/tutorial07/","markdown":"/pl/4.1/intro/tutorial07.md","json":"/pl/4.1/intro/tutorial07.json"},"source":"https://github.com/django/django/blob/stable/4.1.x/docs/intro/tutorial07.txt","official":"https://docs.djangoproject.com/pl/4.1/intro/tutorial07/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10"],"inLocales":["en","zh-hans","fr","ja","id","it","pt-br","ko","es","el","pl"]}