add missing settings

pull/4535/merge
LB 2018-05-12 13:21:52 +10:00
rodzic 8d2ee74be0
commit c886d1ab4f
1 zmienionych plików z 124 dodań i 3 usunięć

Wyświetl plik

@ -250,15 +250,20 @@ Images
This setting lets you provide your own image model for use in Wagtail, which might extend the built-in ``AbstractImage`` class or replace it entirely. This setting lets you provide your own image model for use in Wagtail, which might extend the built-in ``AbstractImage`` class or replace it entirely.
Maximum Upload size for Images
------------------------------
.. code-block:: python .. code-block:: python
WAGTAILIMAGES_MAX_UPLOAD_SIZE = 20 * 1024 * 1024 # i.e. 20MB WAGTAILIMAGES_MAX_UPLOAD_SIZE = 20 * 1024 * 1024 # i.e. 20MB
This setting lets you override the maximum upload size for images (in bytes). If omitted, Wagtail will fall back to using its 10MB default value. This setting lets you override the maximum upload size for images (in bytes). If omitted, Wagtail will fall back to using its 10MB default value.
.. code-block:: python
WAGTAILIMAGES_FEATURE_DETECTION_ENABLED = True
This setting enables feature detection once OpenCV is installed, see all details on the :ref:`image_feature_detection` documentation.
The ``WAGTAILIMAGES_BACKENDS`` setting is no longer supported, it was introduced in 0.3.
Password Management Password Management
------------------- -------------------
@ -338,6 +343,26 @@ This is the path to the Django template which will be used to display the "passw
As above, but for password restrictions on documents. For more details, see the :ref:`private_pages` documentation. As above, but for password restrictions on documents. For more details, see the :ref:`private_pages` documentation.
Login page
----------
The basic login page can be customised with a custom template.
.. code-block:: python
WAGTAIL_FRONTEND_LOGIN_TEMPLATE = 'myapp/login.html'
Or the login page can be a redirect to an external or internal URL.
.. code-block:: python
WAGTAIL_FRONTEND_LOGIN_URL = '/accounts/login/'
For more details, see the :ref:`login_page` documentation.
Case-Insensitive Tags Case-Insensitive Tags
--------------------- ---------------------
@ -474,6 +499,102 @@ can only choose between front office languages:
('pt', 'Portuguese')] ('pt', 'Portuguese')]
API Settings
------------
For full documenation on API configuration, including these settings, see :ref:`api_v2_configuration` documentation.
.. code-block:: python
WAGTAILAPI_BASE_URL = 'http://api.example.com/'
Required when using frontend cache invalidation, used to generate absolute URLs to document files and invalidating the cache.
.. code-block:: python
WAGTAILAPI_LIMIT_MAX = 500
Default is 20, used to change the maximum number of results a user can request at a time, set to ``None`` for no limit.
.. code-block:: python
WAGTAILAPI_SEARCH_ENABLED = False
Default is true, setting this to false will disable full text search on all endpoints.
.. code-block:: python
WAGTAILAPI_USE_FRONTENDCACHE = True
Requires ``wagtailfrontendcache`` app to be installed, inidicates the API should use the frontend cache.
Frontend cache
--------------
For full documenation on frontend cache invalidation, including these settings, see :ref:`_frontend_cache_purging` documentation.
.. code-block:: python
WAGTAILFRONTENDCACHE = {
'varnish': {
'BACKEND': 'wagtail.contrib.frontend_cache.backends.HTTPBackend',
'LOCATION': 'http://localhost:8000',
},
}
See documentation linked above for full options available.
.. note::
``WAGTAILFRONTENDCACHE_LOCATION`` is no longer the preferred way to set the cache location, instead set the ``LOCATION`` within the ``WAGTAILFRONTENDCACHE`` item.
.. code-block:: python
WAGTAILFRONTENDCACHE_LANGUAGES = [l[0] for l in settings.LANGUAGES]
Default is an empty list, must be a list of languages to also purge the urls for each language of a purging url. This setting needs ``settings.USE_I18N`` to be ``True`` to work.
--------------
WAGTAILFRONTENDCACHE = {
'varnish': {
'BACKEND': 'wagtail.contrib.frontend_cache.backends.HTTPBackend',
'LOCATION': 'http://localhost:8000',
},
}
WAGTAILFRONTENDCACHE_LANGUAGES = []
Set ``WAGTAILFRONTENDCACHE_LANGUAGES`` to a list of languages (typically equal to ``[l[0] for l in settings.LANGUAGES]``) to also purge the urls for each language of a purging url. This setting needs ``settings.USE_I18N`` to be ``True`` to work. Its default is an empty list.
Finally, make sure you have configured your frontend cache to accept PURGE requests:
Hallo Editor (deprecated)
-------------------------
**As of Wagtail 2.0, the hallo.js editor is deprecated.** See :ref:`_extending_hallo` documentation for details.
To use hallo.js on Wagtail 2.x, add the following to your settings:
.. code-block:: python
WAGTAILADMIN_RICH_TEXT_EDITORS = {
'default': {
'WIDGET': 'wagtail.admin.rich_text.HalloRichTextArea'
}
}
URL Patterns URL Patterns
~~~~~~~~~~~~ ~~~~~~~~~~~~