Django-simple-utility je aplikace, Django, který poskytuje admin a modelové nástroje, které mohou ušetřit čas při vývoji, plus některé nástroje, které zjednodušují práci s podáním Django.
Instalace:
Můžete použít jeden z těchto příkazů:
& Nbsp; pip nainstalovat Django-jednoduchý nástroje
& nbsp; easy_install Django-simple-pomůcky
Configuration:
Nejprve je nutné přidat nástroje do INSTALLED_APPS v settings.py před django.contrib.admin:
INSTALLED_APPS = (
& Nbsp; & hellip;
& Nbsp; "nástroje",
& Nbsp; "django.contrib.admin"
& Nbsp; & hellip;
)
A konečně spustit :: manage.py collectstatic
Použití:
Model pole:
Django-jednoduchý pomůcky přidává některé modelové pole, které zjednodušují práci. Všechny tyto položky je v utilities.models.fields souboru. Tam je jeho seznam:
- IntegerField:
& Nbsp; konstruktor: IntegerField (MIN_VALUE = None, max_value = None, míra = None, auto_format = False, ** kwargs)
- MIN_VALUE - přidává ověření na hodnotu min
- Max_value - přidává ověření na maximální hodnoty
- Opatření - můžete přidávat opatření, které bude na displeji po vstupu. Například je-li opatření = "EUR", vytvořený vstup HTML bude :: EUR
- Auto_format - číslo bude automatické formátovaný pomocí prostory pro tisíce. Tato funkce používat JavaScript.
- PositiveIntegerField:
& Nbsp; konstruktor: IntegerField (MIN_VALUE = 0, max_value = None, míra = None, auto_format = false, ** kwargs)
& Nbsp; je to stejné jako IntegerField bud MIN_VALUE musí být vyšší než 0 a je nastavena na hodnotu 0 ve výchozím nastavení
- FloatField:
& Nbsp; konstruktor: FloatField (MIN_VALUE = 0, max_value = None, míra = None, auto_format = False, čárka = true, ** kwargs)
& Nbsp; čárka - pokud čárka nastavena na hodnotu true vstup čárka bez čárky
& Nbsp; ostatní hodnoty jsou stejné, jako IntegerField
- PhoneField:
& Nbsp; konstruktor: PhoneField (format = 'CZ', ** kwargs):
& Nbsp; formát - má možnosti: CZ, DE, OPEN
& Nbsp; Při použití formátu CZ je číslo automaticky formátován pomocí JavaScriptu a uživatel může vložit pouze skutečný cz telefonní číslo
- PSCField:
& Nbsp; České PSC (například 143 00), Vstupní hodnota je automaticky formátovaný pomocí JavaScriptu nebo po bezpečí v metodě poli čisté.
- DICField:
& Nbsp; České DIC
- HtmlField:
& Nbsp; V tomto poli se používá textové pole, a přidává k textarea TinyMCE editoru.
- TreeForeignKey:
& Nbsp; konstruktor: TreeForeignKey (k, rodič = None, ** kwargs)
& Nbsp; Toto pole se používá pro modely, které mají stromovou strukturu. Výsledkem je select box, který obsahuje hodnoty se stromovou strukturou.
& Nbsp; rodič - pole ve formátu, které poukazují na nadřazeného objektu řetězce. Je-li rodič stejně jako nemusí být nastavena proměnná obsahující TreeForeignKey.
- OrderedForeignKey:
& nbsp; konstruktor: OrderedForeignKey (až, order_by, ** kwargs):
& Nbsp; Chcete-li nastavit speciální jiný pořadí v konečném vyberte pole, můžete použít toto pole.
- OtherCharField:
& Nbsp; konstruktor: OtherCharField (výběr = None, other_label = _ (u'Other "), hide_relations = None, ** kwargs)
& nbsp; volby - stejné jako u Charfield
& Nbsp; other_label - řetězec, který se bude přidávat k výběru jako možnost. Pokud uživatel vybrat tuto hodnotu, se automaticky zobrazí zadávání textu. Při použití tohoto pole uživatele textu mohou přidat další hodnotu, která není v volby.
Admin:
Všechny tyto modelAdmins je v utilities.admin balení
- RelatedToolsAdmin:
& Nbsp; přidává měnit a mazat tlačítka forma ForeignKey pole
- HiddenModelMixin:
& Nbsp; v případě, nechcete modelovat admin bude vidět v indexu podání, můžete použít tento mixin. Například:
& Nbsp; BookAdmin (HiddenModelMixin, model.Admin):
& Nbsp; průchod
- HiddenModelAdmin:
& Nbsp; Tento model admin dědí z HiddenModelMixin a RelatedToolsAdmin ::
& Nbsp; HiddenModelAdmin (HiddenModelMixin, RelatedToolsAdmin):
& Nbsp; průchod
- MarshallingAdmin:
& Nbsp; Pokud máte dva nebo více modelů, které dědí ze stejného rodiče, a chcete, aby tyto modely budou vystaveny na stejné admin tabulky, můžete použít tento model admin. Použití:
& Nbsp; nejprve vytvořit vlastní modelu správce, který bude dědit z MarshallingAdmin a nastavit rodič modelu a děti modelů. Tento model admin použít k registraci všechny zahrnuty modely:
& Nbsp; CustomMarshallingAdmin (MarshallingAdmin):
& Nbsp; rodič = ParentModel
& Nbsp; dětské = [ChildModel1, ChildModel2, ...]
& Nbsp; admin.site.register (ParentModel, CustomMarshallingAdmin)
& Nbsp; admin.site.register (ChildModel1, CustomMarshallingAdmin)
& Nbsp; admin.site.register (ChildModel2, CustomMarshallingAdmin)
& Nbsp; ...
- TreeModelMixin:
& Nbsp; Tento admin mixin seznam změn pohled na seznam zobrazení stromové struktury. Objekty se zobrazí ve stromové struktuře. Vy jen musíte nastavit mateřskou proměnná pole, které poukazují na rodičovského objektu k modelování. Například:
& Nbsp; PageModelAdmin (TreeModelMixin, admin.ModelAdmin):
& Nbsp; rodič = 'parent_field'
- CSVExportMixin:
& Nbsp; Pokud chcete exportovat do CSV od podání Django, můžete použít tento mixin. Musíte dědit pouze tento mixin jako první rodiče a nastavit některé proměnné:
- Csv_delimiter - char, který odděluje hodnoty, výchozí je ";"
- csv_fields - pole nebo metody objektů, které budou vyvezeny
- Csv_quotechar - pokud můžete přiložit exportované hodnot stejného znaku, můžete použít tuto hodnotu. Výchozí hodnota je "" "
- Csv_header - první řádek bude tvořit názvy polí a short_description metod, pokud nastavíte tuto hodnotu na hodnotu true, výchozí hodnota je False
- Csv_bom - MS Excel potřebuje speciální znak na prvním řádku, pokud nastavíte Pravda BOM bude doplněn. Výchozí hodnota je False
- Csv_encoding - kódování z exportovaného souboru CSV. Default "utf-8"
& Nbsp; Příklad:
& Nbsp; models.py:
& Nbsp; Book (models.Model):
& Nbsp; title = models.CharField (u'Title ', MAX_LENGTH = 255)
& Nbsp; author = models.ForeignKey (Author, verbose_name = u'Author ")
& Nbsp; get_similar_book (self):
& Nbsp; návrat algoritmus, který vrací podobnou knihu
& Nbsp; get_similar_book.short_description = u'Similar kniha '
& Nbsp; admin.py:
& Nbsp; BookCSVExportMixin (CSVExportMixin, admin.ModelAdmin):
& Nbsp; csv_delimiter = ','
& Nbsp; csv_fields = ("title", "autor", "get_similar_book")
& Nbsp; csv_quotechar = '' "
& Nbsp; csv_header = True
& Nbsp; csv_bom = False
& Nbsp; csv_encoding = & lsquo, iso-8859-1 "
- CloneModelMixin:
& Nbsp; Tento mixin přidává tlačítko Clone změnit formu.
- MultipleFilesImportMixin:
& Nbsp; Pokud používáte inline modelu admin souborů. Můžete použít tento mixin více souborů upload. Využívá html 5 a jeden POST pro všechny soubory (nepracují v IE). Mixin zavolá funkci received_file pro všechny soubory v POST. Příklad:
& Nbsp; třída GalleryAdmin (MultipleFilesImportMixin, admin.ModelAdmin):
& Nbsp; vložkou = [ImageInLine]
& Nbsp; def received_file (self, obj, file):
& Nbsp; image = obrázek (image = file, galerie = obj)
& Nbsp; Image.Save ()
- AdminPagingMixin:
& Nbsp; Dodává, tlačítka pro další a předchozí objekt při změně z. Toto tlačítko se nachází v objektu-tools-položky bloku. Můžete nastavit pouze jeden atribut:
& Nbsp; page_ordering - standardně je "pk"
V budoucnu bude přidávat singnals který automaticky poslat e-mail, pokud se model objektu nejprve uloží do paměti a odesílatele e-mailu, který posílat HTML e-maily s obrázky
Vlastnosti :.
< p>- Správa:
- Aktualizace a tlačítko smazat pro ForeignKey
- Strom objekty
- Jednoduché CSV import jako činnost
- více souborů nahrát
- Clone tlačítko na admin formulář
- Model pole:
- Float pole s čárkou
- Integer pole s MIN_VALUE a max_value, které lze nastavit na modelu
- Integer a plovák, který se zobrazí opatřením
- Česká telefonu, PSC a DIC pole s validací
- Textové pole s TinyMCE
- Char pole s možnostmi, které se zobrazí jako select box s možností vložit vlastní hodnotu
Seznam
Požadavky na :
- Python
- Django
Komentáře nebyl nalezen