django-đơn giản-tiện ích là một ứng dụng Django cung cấp quản trị và mô hình tiện ích mà có thể tiết kiệm thời gian trong quá trình phát triển, cộng thêm một số tiện ích đơn giản hóa công việc với chính quyền django.
Lắp đặt:
Bạn có thể sử dụng một trong các lệnh sau:
& Nbsp; pip cài đặt django-đơn giản-tiện ích
& Nbsp; easy_install django-đơn giản-tiện ích
Configuration:
Trước hết bạn phải thêm các tiện ích để INSTALLED_APPS trong settings.py trước django.contrib.admin:
INSTALLED_APPS = (
& Nbsp; & hellip;
& Nbsp; "tiện ích",
& Nbsp; 'django.contrib.admin',
& Nbsp; & hellip;
)
Và cuối cùng chạy :: collectstatic manage.py
Cách sử dụng:
Lĩnh vực mô hình:
django-đơn giản-tiện ích bổ sung thêm một số lĩnh vực mô hình mà đơn giản hóa công việc của bạn. Tất cả các lĩnh vực này là trong tập tin utilities.models.fields. Có là có danh sách:
- IntegerField:
& Nbsp; constructor: IntegerField (MIN_VALUE = None, max_value = None, biện pháp = None, auto_format = False, ** kwargs)
- MIN_VALUE - cho biết thêm xác nhận giá trị min
- Max_value - cho biết thêm xác nhận để tối đa giá trị
- Đo lường - bạn có thể thêm các biện pháp đó sẽ được hiển thị sau khi đầu vào. Ví dụ nếu đo = 'EUR', tạo ra HTML đầu vào sẽ được :: EUR
- Auto_format - số nguyên sẽ được tự động formated sử dụng không gian cho hàng ngàn. Tính năng này sử dụng JavaScript.
- PositiveIntegerField:
& Nbsp; constructor: IntegerField (MIN_VALUE = 0, max_value = None, biện pháp = None, auto_format = False, ** kwargs)
& Nbsp; này giống như IntegerField nụ MIN_VALUE phải cao hơn 0 và được đặt thành 0 theo mặc định
- FloatField:
& Nbsp; constructor: FloatField (MIN_VALUE = 0, max_value = None, biện pháp = None, auto_format = False, dấu phẩy = True, ** kwargs)
& Nbsp; dấu - nếu dấu phẩy được thiết lập là True sử dụng đầu vào mà không có dấu phẩy dấu thập phân
& Nbsp; các giá trị khác là giống như IntegerField
- PhoneField:
& Nbsp; constructor: PhoneField (format = 'CZ', ** kwargs):
& Nbsp; định dạng - có sự lựa chọn: CZ, DE, OPEN
& Nbsp; Khi bạn sử dụng định dạng CZ là số automaticly định dạng bởi JavaScript và người dùng có thể chèn chỉ số điện thoại cz thực
- PSCField:
& Nbsp; Czech PSC (Ví dụ 143 00), giá trị đầu vào được tự động formated với JavaScript hoặc sau khi an toàn trong lĩnh vực phương pháp sạch.
- DICField:
& Nbsp; Czech DIC
- HtmlField:
& Nbsp; Trường này sử dụng trường văn bản và thêm vào trình soạn thảo TinyMCE textarea.
- TreeForeignKey:
& Nbsp; constructor: TreeForeignKey (để, mẹ = None, ** kwargs)
& Nbsp; Trường này được sử dụng cho các mô hình có cấu trúc cây. Kết quả là hộp chọn, trong đó có giá trị với cấu trúc cây.
& Nbsp; mẹ - lĩnh vực trong chuỗi định dạng mà điểm đến đối tượng cha. Nếu cha mẹ là giống như biến có chứa TreeForeignKey không cần phải được thiết lập.
- OrderedForeignKey:
& Nbsp; constructor: OrderedForeignKey (để, order_by, ** kwargs):
& Nbsp; nếu bạn muốn thiết lập đặc biệt đặt hàng khác nhau trong các lựa chọn hộp cuối cùng, bạn có thể sử dụng trường này.
- OtherCharField:
& Nbsp; constructor: OtherCharField (lựa chọn = None, other_label = _ (u'Other '), hide_relations = None, ** kwargs)
& Nbsp; sự lựa chọn - như CharField
& Nbsp; other_label - chuỗi đó sẽ được thêm vào để chọn hộp là tùy chọn. Khi người sử dụng chọn giá trị này, nhập văn bản sẽ tự động được hiển thị. Bằng cách sử dụng người dùng lĩnh vực văn bản này có thể thêm một giá trị khác, mà không phải là trong sự lựa chọn.
Admin:
Tất cả modelAdmins này là trong gói utilities.admin
- RelatedToolsAdmin:
& Nbsp; thêm hiệu thay đổi và xóa các nút trường mẫu ForeignKey
- HiddenModelMixin:
& Nbsp; nếu bạn không muốn để mô hình quản trị sẽ được nhìn thấy trong chỉ số quản trị, bạn có thể sử dụng mixin này. Ví dụ như:
& Nbsp; BookAdmin (HiddenModelMixin, model.Admin):
& Nbsp; vượt qua
- HiddenModelAdmin:
& Nbsp; mô hình quản trị này kế thừa từ HiddenModelMixin và RelatedToolsAdmin ::
& Nbsp; HiddenModelAdmin (HiddenModelMixin, RelatedToolsAdmin):
& Nbsp; vượt qua
- MarshallingAdmin:
& Nbsp; Nếu bạn có hai hoặc nhiều mô hình mà kế thừa từ cha mẹ như nhau và bạn muốn các mô hình này sẽ được hiển thị ở bảng quản trị như nhau, bạn có thể sử dụng mô hình quản trị này. Cách sử dụng:
& Nbsp; trước tiên bạn tạo ra mô hình quản trị tùy chỉnh mà sẽ thừa hưởng từ MarshallingAdmin và thiết lập mô hình mẹ và trẻ em mô hình. Quản trị này mô hình mà bạn sử dụng để đăng ký tất cả các mô hình bao gồm:
& Nbsp; CustomMarshallingAdmin (MarshallingAdmin):
& Nbsp; mẹ = ParentModel
& Nbsp; Childs = [ChildModel1, ChildModel2, ...]
& Nbsp; admin.site.register (ParentModel, CustomMarshallingAdmin)
& Nbsp; admin.site.register (ChildModel1, CustomMarshallingAdmin)
& Nbsp; admin.site.register (ChildModel2, CustomMarshallingAdmin)
& Nbsp; ...
- TreeModelMixin:
& Nbsp; này quản trị mixin danh sách thay đổi nhìn vào danh sách cây xem. Đối tượng được hiển thị trong cấu trúc cây. Bạn chỉ phải đặt mẹ varible để mô hình trường mà điểm để phản đối cha mẹ. Ví dụ như:
& Nbsp; PageModelAdmin (TreeModelMixin, admin.ModelAdmin):
& Nbsp; mẹ = 'parent_field'
- CSVExportMixin:
& Nbsp; Nếu bạn muốn xuất khẩu csv từ chính quyền django, bạn có thể sử dụng điều này mixin này. Bạn chỉ phải kế thừa mixin này như là cha mẹ đầu tiên và thiết lập một số biến:
- Csv_delimiter - char tách giá trị, mặc định là ';'
- Csv_fields - lĩnh vực hoặc các phương pháp đối tượng đó sẽ được xuất khẩu
- Csv_quotechar - nếu bạn có thể đặt giá trị xuất khẩu của cùng một char bạn có thể sử dụng giá trị này. Mặc định là '"'
- Csv_header - hàng đầu tiên sẽ được hình thành bởi các tên trường và SHORT_DESCRIPTION các phương pháp, nếu bạn thiết lập giá trị này thành True, mặc định là False
- Csv_bom - MS Excel cần ký tự đặc biệt trên dòng đầu tiên, nếu bạn thiết lập Đúng BOM sẽ được thêm vào. Mặc định là False
- Csv_encoding - mã hóa các tập tin CSV xuất khẩu. Default 'utf-8'
& Nbsp; Ví dụ:
& Nbsp; models.py:
& Nbsp; Book (models.Model):
& Nbsp; title = models.CharField (u'Title ', max_length = 255)
& Nbsp; author = models.ForeignKey (Tác giả, verbose_name = u'Author ')
& Nbsp; get_similar_book (tự):
& Nbsp; thuật toán trở lại đó trả về một cuốn sách tương tự
& Nbsp; get_similar_book.short_description = u'Similar cuốn sách '
& Nbsp; admin.py:
& Nbsp; BookCSVExportMixin (CSVExportMixin, admin.ModelAdmin):
& Nbsp; csv_delimiter = ','
& Nbsp; csv_fields = ("title", 'tác giả', 'get_similar_book')
& Nbsp; csv_quotechar = '"'
& Nbsp; csv_header = True
& Nbsp; csv_bom = False
& Nbsp; csv_encoding = & lsquo; iso-8859-1 '
- CloneModelMixin:
& Nbsp; mixin này bổ sung thêm nút clone để thay đổi hình thức.
- MultipleFilesImportMixin:
& Nbsp; Nếu bạn đang sử dụng mô hình quản trị nội tuyến cho các tập tin. Bạn có thể sử dụng mixin này cho nhiều tập tin tải lên. Nó sử dụng html 5 và một POST cho tất cả các tập tin (không làm việc trong IE). Mixin gọi hàm received_file cho mỗi tập tin trong POST. Ví dụ:
& Nbsp; class GalleryAdmin (MultipleFilesImportMixin, admin.ModelAdmin):
& Nbsp; inlines = [ImageInLine]
& Nbsp; def received_file (self, obj, file):
& Nbsp; hình = hình ảnh (image = file, gallery = obj)
& Nbsp; image.save ()
- AdminPagingMixin:
& Nbsp; Nó thêm nút cho đối tượng kế tiếp và trước đó về sự thay đổi từ. Nút này là trong đối tượng cụ-vật khối. Bạn có thể cài một thuộc tính:
& Nbsp; page_ordering - mặc định là 'pk'
Trong tương lai sẽ có thêm singnals mà automaticly gửi E-mail khi mô hình đối tượng lần đầu tiên được lưu trữ và email người gửi mà gửi email HTML với hình ảnh
Tính năng .
< class = "bbli"> Quản trị p>- Cập nhật và nút xóa cho ForeignKey
- đối tượng Tree
- nhập khẩu CSV đơn giản là hành động
- Nhiều tập tin tải lên
- nút Clone tại hình thức quản trị viên
- Trường mẫu:
- Float trường với dấu
- trường với MIN_VALUE và max_value Integer có thể được đặt ở mô hình
- Integer và float sẽ được hiển thị với các biện pháp
- Điện thoại Czech, PSC và lĩnh vực DIC với xác nhận
- Text với TinyMCE
- lĩnh vực với sự lựa chọn Char đó sẽ được hiển thị như hộp chọn với các tùy chọn để chèn giá trị tùy chỉnh
Danh sách
Yêu cầu :
- Python
- Django
Bình luận không