mirrors/wagtail
mirrors/wagtail
0
0
Fork 0
mirror of https://github.com/wagtail/wagtail.git synced 2024-12-01 11:41:20 +01:00
Code Issues Releases Wiki Activity
14,986 Commits 56 Branches 258 Tags 413 MiB
dc6c0b0949
Commit Graph

395 Commits

Author SHA1 Message Date
Karl Hobley
9dd9d0c895 Docs for parse_query_string 2020-05-20 14:12:27 +01:00
Karl Hobley
81811f6c1c Documentation for phrase search and query classes 2020-05-20 14:12:18 +01:00
LB Johnston
8fc722a6f3 Add ability to define form_classname on ListBlock & StreamBlock 
* resolves #4042
 2020-05-10 16:48:24 +10:00
Coen van der Kamp
68b2dc01c2 Render user bar on non page views 
* resolves #5565
 2020-05-10 16:10:45 +10:00
Matt Westcott
7b772aba81 Update note on ATOMIC_REBUILD to indicate that the problem is specific to 5.4.x - fixes #6003 2020-05-07 21:45:35 +01:00
danbentley
1156182283
Add Page.context_object_name (#5999) 
Page.context_object_name can be used to define a more meaningful name
for the page variable in the template.

If defined, the default `page` and `self` are still available for use in
shared templates.

Resolves #5213
 2020-05-01 20:01:02 +02:00
Tomas Walch
72ee81fbe5 Documentation: Adding Orderable superclass in code example in "Binding Pages to Snippets". If this is not included sorting in InlinePanel won't work so good to include it in documentation. 2020-04-28 16:21:36 +01:00
Matt Westcott
ceb4270e01 Remove versionadded/versionchanged notes for 2.8 2020-04-22 13:54:09 +01:00
Matt Westcott
4950158e46 Remove remaining references to request.site 2020-02-17 12:06:19 +00:00
Matt Westcott
f34891fbd3 Update docs to cover wagtail_site tag, find_for_request and deprecation of SiteMiddleware 2020-02-17 12:06:18 +00:00
Matt Westcott
4314f3d1a1
Implement MultipleChoiceBlock (rebase of #5592) (#5819) 
* Implement MultipleChoiceBlock (squashed commits from #5592)

* Omit widget from frozen kwargs

* Rename get_callable_choices to indicate it is an internal method

* Add release notes for MultipleChoiceBlock
 2020-02-10 22:24:49 +00:00
Matt Westcott
d2080ff892 Update docs to cover responsive HTML being disabled by default 2020-01-20 18:57:51 +00:00
Matt Westcott
25942a4467 Rename WAGTAIL_ENABLE_RESPONSIVE_EMBED to WAGTAILEMBEDS_RESPONSIVE_HTML for consistency with other settings 2020-01-20 18:57:51 +00:00
Kalob Taulien
aefb0f9506 Responsive emebed setting 2020-01-17 16:44:46 +00:00
Martey Dodoo
229103ff2e Update links in documentation. (#5689) 
Use HTTPS links instead of non-secure HTTP links wherever possible in
documentation.
 2019-11-08 09:15:01 +00:00
Karl Hobley
8335eb5305 syntax => keyword 2019-10-16 16:24:24 +01:00
Karl Hobley
6727ded7bc Improvements to "Alternative HTML tags" based on review feedback 2019-10-16 16:24:24 +01:00
Karl Hobley
abbbceb389 Add documentation for how to use alternative image tags 
This adds documentation for alternative image tags such as `<picture>`
and `<amp-img>`.
 2019-10-16 16:24:24 +01:00
David Thompson
6a6555eb19 Fix multiple minor documentation issues 
- Typo in readme (verb did not agree with the subject)
- Grammatical error in topics/pages
- #5364 - Update URL config code block in getting-started/integrating-into-django
 2019-10-12 09:42:02 +10:00
pySilver
0149eff66a Implements ES7 support (#5611) 
* Implements ES7 support

* Linter fix

* Adds docs

* isort fix

* Fixes typo
 2019-10-10 11:00:14 +01:00
Mike Janger
747b5402d2 Changed height's description to match width's. (#5593) 2019-10-02 09:32:16 +01:00
Jonathan Liuti
2de92f045c Upgrade minimum 6.x release for Elasticsearch to 6.4.0 
Fix doc and test on ES6 python client compat

This commit changes the statement that version < 6.3.1 of the
elasticsearch python client should be used to instead state
that 6.4.0 is fine.

It also update the tests to reflect the statement.

Initially the `update_all_types` argument has been used to work
around an issue described in:
https://github.com/wagtail/wagtail/issues/2968

This argument was removed in elasticsearch-py 6.3.1 and making
use of it was raising an error.

With 6.4.0 nothing is raising anymore.
 2019-08-18 15:37:11 +10:00
Seb
b839bd65bb Add support for custom search handler classes to ModelAdmin's IndexView 
Author:    Seb <seb@takeflight.com.au>
Date:      Sun Apr 7 12:34:00 2019 +1000
 2019-06-08 17:57:24 +01:00
DanAtShenTech
6989c29d33 Create reference in docs to PostgreSQL backend 
wagtailsearch_backends_postgresql was not present in the documentation for reference by change made in this PR:  https://github.com/wagtail/wagtail/pull/5233
 2019-05-03 13:36:02 +01:00
DanAtShenTech
5d52f416df Clarify: extra fields can be indexed by PostgreSQL backend (#5233) 2019-05-01 11:24:14 +01:00
DanAtShenTech
dec456479b Grammar fixes (#5212) 2019-04-12 16:30:17 +01:00
Cassidy Brooke
942979fc4e Missing step for Migrating RichTextFields to StreamField (#5207) 
This generated block of code needs to stay or else there will be an error while running ./manage.py migrate. It is misleading that it is not included in this tutorial.
 2019-04-12 16:20:11 +01:00
DanAtShenTech
f4ada7cad5 Fix typo. Small grammar changes. 2019-04-08 17:32:54 +01:00
DanAtShenTech
f4ca13a9b3 Small wording changes 2019-04-03 10:09:12 +01:00
Kalob Taulien
062ff73665 Add documentation for the ajax_template attribute 2019-03-29 11:25:01 +00:00
Tom Usher
0f8a55a6ce Pass validators to FieldBlocks (#5148) 2019-03-15 18:42:08 +01:00
Arthur Holzner
6f6f9b8e46 Added fallback to pageurl (#4603) 2019-03-13 12:17:13 +01:00
Loic Teixeira
9da3a3d975 Update documentation 2019-03-06 11:00:30 +00:00
Matt Westcott
61e1e4c2f9 Add 'wagtail_update_index' as an alias for the 'update_index' command (#5009) 
Fixes #2447
 2019-03-01 11:01:41 +00:00
Sergey Fedoseev
c2a83b92da Fix typo in docs/topics/images.rst 2019-02-27 19:25:06 +00:00
Evan Winter
a4c3ccc464 Fix typo in docs (#5103) 2019-02-26 21:46:23 +00:00
Karl Hobley
50e72dc58b Allow disabling search auto-update on a per-model basis (#4946) 2019-01-29 17:06:41 +00:00
Matt Westcott
056096c2de Remove old versionchanged note 2018-12-07 11:59:55 +00:00
Sergey Fedoseev
47465197a9 Use intersphinx for Django references when possible. (#4896) 2018-11-14 11:48:32 +00:00
Matt Westcott
659a57d75f Specify Elasticsearch <6.3.1 2018-08-10 14:27:07 +01:00
Oliver Wilkerson
091ea75de7 Added a simple scale filter to image_operations. 2018-08-09 16:11:39 +01:00
Matt Westcott
7c38c5ad56 Fix typo preventing facet example from displaying 2018-07-27 12:00:38 +01:00
Matt Westcott
bf5d6e3363 Release note for #4524 2018-07-27 11:58:21 +01:00
Bertrand Bordage
0a50aaf130 Typo. 2018-06-20 15:33:49 +02:00
Karl Hobley
fe76c11043 Implemented facet() method on search results 
Add error handling for when facet field doesnt exist

Count('id' -> 'pk')

Use assertDictEqual

Fix indexing related fields using FilterField
 2018-06-20 14:59:57 +02:00
Victor Miti
c38b172793 updated Django Docs Links to point to *docs.djangoproject.com/en/stable/* 2018-05-18 14:43:42 +01:00
Matt Westcott
5ce14841d8 Remove ancient versionchanged notes 2018-05-15 14:54:41 +01:00
Matt Westcott
7f38c476be Release note for #4132 2018-05-04 16:19:27 +01:00
Karl Hobley
6308e6b816 Docs update for Elasticsearch 6 support 2018-05-04 15:57:36 +01:00
Karl Hobley
df4f1204e8
Fix a couple of search indexing examples 2018-05-03 12:29:35 +01:00
DanAtShenTech
8741491313 Wording clarification 2018-04-06 16:23:04 +01:00
Karl Hobley
f608c67eb1 Fix capitalisation of names 2018-04-05 12:13:05 +01:00
Karl Hobley
a9b4b09152 Fix spelling mistakes in documentation 2018-04-05 12:13:05 +01:00
DanAtShenTech
72e1491f39 Fix typo 2018-03-16 19:54:59 +01:00
Mads Jensen
b30c722728 Used Python 3 super() syntax also in documentation. (#4246) 
This disregards the release notes for earlier releases and only deals
with current documentation.
 2018-02-07 10:11:27 +00:00
Matt Westcott
bcc93806bd Fix anchor syntax 2018-01-05 16:33:33 +00:00
Bertrand Bordage
317ea80a7e Doc typos. 2018-01-03 11:29:23 +01:00
Karl Hobley
1e332b4b67 Implement 'bgcolor' image operation. 
Also fixes #3713.

Remove alpha channel if converting transparent image to JPEG
 2018-01-03 11:26:14 +01:00
LB
70eb2b6ae3 add on_delete argument to ParentalKey & ForeignKey 2017-12-15 10:33:09 +00:00
LB
5c29f37632 Add filter example images 2017-12-14 12:35:52 +00:00
LB
4ea8365203 Add ability to set custom value_class on StructBlock 2017-12-13 00:00:35 +00:00
Mads Jensen
8b420b9abc Removed __future__ imports 
Also delete add_imports directive from isort configuration
 2017-11-27 02:18:30 +00:00
Karl Hobley
9a13b09d41 Renamed wagtail.contrib.wagtailstyleguide to wagtail.contrib.styleguide 2017-11-26 22:43:47 +00:00
Karl Hobley
fd8f642fb6 Renamed wagtail.contrib.wagtailsearchpromotions to 
wagtail.contrib.search_promotions

Conflicts:
	wagtail/contrib/search_promotions/forms.py
	wagtail/contrib/search_promotions/templatetags/wagtailsearchpromotions_tags.py
	wagtail/contrib/search_promotions/wagtail_hooks.py
 2017-11-26 22:43:47 +00:00
Karl Hobley
1ecf48fb3f Rename wagtail.wagtailsnippets to wagtail.snippets 
Conflicts:
	docs/advanced_topics/settings.rst
	docs/getting_started/integrating_into_django.rst
	docs/topics/pages.rst
	docs/topics/snippets.rst
	gulpfile.js/config.js
	wagtail/contrib/wagtailstyleguide/views.py
	wagtail/project_template/project_name/settings/base.py
	wagtail/snippets/tests.py
	wagtail/snippets/views/chooser.py
	wagtail/snippets/views/snippets.py
	wagtail/snippets/wagtail_hooks.py
	wagtail/tests/settings.py
	wagtail/tests/snippets/models.py
	wagtail/tests/testapp/models.py
 2017-11-26 22:43:47 +00:00
Karl Hobley
19730bea53 Renamed wagtail.wagtailsearch to wagtail.search 
Conflicts:
	docs/advanced_topics/settings.rst
	docs/getting_started/integrating_into_django.rst
	docs/getting_started/tutorial.rst
	docs/topics/pages.rst
	docs/topics/search/searching.rst
	tox.ini
	wagtail/admin/tests/test_pages_views.py
	wagtail/admin/views/mixins.py
	wagtail/api/v2/filters.py
	wagtail/contrib/wagtailsearchpromotions/forms.py
	wagtail/contrib/wagtailsearchpromotions/views.py
	wagtail/documents/models.py
	wagtail/documents/views/chooser.py
	wagtail/documents/views/documents.py
	wagtail/documents/views/multiple.py
	wagtail/images/migrations/0001_initial.py
	wagtail/images/models.py
	wagtail/images/views/chooser.py
	wagtail/images/views/images.py
	wagtail/images/views/multiple.py
	wagtail/project_template/project_name/settings/base.py
	wagtail/project_template/search/views.py
	wagtail/search/tests/test_frontend.py
	wagtail/search/tests/test_index_functions.py
	wagtail/search/views/frontend.py
	wagtail/search/views/queries.py
	wagtail/search/wagtail_hooks.py
	wagtail/tests/demosite/models.py
	wagtail/tests/modeladmintest/models.py
	wagtail/tests/non_root_urls.py
	wagtail/tests/settings.py
	wagtail/tests/snippets/models.py
	wagtail/tests/testapp/migrations/0001_initial.py
	wagtail/tests/testapp/migrations/0020_customdocument.py
	wagtail/tests/testapp/models.py
	wagtail/tests/urls.py
	wagtail/wagtailsnippets/views/chooser.py
	wagtail/wagtailsnippets/views/snippets.py
 2017-11-26 22:43:47 +00:00
Karl Hobley
bf0f3e02ba Rename wagtail.wagtailimages to wagtail.images 
Conflicts:
	docs/advanced_topics/api/v2/configuration.rst
	docs/advanced_topics/jinja2.rst
	docs/advanced_topics/settings.rst
	docs/getting_started/integrating_into_django.rst
	docs/getting_started/tutorial.rst
	docs/topics/pages.rst
	docs/topics/streamfield.rst
	gulpfile.js/config.js
	tox.ini
	wagtail/admin/tests/test_compare.py
	wagtail/admin/tests/test_edit_handlers.py
	wagtail/api/v2/signal_handlers.py
	wagtail/contrib/wagtailstyleguide/views.py
	wagtail/core/tests/test_streamfield.py
	wagtail/documents/tests/test_models.py
	wagtail/images/models.py
	wagtail/images/permissions.py
	wagtail/images/tests/test_admin_views.py
	wagtail/images/tests/test_image_operations.py
	wagtail/images/tests/test_models.py
	wagtail/images/tests/test_signal_handlers.py
	wagtail/images/views/chooser.py
	wagtail/images/views/images.py
	wagtail/images/views/multiple.py
	wagtail/images/wagtail_hooks.py
	wagtail/images/widgets.py
	wagtail/project_template/project_name/settings/base.py
	wagtail/tests/demosite/models.py
	wagtail/tests/non_root_urls.py
	wagtail/tests/settings.py
	wagtail/tests/testapp/migrations/0001_initial.py
	wagtail/tests/testapp/migrations/0008_inlinestreampage_inlinestreampagesection.py
	wagtail/tests/testapp/migrations/0009_defaultstreampage.py
	wagtail/tests/urls.py
 2017-11-26 22:43:47 +00:00
Karl Hobley
54d8357f96 Rename wagtail.wagtailembeds to wagtail.embeds 
Conflicts:
	gulpfile.js/config.js
	wagtail/embeds/blocks.py
	wagtail/embeds/tests.py
	wagtail/embeds/views/chooser.py
	wagtail/embeds/wagtail_hooks.py
 2017-11-26 22:43:47 +00:00
Karl Hobley
78b1372cd4 Rename wagtail.wagtaildocs to wagtail.documents 
Conflicts:
	docs/advanced_topics/i18n/index.rst
	docs/advanced_topics/settings.rst
	docs/getting_started/integrating_into_django.rst
	gulpfile.js/config.js
	wagtail/admin/tests/test_collections_views.py
	wagtail/api/v2/signal_handlers.py
	wagtail/contrib/wagtailstyleguide/views.py
	wagtail/core/tests/test_collection_permission_policies.py
	wagtail/documents/permissions.py
	wagtail/documents/tests/test_admin_views.py
	wagtail/documents/tests/test_collection_privacy.py
	wagtail/documents/tests/test_models.py
	wagtail/documents/views/chooser.py
	wagtail/documents/views/documents.py
	wagtail/documents/views/serve.py
	wagtail/documents/wagtail_hooks.py
	wagtail/documents/widgets.py
	wagtail/project_template/project_name/urls.py
	wagtail/tests/demosite/models.py
	wagtail/tests/non_root_urls.py
	wagtail/tests/settings.py
	wagtail/tests/testapp/models.py
	wagtail/tests/urls.py
 2017-11-26 22:43:47 +00:00
Karl Hobley
062d05189b Rename wagtail.wagtailadmin to wagtail.admin 
Conflicts:
	docs/advanced_topics/customisation/admin_templates.rst
	docs/advanced_topics/customisation/page_editing_interface.rst
	docs/advanced_topics/i18n/duplicate_tree.rst
	docs/advanced_topics/jinja2.rst
	docs/advanced_topics/settings.rst
	docs/getting_started/integrating_into_django.rst
	docs/getting_started/tutorial.rst
	docs/reference/hooks.rst
	docs/reference/pages/panels.rst
	docs/topics/pages.rst
	docs/topics/streamfield.rst
	wagtail/admin/blocks.py
	wagtail/admin/checks.py
	wagtail/admin/edit_handlers.py
	wagtail/admin/forms.py
	wagtail/admin/rich_text.py
	wagtail/admin/search.py
	wagtail/admin/site_summary.py
	wagtail/admin/templatetags/wagtailadmin_tags.py
	wagtail/admin/tests/test_admin_search.py
	wagtail/admin/tests/test_buttons_hooks.py
	wagtail/admin/tests/test_compare.py
	wagtail/admin/tests/test_edit_handlers.py
	wagtail/admin/tests/test_page_chooser.py
	wagtail/admin/tests/test_pages_views.py
	wagtail/admin/tests/test_rich_text.py
	wagtail/admin/tests/test_widgets.py
	wagtail/admin/tests/tests.py
	wagtail/admin/urls/__init__.py
	wagtail/admin/views/account.py
	wagtail/admin/views/chooser.py
	wagtail/admin/views/collection_privacy.py
	wagtail/admin/views/collections.py
	wagtail/admin/views/home.py
	wagtail/admin/views/page_privacy.py
	wagtail/admin/viewsets/model.py
	wagtail/admin/wagtail_hooks.py
	wagtail/admin/widgets.py
	wagtail/contrib/settings/registry.py
	wagtail/contrib/wagtailsearchpromotions/wagtail_hooks.py
	wagtail/contrib/wagtailstyleguide/wagtail_hooks.py
	wagtail/project_template/project_name/settings/base.py
	wagtail/project_template/project_name/urls.py
	wagtail/tests/non_root_urls.py
	wagtail/tests/settings.py
	wagtail/tests/snippets/models.py
	wagtail/tests/testapp/models.py
	wagtail/tests/testapp/wagtail_hooks.py
	wagtail/tests/urls.py
	wagtail/wagtaildocs/models.py
	wagtail/wagtaildocs/views/chooser.py
	wagtail/wagtaildocs/wagtail_hooks.py
	wagtail/wagtailembeds/wagtail_hooks.py
	wagtail/wagtailforms/models.py
	wagtail/wagtailforms/tests/test_views.py
	wagtail/wagtailforms/views.py
	wagtail/wagtailforms/wagtail_hooks.py
	wagtail/wagtailimages/models.py
	wagtail/wagtailimages/views/chooser.py
	wagtail/wagtailimages/wagtail_hooks.py
	wagtail/wagtailredirects/forms.py
	wagtail/wagtailredirects/wagtail_hooks.py
	wagtail/wagtailsites/forms.py
	wagtail/wagtailsites/views.py
	wagtail/wagtailsites/wagtail_hooks.py
	wagtail/wagtailsnippets/tests.py
	wagtail/wagtailsnippets/wagtail_hooks.py
	wagtail/wagtailusers/forms.py
	wagtail/wagtailusers/views/groups.py
	wagtail/wagtailusers/wagtail_hooks.py
 2017-11-26 22:43:47 +00:00
Karl Hobley
4300e19da2 Rename wagtail.wagtailcore to wagtail.core 2017-11-26 22:43:47 +00:00
LB
8f1f7a63d1 Add explicit requirement for image and filter 2017-11-14 20:10:45 +00:00
Karl Hobley
696acfd28b Remove ES 1.x search backend 2017-11-06 14:27:27 +00:00
Matt Westcott
b0ddfc6da4 Update warning re ATOMIC_REBUILD on Elasticsearch >= 5.4 
It appears that the bug may have reappeared in 5.5 final. Fixes #3985
 2017-11-03 15:53:29 +00:00
Karl Hobley
bd38525e5b Merge branch 'master' into cleanup/remove-python2 2017-10-25 16:21:27 +01:00
Matt Westcott
9ec8daba43 Update slugurl documentation with a "real-world" example. 
Thanks to @rifuso for the suggestion!
 2017-10-23 12:40:07 +01:00
Bertrand Bordage
0f5640b212 Fixes INDEX_SETTINGS docs. 2017-10-19 23:11:40 +01:00
Matt Westcott
5f382d8784 Remove Python 2 references from docs 2017-10-13 12:24:42 +01:00
Matt Westcott
c80bbfcc5f Eliminate references to wagtaildemo from the docs 
bakerydemo is now our preferred demo site and the one which will be updated for Wagtail 2.x / Django 2.x.
 2017-10-11 16:58:30 +01:00
Matt Westcott
fddb9a076e Correct 'Indexing extra fields' note to avoid implying that the Postgresql backend doesn't support it 
Fixes #3899 - thanks @sivictorallen for the report!
 2017-10-10 12:09:13 +01:00
Matt Westcott
a4b99ce4f0 Change StreamField examples to use explicit required=False instead of required=True 2017-09-18 21:34:35 +01:00
Matt Westcott
addb31c1d6 Explicitly state that required defaults to true on StreamField blocks 2017-09-18 21:34:35 +01:00
Matt Westcott
cc77f8e7d4 Clarify interaction between StreamField's blank property and StreamBlock's required property 2017-09-18 21:34:35 +01:00
Ben Sturmfels
5278e005a0 Remove unused import in docs snippet. 2017-08-23 22:58:42 +01:00
Ben Sturmfels
5301010474 Update docs for Amazon ElasticSearch service as backend. 
This change moves the "connection_class" key into "OPTIONS", resolving error
``AttributeError: 'AWS4Auth' object has no attribute 'encode'``.
 2017-08-23 21:11:25 +01:00
Tomasz Knapik
80c846a0cf Add help_text to DecimalBlock and RegexBlock 2017-08-11 11:48:51 +01:00
Matt Westcott
7c99cad62b Documentation for rich text features 2017-08-10 14:19:34 +01:00
Matt Westcott
2e5dd9aa55 Refactor #3605 to work alongside 'required' param 2017-08-01 15:02:52 +01:00
ebar0n
993cff3e22 Add validations for min_max_fields on StreamBlock 2017-08-01 10:41:49 +01:00
Edwar Baron
58ad6545be Add ability to specify min/max block counts on StreamBlock 2017-08-01 10:41:48 +01:00
Matt Westcott
4a5f3072bd Release note and docs for #3315 2017-08-01 00:17:02 +01:00
Jeffrey Chau
988a2487ef Update documentation to reflect specific behavior of form_classname meta attribute 2017-07-28 15:41:38 +01:00
Karl Hobley
8a8b440532 Put a space back 
Accidentally removed by previous commit
 2017-07-04 09:58:01 +01:00
Karl Hobley
1d878c6788 Remove a broken link from pages.rst 
This link now just leads to a blank page with the message "The Django wiki is no longer used for this information."
 2017-07-04 09:56:36 +01:00
Matt Westcott
b2fbd91864 Document the DOCUMENT_PASSWORD_REQUIRED_TEMPLATE setting 2017-06-16 14:50:48 +01:00
Matt Westcott
ea8ab5de45 Document Elasticsearch 5.4 incompatibility with ATOMIC_REBUILD 2017-06-07 15:08:48 +01:00
John Franey
3f8052064e Mention PostgreSQL backend in docs Search index 
Updates the Search docs index to mention the new PostgreSQL backend
 2017-05-30 20:48:46 +01:00
Matt Westcott
1f8edc8984 Cache Site.get_site_root_paths in the request scope (#3354) 2017-05-16 15:24:48 +01:00
Bertrand Bordage
e62d67bd73 Adds PostgreSQL search backend. (#3515) 
* Adds PostgreSQL search backend.

* Isort nitpicks.

* Fixes PostgreSQL versions incompatibilities.

* Uses Django lru_cache instead of building our own.

* Fixes PostgreSQL search index on some empty vector & query cases.

* Never sets the PostgreSQL search vector to NULL.

* Simplification + removes caching on two fast enough functions.

* Rewrites stale entries deletion to use the ORM.
 2017-04-12 16:16:16 +01:00
Andreas Nüßlein
bfd4a2ef4b Adding the Meta attribute group to Blocks. 
The idea is that Streamfield-Blocks can be grouped in the CMS
by setting Meta's `group` attribute.
This gives a better overview, particularly with many blocks.
If the attribute remains unset, nothing changes.
 2017-04-10 20:27:32 +01:00
Matt Westcott
6d553ab396 Document that 'format' on Date(Time)Block must be one of the recognised DATE(TIME)_INPUT_FORMATS 2017-03-31 16:46:00 +01:00
Bojan Mihelac
0f53afc5a6 Adds support for custom date and datetime formats (#2595) 
It is possible to set default format for date/datetime inputs. This works together
with standard django localization.

    # django settings
    USE_I18N = True
    LANGUAGE_CODE = 'sl'

    # wagtail settings
    WAGTAIL_DATE_FORMAT = '%d.%m.%Y.'
    WAGTAIL_DATETIME_FORMAT = '%d.%m.%Y. %H:%M'

DateBlock, DateTimeBlock accepts additional keyword argument `format`.
 2017-03-31 16:30:27 +01:00
Nick Smith
48949e69a7 Add to StreamField migrations documentation 
- Add example code for migrating draft pages and page revisions
 2017-03-30 21:37:12 +01:00
Kees Hink
6961f33078 Restrict view_draft to can_publish / can_edit permissions (#3474) 2017-03-24 11:54:10 +01:00
Scot Hacker
6364104282 Document get_rendition() 2017-02-21 22:48:20 +00:00
Mikalai Radchuk
eb47526888 Enhancement for PageChooserBlock 
Allow the target_model argument to be a list or tuple.
 2017-02-17 11:30:32 +00:00
Matt Westcott
bd9455a11b Document wagtailsearch settings for Amazon Elasticsearch Service (#3345) 
Resolves #2776
 2017-02-08 18:58:24 +00:00
Matt Westcott
19310a84ed Documentation and release notes for #3275 2017-01-16 18:51:42 +00:00
Mikela Clemmons
26b7071307 RegexBlock error_message typo in docs 
In the documention an example had a singular
 2017-01-13 10:06:19 +00:00
Nikolai R Kristiansen
54bfd1a802 docs: Fix INDEX_SETTINGS in ES search backend ex. 
The key `number_of_shards` lives below the `index` key.

Ref: https://www.elastic.co/guide/en/elasticsearch/reference/2.4/indices-create-index.html#create-index-settings
 2017-01-06 11:23:16 +00:00
J. Heasly
9424a8eab9 Give indication that there may be other template bits necessary for tag to work. 
I came to this page from "Getting Started" template examples where all pages examples are rendered within {% block content %} tags which are not in these template examples."
;
 2017-01-05 10:14:07 +00:00
Matt Westcott
5e13a1d674 Remove old versionadded line 2016-12-15 16:23:05 +00:00
Matt Westcott
6f834c9a9b Update links to github.com/torchbox to point to github.com/wagtail 2016-12-15 11:49:49 +00:00
pyMan
7d1114c1a1 Extra ES params passed through new OPTIONS key 
Closes #2778

Extra ES params are now passed through new OPTIONS key in the
WAGTAILSEARCH_BACKENDS setting.

It's backward compatible: if no OPTIONS key is found and some parameters
still exist, those parameters are used for the ES constructor..
 2016-12-01 12:04:14 +00:00
Karl Hobley
18316d627d Added Elasticsearch 5 to search backend docs 2016-11-30 16:31:20 +00:00
Scot Hacker
2882775842 Add BlockQuoteBlock to core block types 2016-11-29 10:13:10 +00:00
Mikalai Radchuk
55bdae573b Add support of callable choices for ChoiceBlock 
Fixes #2809
 2016-11-28 17:44:35 +00:00
Tim Heap
16213db0f8 Remove old versionadded notes 
A step has been added to the release process notes to do this for future
releases as well.

https://github.com/torchbox/wagtail/wiki/Creating-a-new-Wagtail-release
 2016-11-28 13:41:35 +00:00
Tim Heap
6ba34636cb Fix whitespace errors in docs 
Trimmed trailing whitespace, convert tabs to 4 spaces, add preference
for spaces to `.editorconfig`.
 2016-11-28 13:41:35 +00:00
Tim Heap
254e675634 Use .. code-block:: console for all shell commands 
This is the correct lexer for interactive console sessions, according to
<http://pygments.org/docs/lexers/>. This does require command lines to
be prefixed with `$`, otherwise they are interpreted as the output of a
command. It highlights the command nicely, including environment
variables, strings, and comments.
 2016-11-28 13:41:35 +00:00
Tim Heap
f742d4a476 Use .. code-block:: for all python, html blocks 2016-11-28 13:41:34 +00:00
Benoit Vogel
2fba07ad8e Implemented StaticBlock 
Uses admin_text which is a Meta attribute.
* StaticBlock code in wagtailcore/blocks + tests
* StaticBlock in Streamfield docs
 2016-11-15 10:29:06 +00:00
Matt Westcott
59e9a31bc1 Document the fact that a matching version of the elasticsearch package must be used 2016-11-04 11:14:12 +00:00
Matt Westcott
8de1b1b16f Release note for #3035 2016-11-03 16:58:54 +00:00
Matt Westcott
1b2cb50a84 Add documentation for bulk delete permission 2016-11-03 16:58:50 +00:00
Matt Westcott
5c9fc29fbe Mention that deleting a published page requires publish permission 2016-11-03 16:10:11 +00:00
Matt Westcott
e681cb3626 Add documentation about permission configuration 2016-11-03 16:10:09 +00:00
Tim Heap
9d54031a50 Add PageChooserBlock target_model option 
It allows selecting a restricted subset of pages, like with the
PageChooserPanel
 2016-10-26 13:01:46 +01:00
Matt Westcott
a326cd8559 Custom Page Manager documentation fix 
Thanks to @nimasmi for reporting!
 2016-10-25 11:48:02 +01:00
Matt Westcott
534b5d1fd9 Release note for #2474 2016-10-05 16:03:54 +01:00
Karl Hobley
2a6f908972 Various docs tweaks 
Thanks @tomdyson for spotting!
 2016-10-05 15:54:05 +01:00
Karl Hobley
6c57b5b280 Docs for format and jpegquality image filters 
This also fixes #1205
 2016-10-05 15:54:05 +01:00
Karl Hobley
9a57e39cfd Implemented annotate_score on SearchResults 
This allows the user to retrieve the scores for each search result:

    for page in Page.objects.search("Hello").annotate_score('_score'):
        print(page.title, page._score)
 2016-09-22 12:03:23 +01:00
Mikalai Radchuk
5598910a2b Release notes for #2573 2016-08-31 14:13:47 +03:00
Karl Hobley
daa82936d7 Elasticsearch 2 support (#2573) 
* Created Elasticsearch 2 backend

* Added tests for Elasticsearch 2 backend

* Split models up into different indices

pages, images and documents are now in separate indices

* Prefix fields of child models to prevent mapping clashes

* Replaced index_analyzer with analyzer/search_analyzer

index_analyzer has been removed in Elasticsearch 2.0

https://www.elastic.co/guide/en/elasticsearch/reference/current/breaking_20_mapping_changes.html#_analyzer_mappings

There's no indication in Elasticsearch's docs that this wouldn't work on Elasticsearch 1.x. However, we found that the new configuration isn't reliable on Elasticsearch 1.6 and below (causes the test_query_analyzer test to fail randomly).

* Implemented new way of representing content types in search index

Instead of using a long string of model names that is queried using a
"prefix" query, we instead use a multi-value string field and query it
using a simple "match" query.

The only reason why this isn't implemented in the Elasticsearch 1.x
backend yet is backwards compatibility

* Added another child model of SearchTest with clashing field mapping

This checks that the namespacing of fields on child models is working properly (if it doesn't the update_index tests will fail)

* Added tests for get_model_root function

* fixup! Added tests for get_model_root function

* Docs updates for Elasticsearch 2 support

Also tweak examples to use elasticsearch2 backend by default

* Test against Elasticsearch 2 on travis
 2016-08-31 13:46:57 +03:00
Karl Hobley
e29f9b2423 No longer say that ATOMIC_REBUILD is "Experimental" 
We've used this in production on a few sites for over a year now and haven't hit any problems.
 2016-08-31 09:54:35 +01:00
Matt Westcott
7bc819640d Restore PageManager behaviour by setting it on an abstract superclass of Page 
Django's standard behaviour is to preserve managers that are set on abstract
superclasses, so this allows us to eliminate the metaclass hackery.

Fixes #2933
 2016-08-23 20:12:22 +01:00
David Burke
db54a9f0c4 Update IntegerBlock docs to show correct kwargs (#2930) 
It should be max and min value - not length. See [here](07c3ba84fb/wagtail/wagtailcore/blocks/field_block.py (L306)).

So this would work 

`blocks.IntegerBlock(max_value=10, min_value=0)`

but this wouldn't do anything

`blocks.IntegerBlock(max_length=10, min_length=0)`
 2016-08-20 02:38:00 +01:00
Matt Westcott
bc7739e104 Add usage examples for EmailBlock, IntegerBlock, DecimalBlock 
Thanks to @OktayAltay for the original pull request.
 2016-08-08 20:15:45 +01:00
Nik Nyby
389317c104 docs: fix typo (#2845) 2016-07-15 21:58:47 +03:00
Matt Westcott
be1e1927c5 Promote include_block and unicode page slugs to major features 2016-07-07 11:20:43 +01:00
Matt Westcott
dbc4c9b28e Adds the include_block template tag (#2786) 
Update render and render_basic methods on Block to take a context kwarg

Update TableBlock to support passing extra context to render

Implement render_as_block on BoundBlock, StreamValue and StructValue.

Collectively, these are the objects encountered during template rendering which typically render
a block template when output inside {{ ... }} tags. Implementing render_as_block allows us to do
the same thing, but passing a template context as well.

Implement include_block tag

Support extra context vars on include_block via 'with foo=bar'

Support 'only' flag on include_block tag, to omit the parent context

Update StreamField documentation to cover the include_block tag

Rewrite 'BoundBlocks and values' docs based on the include_block tag

Add tests for blocks with legacy render / render_basic methods

Any bits of StreamField infrastructure that attempt to call render or render_basic
on a block with a 'context' kwarg, should (for now) also work on blocks that don't
accept the context kwarg, but output a RemovedInWagtail18Warning.

Explicitly test whether render / render_basic will accept a 'context' kwarg

This avoids unexpected behaviour when the method legitimately accepts a context
kwarg, but happens to throw an unrelated TypeError - in this situation, the final
output (or error diagnostics) will behave as if the context was never passed,
making debugging difficult. See https://github.com/torchbox/wagtail/pull/2786#discussion_r69563984
 2016-07-06 17:44:02 +03:00
Matt Westcott
9961455c6a Add formal support for customising the form rendering of StructBlocks 
The `form_template` attribute was mentioned in passing in the docs, but was missing various things
to make it fully useful:

- context passed to form_template now includes 'prefix' and 'block_definition'
- context for the form is now populated in a separate overrideable `get_form_context` method
- full documentation and tests for form_template and get_form_context added
 2016-07-05 11:48:09 +01:00
Matt Westcott
5758b54f2e Support error_messages dict as argument to RegexBlock 
The individual `error_message` kwarg on RegexField is deprecated in Django 1.8
(and removed in Django 1.10), so it's appropriate for RegexBlock to follow the
same convention.
 2016-06-28 16:11:52 +01:00
OktayAltay
9358e3b611 Add new FloatBlock, DecimalBlock and a RegexBlock (#2737) 2016-06-23 10:14:28 +01:00
Oktay Altay
31ce2e802c Add new EmailBlock and IntegerBlock 2016-06-17 23:39:49 +01:00
Gagaro
871a5b5d9c Use python_2_unicode_compatible in snippets.rst (#2688) 
We should use `python_2_unicode_compatible` in the documentation so that new users know the best practice.
 2016-06-07 13:49:28 +01:00
Josh Schneier
6d1a9efbb6 Update documentation and code to put mixin first 2016-05-04 14:05:33 +01:00
Robert Rollins
11793f88c5 Changed indentation on all code samples to 4 spaces. 
Most of the samples were already 4-space indented, but a few were using 2-space,
which is both inconsistent and, when it happened with Python code samples,
incompatible with PEP8.
 2016-04-28 10:57:22 +01:00
João Luiz Lorencetti
ffbe4730f0 The destination of the ParentalKey should be a subclass of ClusterableModel 2016-04-03 20:18:57 +01:00
Timo Rieber
9bdc843c8f Clarified wagtail userbar options and positioning 2016-03-27 14:23:47 +01:00
Tim Heap
6bd168580e Change Indexed.search_fields to be a listish thing 
Indexed.search_fields used to be a tuple. This is incorrect, and it
should have been a list.  Changing it to be a list now would be a
backwards incompatible change, as people do

    search_fields = Page.search_fields + (
        SearchField('body')
    )

Adding a tuple to the end of a list causes an error, so this would
cause all old code that used tuples to throw an error. This is not
great.

A new ThisShouldBeAList class, which subclasses list, has been added.
It additionally allows tuples to be added to it, as in the above
behaviour, but will raise a deprecation warning if someone does this.
Old code that uses tuples will continue to work, but raise a deprecation
warning.

See #2310
 2016-03-24 21:05:09 +00:00
Robert Rollins
b94ff6a952 Searchly no longer supports Elasticsearch 1.x, so I switched the suggested development service to Bonsai. 2016-03-10 15:11:42 +00:00
Robert Rollins
6446c42132 Various typo fixes and grammar/clarity improvements. 2016-03-10 15:11:41 +00:00
Loïc Teixeira
33aad3957f Fix internal links with anchors 
Generating links with `link text <./path/to/doc#anchor>`__ does not work for html.
It produces a link to `./path/to/doc#anchor` instead of `./path/to/doc.html#anchor`.

It would be tempting to add `.html` before `#` but would likely cause some more issues
when generating the documentation as pdf or epub.

References on the other hand will work regardless of the output format.
 2016-03-06 21:05:05 +00:00
Matt Westcott
49e2de9813 fix doc rendering error in wagtailuserbar code block 2016-03-06 21:02:51 +00:00
Josh Barr
a1a2940495 fixed font size rounding issue in firefox, added contrib notes 2016-03-03 12:29:28 +13:00
Quadric
d27df01815 Tagging snippets documentation fix 
I'm not sure i'm right but i think there is a typo in this example. I guess there should be a AdvertTag use in TaggableManager instead BlogPageTag
 2016-02-12 11:11:08 +00:00
Andrew Pryde
e2601c30b8 Fix PageQuerySet code overriding code snippet 2016-02-08 16:03:11 +03:00
Karl Hobley
95ff74feeb Moved advanced image topics into advanced topics 2016-01-27 11:27:16 +00:00
Karl Hobley
8a9e65f92f Change title of "topics" section to "Usage guide" 2016-01-27 11:27:16 +00:00
Matt Westcott
04fdd5f352 Remove Django 1.7 support from documentation, requirements and CI definitions 2016-01-05 17:38:29 +00:00
Denis Voskvitsov
ab45915a90 Set request.is_preview flag to show whether page is served as preview 2015-12-16 11:28:53 +00:00
Tim Heap
9e8c2c2d5f Allow custom Page Managers 
Previously, if a developer wanted to use a custom Manager on their Page
subclass, some fairly hacky hacks were required. Now, the `objects`
attribute is only overridden if it is a plain `Manager`. If it is
anything else, it is left alone. A system check has been added to ensure
that all `Page` managers inherit from `PageManager`
 2015-12-14 23:09:45 +00:00
Matt Westcott
9e124cb9b6 Remove use of value.bound_blocks from basic StructBlock template example. 
This hasn't been necessary since #1360 was merged, and the new 'BoundBlocks and values' section covers it much better.
 2015-12-11 12:48:37 +00:00
Matt Westcott
0e34282646 Add section about BoundBlocks and values 2015-12-11 12:48:37 +00:00
Matt Westcott
2c765a7462 Release note for #1491 2015-12-11 12:46:01 +00:00
Karl Hobley
eed5c60d72 Docs for index.RelatedFields 2015-12-11 12:29:27 +00:00
Maris Serzans
32b4124767 Changed verbose names to start with lowercase when necessary 2015-12-08 17:33:19 +00:00
Jan Korte
56cfe02bae snippet docs: loading the tags is necessary 2015-12-03 18:45:29 +00:00
Tim Heap
f4968de0f9 Allow overriding attributes in {% image %} tag 
The `alt` attribute that was automatically generated as part of the
`{% image %}` tag could not be overridden. If template authors passed
their own `alt="..."` attribute in, two would be printed out instead
of the default one being overridden.

The relevant code has been refactored to build a dict of attributes,
allowing the default set to be overridden, and then printing them using
`flatatt`.

Fixes #1933
 2015-11-24 11:38:10 +00:00
Rich Brennan
010838b53e Add Orderable to list of imported wagtailcore models 2015-11-24 10:36:02 +00:00
Rich Brennan
fab4e2224f Move content_panels inside BookPage definition. 2015-11-24 10:36:02 +00:00
Karl Hobley
059fc15b9d Added note about Elasticsearch 2.x 2015-11-20 12:50:31 +00:00
Rich Brennan
2ad3985d67 Move content_panels inside BlogPage definition. 2015-11-19 17:16:02 +00:00
Matt Westcott
c73a3caa31 Use rendition.alt in {% image img as rendition %} example. 
This restores the documentation to the pre-#1517 state, and is evidently more natural to write since the original documentation did so by mistake :-)
 2015-11-19 15:29:40 +00:00
Alex Gleason
6a0b576376 Updated reasoning for Page suffix, fixes #1927 
Fixed typo
 2015-11-16 20:06:36 +00:00
Matt Westcott
f668922893 Add a can_choose_root flag to PageChooserBlock 2015-11-02 15:12:42 +00:00
Matt Westcott
2eb4b4c2c1 Release notes for #1810, #1835, #1812 2015-10-20 11:16:09 +01:00
Karl Hobley
26889ba128 Merge pull request #1812 from gasman/feature/block-template-context 
Allow block subclasses to pass extra context variables to templates
 2015-10-19 09:29:59 +01:00
Matt Westcott
c1edbe6a98 Merge branch 'docs-self-var' of https://github.com/kaedroho/wagtail into kaedroho-docs-self-var 2015-10-14 14:52:00 +01:00
Matt Westcott
c2a183f19f Documentation tweaks as per https://github.com/torchbox/wagtail/pull/1815#commitcomment-13736415 https://github.com/torchbox/wagtail/pull/1815#commitcomment-13736421 2015-10-13 15:17:47 +01:00
Karl Hobley
b278a0c0f8 Docs for custom ordering 2015-10-13 10:06:58 +01:00
Karl Hobley
6eae465e64 Renamed "self" template variable to "page" in docs 2015-10-13 09:52:16 +01:00
Matt Westcott
06e721bc74 document the 'operator' kwarg on QuerySet.search 2015-10-12 22:04:29 +01:00
Matt Westcott
46845112e2 Allow block subclasses to pass extra context variables to templates 
Block now defines a get_context method, which subclasses can override
in the same way as we can for pages.
 2015-10-12 13:25:56 +01:00
Karl Hobley
4dbf166e06 Merged duplicate documentation 2015-10-12 12:20:45 +01:00
Karl Hobley
83f8332288 Added docs for search operators 2015-10-12 12:15:57 +01:00
Karl Hobley
fb09d89ec6 Search docs improvements 2015-10-12 12:15:33 +01:00
Matt Westcott
94d0d7bda2 Release / upgrade consideration note for #1478 2015-10-07 20:02:25 +01:00
Matt Westcott
94b5975afa Document the new image/document queryset search method 2015-10-07 20:02:19 +01:00
Karl Hobley
4dc09dfb22 Merge pull request #1755 from takeflight/feature/jinja2-template-functions 
Add rudimentary Jinja2 template tag support
 2015-10-06 22:00:47 +01:00
Matt Westcott
3cbee6c66c fix typo I introduced while removing typos 2015-10-05 21:12:21 +01:00
Matt Westcott
7d67e4b448 Minor copyediting on the Pages docs 2015-10-05 21:07:09 +01:00
Karl Hobley
be0a2ccd1c Tweaks to template rendering docs 2015-10-05 21:07:09 +01:00
Karl Hobley
f72e84f199 Added a couple of missing links 2015-10-05 21:07:09 +01:00
Karl Hobley
c18c67ba3b Working with pages docs 2015-10-05 21:07:09 +01:00
Karl Hobley
2e65c08210 Docs for inline models 2015-10-05 21:07:09 +01:00
Karl Hobley
ee7718ccdb Various tweaks 2015-10-05 21:07:09 +01:00
Karl Hobley
249a411b09 Template rendering docs 2015-10-05 21:07:09 +01:00