Skip to content

Commit

Permalink
Add docs for WAGTAILLOCALIZE_DISABLE_ON_DELETE
Browse files Browse the repository at this point in the history
  • Loading branch information
zerolab committed Oct 14, 2022
1 parent f68a111 commit f68ad59
Showing 1 changed file with 17 additions and 0 deletions.
17 changes: 17 additions & 0 deletions docs/how-to/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,24 @@ on your model. The default value is `synced`.
e.g.

```python
from wagtail.models import Page


class MyPage(Page):
localize_default_translation_mode = "simple"
# ...
```

## Control translation cleanup mode

<!-- prettier-ignore -->
!!! info "Changed in 1.3"
Prior to version 1.3, `Translation` objects were marked as disabled and all related data was kept. This led to
confusion and poor user experience. To restore the previous behaviour,
set `WAGTAILLOCALIZE_DISABLE_ON_DELETE = True` in your settings file.

Wagtail Localize will remove translation data when the translation source (e.g. original page)
or the translation destination (e.g. translated page) is deleted.

To disable the `Translation` object and keep the related data, such as translated strings or overrides,
set `WAGTAILLOCALIZE_DISABLE_ON_DELETE = True` in your settings file.

0 comments on commit f68ad59

Please sign in to comment.