mirrors/wagtail
mirrors/wagtail
0
0
Fork 0
mirror of https://github.com/wagtail/wagtail.git synced 2024-11-29 17:36:49 +01:00
Code Issues Releases Wiki Activity

Some edits to model reference

Browse Source
This commit is contained in:
Karl Hobley 2015-05-29 12:53:48 +01:00
parent 16315403fc
commit 77d143a099
1 changed files with 21 additions and 28 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

49
docs/reference/pages/model_reference.rst
View File

@ -1,14 +1,17 @@
Page model Reference Model Reference
==================== ===============
``Page`` Class Reference
~~~~~~~~~~~~~~~~~~~~~~~~
.. automodule:: wagtail.wagtailcore.models .. automodule:: wagtail.wagtailcore.models
This document contains reference information for the model classes inside the ``wagtailcore`` module.
``Page``
~~~~~~~~
.. autoclass:: Page .. autoclass:: Page
The following Django model fields are provided for all pages and are queryable from ``Page.objects``. **Database fields:**
.. attribute:: title .. attribute:: title
@ -20,7 +23,7 @@ Page model Reference
(text) (text)
The slug of the page. This is used for constructing the page's URL. This is used for constructing the page's URL.
For example: ``http://domain.com/blog/[my-slug]/`` For example: ``http://domain.com/blog/[my-slug]/``
@ -85,12 +88,6 @@ Page model Reference
.. autoattribute:: url .. autoattribute:: url
.. autoattribute:: full_url .. autoattribute:: full_url
.. automethod:: get_verbose_name
.. automethod:: relative_url
.. automethod:: is_navigable
.. automethod:: route .. automethod:: route
@ -110,8 +107,6 @@ Page model Reference
.. automethod:: get_siblings .. automethod:: get_siblings
.. automethod:: search
.. attribute:: search_fields .. attribute:: search_fields
A list of fields to be indexed by the search engine. See Search docs :ref:`wagtailsearch_indexing_fields` A list of fields to be indexed by the search engine. See Search docs :ref:`wagtailsearch_indexing_fields`
@ -153,9 +148,6 @@ Page model Reference
Defines which template file should be used to render the login form for Protected pages using this model. This overrides the default, defined using ``PASSWORD_REQUIRED_TEMPLATE`` in your settings. See :ref:`private_pages` Defines which template file should be used to render the login form for Protected pages using this model. This overrides the default, defined using ``PASSWORD_REQUIRED_TEMPLATE`` in your settings. See :ref:`private_pages`
Other core models
-----------------
``Site`` ``Site``
~~~~~~~~ ~~~~~~~~
@ -218,11 +210,12 @@ This configuration is used by the :class:`~wagtail.wagtailcore.middleware.SiteMi
``PageRevision`` ``PageRevision``
~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~
The ``PageRevision`` model contains all the past revisions of a page. Every time a page is created or updated, a new revision is created. Revisions can be created manually by calling the :meth:`~Page.create_revision` method. Every time a page is edited a new ``PageRevision`` is created and saved to the database. It can be used to find the full history of all changes that have been made to a page and it also provides a place for new changes to be kept before going live.
Revisions are used by Wagtail for keeping draft changes out of the live database. Every revision has the content of the page serialised and stored in the :attr:`~PageRevision.content_json` field. - Revisions can be created from any class:`~wagtail.wagtailcore.models.Page` object calling its :meth:`~Page.create_revision` method
- The content of the class:`~wagtail.wagtailcore.models.Page` is JSON-serialised and stored in the :attr:`~PageRevision.content_json` field
- You can retrieve a ``PageRevision`` as a :class:`~wagtail.wagtailcore.models.Page` object by calling the :meth:`~PageRevision.as_page_object` method
It is possible to retrieve a ``PageRevision`` as a :class:`~wagtail.wagtailcore.models.Page` object by calling the :meth:`~PageRevision.as_page_object` method.
.. autoclass:: PageRevision .. autoclass:: PageRevision
@ -236,6 +229,8 @@ It is possible to retrieve a ``PageRevision`` as a :class:`~wagtail.wagtailcore.
(boolean) (boolean)
``True`` if this revision is in moderation
.. attribute:: created_at .. attribute:: created_at
(date/time) (date/time)
@ -246,7 +241,7 @@ It is possible to retrieve a ``PageRevision`` as a :class:`~wagtail.wagtailcore.
(foreign key to user model) (foreign key to user model)
This is the user that created the revision This links to the user that created the revision
.. attribute:: content_json .. attribute:: content_json
@ -254,12 +249,10 @@ It is possible to retrieve a ``PageRevision`` as a :class:`~wagtail.wagtailcore.
This field contains the JSON content for the page at the time the revision was created This field contains the JSON content for the page at the time the revision was created
**Methods and attributes:** **Managers:**
.. attribute:: objects .. attribute:: objects
(manager)
This manager is used to retrieve all of the ``PageRevision`` objects in the database This manager is used to retrieve all of the ``PageRevision`` objects in the database
Example: Example:
@ -270,8 +263,6 @@ It is possible to retrieve a ``PageRevision`` as a :class:`~wagtail.wagtailcore.
.. attribute:: submitted_revisions .. attribute:: submitted_revisions
(manager)
This manager is used to retrieve all of the ``PageRevision`` objects that are awaiting moderator approval This manager is used to retrieve all of the ``PageRevision`` objects that are awaiting moderator approval
Example: Example:
@ -280,6 +271,8 @@ It is possible to retrieve a ``PageRevision`` as a :class:`~wagtail.wagtailcore.
PageRevision.submitted_revisions.all() PageRevision.submitted_revisions.all()
**Methods and attributes:**
.. automethod:: as_page_object .. automethod:: as_page_object
This method retrieves this revision as an instance of its :class:`~wagtail.wagtailcore.models.Page` subclass. This method retrieves this revision as an instance of its :class:`~wagtail.wagtailcore.models.Page` subclass.