From d5262f9904e9071a67609d9b27d91a2c636fb98a Mon Sep 17 00:00:00 2001 From: Vidar Langseid Date: Thu, 14 Nov 2019 12:57:39 +0100 Subject: [PATCH 1/9] Added info on how to migrate custom tags from ezpublish --- .../migrating_from_ez_publish_platform.md | 27 +++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/docs/migrating/migrating_from_ez_publish_platform.md b/docs/migrating/migrating_from_ez_publish_platform.md index 84f67f128e..1b5ead04af 100644 --- a/docs/migrating/migrating_from_ez_publish_platform.md +++ b/docs/migrating/migrating_from_ez_publish_platform.md @@ -362,6 +362,33 @@ When you are ready to migrate your eZ Publish XmlText content to the eZ Platform `php -d memory_limit=1536M bin/console ezxmltext:convert-to-richtext --export-dir=ezxmltext-export --export-dir-filter=notice,warning,error --concurrency 4 -v` +**Custom tags** + +eZ Platform now supports custom tags, (including inline custom tags), and limited use of custom tag attributes. +After migration to richtext, you'll need to adapt your custom tag config for eZ Platform and rewrite the custom tags in twig + +See [eZ Platform custom tag documentation](https://doc.ezplatform.com/en/latest/guide/extending/extending_online_editor/#custom-tags) for more info. +If you in legacy as configured custom attributes in OE using [ezoe_attributes.ini](https://github.com/ezsystems/ezpublish-legacy/blob/master/extension/ezoe/settings/ezoe_attributes.ini#L33-L48), please note that not all types are supported. +Below is a table of what is currently supported, and their corresponding name in eZ Platform. + +| [XmlText](https://github.com/ezsystems/ezpublish-legacy/blob/2019.03/extension/ezoe/settings/ezoe_attributes.ini#L33-L48) | [RichText](https://github.com/ezsystems/ezplatform-richtext/blob/master/src/bundle/DependencyInjection/Configuration.php#L17) | Note | +| ------------- | ------------- | :-----: | +| `link` | `link` | Treated as a string, no special UI provided by eZ Platform editor | +| `number` | `number` | | +| `int` | `number` | | +| `checkbox` | `boolean` | | +| `select` | `choice` | | +| `text` | `string` | | +| `textarea` | Not supported | Use `string` as workaround | +| `email` | Not supported | Use `string` as workaround | +| `hidden` | Not supported | Use `string` as workaround | +| `color` | Not supported | Use `string` as workaround | +| `htmlsize` | Not supported | Use `string` as workaround | +| `csssize` | Not supported | Use `string` as workaround | +| `csssize4` | Not supported | Use `string` as workaround | +| `cssborder` | Not supported | Use `string` as workaround | + + ###### 3.2.2 Migrate Page field to Page (eZ Enterprise only) **If** you use Page field (ezflow) and an eZ Enterprise subscription, and are ready to migrate your eZ Publish Flow content to the eZ Enterprise Page format, you can use a script to migrate your old Page content to new Page, to start using a pure eZ Enterprise setup. See [Migrating legacy Page field (ezflow) to new Page (Enterprise)](#migrating-legacy-page-field-ezflow-to-new-page-enterprise) for more information. From 521928eee0b30dc29d2681e89fcd04bc69e1461f Mon Sep 17 00:00:00 2001 From: Vidar Langseid Date: Thu, 14 Nov 2019 13:46:44 +0100 Subject: [PATCH 2/9] Added anchor on custom link attribute(customtags) and linked to it from migration doc --- docs/guide/extending/extending_online_editor.md | 2 +- docs/migrating/migrating_from_ez_publish_platform.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/guide/extending/extending_online_editor.md b/docs/guide/extending/extending_online_editor.md index ce2c0e8ba1..f942c4838b 100644 --- a/docs/guide/extending/extending_online_editor.md +++ b/docs/guide/extending/extending_online_editor.md @@ -179,7 +179,7 @@ ezrichtext.custom_tags.ezfactbox.attributes.style.choices.light.label: Light sty ezrichtext.custom_tags.ezfactbox.attributes.style.choices.dark.label: Dark style ``` -**Example: Link tag** +[**Example: Link tag**](#example-link-tag) You can also configure a custom tag with a `link` attribute that offers a basic UI with text input. It is useful when migrating from eZ Publish to eZ Platform. diff --git a/docs/migrating/migrating_from_ez_publish_platform.md b/docs/migrating/migrating_from_ez_publish_platform.md index 1b5ead04af..e671220179 100644 --- a/docs/migrating/migrating_from_ez_publish_platform.md +++ b/docs/migrating/migrating_from_ez_publish_platform.md @@ -373,7 +373,7 @@ Below is a table of what is currently supported, and their corresponding name in | [XmlText](https://github.com/ezsystems/ezpublish-legacy/blob/2019.03/extension/ezoe/settings/ezoe_attributes.ini#L33-L48) | [RichText](https://github.com/ezsystems/ezplatform-richtext/blob/master/src/bundle/DependencyInjection/Configuration.php#L17) | Note | | ------------- | ------------- | :-----: | -| `link` | `link` | Treated as a string, no special UI provided by eZ Platform editor | +| `link` | [`link`](../guide/extending/extending_online_editor#example-link-tag) | Treated as a string, no special UI provided by eZ Platform editor | | `number` | `number` | | | `int` | `number` | | | `checkbox` | `boolean` | | From c453d7379e2a83ed092228a16809f55f1dd12f1c Mon Sep 17 00:00:00 2001 From: Vidar Langseid Date: Thu, 14 Nov 2019 16:11:46 +0100 Subject: [PATCH 3/9] fixup! Added info on how to migrate custom tags from ezpublish --- docs/migrating/migrating_from_ez_publish_platform.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/migrating/migrating_from_ez_publish_platform.md b/docs/migrating/migrating_from_ez_publish_platform.md index e671220179..5fa269d127 100644 --- a/docs/migrating/migrating_from_ez_publish_platform.md +++ b/docs/migrating/migrating_from_ez_publish_platform.md @@ -365,9 +365,9 @@ When you are ready to migrate your eZ Publish XmlText content to the eZ Platform **Custom tags** eZ Platform now supports custom tags, (including inline custom tags), and limited use of custom tag attributes. -After migration to richtext, you'll need to adapt your custom tag config for eZ Platform and rewrite the custom tags in twig +After migration to RichText, you'll need to adapt your custom tag config for eZ Platform and rewrite the custom tags in Twig -See [eZ Platform custom tag documentation](https://doc.ezplatform.com/en/latest/guide/extending/extending_online_editor/#custom-tags) for more info. +See [eZ Platform custom tag documentation](../guide/extending/extending_online_editor.md#custom-tags) for more info. If you in legacy as configured custom attributes in OE using [ezoe_attributes.ini](https://github.com/ezsystems/ezpublish-legacy/blob/master/extension/ezoe/settings/ezoe_attributes.ini#L33-L48), please note that not all types are supported. Below is a table of what is currently supported, and their corresponding name in eZ Platform. From 5f46281b62033b47509e23baa747a1b980a067fc Mon Sep 17 00:00:00 2001 From: Vidar Langseid Date: Thu, 14 Nov 2019 16:12:10 +0100 Subject: [PATCH 4/9] fixup! Added anchor on custom link attribute(customtags) and linked to it from migration doc --- docs/migrating/migrating_from_ez_publish_platform.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/migrating/migrating_from_ez_publish_platform.md b/docs/migrating/migrating_from_ez_publish_platform.md index 5fa269d127..8ac7ee8bfb 100644 --- a/docs/migrating/migrating_from_ez_publish_platform.md +++ b/docs/migrating/migrating_from_ez_publish_platform.md @@ -373,7 +373,7 @@ Below is a table of what is currently supported, and their corresponding name in | [XmlText](https://github.com/ezsystems/ezpublish-legacy/blob/2019.03/extension/ezoe/settings/ezoe_attributes.ini#L33-L48) | [RichText](https://github.com/ezsystems/ezplatform-richtext/blob/master/src/bundle/DependencyInjection/Configuration.php#L17) | Note | | ------------- | ------------- | :-----: | -| `link` | [`link`](../guide/extending/extending_online_editor#example-link-tag) | Treated as a string, no special UI provided by eZ Platform editor | +| `link` | [`link`](../guide/extending/extending_online_editor.md#example-link-tag) | Treated as a string, no special UI provided by eZ Platform editor | | `number` | `number` | | | `int` | `number` | | | `checkbox` | `boolean` | | From 29346e80165c0c3dc913033ab439acd487c508cb Mon Sep 17 00:00:00 2001 From: DominikaK Date: Fri, 15 Nov 2019 08:45:32 +0100 Subject: [PATCH 5/9] Proofing --- docs/guide/extending/extending_online_editor.md | 6 +++--- .../migrating_from_ez_publish_platform.md | 17 +++++++++-------- 2 files changed, 12 insertions(+), 11 deletions(-) diff --git a/docs/guide/extending/extending_online_editor.md b/docs/guide/extending/extending_online_editor.md index f942c4838b..8703571f37 100644 --- a/docs/guide/extending/extending_online_editor.md +++ b/docs/guide/extending/extending_online_editor.md @@ -17,7 +17,7 @@ They are configured under the `ezrichtext` key. If you want to learn how to apply them to your installation follow [Creating a custom tag tutorial](../../tutorials/extending_admin_ui/6_adding_a_custom_tag). -**Example: YouTube tag** +#### Example: YouTube tag Preparation of the tag always starts with the configuration file that should be added to `app/Resources/config`. This is sample configuration for the YouTube tag, `custom_tags.yml`: @@ -108,7 +108,7 @@ ezrichtext.custom_tags.ezyoutube.attributes.width.label: Width ezrichtext.custom_tags.ezyoutube.attributes.align.label: Align ``` -**Example: FactBox tag** +#### Example: FactBox tag FactBox tag is a good example for showcasing possibilities of `ezcontent` property. Each custom tag has an `ezcontent` property that contains the tag's main content. @@ -179,7 +179,7 @@ ezrichtext.custom_tags.ezfactbox.attributes.style.choices.light.label: Light sty ezrichtext.custom_tags.ezfactbox.attributes.style.choices.dark.label: Dark style ``` -[**Example: Link tag**](#example-link-tag) +#### Example: Link tag You can also configure a custom tag with a `link` attribute that offers a basic UI with text input. It is useful when migrating from eZ Publish to eZ Platform. diff --git a/docs/migrating/migrating_from_ez_publish_platform.md b/docs/migrating/migrating_from_ez_publish_platform.md index 8ac7ee8bfb..6368277b57 100644 --- a/docs/migrating/migrating_from_ez_publish_platform.md +++ b/docs/migrating/migrating_from_ez_publish_platform.md @@ -364,16 +364,17 @@ When you are ready to migrate your eZ Publish XmlText content to the eZ Platform **Custom tags** -eZ Platform now supports custom tags, (including inline custom tags), and limited use of custom tag attributes. -After migration to RichText, you'll need to adapt your custom tag config for eZ Platform and rewrite the custom tags in Twig +eZ Platform now supports custom tags, including inline custom tags, and limited use of custom tag attributes. +After migrating to RichText, you need to adapt your custom tag config for eZ Platform and rewrite the custom tags in Twig. +See [Custom tag documentation](../guide/extending/extending_online_editor.md#custom-tags) for more info. -See [eZ Platform custom tag documentation](../guide/extending/extending_online_editor.md#custom-tags) for more info. -If you in legacy as configured custom attributes in OE using [ezoe_attributes.ini](https://github.com/ezsystems/ezpublish-legacy/blob/master/extension/ezoe/settings/ezoe_attributes.ini#L33-L48), please note that not all types are supported. -Below is a table of what is currently supported, and their corresponding name in eZ Platform. +If you configured custom attributes in legacy in OE using [ezoe_attributes.ini](https://github.com/ezsystems/ezpublish-legacy/blob/master/extension/ezoe/settings/ezoe_attributes.ini#L33-L48), note that not all types are supported. -| [XmlText](https://github.com/ezsystems/ezpublish-legacy/blob/2019.03/extension/ezoe/settings/ezoe_attributes.ini#L33-L48) | [RichText](https://github.com/ezsystems/ezplatform-richtext/blob/master/src/bundle/DependencyInjection/Configuration.php#L17) | Note | -| ------------- | ------------- | :-----: | -| `link` | [`link`](../guide/extending/extending_online_editor.md#example-link-tag) | Treated as a string, no special UI provided by eZ Platform editor | +Below is a table of the tags that are currently supported, and their corresponding names in eZ Platform. + +| [XmlText](https://github.com/ezsystems/ezpublish-legacy/blob/2019.03/extension/ezoe/settings/ezoe_attributes.ini#L33-L48) | [RichText](https://github.com/ezsystems/ezplatform-richtext/blob/2.5/src/bundle/DependencyInjection/Configuration.php#L17) | Note | +| ------------- | ------------- | ----- | +| `link` | [`link`](../guide/extending/extending_online_editor.md#example-link-tag) | Treated as a string, no special UI provided by the eZ Platform editor | | `number` | `number` | | | `int` | `number` | | | `checkbox` | `boolean` | | From 211dccbcebb467a71d7f802f806c6a0008ccf5ef Mon Sep 17 00:00:00 2001 From: DominikaK Date: Mon, 24 Feb 2020 13:17:41 +0100 Subject: [PATCH 6/9] Fix heading --- docs/migrating/migrating_from_ez_publish_platform.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/migrating/migrating_from_ez_publish_platform.md b/docs/migrating/migrating_from_ez_publish_platform.md index 619fdaa5ed..f5224349de 100644 --- a/docs/migrating/migrating_from_ez_publish_platform.md +++ b/docs/migrating/migrating_from_ez_publish_platform.md @@ -405,7 +405,7 @@ When you are ready to migrate your eZ Publish XmlText content to the eZ Platform `php -d memory_limit=1536M bin/console ezxmltext:convert-to-richtext --export-dir=ezxmltext-export --export-dir-filter=notice,warning,error --concurrency 4 -v` -**Custom tags** +**Custom tags and attributes** eZ Platform now supports custom tags, including inline custom tags, and limited use of custom tag attributes. After migrating to RichText, you need to adapt your custom tag config for eZ Platform and rewrite the custom tags in Twig. From 13ff970c4a5c04df405889c3f09d240a425e262d Mon Sep 17 00:00:00 2001 From: DominikaK Date: Mon, 24 Feb 2020 14:23:03 +0100 Subject: [PATCH 7/9] Fix link --- docs/migrating/migrating_from_ez_publish_platform.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/migrating/migrating_from_ez_publish_platform.md b/docs/migrating/migrating_from_ez_publish_platform.md index f5224349de..579425770f 100644 --- a/docs/migrating/migrating_from_ez_publish_platform.md +++ b/docs/migrating/migrating_from_ez_publish_platform.md @@ -415,7 +415,7 @@ If you configured custom attributes in legacy in OE using [ezoe_attributes.ini]( Below is a table of the tags that are currently supported, and their corresponding names in eZ Platform. -| [XmlText](https://github.com/ezsystems/ezpublish-legacy/blob/2019.03/extension/ezoe/settings/ezoe_attributes.ini#L33-L48) | [RichText](https://github.com/ezsystems/ezplatform-richtext/blob/2.5/src/bundle/DependencyInjection/Configuration.php#L17) | Note | +| [XmlText](https://github.com/ezsystems/ezpublish-legacy/blob/2019.03/extension/ezoe/settings/ezoe_attributes.ini#L33-L48) | [RichText](https://github.com/ezsystems/ezplatform-richtext/blob/v1.1.3/src/bundle/DependencyInjection/Configuration.php#L17) | Note | | ------------- | ------------- | ----- | | `link` | [`link`](../guide/extending/extending_online_editor.md#example-link-tag) | Treated as a string, no special UI provided by the eZ Platform editor | | `number` | `number` | | From c47848d5098f3ba69403912b59cc850b94252973 Mon Sep 17 00:00:00 2001 From: DominikaK Date: Tue, 25 Feb 2020 08:48:06 +0100 Subject: [PATCH 8/9] Apply suggestions from code review MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: André R. <289757+andrerom@users.noreply.github.com> --- docs/migrating/migrating_from_ez_publish_platform.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/migrating/migrating_from_ez_publish_platform.md b/docs/migrating/migrating_from_ez_publish_platform.md index 579425770f..5ddefa60d1 100644 --- a/docs/migrating/migrating_from_ez_publish_platform.md +++ b/docs/migrating/migrating_from_ez_publish_platform.md @@ -415,7 +415,7 @@ If you configured custom attributes in legacy in OE using [ezoe_attributes.ini]( Below is a table of the tags that are currently supported, and their corresponding names in eZ Platform. -| [XmlText](https://github.com/ezsystems/ezpublish-legacy/blob/2019.03/extension/ezoe/settings/ezoe_attributes.ini#L33-L48) | [RichText](https://github.com/ezsystems/ezplatform-richtext/blob/v1.1.3/src/bundle/DependencyInjection/Configuration.php#L17) | Note | +| [XmlText](https://github.com/ezsystems/ezpublish-legacy/blob/2019.03/extension/ezoe/settings/ezoe_attributes.ini#L33-L48) | [RichText](https://github.com/ezsystems/ezplatform-richtext/blob/v1.1.5/src/bundle/DependencyInjection/Configuration.php#L17) | Note | | ------------- | ------------- | ----- | | `link` | [`link`](../guide/extending/extending_online_editor.md#example-link-tag) | Treated as a string, no special UI provided by the eZ Platform editor | | `number` | `number` | | From b3e695f52c0924dd1cd2032cc464c10baed51b81 Mon Sep 17 00:00:00 2001 From: DominikaK Date: Thu, 27 Feb 2020 14:56:46 +0100 Subject: [PATCH 9/9] Fixes after review --- docs/migrating/migrating_from_ez_publish_platform.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/migrating/migrating_from_ez_publish_platform.md b/docs/migrating/migrating_from_ez_publish_platform.md index 5ddefa60d1..a8aa3d3ae0 100644 --- a/docs/migrating/migrating_from_ez_publish_platform.md +++ b/docs/migrating/migrating_from_ez_publish_platform.md @@ -417,7 +417,7 @@ Below is a table of the tags that are currently supported, and their correspondi | [XmlText](https://github.com/ezsystems/ezpublish-legacy/blob/2019.03/extension/ezoe/settings/ezoe_attributes.ini#L33-L48) | [RichText](https://github.com/ezsystems/ezplatform-richtext/blob/v1.1.5/src/bundle/DependencyInjection/Configuration.php#L17) | Note | | ------------- | ------------- | ----- | -| `link` | [`link`](../guide/extending/extending_online_editor.md#example-link-tag) | Treated as a string, no special UI provided by the eZ Platform editor | +| `link` | [`link`](../guide/extending/extending_online_editor.md#example-link-tag) | | | `number` | `number` | | | `int` | `number` | | | `checkbox` | `boolean` | |