From b251ceb732046f50f9c5c248b0d242ef762f92cc Mon Sep 17 00:00:00 2001 From: Diana <75819066+cloudjumpercat@users.noreply.github.com> Date: Thu, 18 Jun 2026 14:41:35 -0500 Subject: [PATCH 1/7] First draft Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com> --- app/_data/schemas/frontmatter/tags.json | 1 + app/_how-tos/dev-portal/equalweb.md | 70 ++++++++++++++++++ app/_indices/dev-portal.yaml | 5 ++ app/_landing_pages/dev-portal.yaml | 11 ++- app/assets/icons/third-party/equalweb.png | Bin 0 -> 3612 bytes app/assets/icons/third-party/equalwebicon.png | Bin 0 -> 15406 bytes 6 files changed, 86 insertions(+), 1 deletion(-) create mode 100644 app/_how-tos/dev-portal/equalweb.md create mode 100644 app/assets/icons/third-party/equalweb.png create mode 100644 app/assets/icons/third-party/equalwebicon.png diff --git a/app/_data/schemas/frontmatter/tags.json b/app/_data/schemas/frontmatter/tags.json index 571c3211d87..dbb90be8e62 100644 --- a/app/_data/schemas/frontmatter/tags.json +++ b/app/_data/schemas/frontmatter/tags.json @@ -4,6 +4,7 @@ "enum": [ "1password", "a2a", + "accessibility", "access-control", "account-management", "after-response-scripts", diff --git a/app/_how-tos/dev-portal/equalweb.md b/app/_how-tos/dev-portal/equalweb.md new file mode 100644 index 00000000000..a7731796208 --- /dev/null +++ b/app/_how-tos/dev-portal/equalweb.md @@ -0,0 +1,70 @@ +--- +title: "Add the EqualWeb accessibility widget to {{site.dev_portal}}" +permalink: /dev-portal/equalweb/ +description: "Learn how to add the EqualWeb accessibility widget to all pages of your {{site.konnect_short_name}} Dev Portal." +content_type: how_to +related_resources: + - text: About {{site.dev_portal}} + url: /dev-portal/ + - text: Add the Google Tag Manager script to {{site.dev_portal}} + url: /dev-portal/google-tag-manager/ + - text: Send {{site.dev_portal}} events data to Google Analytics + url: /dev-portal/google-analytics/ +automated_tests: false +products: + - dev-portal + - gateway +works_on: + - konnect + +tldr: + q: How do I add EqualWeb to my {{site.dev_portal}}? + a: | + In your {{site.dev_portal}} settings, click the **Integrations** tab and enable the EqualWeb integration. Add your EqualWeb site key and widget configuration. +tags: + - accessibility +prereqs: + skip_product: true + inline: + - title: "{{site.dev_portal}}" + include_content: prereqs/dev-portal-create-ui + icon_url: /assets/icons/dev-portal.svg + - title: EqualWeb + content: | + You need an active EqualWeb account. + icon_url: /assets/icons/third-party/equalwebicon.png +--- + +You can add the EqualWeb accessibility widget to your {{site.dev_portal}} to help meet your organization's accessibility requirements. +After it's configured, the EqualWeb widget script will be injected into every page of your {{site.dev_portal}}. + +## Get your EqualWeb site key + +Before you configure the integration in {{site.konnect_short_name}}, you need your {{site.dev_portal}} domain and your EqualWeb site key. + +1. In the {{site.konnect_short_name}} sidebar, expand **{{site.dev_portal}}**. +1. Click **Portals**. +1. Click your {{site.dev_portal}}. +1. Copy your {{site.dev_portal}} domain. This is the URL you'll register in EqualWeb. You can use either the default {{site.konnect_short_name}}-generated domain or your custom domain if you've configured one. +1. In your EqualWeb account, register your {{site.dev_portal}} domain and copy the site key from the widget installation code. + +## Configure the EqualWeb integration + +Configure the EqualWeb integration in your {{site.dev_portal}} settings. + +1. In the {{site.konnect_short_name}} sidebar, expand **Dev Portal**. +1. Click **Portals**. +1. Click your Dev Portal. +1. Click the **Settings** tab. +1. Click the **Integrations** tab. +1. Click **EqualWeb**. +1. Click the **Enabled** toggle. +? +1. Click **Save**. + +You can also do this in the {{site.konnect_short_name}} UI by navigating to your {{site.dev_portal}} and clicking the **Integrations** tab. + +## Validate + +You can verify that the integration is working as expected by navigating to your {{site.dev_portal}} URL. +The EqualWeb accessibility widget should display on the page. diff --git a/app/_indices/dev-portal.yaml b/app/_indices/dev-portal.yaml index e95a77cb0ac..c8eb701f891 100644 --- a/app/_indices/dev-portal.yaml +++ b/app/_indices/dev-portal.yaml @@ -41,3 +41,8 @@ sections: - path: /dev-portal/sso/ - path: /dev-portal/security-settings/ - path: /dev-portal/self-service/ + - title: Integrations + items: + - path: /dev-portal/google-analytics/ + - path: /dev-portal/google-tag-manager/ + - path: /dev-portal/equalweb/ diff --git a/app/_landing_pages/dev-portal.yaml b/app/_landing_pages/dev-portal.yaml index 28bdda712c3..13e07db32de 100644 --- a/app/_landing_pages/dev-portal.yaml +++ b/app/_landing_pages/dev-portal.yaml @@ -252,7 +252,16 @@ rows: icon: /assets/icons/third-party/google-tag-manager.svg cta: url: "/dev-portal/google-tag-manager/" - + - blocks: + - type: card + config: + title: EqualWeb + description: | + Learn how to add the EqualWeb accessibility widget to your {{site.dev_portal}}. + icon: /assets/icons/third-party/equalwebicon.png + cta: + url: "/dev-portal/equalweb/" + - header: type: h2 text: "References" diff --git a/app/assets/icons/third-party/equalweb.png b/app/assets/icons/third-party/equalweb.png new file mode 100644 index 0000000000000000000000000000000000000000..87c7fc1d49ec15eaaf5e5cd607b933834b778937 GIT binary patch literal 3612 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 P|J!C8ds>n8&i(%cp>py= literal 0 HcmV?d00001 diff --git a/app/assets/icons/third-party/equalwebicon.png b/app/assets/icons/third-party/equalwebicon.png new file mode 100644 index 0000000000000000000000000000000000000000..4b320ca32b9739e640834104f13ca8247a71714d GIT binary patch literal 15406 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 literal 0 HcmV?d00001 From e5eebec3e9acdb0980e0e70928789868fad11923 Mon Sep 17 00:00:00 2001 From: Diana <75819066+cloudjumpercat@users.noreply.github.com> Date: Tue, 23 Jun 2026 09:57:09 -0500 Subject: [PATCH 2/7] Revise how to Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com> --- app/_how-tos/dev-portal/equalweb.md | 86 +++++++++++++++++++++++++++-- 1 file changed, 80 insertions(+), 6 deletions(-) diff --git a/app/_how-tos/dev-portal/equalweb.md b/app/_how-tos/dev-portal/equalweb.md index a7731796208..b4ea97fae80 100644 --- a/app/_how-tos/dev-portal/equalweb.md +++ b/app/_how-tos/dev-portal/equalweb.md @@ -20,7 +20,9 @@ works_on: tldr: q: How do I add EqualWeb to my {{site.dev_portal}}? a: | - In your {{site.dev_portal}} settings, click the **Integrations** tab and enable the EqualWeb integration. Add your EqualWeb site key and widget configuration. + Configure the EqualWeb widget with your {{site.dev_portal}} domain. + In your {{site.dev_portal}} settings, click the **Integrations** tab and enable the EqualWeb integration. + Add your EqualWeb site key and widget configuration. tags: - accessibility prereqs: @@ -31,11 +33,11 @@ prereqs: icon_url: /assets/icons/dev-portal.svg - title: EqualWeb content: | - You need an active EqualWeb account. + You need an [EqualWeb](https://www.equalweb.com/) account. icon_url: /assets/icons/third-party/equalwebicon.png --- -You can add the EqualWeb accessibility widget to your {{site.dev_portal}} to help meet your organization's accessibility requirements. +You can add the [EqualWeb](https://www.equalweb.com/) accessibility widget to your {{site.dev_portal}} to help meet your organization's accessibility requirements. After it's configured, the EqualWeb widget script will be injected into every page of your {{site.dev_portal}}. ## Get your EqualWeb site key @@ -46,7 +48,44 @@ Before you configure the integration in {{site.konnect_short_name}}, you need yo 1. Click **Portals**. 1. Click your {{site.dev_portal}}. 1. Copy your {{site.dev_portal}} domain. This is the URL you'll register in EqualWeb. You can use either the default {{site.konnect_short_name}}-generated domain or your custom domain if you've configured one. -1. In your EqualWeb account, register your {{site.dev_portal}} domain and copy the site key from the widget installation code. +1. In your EqualWeb account, click **Add new site**. +1. In the **Insert your domain** field, enter your {{site.dev_portal}} domain. +1. Click **Continue to customize design**. +1. Configure the widget design settings as needed. +1. Click **Continue to install widget**. +1. Click **Collapse** for your widget code. +1. Copy your site key from the `get sitekey (){ return "1234..."}` field. For example: `79ad2e1ec52e63565e254555077aaaec`. +1. (Optional) If you configured the widget design, copy the configuration. For example: + ```json + "Position": "left", + "Menulang": "EN", + "draggable": true, + "btnStyle": { + "vPosition": [ + "80%", + "80%" + ], + "margin": [ + "0", + "0" + ], + "scale": [ + "0.5", + "0.5" + ], + "color": { + "main": "#1c4bb6", + "second": "#ffffff" + }, + "icon": { + "outline": false, + "outlineColor": "#ffffff", + "type": 1 , + "shape": "circle" + } + } + ``` + {:.collapsible} ## Configure the EqualWeb integration @@ -59,12 +98,47 @@ Configure the EqualWeb integration in your {{site.dev_portal}} settings. 1. Click the **Integrations** tab. 1. Click **EqualWeb**. 1. Click the **Enabled** toggle. -? +1. In the **Site key**, enter the site key from the EqualWeb widget you configured in the previously. For example: `79ad2e1ec52e63565e254555077aaaec`. +1. (Optional) If you configured the widget design in EqualWeb, click **Advanced configurations** and enter the JSON configuration in the **** field with opening and closing brackets. For example: + ```json + { + "Position": "left", + "Menulang": "EN", + "draggable": true, + "btnStyle": { + "vPosition": [ + "80%", + "80%" + ], + "margin": [ + "0", + "0" + ], + "scale": [ + "0.5", + "0.5" + ], + "color": { + "main": "#1c4bb6", + "second": "#ffffff" + }, + "icon": { + "outline": false, + "outlineColor": "#ffffff", + "type": 1 , + "shape": "circle" + } + } + } + ``` + {:.collapsible} 1. Click **Save**. -You can also do this in the {{site.konnect_short_name}} UI by navigating to your {{site.dev_portal}} and clicking the **Integrations** tab. + +You can also configure the EqualWeb integration using the {{site.konnect_short_name}} API by sending a `PUT` request to the `/portals/{portalId}/integrations` endpoint. ## Validate You can verify that the integration is working as expected by navigating to your {{site.dev_portal}} URL. The EqualWeb accessibility widget should display on the page. +It can take several minutes to display the widget after you've enabled the integration. From e08f4563e6f568be1d898e72a3365d87071bb543 Mon Sep 17 00:00:00 2001 From: Diana <75819066+cloudjumpercat@users.noreply.github.com> Date: Tue, 23 Jun 2026 10:17:21 -0500 Subject: [PATCH 3/7] Apply suggestions from code review Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --- app/_how-tos/dev-portal/equalweb.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/app/_how-tos/dev-portal/equalweb.md b/app/_how-tos/dev-portal/equalweb.md index b4ea97fae80..f58f2b3819e 100644 --- a/app/_how-tos/dev-portal/equalweb.md +++ b/app/_how-tos/dev-portal/equalweb.md @@ -91,15 +91,15 @@ Before you configure the integration in {{site.konnect_short_name}}, you need yo Configure the EqualWeb integration in your {{site.dev_portal}} settings. -1. In the {{site.konnect_short_name}} sidebar, expand **Dev Portal**. +1. In the {{site.konnect_short_name}} sidebar, expand **{{site.dev_portal}}**. 1. Click **Portals**. -1. Click your Dev Portal. +1. Click your {{site.dev_portal}}. 1. Click the **Settings** tab. 1. Click the **Integrations** tab. 1. Click **EqualWeb**. 1. Click the **Enabled** toggle. -1. In the **Site key**, enter the site key from the EqualWeb widget you configured in the previously. For example: `79ad2e1ec52e63565e254555077aaaec`. -1. (Optional) If you configured the widget design in EqualWeb, click **Advanced configurations** and enter the JSON configuration in the **** field with opening and closing brackets. For example: +1. In the **Site key**, enter the site key from the EqualWeb widget you configured previously. For example: `79ad2e1ec52e63565e254555077aaaec`. +1. (Optional) If you configured the widget design in EqualWeb, click **Advanced configurations** and enter the JSON configuration in the configuration field with opening and closing brackets. For example: ```json { "Position": "left", From 7d50558683c1c71362e0129206eeb7d70a3a2075 Mon Sep 17 00:00:00 2001 From: Diana <75819066+cloudjumpercat@users.noreply.github.com> Date: Wed, 24 Jun 2026 09:58:47 -0500 Subject: [PATCH 4/7] apply PM/eng feedback Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com> --- app/_how-tos/dev-portal/equalweb.md | 61 +++++++++++++++-------------- 1 file changed, 31 insertions(+), 30 deletions(-) diff --git a/app/_how-tos/dev-portal/equalweb.md b/app/_how-tos/dev-portal/equalweb.md index f58f2b3819e..a9c2854788d 100644 --- a/app/_how-tos/dev-portal/equalweb.md +++ b/app/_how-tos/dev-portal/equalweb.md @@ -47,45 +47,46 @@ Before you configure the integration in {{site.konnect_short_name}}, you need yo 1. In the {{site.konnect_short_name}} sidebar, expand **{{site.dev_portal}}**. 1. Click **Portals**. 1. Click your {{site.dev_portal}}. -1. Copy your {{site.dev_portal}} domain. This is the URL you'll register in EqualWeb. You can use either the default {{site.konnect_short_name}}-generated domain or your custom domain if you've configured one. +1. Copy your {{site.dev_portal}} domain. This is the URL you'll register in EqualWeb. 1. In your EqualWeb account, click **Add new site**. 1. In the **Insert your domain** field, enter your {{site.dev_portal}} domain. 1. Click **Continue to customize design**. 1. Configure the widget design settings as needed. 1. Click **Continue to install widget**. -1. Click **Collapse** for your widget code. -1. Copy your site key from the `get sitekey (){ return "1234..."}` field. For example: `79ad2e1ec52e63565e254555077aaaec`. +1. Click **Collapse** for your widget code. This will expand the widget configuration. +1. Copy your site key from the `get sitekey (){ return "79ad2e1..."}` field. For example: `79ad2e1ec52e63565e254555077aaaec`. 1. (Optional) If you configured the widget design, copy the configuration. For example: ```json "Position": "left", - "Menulang": "EN", - "draggable": true, - "btnStyle": { - "vPosition": [ - "80%", - "80%" - ], - "margin": [ - "0", - "0" - ], - "scale": [ - "0.5", - "0.5" - ], - "color": { - "main": "#1c4bb6", - "second": "#ffffff" - }, - "icon": { - "outline": false, - "outlineColor": "#ffffff", - "type": 1 , - "shape": "circle" - } - } + "Menulang": "EN", + "draggable": true, + "btnStyle": { + "vPosition": [ + "80%", + "80%" + ], + "margin": [ + "0", + "0" + ], + "scale": [ + "0.5", + "0.5" + ], + "color": { + "main": "#1c4bb6", + "second": "#ffffff" + }, + "icon": { + "outline": false, + "outlineColor": "#ffffff", + "type": 1, + "shape": "circle" + } + } ``` {:.collapsible} + This won't be valid JSON, but when you add it to the {{site.dev_portal}} integration configuration, you'll add `{}` to make it valid. ## Configure the EqualWeb integration @@ -99,7 +100,7 @@ Configure the EqualWeb integration in your {{site.dev_portal}} settings. 1. Click **EqualWeb**. 1. Click the **Enabled** toggle. 1. In the **Site key**, enter the site key from the EqualWeb widget you configured previously. For example: `79ad2e1ec52e63565e254555077aaaec`. -1. (Optional) If you configured the widget design in EqualWeb, click **Advanced configurations** and enter the JSON configuration in the configuration field with opening and closing brackets. For example: +1. (Optional) If you configured the widget design in EqualWeb, click **Advanced configurations** and enter the JSON configuration in the configuration field with opening and closing brackets (`{}`). For example: ```json { "Position": "left", From cb5409d31b8365c23161212a34ca7795d40555f4 Mon Sep 17 00:00:00 2001 From: Diana <75819066+cloudjumpercat@users.noreply.github.com> Date: Tue, 30 Jun 2026 09:03:43 -0500 Subject: [PATCH 5/7] Apply suggestions from code review Co-authored-by: lena-larionova <54370747+lena-larionova@users.noreply.github.com> Co-authored-by: Diana <75819066+cloudjumpercat@users.noreply.github.com> --- app/_how-tos/dev-portal/equalweb.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/app/_how-tos/dev-portal/equalweb.md b/app/_how-tos/dev-portal/equalweb.md index a9c2854788d..b53a600b36a 100644 --- a/app/_how-tos/dev-portal/equalweb.md +++ b/app/_how-tos/dev-portal/equalweb.md @@ -85,8 +85,10 @@ Before you configure the integration in {{site.konnect_short_name}}, you need yo } } ``` - {:.collapsible} - This won't be valid JSON, but when you add it to the {{site.dev_portal}} integration configuration, you'll add `{}` to make it valid. + {:.collapsible .no-copy-code} + + {:.info} + > The configuration you copy won't be valid JSON. When you add it to the {{site.dev_portal}} integration configuration, you'll add `{}` to make it valid. ## Configure the EqualWeb integration @@ -132,11 +134,11 @@ Configure the EqualWeb integration in your {{site.dev_portal}} settings. } } ``` - {:.collapsible} + {:.collapsible .no-copy-code} 1. Click **Save**. -You can also configure the EqualWeb integration using the {{site.konnect_short_name}} API by sending a `PUT` request to the `/portals/{portalId}/integrations` endpoint. +You can also configure the EqualWeb integration using the {{site.konnect_short_name}} API by sending a `PUT` request to the [`/portals/{portalId}/integrations` endpoint](/api/konnect/portal-management/v3/#/operations/upsert-portal-integrations). ## Validate From a8d45fdd78889ed30ec4fce7f85628dc070c5409 Mon Sep 17 00:00:00 2001 From: Diana <75819066+cloudjumpercat@users.noreply.github.com> Date: Tue, 30 Jun 2026 09:31:48 -0500 Subject: [PATCH 6/7] shorten the one file Co-authored-by: Diana <75819066+cloudjumpercat@users.noreply.github.com> --- app/_how-tos/dev-portal/equalweb.md | 27 ++------------------------- 1 file changed, 2 insertions(+), 25 deletions(-) diff --git a/app/_how-tos/dev-portal/equalweb.md b/app/_how-tos/dev-portal/equalweb.md index b53a600b36a..59f827e9edc 100644 --- a/app/_how-tos/dev-portal/equalweb.md +++ b/app/_how-tos/dev-portal/equalweb.md @@ -108,31 +108,8 @@ Configure the EqualWeb integration in your {{site.dev_portal}} settings. "Position": "left", "Menulang": "EN", "draggable": true, - "btnStyle": { - "vPosition": [ - "80%", - "80%" - ], - "margin": [ - "0", - "0" - ], - "scale": [ - "0.5", - "0.5" - ], - "color": { - "main": "#1c4bb6", - "second": "#ffffff" - }, - "icon": { - "outline": false, - "outlineColor": "#ffffff", - "type": 1 , - "shape": "circle" - } - } - } + ... + } ``` {:.collapsible .no-copy-code} 1. Click **Save**. From 92b0b5dba134dc92ef47c6e933bd16cfdaee07f8 Mon Sep 17 00:00:00 2001 From: Diana <75819066+cloudjumpercat@users.noreply.github.com> Date: Tue, 30 Jun 2026 09:59:02 -0500 Subject: [PATCH 7/7] Apply suggestions from code review Co-authored-by: lena-larionova <54370747+lena-larionova@users.noreply.github.com> --- app/_how-tos/dev-portal/equalweb.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/app/_how-tos/dev-portal/equalweb.md b/app/_how-tos/dev-portal/equalweb.md index 59f827e9edc..bc4788fb05d 100644 --- a/app/_how-tos/dev-portal/equalweb.md +++ b/app/_how-tos/dev-portal/equalweb.md @@ -56,6 +56,7 @@ Before you configure the integration in {{site.konnect_short_name}}, you need yo 1. Click **Collapse** for your widget code. This will expand the widget configuration. 1. Copy your site key from the `get sitekey (){ return "79ad2e1..."}` field. For example: `79ad2e1ec52e63565e254555077aaaec`. 1. (Optional) If you configured the widget design, copy the configuration. For example: + ```json "Position": "left", "Menulang": "EN", @@ -103,6 +104,7 @@ Configure the EqualWeb integration in your {{site.dev_portal}} settings. 1. Click the **Enabled** toggle. 1. In the **Site key**, enter the site key from the EqualWeb widget you configured previously. For example: `79ad2e1ec52e63565e254555077aaaec`. 1. (Optional) If you configured the widget design in EqualWeb, click **Advanced configurations** and enter the JSON configuration in the configuration field with opening and closing brackets (`{}`). For example: + ```json { "Position": "left", @@ -111,7 +113,7 @@ Configure the EqualWeb integration in your {{site.dev_portal}} settings. ... } ``` - {:.collapsible .no-copy-code} + {:.no-copy-code} 1. Click **Save**.