!!!Django 最初のアプリケーション 2 (Admin サイトの構築)
[Python][Django][[[前|Django 最初のアプリケーション 1]]][[[次|Django 最初のアプリケーション 3]]]

Pythonの概要も分かり易い.
{{amazon 477413760X}}

*[The Django Book|http://www.djangobook.com/en/1.0/]

*http://docs.djangoproject.com/en/dev/intro/tutorial02/#intro-tutorial02
を参考にサンプルアプリケーションを作成してみる

!!Admin サイトを有効化
*DjangoのAdminサイトはデフォルトでは有効でない
!有効化手順
::"django.contrib.admin" を INSTALLED_APPS セッティングに追加する
 INSTALLED_APPS = (
     'django.contrib.auth',
     'django.contrib.contenttypes',
     'django.contrib.sessions',
     'django.contrib.sites',
     'django.contrib.admin',
     'mysite.polls'
 )
::python manage.py syncdb を実行。データベースが更新される必要がある
 # python manage.py syncdb
 Creating table django_admin_log
 Installing index for admin.LogEntry model
::mysite/urls.py ファイルを編集し、"Uncomment the next two lines..." 以下のコメントをはずす
 from django.conf.urls.defaults import *
 
 # Uncomment the next two lines to enable the admin:
 from django.contrib import admin   # <- コメントはずす
 admin.autodiscover()               # <- コメントはずす
 
 urlpatterns = patterns('',
     # Example:
     # (r'^mysite/', include('mysite.foo.urls')), 
 
     # Uncomment the admin/doc line below and add 'django.contrib.admindocs'
     # to INSTALLED_APPS to enable admin documentation:
     # (r'^admin/doc/', include('django.contrib.admindocs.urls')), 
 
     # Uncomment the next line to enable the admin:
     (r'^admin/(.*)', admin.site.root),   # <- コメントはずす
 )
!!開発サーバー起動
*アドレスとポートを指定して起動
 # python manage.py runserver 192.168.24.14:8080
 Validating models...
 0 errors found
 
 Django version 1.0.2 final, using settings 'mysite.settings'
 Development server is running at http://192.168.24.14:8080/
 Quit the server with CONTROL-C.

!Adminサイトへログイン

::アクセス http://ホスト:ポート/admin/
{{ref_image django_firstapp06.jpg}}

::Django 最初のアプリケーション 1で設定したユーザIDとパスワードでログイン
{{ref_image django_firstapp07.jpg}}

!!作成した、PollオブジェクトをAdminサイトに追加する
*mysite/polls に admin.py ファイルを作成し、以下の内容を記述
 from mysite.polls.models import Poll
 from django.contrib import admin
 
 admin.site.register(Poll)
*サーバーを再起動

!機能の確認
*Pollを登録したのでDjangoのインデックスページに表示される
{{ref_image django_firstapp08.jpg}}
*Pollsをクリックすると、チェンジリストページが開く。このページでは、データベース上のすべてのPollsが表示される
*そのうちの1つを選択して変更することができる
{{ref_image django_firstapp09.jpg}}
*編集するために、"What's up"を選択
{{ref_image django_firstapp10.jpg}}
::覚書
*Poll モデルから、form は自動生成される
*モデルのフィールド型(DateTimeField, CharField)は、適切なHTMLのInputタグとして表示される
*DateTimeField は、"Today" リンクや、カレンダーポップアップへのリンクが表示され、時間の場合、"Now"リンクや、時間を選択するポップアップへのリンクが表示される

,画面下部のオプション,内容
,Save,保存して、チェンジリストへ戻る
,Save and continue editing,保存して、リロード
,Save and add other,保存して、ブランクページを開く
,Delete,削除確認へ

!!Admin Form のカスタマイズ
*admin form の見た目や働きをカスタマイズしたい場合、/mysite/polls/admin.py を以下のように変更する

!フィールドの表示順を変更する
 from mysite.polls.models import Poll
 from django.contrib import admin
 
 #以下を追加
 class PollAdmin(admin.ModelAdmin):
         fields = ['pub_date', 'question']
 
 #PollAdmin引数を追加
 admin.site.register(Poll,PollAdmin)
{{ref_image django_firstapp11.jpg}}

!フィールドが多数ある場合など、フィールドセットに分割
    class PollAdmin(admin.ModelAdmin):
    fieldsets = [(None,                {'fields':['question']}),      
                 ('Date information',  {'fields':['pub_date']}),
     ]
{{ref_image django_firstapp12.jpg}}
!開閉可能にする
*Djangoが提供する collapse クラスを使用する
    class PollAdmin(admin.ModelAdmin):
    fieldsets = [(None,                {'fields':['question']}),      
                 ('Date information',  {'fields':['pub_date'],'classes':['collapse']}),
     ]
{{ref_image django_firstapp13.jpg}}
{{ref_image django_firstapp14.jpg}}

!関連オブジェクトの追加
*Poll は複数の Choice 持つが、Pollの adminページでは Choice が表示されていない。
::1つ目の方法
*Pollと同様Choiceも adminに 追加する
 from mysite.polls.models import Poll, Choice
 
 from django.contrib import admin
 
 class PollAdmin(admin.ModelAdmin):
         fieldsets = [
                 (None   ,               {'fields':['question']}),
                 ('Date information',     {'fields':['pub_date'],'classes':['collapse']}),
         ]
 admin.site.register(Poll,PollAdmin)
 admin.site.register(Choice)
*Choiceの追加に、Pollを指定するオプションが表示される
{{ref_image django_firstapp15.jpg}}
*Djangoは外部キーを把握しており、プルダウンにすべてのPollを選択可能にする

::2つ目の方法
*1つ目の方法は非効率。Pollオブジェクトから、Choiceオブジェクトを追加できるようにするには、以下のようにする
 from mysite.polls.models import Poll, Choice
 from django.contrib import admin 
 
 class ChoiceInline(admin.StackedInline):
         model = Choice
         extra = 3 
 
 class PollAdmin(admin.ModelAdmin):
         fieldsets = [
                 (None   ,               {'fields':['question']}),
                 ('Date information',     {'fields':['pub_date'],'classes':['collapse']}),
         ]
         inlines = [ChoiceInline]
 
 admin.site.register(Poll,PollAdmin)
 #admin.site.register(Choice)
{{ref_image django_firstapp16.jpg}}

*StackedInline -> TabularInline に変更すると、以下のような表示になる

 class ChoiceInline(admin.TabularInline):

{{ref_image django_firstapp17.jpg}}

!!チェンジリストのカスタマイズ
!一覧にカラムを表示
*Djangoではデフォルトで、オブジェクトの str() メソッドを一覧に表示しているが、役に立つ別のフィールドを list_display オプションを利用して表示することもできる

 class PollAdmin(admin.ModelAdmin):
         fieldsets = [
                 (None   ,               {'fields':['question']}),
                 ('Date information',     {'fields':['pub_date'],'classes':['collapse']}),
         ]
         inlines = [ChoiceInline]
         # この行を追加
         list_display = ('question', 'pub_date', 'was_published_today')

{{ref_image django_firstapp18.jpg}}

!カラムの名称を変更
*カラムヘッダーをクリックすることでソートできるが、任意に追加した was_published_today メソッドなどでは利用不可
*デフォルトではカラムにメソッド名が表示されているが、short_description 属性にて変更できる

/mysite/polls/models.py
 class Poll(models.Model):
                 :
         def was_published_today(self):
                 return self.pub_date == datetime.date.today()
         # 以下を追加
         was_published_today.short_description = 'Published today?'
{{ref_image django_firstapp19.jpg}}

!フィルターの追加
 class PollAdmin(admin.ModelAdmin):
         fieldsets = [
                 (None   ,               {'fields':['question']}),
                 ('Date information',     {'fields':['pub_date'],'classes':['collapse']}),        ]
         inlines = [ChoiceInline]        list_display = ('question', 'pub_date', 'was_published_today')
         # 以下を追加
         list_filter = ['pub_date']

pub_date に対するフィルターサイドバーが表示される
{{ref_image django_firstapp20.jpg}}

!検索フィールドの追加
以下を追加
 search_fields = ['question']
{{ref_image django_firstapp21.jpg}}

!日付フィールドでのドリルダウン
以下を追加
 date_hierarchy = 'pub_date'
{{ref_image django_firstapp22.jpg}}

!!Admin のルック＆フィールの変更
*Djangoのテンプレートシステム機能によって、ルック＆フィールを簡単に変更できる
*mysite/settings.py 設定ファイルを開き、Djangoテンプレートの設定をTEMPLATE_DIRSで変更する
*デフォルトで、TEMPLATE_DIRSは空になっている
 TEMPLATE_DIRS = (
     # Put strings here, like "/home/html/django_templates" or "C:/www/django/templates".
     # Always use forward slashes, even on Windows.
     # Don't forget to use absolute paths, not relative paths.
     "/home/my_username/mytemplates",
 )

*TEMPLATE_DIRS で指定したフォルダの下に adminフォルダを作成し、/django/contrib/admin/templates/admin/base_site.html をコピーする
 # cd /usr/local/lib/python2.6/site-packages/django/contrib/admin/templates/admin
 # cp base_site.html /home/my_username/mytemplates/admin

*コピーしたファイルを適当に変更
 {% load i18n %}
 {% load i18n %}
 
 {% block title %}{{ title }} | {% trans 'My Sample site admin' %}{% endblock %}
 
 {% block branding %}
 <h1 id="site-name">{% trans 'My Sample  administration' %}</h1>
 {% endblock %}
 
 {% block nav-global %}{% endblock %}
*タイトルが変更された
{{ref_image django_firstapp23.jpg}}

[[[前|Django 最初のアプリケーション 1]]][[[次|Django 最初のアプリケーション 3]]]