Django-прості-комунальні послуги додаток Django, яка забезпечує адміністратора і моделі утиліт, які можуть заощадити час в процесі розробки, а також деякі утиліти, які спрощують роботу з адміністрацією Django.
Переустановленное:
Ви можете використовувати одну з наступних команд:
І NBSP; пункт встановити Django-прості-комунальні послуги
і NBSP; easy_install Django-просто-комунальні послуги
Конфігурація:
По-перше ви повинні додати утиліти для INSTALLED_APPS в settings.py до django.contrib.admin:
INSTALLED_APPS = (
І NBSP; & hellip;
І NBSP; 'утиліти',
І NBSP; 'django.contrib.admin',
І NBSP; & hellip;
)
І, нарешті, запустити :: manage.py collectstatic
Застосування:
Модель поля:
Django-прості-комунальні послуги додає деякі моделі поля, які спрощують вашу роботу. Все це поля в utilities.models.fields файлу. Існує список його:
- IntegerField:
І NBSP; конструктор: IntegerField (min_value = None, max_value = None, міра = None, auto_format = False, ** kwargs)
- Min_value, - додає перевірку, щоб мінімального значення
- Max_value, - додає перевірку, щоб Максимальне значення
- Міра - ви можете додати міру, яка буде відображатися після введення. Наприклад, якщо міра = 'EUR', генерується вхідний HTML буде :: EUR
- Auto_format - ціле число буде автоматичним відформатований з використанням простору для тисяч людей. Ця функція використовувати JavaScript.
- PositiveIntegerField:
І NBSP; конструктор: IntegerField (min_value = 0, max_value = None, міра = None, auto_format = False, ** kwargs)
& NBSP; це те ж саме, як IntegerField нирки MIN_VALUE повинна бути вище, ніж 0, і встановлюється в 0 за замовчуванням
- FloatField:
І NBSP; конструктор: FloatField (min_value = 0, max_value = None, міра = None, auto_format = False, кома = True, ** kwargs)
І NBSP; кома - якщо кома встановлюється на True Вхід використовуйте кому без десяткового дробу
І NBSP; інші значення такий же, як IntegerField
- PhoneField:
І NBSP; конструктор: PhoneField (формат = 'CZ' ** kwargs):
І NBSP; формат - має вибір: CZ, DE, ТОВ
І NBSP; Якщо ви використовуєте формат CZ це номер автоматично відформатований JavaScript і користувач може вставити тільки в реальному CZ номер телефону
- PSCField:
І NBSP; Чеська PSC (Наприклад 143 00), Input значення автоматично форматується з JavaScript або після сейф в методі поля в чистоті.
- DICField:
І NBSP; Чеська DIC
- HtmlField:
І NBSP; Це поле використовується текстове поле і додає до редактора текстова TinyMCE.
- TreeForeignKey:
І NBSP; конструктор: TreeForeignKey (в, батько = None, ** kwargs)
І NBSP; Це поле використовується для моделей, які мають деревоподібну структуру. Результат вибору ящик, який містить значення зі структурою дерева.
І NBSP; батько - поле у форматі, який вказує на батьківський об'єкт рядка. Якщо батько так само, як змінна, що містить TreeForeignKey встановлювати не потрібно.
- OrderedForeignKey:
і NBSP; конструктор: OrderedForeignKey (до, order_by, ** kwargs):
І NBSP; Якщо ви хочете встановити спеціальний інший порядок в кінцевому полі вибору, ви можете використовувати це поле.
- OtherCharField:
І NBSP; конструктор: OtherCharField (вибір = None, other_label = _ (u'Other '), hide_relations = None, ** kwargs)
і NBSP; вибір - такі ж, як CharField
І NBSP; other_label - рядок, яка буде додати, щоб вибрати вікно, як варіант. Коли користувач вибирає це значення відображається автоматично введення тексту. За допомогою цього текстового поля користувача можна додати ще одне значення, яке не в виборі.
Admin:
Все це modelAdmins в utilities.admin пакета
- RelatedToolsAdmin:
І NBSP; додає змінити, і кнопку поля форми ForeignKey видалити
- HiddenModelMixin:
І NBSP; якщо ви не хочете, щоб змоделювати адміністратора можна буде побачити в індексі введення, ви можете використовувати цю змішання ,. Що наприклад:
І NBSP; BookAdmin (HiddenModelMixin, model.Admin):
І NBSP; передача
- HiddenModelAdmin:
І NBSP; Ця модель Адмін успадковує від HiddenModelMixin і RelatedToolsAdmin ::
І NBSP; HiddenModelAdmin (HiddenModelMixin, RelatedToolsAdmin):
І NBSP; передача
- MarshallingAdmin:
І NBSP; Якщо у вас є два або кілька моделей, які успадковують ж батька, і ви хочете, щоб ці моделі будуть відображатися в той же адмін таблиці, ви можете використовувати цю модель адміна. Використання:
І NBSP; по-перше, створювати користувацькі моделі адміна, який буде наслідувати MarshallingAdmin і набір моделі батьківської моделі і дітей. Ця модель адміністратор ви використовували при реєстрації всі включені моделі:
І NBSP; CustomMarshallingAdmin (MarshallingAdmin):
І NBSP; батько = ParentModel
І NBSP; породжених = [ChildModel1, ChildModel2 ...]
І NBSP; admin.site.register (ParentModel, CustomMarshallingAdmin)
І NBSP; admin.site.register (ChildModel1, CustomMarshallingAdmin)
І NBSP; admin.site.register (ChildModel2, CustomMarshallingAdmin)
І NBSP; ...
- TreeModelMixin:
І NBSP; Цей список Змінити вид Адмін домішка до виду списку дерево. Об'єкти відображаються в структурі дерева. Ви тільки повинні встановити батьківський мінливим в поле, яке вказує на батьківський об'єкт моделювання. Що наприклад:
І NBSP; PageModelAdmin (TreeModelMixin, admin.ModelAdmin):
І NBSP; батько = 'parent_field "
- CSVExportMixin:
І NBSP; Якщо ви хочете експорту CSV від адміністрації Django, ви можете використовувати це, це домішка. Ви повинні наслідувати тільки цей змішання, як першого батька і встановити деякі змінні:
- Csv_delimiter - символ, який відокремлює значення, за замовчуванням ';'
- Csv_fields - поля і методи об'єкта, які будуть експортовані
- Csv_quotechar - якщо ви можете зробити висновок, що експортуються значення, же гольця ви можете використовувати це значення. За замовчуванням '"'
- Csv_header - перший рядок буде сформований імен полів і short_description методів, якщо ви встановите значення Правда, за замовчуванням значення False
- Csv_bom - MS Excel вимагає особливого символу на першій лінії, якщо ви встановите Правда BOM буде додано. За замовчуванням має значення Брехня
- Csv_encoding - кодування експортованого файлу CSV. За замовчуванням 'UTF-8'
І NBSP; Приклад:
І NBSP; models.py:
І NBSP; Book (models.Model):
І NBSP; назва = models.CharField (u'Title ', max_length = 255)
І NBSP; автор = models.ForeignKey (Автор, verbose_name = u'Author ')
І NBSP; get_similar_book (само):
І NBSP; повернення алгоритм, який повертає аналогічної книги
І NBSP; get_similar_book.short_description = u'Similar книга "
І NBSP; admin.py:
І NBSP; BookCSVExportMixin (CSVExportMixin, admin.ModelAdmin):
І NBSP; csv_delimiter = ','
І NBSP; csv_fields = ('назва', 'автор', 'get_similar_book')
І NBSP; csv_quotechar = '"'
І NBSP; csv_header = True
І NBSP; csv_bom = False
І NBSP; csv_encoding = & lsquo; ISO-8859-1 »,
- CloneModelMixin:
І NBSP; Це домішка додає кнопку клон змінити форму.
- MultipleFilesImportMixin:
І NBSP; Якщо ви використовуєте вбудований модель для адміністрування файлів. Ви можете використовувати цю змішання, для декількох файлів завантаження. Він використовує HTML 5 і одна посада для всіх файлів (які не працюють у IE). Mixin викликає функцію received_file для кожного файлу на посаду. Приклад:
І NBSP; клас GalleryAdmin (MultipleFilesImportMixin, admin.ModelAdmin):
І NBSP; вбудовує = [ImageInLine]
І NBSP; Def received_file (я, OBJ, файл):
І NBSP; зображення = Зображення (зображення = файл, галерея = об'єкт)
І NBSP; image.save ()
- AdminPagingMixin:
І NBSP; Це додає кнопки для наступного і попереднього об'єкта при зміні від. Ці кнопки є об'єктно-Tools-пунктів блоку. Ви можете встановити тільки один атрибут:
І NBSP; page_ordering замовчуванням - "рк"
У майбутньому буде додати singnals, які автоматично відправляти електронну пошту, коли об'єктна модель, по-перше, зберігається і електронної пошти відправника, які відправляють HTML листів із зображеннями
Особливості :.
< P>- Адміністрація:
- Кнопка Оновити і видалити для ForeignKey
- дерево об'єктів
- Простий імпорт CSV як дія
- Кілька завантаження файлів
- Кнопка Clone на адміністратора формі
- поля Модель:
- Float поле з комою
- Integer поле з MIN_VALUE і MAX_VALUE, які можуть бути встановлені на моделі
- Integer і поплавок, який буде відображатися з мірою
- Чеська Телефон, PSC і поле DIC з перевіркою
- Текстове поле з TinyMCE
- Char поле з виборами, які будуть відображатися у вигляді вікна вибору з можливістю вставляти користувальницьке значення
Список
Вимоги
- Python
- Django
Коментар не знайдено