mirror of
https://github.com/wagtail/wagtail.git
synced 2024-11-29 01:22:07 +01:00
24ef0e62e6
Fix code block indentation in tutorial.rst Prevent it from being displayed as a quote. Fix indentation in pages.rst Fix indentation in indexing.rst Fix indentation in searching.rst Fix indentation in backends.rst Fix indentation in renditions.rst Fix indentation in custom_image_model.rst Fix indentation in feature_detection.rst Fix indentation in image_serve_view.rst Fix indentation in custom_document_model.rst Fix indentation in i18n.rst Fix indentation in privacy.rst Fix indentation in page_editing_interface.rst Fix indentation in rich_text_internals.rst Fix indentation in extending_hallo.rst Fix indentation in configuration.rst Fix indentation in usage.rst Fix indentation in theory.rst Fix indentation in model_reference.rst Fix indentation in queryset_reference.rst Configure editors to indent .rst files with 2 spaces In order for the documentation to be styled correctly, the generator depends on indentation. Too much indentation can result in the content being wrapped in a quote block, which looks bad. Fix indentation in sitemaps.rst Fix indentation in frontendcache.rst Fix indentation in routablepage.rst Fix indentation in table_block.rst Fix routablepage.rst autodocs disppearing Fix indentation in table_block.rst Fix indentation in redirects.rst Fix indentation in table_documentation-modes.rst Fix indentation in browser_issues.rst Fix indentation in release_process.rst Fix indentation of release notes One more indent fix in the release notes Fix indentation warnings Fix warning about undefined label in docs Error during `make html`: wagtail/docs/releases/1.7.rst:25: WARNING: undefined label: jpeg_image_quality
67 lines
1.8 KiB
ReStructuredText
67 lines
1.8 KiB
ReStructuredText
.. _custom_document_model:
|
|
|
|
=====================
|
|
Custom document model
|
|
=====================
|
|
|
|
An alternate ``Document`` model can be used to add custom behaviour and
|
|
additional fields.
|
|
|
|
You need to complete the following steps in your project to do this:
|
|
|
|
- Create a new document model that inherits from
|
|
``wagtail.documents.models.AbstractDocument``. This is where you would
|
|
add additional fields.
|
|
- Point ``WAGTAILDOCS_DOCUMENT_MODEL`` to the new model.
|
|
|
|
Here's an example:
|
|
|
|
.. code-block:: python
|
|
|
|
# models.py
|
|
from wagtail.documents.models import Document, AbstractDocument
|
|
|
|
class CustomDocument(AbstractDocument):
|
|
# Custom field example:
|
|
source = models.CharField(
|
|
max_length=255,
|
|
blank=True,
|
|
null=True
|
|
)
|
|
|
|
admin_form_fields = Document.admin_form_fields + (
|
|
# Add all custom fields names to make them appear in the form:
|
|
'source',
|
|
)
|
|
|
|
.. versionchanged:: 2.12
|
|
|
|
Fields on a custom document model can now be defined as required (``blank=False``).
|
|
|
|
Then in your settings module:
|
|
|
|
.. code-block:: python
|
|
|
|
# Ensure that you replace app_label with the app you placed your custom
|
|
# model in.
|
|
WAGTAILDOCS_DOCUMENT_MODEL = 'app_label.CustomDocument'
|
|
|
|
.. topic:: Migrating from the builtin document model
|
|
|
|
When changing an existing site to use a custom document model, no documents
|
|
will be copied to the new model automatically. Copying old documents to the
|
|
new model would need to be done manually with a
|
|
:ref:`data migration <django:data-migrations>`.
|
|
|
|
Any templates that reference the builtin document model will still continue
|
|
to work as before.
|
|
|
|
Referring to the document model
|
|
===============================
|
|
|
|
.. module:: wagtail.documents
|
|
|
|
.. autofunction:: get_document_model
|
|
|
|
.. autofunction:: get_document_model_string
|