djangodocs.org

717 sections in Django dev Search all versions →

django.contrib.postgres

Reference

This optional module contains model fields and form fields for a number of PostgreSQL specific data types. NOTE: Django is, and will continue to be, a database-agnostic web framework.

Widgets

Reference

TIP: Widgets should not be confused with the form fields. Form fields deal with the logic of input validation > and are used directly in templates.

Widget

Reference Widgets Base widget classes

`render(name,value,attrs=None,renderer=None)`[[source]](https://github.com/django/django/blob/main/django/forms/widgets.py#L373) : Renders a widget to HTML using the given renderer. If `renderer` is `None`, the renderer from the [`FORM_RENDERER`](../settings.md#std-setting-FORM_RENDERER) setting is used. `value_from_datadict(data,files,name)`[[source]](https://github.com/django/django/blob/main/django/forms/widgets.py#L387) : Given a dictionary of data and this widget’s name, returns the value of this widget.

FileField

Reference Model field reference Field types

This handles the storage and retrieval of your files. See Managing files for details on how to provide this object. The default form widget for this field is a ClearableFileInput.

Validating objects

Reference Model instance reference

… as a whole - Model.clean() Validate the field uniqueness - Model.validate_unique() Validate the constraints - Model.validate_constraints() All four steps are performed when you call a model’s full_clean() method. When you use a ModelForm, the call to is_valid() will perform these …

Field types

Topic guide Models Fields

INTEGER, VARCHAR, TEXT). The default HTML widget to use when rendering a form field (e.g. <input type="text">, <select>). The minimal validation requirements, used in Django’s admin and in automatically-generated forms.

Topic guide Creating forms from models Model formsets

Just like with a ModelForm, by default the clean() method of a ModelFormSet will validate that none of the items in the formset violate the unique constraints on your model (either unique, unique_together or unique_for_date|month|year).

Topic guide Translation Internationalization: in Python codeWorking with lazy translation objects

When using lazy translation for a plural string (n[p]gettext_lazy), you generally don’t know the number argument at the time of the string definition. Therefore, you are authorized to pass a key name instead of an integer as the number argument.

Creating models

Tutorial Writing your first Django app, part 2

NOTE: A model is the single, definitive source of information about your data. It > contains the essential fields and behaviors of the data you’re storing. > Django follows the DRY Principle.

ModelAdmin options

Reference The Django admin site ModelAdmin objects

That is, fields listed in list_editable will be displayed as form widgets on the change list page, allowing users to edit and save multiple rows at once.

How it works

Reference Cross Site Request Forgery protection

2. A hidden form field with the name ‘csrfmiddlewaretoken’, present in all outgoing POST forms. In order to protect against BREACH attacks, the value of this field is not simply the secret.

Validating objects

Reference Model instance reference

In the above example, the ValidationError exception raised by Model.clean() was instantiated with a string, so it will be stored in a special error dictionary key, NON_FIELD_ERRORS.

Built-in forms

Topic guide Using the Django authentication system Authentication in web requests

If you don’t want to use the built-in views, but want the convenience of not having to write forms for this functionality, the authentication system provides several built-in forms located in django.contrib.auth.forms: NOTE: The built-in authentication forms make certain assumptions …

Topic guide Formsets

The max_num parameter to formset_factory() gives you the ability to limit the number of forms the formset will display: If the value of max_num is greater than the number of existing items in the initial data, up to extra additional …

Topic guide Creating forms from models ModelForm

… you can do so by defining the field declaratively and setting its validators parameter: NOTE: When you explicitly instantiate a form field like this, it is important to > understand how ModelForm and regular Form are related. ModelForm is a …

Using Django

Topic guide

… mod_wsgi Get your database running Install the Django code Models and databases Models Making queries Fetch modes Aggregation Search Managers Performing raw SQL queries Database transactions Multiple databases Tablespaces Database access optimization Database instrumentation Fixtures Examples of model relationship API …

P

Index

… template tag - partialdef - template tag - PASSWORD - setting - password (models.User attribute) - password_change_done_template (AdminSite attribute) - password_change_form (AdminSite attribute) - password_change_template (AdminSite attribute) - password_changed() (in module django.contrib.auth.password_validation) - PASSWORD_HASHERS - setting - PASSWORD_RESET_TIMEOUT - setting …

ModelAdmin options

Reference The Django admin site ModelAdmin objects

ModelAdmin.form : By default a ModelForm is dynamically created for your model. It is used to create the form presented on both the add/change pages.

Security considerations

Reference GDAL API Raster Data ObjectsUsing GDAL’s Virtual Filesystem

When validating geometry inputs, the GeometryField form field will reject raster values. When validating raster inputs, you should write custom validation. For defense-in-depth strategies for limiting the available raster drivers, see GDAL security considerations.