From eacebbf26b93a2d4604d58cbdfe389605139dd11 Mon Sep 17 00:00:00 2001 From: Stefan Seifert Date: Fri, 23 Aug 2024 10:37:03 +0200 Subject: [PATCH] update documentation reflecting that remote assets are no longer enabled by default --- changes.xml | 13 +++++++------ src/site/markdown/dynamic-media-openapi.md | 14 ++++++++++++-- 2 files changed, 19 insertions(+), 8 deletions(-) diff --git a/changes.xml b/changes.xml index 5c9418a0..708e611b 100644 --- a/changes.xml +++ b/changes.xml @@ -23,16 +23,17 @@ xsi:schemaLocation="http://maven.apache.org/changes/1.0.0 http://maven.apache.org/plugins/maven-changes-plugin/xsd/changes-1.0.0.xsd"> - - + + Dynamic Media with OpenAPI: Use static cropping (center cropping) if named smart cropping based on Image Profile define in AEM is not available. - + Dynamic Media with OpenAPI: Provide max. width/height in UriTemplate if source image dimension is available in metadata. - - Dynamic Media with OpenAPI: Do not enable support for remote assets by default. Since general availability the related configuration services not longer protected by a feature flag, so the feature has to be enabled explicitly via OSGi configuration. - + + Breaking change: You can enable support for remote assets by setting "Remote Assets" to true in the "wcm.io Media Handler Dynamic Media with OpenAPI Support" OSGi configuration. + ]]> Eliminate dependency to Commons Lang 2. diff --git a/src/site/markdown/dynamic-media-openapi.md b/src/site/markdown/dynamic-media-openapi.md index f8d77625..89dac29e 100644 --- a/src/site/markdown/dynamic-media-openapi.md +++ b/src/site/markdown/dynamic-media-openapi.md @@ -82,9 +82,19 @@ public class MediaHandlerConfigImpl extends MediaHandlerConfig { } ``` -With this configuration, remote assets should work out-of-the-box, if a remote asset repository is configured for the AEMaaCS instance. +By default, support for local and remote assets is disabled, because it depends on separate licensing for an AEMaaCS environment. For using remove assets, additional configuration (environment variables) are required to configure the remote repository, see AEM documentation. -The "wcm.io Dynamic Media with OpenAPI Support" OSGi configuration allows to reconfigure the actual URLs used for the [Assets Delivery API (DM API)][aem-dm-api]. Usually you can stick with the default values which reflect the latest version of the DM API. Remote assets are supported by default, but can be disabled via this configuration. Local assets are disabled by support, but can be enabled via this configuration. In this case, you also have to configure a repository ID for building the rendition URLs pointing to the AEMaaCS instance. Example: +The "wcm.io Dynamic Media with OpenAPI Support" OSGi configuration allows to enable the support. Additionally it is possible and to reconfigure the actual URLs used for the [Assets Delivery API (DM API)][aem-dm-api]. Usually you can stick with the default values which reflect the latest version of the DM API. + +To enable support for remote Assets configure: + +```json +{ + "enabledRemoteAssets": true +} +``` + +If you want to enable support for local assets you also have to configure a repository ID for building the rendition URLs pointing to the AEMaaCS instance. Example: ```json {