首頁 > 後端開發 > Python教學 > Djangoadminsite(一)ModelAdminOptions

Djangoadminsite(一)ModelAdminOptions

黄舟
發布: 2016-12-23 17:44:11
原創
1328 人瀏覽過

Admin管理介面是django的殺手級應用。它讀取你模式中的元數據,然後提供給你一個強大且可以使用的介面,網站管理者可以用它立即為網站添加內容。

要使用admin,可以按照下面的步驟:

將'django.contrib.admin'加入setting的INSTALLED_APPS設定中。

保證INSTALLED_APPS中包含'django.contrib.auth','django.contrib.contenttypes','django.contrib.messages'和'django.contrib.sessions.',Django的admin需要這4個包。

將'django.contrib.messages.context_PRo​​cessors.messages'添加到 TEMPLATE_CONTEXT_PROCESSORS中,並確保MIDDLEWARE_CLASSES 包含'django.contrib.auth.middleware.Authmentiwareware.Auth.djangom.djm.dj​​mango​​o.Auth.mango​​m​​k.確定。 (預設已加入)

決定哪些Model需要應用到admin中。

為每個需要admin的app中的admin.py中建立一個ModelAdmin。

註冊Model及ModelAdmin

from django.contrib import admin
from myproject.myapp.models import Author

class AuthorAdmin(admin.ModelAdmin): orm.


將admin存取配置在URLconf中

from django.contrib import admin

admin.autodiscover()


# And include this URLpattern...
urlpatterns = patterns('',
...... ', include(admin.site.urls)),
   # ...
)


運行python manage.py migrate提醒創建superuser後就可以訪問http://127.0.0.1:8000/admin/了。

ModelAdmin物件

register裝飾器

register(*models[, site=django.admin.sites.site])

1.7中新加入。 Model和ModelAdmin可以這樣註冊:

from django.contrib import admin

from .models import Author

@admin.register(Author)
class AuthorAdmin(admin.ModelAdmin): 一次註冊
class AuthorAdmin(admin.ModelAdmin): 一次註冊🜎由ite )
class PersonAdmin(admin.ModelAdmin):
   pass

Admin是如何工作的

當把'django.contrib.admin'添加到INSTALLED_APPS後,django會自動查找每個app中的django. import載入。


class apps.AdminConfig
Django 1.7新增.
admin預設的AppConfig類別.當django啟動時會執行autodiscover()。

class apps.SimpleAdminConfig
Django 1.7新增.
類似於AdminConfig,不會執行autodiscover().

autodiscover()

import每個app的admin.py模組。

Django 1.7改變:

在先前的版本中需要在urls.py中手動啟動此方法去尋找每個app的admin.py,1.7後AdminConfig會自動執行此方法。

如果正在使用自訂的AdminSite,需要將ModelAdmin的子類別載入到自己的程式碼中並全部註冊到自訂的AdminSite中。這種情況下需要停止自動discovery(),可以將'django.contrib.admin.apps.SimpleAdminConfig'代替INSTALLED_APPS中的'django.contrib.admin'。

ModelAdmin選項

actions

admin actions的清單

actions_on_top

actions_on_bottom

action的位置。

date_hierarchy

將date_hierarchy設為Model的DateField或DateTimeField,就可以為admin中的此Model新增日期層次。

fields

exclude


決定Model的form中展現哪些字段。 fields是包括,exclude是排除。

from django.contrib import admin

class AuthorAdmin(admin.ModelAdmin):

   fields = ('name', 'title')

class AuthorAdmin(admin.ModelAdmin):

   exclude = ('birth_date',)

可以將一些欄位放在同一行,如下url和title欄位放在同一行:

class FlatPageAdmin(admin.ModelAdmin):

   fields = (('url', 'title'), 'content')


fieldsets

fieldsets是雙元組(name, field_options)的列表,可以將字段分塊:

from django.contrib import admin

class FlatPageAdmin(admin.ModelAdmin (None , {

           'fields': ('url', 'title', 'content', 'sites')

       }),

    ('collapse',),
           ' fields': ('enable_comments', 'registration_required', 'template_name')
       }),

   )

name是塊的標題,field_options是一個字典。

field_options的key有以下幾種:

  fields

欄位名稱的元組,在fieldset中展示

{
'fields': (('first_name', 'last_name'), 'last_name'), 'address', ' ', 'state'),
}

  classes

提供給fieldset的額外CSS類別的清單。

  description

可以在fieldset頂部額外展示的文字。

filter_horizo​​ntal
filter_vertical

Model有ManyToManyField欄位時,使用filter_horizo​​ntal,filter_vertical可以從現有的​​選項中多選。一個為橫排,一個為垂直排。

form

使用的表單。

from django import forms
from django.contrib import admin
from myapp.models import Person

class PersonForm(forms.ModelForm): Person     exclude = ['name']

class PersonAdmin(admin.ModelAdmin):
   exclude = ['age']
   form = PersonForm


衝突時,ModelAdmin優先。上面的例子中age會被排除,但name會在頁面中展示。

formfield_overrides

可以覆蓋Model表單介面的一些字段的選項,為一些特定類型的字段添加自己定制的部件

比如,想為自己Model的TextField字段使用富文本編輯器:

from django. import models

from django.contrib import admin

# Import our custom widget and our model from where they're defined

from myapp.widgets import RichTextEditorWidgetgetonidapp; ):
formfield_overrides = {
       models.TextField: {'widget': RichTextEditorWidget},
   }


list_display
   }


list_display
list結果。

 list_display中有4種值:

model的一個欄位

list_display = ('first_name', 'last_name')

一個可呼叫的以model為參數的函數為參數的函數return ("%s %s" % (obj.first_name, obj.last_name)).upper()

upper_case_name.short_description = 'Name'

class PersonAdmin(admin.ModelAdmin): 'Name'

class Person阿

ModelAdmin的一個屬性,類似可呼叫函數

class PersonAdmin(admin.ModelAdmin):
   list_display = ('upper_case_name',)
   def s" % 。

class Person(models.Model):

   name = models.CharField(max_length=50)

   birthday = models.DateField()

born birthday.strftime('%Y') [:3] + "0's"

   decade_born_in.short_description = 'Birth decade'

class PersonAdmin(admin.ModelAdmin):
   list_display = ('name',' ,會顯示外鍵的__unicode__。

不支援ManyToManyField

如果是BooleanField,會顯示on或off。

如果提供的字串是Model或ModelAdmin的方法或可呼叫函數,django會自動的HTML-escape輸出,如果不想轉義,可以將方法的allow_tags設為True。為了避免XSS跨站攻擊,需要使用format_html轉義用戶的輸入:

from django.db import models
from django.contrib import admin
from django.utils.html import format_html

class Person(models.Model):🠎   maxfir. name = models.CharField (max_length=50)
   color_code = models.CharField(max_length=6)

   def colored_name(self):
卷/span>',
                          self.color_code,
         sel                                      self.last_name)

   colored_name.allow_tags = True
class PersonAdmin(admin.ModelAdmin): colored_name') 


如果提供的字串是Model或ModelAdmin的方法或可呼叫函數,並且傳回True或False,可以將方法的boolean屬性設為True。這樣頁面上會展示on或off圖示。

from django.db import models
from django.contrib import admin

class Person(models.Model):

   first_name = models.CharField(max_leconvateo50k)

   def born_in_fifties(self ):
       return self.birthday.strftime('%Y')[:3] == '195'
   born_in_fifties.boolean = True

class pAdmin(admin.ModeAdd ') 


Model的__str__或者__unicode__方法也可以使用

list_display = ('__str__', 'some_other_field')


如果list_display中的項目不是資料庫的實際字段,那麼不可以以此為基礎項排序。反之,則可以以此項排序,可以透過設定 admin_order_field屬性來指出這個事實。

from django.db import models

from django.contrib import admin

from django.utils.html import format_html


class Person(models.Model):

. color_code = models. CharField(max_length=6)

   def colored_first_name(self):

       return format_html('{1} ,       self.color_code,
                          self. first_name)

   colored_first_name.allow_tags = True
   colored_first_name.admin_order_field = 'first_name'

class PersonAdmin(admin.p.d. name')


這樣試圖以colored_first_name排序時,django會以first_name排序。可反向排序:

colored_first_name.admin_order_field = '-first_name'


list_display中的項目也可以是特性:

class Person(object):amdom​​片_name = models .CharField(max_length=50)

   def my_property(self):

       return self.first_name + ' ' + self.last_name

.   full_name = property(my_property)

class PersonAdmin(admin.ModelAdmin):
   list_display = ('full_name',)    

list_display_link


52:Adplistd display = ('first_name' , 'last_name', 'birthday')
   list_display_links = ('first_name', 'last_name')


list_editable

其中的欄位在change list頁面是可以被更改的。在其中的欄位也必須在list_display中。

list_filter

其中的欄位可以作為過濾器過濾model 。可以是相關域。

class PersonAdmin(admin.UserAdmin):

   list_filter = ('company__name',)

list_max_show_all


show all頁上的model數目,缺省200。

list_per_page

每個change list頁的model數目,缺省100。

list_select_related

與select_related()有關。

ordering

排序。

paginator

使用的分頁。缺省django.core.paginator.Paginator 。

prepopulated_fields

預置欄位。

radio_fields

使用radio-button代替select-box( ForeignKey或有choices選項時)。

class PersonAdmin(admin.ModelAdmin):
   radio_fields = {"group": admin.VERTICAL}

raw_id_fields

會顯示其中欄位的Keyid,用於展示其中一個欄位的Keya。

class ArticleAdmin(admin.ModelAdmin):
   raw_id_fields = ("newspaper",)

readonly_fields

只讀不可編輯的欄位。也可以是方法:

from django.contrib import admin
from django.utils.html import format_html_join
from django.utils.safestring import mark_safe
',)

   def address_report(self, instance):
       # assuming get_full_address() returns a list of strings
Š    . # line by a linebreak
       return format_html_join(
           mark_safe(''),
           '{0}',
           ((line,) for line in  .get_full_address()),
class  address."

   # short_description functions like a model field's verbose_name
   address_report.short_description = "Address"
   address_report.short_description = "Address"
   . allow_tags = True


save_as

設為Ture時,change頁面的 "Save and add another"按鈕會被"Save as"取代。

save_on_top

設為Ture時,change頁面的頂端也會有save按鈕。

search_fields

可搜尋欄位。

view_on_site

是否顯示View on site連結。

template options

一些客製化admin模板時指定模板所使用的選項。

add_form_template

add_view()使用的模板.

change_form_template
change_view()使用的模板.

change_list_templatedeletelist_view()所使用的模板.view_oeteetes使用的模板。

delete_selected_confirmation_template

delete_selected action method 使用的模板。

ModelAdmin.object_history_template

history_view()使用的模板,日誌。

 


 以上就是Djangoadminsite(一)ModelAdminOptions的內容,更多相關內容請關注PHP中文網(www.php.cn)!


來源:php.cn
本網站聲明
本文內容由網友自願投稿,版權歸原作者所有。本站不承擔相應的法律責任。如發現涉嫌抄襲或侵權的內容,請聯絡admin@php.cn
熱門教學
更多>
最新下載
更多>
網站特效
網站源碼
網站素材
前端模板