From 870a9a59efefb7ce6ff2f9dc2b952416247a9953 Mon Sep 17 00:00:00 2001
From: Rafi Zadanly <zadanlyr@gmail.com>
Date: Wed, 8 Mar 2023 11:04:08 +0700
Subject: add widget ckeditor

---
 web_widget_ckeditor/readme/CONFIGURE.rst    | 32 +++++++++++++++++++++++++++++
 web_widget_ckeditor/readme/CONTRIBUTORS.rst |  9 ++++++++
 web_widget_ckeditor/readme/DESCRIPTION.rst  |  1 +
 web_widget_ckeditor/readme/ROADMAP.rst      | 13 ++++++++++++
 4 files changed, 55 insertions(+)
 create mode 100644 web_widget_ckeditor/readme/CONFIGURE.rst
 create mode 100644 web_widget_ckeditor/readme/CONTRIBUTORS.rst
 create mode 100644 web_widget_ckeditor/readme/DESCRIPTION.rst
 create mode 100644 web_widget_ckeditor/readme/ROADMAP.rst

(limited to 'web_widget_ckeditor/readme')

diff --git a/web_widget_ckeditor/readme/CONFIGURE.rst b/web_widget_ckeditor/readme/CONFIGURE.rst
new file mode 100644
index 00000000..50409ef8
--- /dev/null
+++ b/web_widget_ckeditor/readme/CONFIGURE.rst
@@ -0,0 +1,32 @@
+By default, this module will replace the original `html` wysiwyg field with CKEditor.
+The original `html` widget will be renamed as `html_odoo`.
+
+If you only want to use `ckeditor` on specific views, you can disable the `html` widget
+override by archiving the `web_widget_ckeditor.assets_backend_field_html_override` view.
+
+When the global `html` widget replacement is disabled, `ckeditor` has to be explicitly
+set on the desired `ir.ui.view`:
+
+.. code-block:: xml
+
+    <field name="description_html" widget="ckeditor" />
+
+
+The CKEditor toolbar can be customized with an `ir.config_parameter`. To do so,
+please create a parameter named `web_widget_ckeditor.toolbar`, and set the desired
+toolbar items using either `,`, `space` or `newline` as separators.
+
+.. code-block::
+
+    heading
+    | bold italic underline removeFormat
+    | fontSize fontColor fontBackgroundColor
+    | bulletedList numberedList alignment
+    | outdent indent pagebreak
+    | link imageUpload blockQuote insertTable
+    | undo redo
+
+
+There's more information about available toolbar items in the
+`official CKEditor documentation page
+<https://ckeditor.com/docs/ckeditor5/latest/features/toolbar/toolbar.html>`_
diff --git a/web_widget_ckeditor/readme/CONTRIBUTORS.rst b/web_widget_ckeditor/readme/CONTRIBUTORS.rst
new file mode 100644
index 00000000..f635d841
--- /dev/null
+++ b/web_widget_ckeditor/readme/CONTRIBUTORS.rst
@@ -0,0 +1,9 @@
+* `Therp <https://www.therp.nl>`_
+
+    * Holger Brunn <hbrunn@therp.nl>
+    * Stefan Rijnhart <stefan@therp.nl>
+    * George Daramouskas <gdaramouskas@therp.nl>
+
+* `Camptocamp <https://www.camptocamp.com>`_
+
+    * Iván Todorovich <ivan.todorovich@camptocamp.com>
diff --git a/web_widget_ckeditor/readme/DESCRIPTION.rst b/web_widget_ckeditor/readme/DESCRIPTION.rst
new file mode 100644
index 00000000..e3a8eb0b
--- /dev/null
+++ b/web_widget_ckeditor/readme/DESCRIPTION.rst
@@ -0,0 +1 @@
+This module adds a new widget `ckeditor` to edit HTML fields using CKEditor.
diff --git a/web_widget_ckeditor/readme/ROADMAP.rst b/web_widget_ckeditor/readme/ROADMAP.rst
new file mode 100644
index 00000000..b0a33d4f
--- /dev/null
+++ b/web_widget_ckeditor/readme/ROADMAP.rst
@@ -0,0 +1,13 @@
+* Allow to configure toolbar using widget's options.
+
+.. code-block:: xml
+
+    <field
+        name="description_html"
+        widget="ckeditor"
+        options="{'bulletedList': false, 'pageBreak': true}"
+    />
+
+
+* There seems to be a small incompatibility issue with `web_drop_target`.
+  `More information here <https://github.com/OCA/web/pull/2083#issuecomment-970719103>`_
-- 
cgit v1.2.3