cms_delete_content: readme fragment + towncrier changelog

Author: simahawk

cms_delete_content/readme/CONTRIBUTORS.rst

@@ -0,0 +1 @@
+* Simone Orsi <simone.orsi@camptocamp.com>

cms_delete_content/readme/DESCRIPTION.rst

@@ -0,0 +1,10 @@
+Basic features for deleting content via frontend.
+
+Features
+--------
+
+-  register your own custom delete confirmation view per-model
+-  use ``cms_status_message`` to show confirmation message for deletion
+-  generic template for asking delete confirmation
+-  new fields and parameters on ``website.published.mixin`` to handle
+   delete links and redirects

cms_delete_content/CHANGES.rst renamed to cms_delete_content/readme/HISTORY.rst

@@ -1,9 +1,5 @@
-=========
-CHANGELOG
-=========
-
 11.0.1.0.2 (2018-04-27)
-=======================
+~~~~~~~~~~~~~~~~~~~~~~~
 
 **Fixes**
 
@@ -16,14 +12,14 @@ CHANGELOG
 
 
 11.0.1.0.1 (2018-04-24)
-=======================
+~~~~~~~~~~~~~~~~~~~~~~~
 
 **Fixes**
 
 * Update JS according to `cms_status_message` updates
 
 
 11.0.1.0.0 (2018-01-18)
-=======================
+~~~~~~~~~~~~~~~~~~~~~~~
 
 * Initial release

cms_delete_content/readme/ROADMAP.rst

@@ -0,0 +1,2 @@
+
+Get rid of `website` dependency to be able to use it w/ `portal` module only.

cms_delete_content/readme/USAGE.rst

@@ -0,0 +1,69 @@
+Delete button and behavior
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+To add a delete button:
+
+.. code:: html
+
+    <a class="btn btn-danger cms_delete_confirm" t-att-href="object.cms_delete_confirm_url">Delete</a>
+
+When you click on a confirmation dialog pops up.
+
+If you hit ``cancel`` the popup is closed. If you hit submit the item is
+deleted and you get redirected to your model's ``cms_after_delete_url``.
+By default is ``/``.
+
+Customization
+-------------
+
+Custom per-model delete messge
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. code:: python
+
+    class MyModel(models.Model):
+        _inherit = "my.model"
+
+        @api.multi
+        def msg_content_delete_confirm(self):
+            self.ensure_one()
+            return _('Are you sure you want to delete "%s"?.') % self.name
+
+Custom "after delete URL"
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+When you are viewing a content and you delete it you want to be
+redirected to some other place.
+
+By default you get redirected to the root of the website.
+
+To change this behavior just override the attribute in your model
+declaration:
+
+.. code:: python
+
+    class MyModel(models.Model):
+        _inherit = "my.model"
+
+        cms_after_delete_url = '/foo'
+
+Note: if you want to customize it on demand for particular pages, or you
+are deleting an item from another page (like a management page) you can
+pass ``?redirect=`` in the url, like:
+
+.. code:: html
+
+    <a class="btn btn-danger cms_delete_confirm" t-attf-href="#{object.cms_delete_confirm_url}?redirect=">Delete</a>
+
+Custom global delete confirm message appeareance
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. code:: xml
+
+    <template id="delete_confirm" inherit_id="cms_delete_content.delete_confirm">
+
+        <xpath expr="//h4[@id='delete_confirm']" position="replace">
+            <h1 t-esc="main_object.msg_content_delete_confirm()">I want it bigger!</h1>
+        </xpath>
+
+    </template>

cms_delete_content/readme/newsfragments/111.feature

@@ -0,0 +1 @@
+Migration to v13