diff --git a/repository/docs/identity-provider/authentication/README.md b/repository/docs/identity-provider/authentication/README.md
index 02f21977f2..36a14f38c8 100644
--- a/repository/docs/identity-provider/authentication/README.md
+++ b/repository/docs/identity-provider/authentication/README.md
@@ -27,7 +27,7 @@ to integrate with a number of external Authentication providers including
* https://github.com/Alfresco/alfresco-data-model/tree/master/src/main/java/org/alfresco/repo/security/authentication
* License: LGPL
* Issue Tracker Link: https://issues.alfresco.com/jira/issues/?jql=project%3DREPO
-* Documentation Link: https://support.hyland.com/r/Alfresco/Alfresco-Content-Services-Community-Edition/23.4/Alfresco-Content-Services-Community-Edition/Administer/Manage-Security/Authentication-and-sync
+* Documentation Link: https://support.hyland.com/access?dita:id=byj1720776091160&vrm_version=25.2&component=Alfresco%20Content%20Services%20Community%20Edition
* Contribution Model: Alfresco Open Source
***
diff --git a/repository/docs/meta-data-services/versions/README.md b/repository/docs/meta-data-services/versions/README.md
index 268a1f1305..dcdb8ad31c 100644
--- a/repository/docs/meta-data-services/versions/README.md
+++ b/repository/docs/meta-data-services/versions/README.md
@@ -16,7 +16,7 @@
* Source Code Link:m https://svn.alfresco.com/repos/alfresco-enterprise/alfresco/
* License: LGPL
* Issue Tracker Link: https://issues.alfresco.com/jira/secure/RapidBoard.jspa?projectKey=REPO&useStoredSettings=true&rapidView=379
-* Documentation Link: https://support.hyland.com/r/Alfresco/Alfresco-Content-Services/23.4/Alfresco-Content-Services/Configure/Repository/About-Versioning
+* Documentation Link: https://support.hyland.com/access?dita:id=ybx1720084724583&vrm_version=25.2
* Contribution Model: Alfresco publishes the source code and will review proposed patch requests
***
diff --git a/repository/src/main/java/org/alfresco/repo/template/DocumentationURLMethod.java b/repository/src/main/java/org/alfresco/repo/template/DocumentationURLMethod.java
new file mode 100644
index 0000000000..b51a5be45d
--- /dev/null
+++ b/repository/src/main/java/org/alfresco/repo/template/DocumentationURLMethod.java
@@ -0,0 +1,195 @@
+/*
+ * #%L
+ * Alfresco Repository
+ * %%
+ * Copyright (C) 2005 - 2025 Alfresco Software Limited
+ * %%
+ * This file is part of the Alfresco software.
+ * If the software was purchased under a paid Alfresco license, the terms of
+ * the paid license agreement will prevail. Otherwise, the software is
+ * provided under the following open source license terms:
+ *
+ * Alfresco is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * Alfresco is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with Alfresco. If not, see
.
+ * #L%
+ */
+package org.alfresco.repo.template;
+
+import java.util.List;
+
+import freemarker.template.TemplateMethodModelEx;
+import freemarker.template.TemplateModelException;
+import freemarker.template.TemplateScalarModel;
+import org.apache.commons.lang3.StringUtils;
+
+public class DocumentationURLMethod extends BaseTemplateProcessorExtension implements TemplateMethodModelEx
+{
+
+ private static final String COMPONENT_SEARCHENTERPRISE = "elasticsearch";
+ private static final String COMPONENT_SEARCH = "solr";
+
+ private String documentationBaseUrl;
+ private String acsVersion;
+ private String alfrescoSearchVersion;
+ private String alfrescoSearchEnterpriseVersion;
+ private String defaultDocumentationUrl;
+
+ public void setDefaultDocumentationUrl(String defaultDocumentationUrl)
+ {
+ this.defaultDocumentationUrl = defaultDocumentationUrl;
+ }
+
+ public void setAcsVersion(String acsVersion)
+ {
+ this.acsVersion = acsVersion;
+ }
+
+ public void setAlfrescoSearchVersion(String alfrescoSearchVersion)
+ {
+ this.alfrescoSearchVersion = alfrescoSearchVersion;
+ }
+
+ public void setAlfrescoSearchEnterpriseVersion(String alfrescoSearchEnterpriseVersion)
+ {
+ this.alfrescoSearchEnterpriseVersion = alfrescoSearchEnterpriseVersion;
+ }
+
+ public void setDocumentationBaseUrl(String documentationBaseUrl)
+ {
+ this.documentationBaseUrl = documentationBaseUrl;
+ }
+
+ /**
+ * Returns documentation URL. You can specify property key which should hold value of topic uid and url component(if required). * a) If no arguments are provided, the default documentation URL is returned.
+ *
+ *
+ * ${documentationUrl() -> https://support.hyland.com/p/alfresco
+ *
+ *
+ * b) First argument is interpreted as Topic UID of the URL. The value is retrieved and treated as Topic UID appended after baseURL and before version.
+ *
+ *
+ * ${documentationURL("eet567890373737")} -> https://support.hyland.com/access?dita:id=eet567890373737&vrm_version=25.1
+ *
+ *
+ * c) Second argument(if required) is interpreted as an additional URL component, which will be appended to the URL to denote a specific component of Alfresco.
+ *
+ *
+ * ${documentationUrl("eeu1720075126296", "&component=Alfresco%20Content%20Services%20Community%20Edition"} -> https://support.hyland.com/access?dita:id=eeu1720075126296&vrm_version=25.1&component=Alfresco%20Content%20Services%20Community%20Edition
+ *
+ *
+ * d) Third argument (if required) is interpreted as the Alfresco component (e.g., "solr", "elasticsearch", or empty) to determine which version to use in the URL.
+ *
+ *
+ * ${documentationUrl("eeu1720075126296", "", "solr")} -> https://support.hyland.com/access?dita:id=eeu1720075126296&vrm_version=2.0
+ *
+ *
+ * @param args
+ * arguments passed to Freemarker template method invocation first argument is interpreted as Topic UID of the URL, second argument is interpreted as an additional URL component, third argument is interpreted as the Alfresco component ("solr", "elasticsearch", or empty) to select the version.
+ * @return the documentation URL
+ * @throws TemplateModelException
+ * if an error occurs
+ */
+ @Override
+ public Object exec(List args) throws TemplateModelException
+ {
+ String topicUid = getTopicUid(args);
+ String urlComponent = getUrlComponent(args);
+ String alfrescoComponent = getAlfrescoComponent(args);
+ return getDocumentationUrl(topicUid, urlComponent, alfrescoComponent);
+ }
+
+ /**
+ * Returns default landing documentation URL.
+ *
+ * @return default documentation URL
+ */
+ public String getDocumentationUrl()
+ {
+ return defaultDocumentationUrl;
+ }
+
+ /**
+ * Constructs the documentation URL using the base URL, topic UID, version, and additional component.
+ *
+ * @param topicUid
+ * path segment
+ * @param urlComponent
+ * additional URL component (may be empty)
+ * @param alfrescoComponent
+ * additional Alfresco component (may be empty), to determine the version
+ * @return full documentation URL
+ */
+ public String getDocumentationUrl(String topicUid, String urlComponent, String alfrescoComponent)
+ {
+ if (StringUtils.isEmpty(topicUid) && StringUtils.isEmpty(urlComponent))
+ {
+ return getDocumentationUrl();
+ }
+ String version = selectVersion(alfrescoComponent);
+ return documentationBaseUrl + topicUid + version + urlComponent;
+ }
+
+ private String selectVersion(String alfrescoComponent)
+ {
+ if (COMPONENT_SEARCHENTERPRISE.equalsIgnoreCase(alfrescoComponent))
+ {
+ return alfrescoSearchEnterpriseVersion;
+ }
+ if (COMPONENT_SEARCH.equalsIgnoreCase(alfrescoComponent))
+ {
+ return alfrescoSearchVersion;
+ }
+ return acsVersion;
+ }
+
+ /**
+ * Extracts a string argument from the list at the given index.
+ *
+ * @param args
+ * argument list
+ * @param index
+ * index to extract
+ * @return string value or empty string if not present
+ * @throws TemplateModelException
+ * if argument is not a scalar
+ */
+ private String getStringArg(List args, int index) throws TemplateModelException
+ {
+ if (args.size() > index)
+ {
+ Object arg = args.get(index);
+ if (arg instanceof TemplateScalarModel)
+ {
+ String value = ((TemplateScalarModel) arg).getAsString();
+ return value != null ? value : "";
+ }
+ }
+ return "";
+ }
+
+ private String getTopicUid(List args) throws TemplateModelException
+ {
+ return getStringArg(args, 0);
+ }
+
+ private String getUrlComponent(List args) throws TemplateModelException
+ {
+ return getStringArg(args, 1);
+ }
+
+ private String getAlfrescoComponent(List args) throws TemplateModelException
+ {
+ return getStringArg(args, 2);
+ }
+}
diff --git a/repository/src/main/resources/alfresco/messages/system-messages.properties b/repository/src/main/resources/alfresco/messages/system-messages.properties
index 4c4e46b277..04ec48c837 100644
--- a/repository/src/main/resources/alfresco/messages/system-messages.properties
+++ b/repository/src/main/resources/alfresco/messages/system-messages.properties
@@ -5,7 +5,6 @@
system.err.property_not_set=Property ''{0}'' has not been set: {1} ({2})
system.err.duplicate_name=Duplicate child name not allowed: {0}
-system.err.lucene_not_supported=The lucene search subsystem is not supported. Please see https://support.hyland.com/p/alfresco
# Bootstrap configuration check messages
diff --git a/repository/src/main/resources/alfresco/messages/system-messages_cs.properties b/repository/src/main/resources/alfresco/messages/system-messages_cs.properties
index 9cf3047776..055a99f691 100644
--- a/repository/src/main/resources/alfresco/messages/system-messages_cs.properties
+++ b/repository/src/main/resources/alfresco/messages/system-messages_cs.properties
@@ -5,7 +5,6 @@
system.err.property_not_set=Vlastnost ''{0}'' nebyla nastavena: {1} ({2})
system.err.duplicate_name=Duplicitn\u00ed n\u00e1zvy pod\u0159\u00edzen\u00fdch objekt\u016f nejsou povoleny ({0})
-system.err.lucene_not_supported=Subsyst\u00e9m hled\u00e1n\u00ed Lucene nen\u00ed podporov\u00e1n. Viz https://support.hyland.com/p/alfresco
# Bootstrap configuration check messages
diff --git a/repository/src/main/resources/alfresco/messages/system-messages_da.properties b/repository/src/main/resources/alfresco/messages/system-messages_da.properties
index 06c3cb3015..e523ecfd20 100644
--- a/repository/src/main/resources/alfresco/messages/system-messages_da.properties
+++ b/repository/src/main/resources/alfresco/messages/system-messages_da.properties
@@ -5,7 +5,6 @@
system.err.property_not_set=Egenskaben ''{0}'' er ikke blevet indstillet: {1} ({2})
system.err.duplicate_name=Duplikeret navn p\u00e5 underordnet er ikke tilladt: {0}
-system.err.lucene_not_supported=Lucene-s\u00f8geundersystemet underst\u00f8ttes ikke. Se https://support.hyland.com/p/alfresco
# Bootstrap configuration check messages
diff --git a/repository/src/main/resources/alfresco/messages/system-messages_de.properties b/repository/src/main/resources/alfresco/messages/system-messages_de.properties
index b20abde9cc..bd75300896 100755
--- a/repository/src/main/resources/alfresco/messages/system-messages_de.properties
+++ b/repository/src/main/resources/alfresco/messages/system-messages_de.properties
@@ -5,7 +5,6 @@
system.err.property_not_set=Property ''{0}'' has not been set: {1} ({2})
system.err.duplicate_name=Duplicate child name not allowed: {0}
-system.err.lucene_not_supported=The lucene search subsystem is not supported. Please see https://support.hyland.com/p/alfresco
# Bootstrap configuration check messages
diff --git a/repository/src/main/resources/alfresco/messages/system-messages_es.properties b/repository/src/main/resources/alfresco/messages/system-messages_es.properties
index 8ca51c9df6..08cc0f4af9 100755
--- a/repository/src/main/resources/alfresco/messages/system-messages_es.properties
+++ b/repository/src/main/resources/alfresco/messages/system-messages_es.properties
@@ -5,7 +5,6 @@
system.err.property_not_set=Property ''{0}'' has not been set: {1} ({2})
system.err.duplicate_name=Duplicate child name not allowed: {0}
-system.err.lucene_not_supported=The lucene search subsystem is not supported. Please see https://support.hyland.com/p/alfresco
# Bootstrap configuration check messages
diff --git a/repository/src/main/resources/alfresco/messages/system-messages_fi.properties b/repository/src/main/resources/alfresco/messages/system-messages_fi.properties
index 56c38e2df1..bfee25c206 100644
--- a/repository/src/main/resources/alfresco/messages/system-messages_fi.properties
+++ b/repository/src/main/resources/alfresco/messages/system-messages_fi.properties
@@ -5,7 +5,6 @@
system.err.property_not_set=Ominaisuutta {0} ei ole m\u00e4\u00e4ritetty: {1} ({2})
system.err.duplicate_name=P\u00e4\u00e4llekk\u00e4ist\u00e4 alatasonime\u00e4 ei sallita: {0}
-system.err.lucene_not_supported=Lucene-hakualij\u00e4rjestelm\u00e4\u00e4 ei tueta. Saat lis\u00e4tietoja osoitteesta https://support.hyland.com/p/alfresco
# Bootstrap configuration check messages
diff --git a/repository/src/main/resources/alfresco/messages/system-messages_fr.properties b/repository/src/main/resources/alfresco/messages/system-messages_fr.properties
index 498a6d7b75..8e2f38dc42 100755
--- a/repository/src/main/resources/alfresco/messages/system-messages_fr.properties
+++ b/repository/src/main/resources/alfresco/messages/system-messages_fr.properties
@@ -5,7 +5,6 @@
system.err.property_not_set=Property ''{0}'' has not been set : {1} ({2})
system.err.duplicate_name=Duplicate child name not allowed : {0}
-system.err.lucene_not_supported=The lucene search subsystem is not supported. Please see https://support.hyland.com/p/alfresco
# Bootstrap configuration check messages
diff --git a/repository/src/main/resources/alfresco/messages/system-messages_it.properties b/repository/src/main/resources/alfresco/messages/system-messages_it.properties
index cda7bde170..0ffbf5e08e 100755
--- a/repository/src/main/resources/alfresco/messages/system-messages_it.properties
+++ b/repository/src/main/resources/alfresco/messages/system-messages_it.properties
@@ -5,7 +5,6 @@
system.err.property_not_set=Property ''{0}'' has not been set: {1} ({2})
system.err.duplicate_name=Duplicate child name not allowed: {0}
-system.err.lucene_not_supported=The lucene search subsystem is not supported. Please see https://support.hyland.com/p/alfresco
# Bootstrap configuration check messages
diff --git a/repository/src/main/resources/alfresco/messages/system-messages_ja.properties b/repository/src/main/resources/alfresco/messages/system-messages_ja.properties
index 3178ef3acb..d1c062cbf1 100755
--- a/repository/src/main/resources/alfresco/messages/system-messages_ja.properties
+++ b/repository/src/main/resources/alfresco/messages/system-messages_ja.properties
@@ -5,7 +5,6 @@
system.err.property_not_set=Property ''{0}'' has not been set: {1} ({2})
system.err.duplicate_name=Duplicate child name not allowed: {0}
-system.err.lucene_not_supported=The lucene search subsystem is not supported. Please see https://support.hyland.com/p/alfresco
# Bootstrap configuration check messages
diff --git a/repository/src/main/resources/alfresco/messages/system-messages_nb.properties b/repository/src/main/resources/alfresco/messages/system-messages_nb.properties
index 40611af5aa..45eba3fabe 100755
--- a/repository/src/main/resources/alfresco/messages/system-messages_nb.properties
+++ b/repository/src/main/resources/alfresco/messages/system-messages_nb.properties
@@ -5,7 +5,6 @@
system.err.property_not_set=Property ''{0}'' has not been set: {1} ({2})
system.err.duplicate_name=Duplicate child name not allowed: {0}
-system.err.lucene_not_supported=The lucene search subsystem is not supported. Please see https://support.hyland.com/p/alfresco
# Bootstrap configuration check messages
diff --git a/repository/src/main/resources/alfresco/messages/system-messages_nl.properties b/repository/src/main/resources/alfresco/messages/system-messages_nl.properties
index e47648c61c..ab9017a481 100755
--- a/repository/src/main/resources/alfresco/messages/system-messages_nl.properties
+++ b/repository/src/main/resources/alfresco/messages/system-messages_nl.properties
@@ -5,7 +5,6 @@
system.err.property_not_set=Property ''{0}'' has not been set: {1} ({2})
system.err.duplicate_name=Duplicate child name not allowed: {0}
-system.err.lucene_not_supported=The lucene search subsystem is not supported. Please see https://support.hyland.com/p/alfresco
# Bootstrap configuration check messages
diff --git a/repository/src/main/resources/alfresco/messages/system-messages_pl.properties b/repository/src/main/resources/alfresco/messages/system-messages_pl.properties
index 2e4f3c05a5..5888dff051 100644
--- a/repository/src/main/resources/alfresco/messages/system-messages_pl.properties
+++ b/repository/src/main/resources/alfresco/messages/system-messages_pl.properties
@@ -5,7 +5,6 @@
system.err.property_not_set=Nie ustawiono w\u0142a\u015bciwo\u015bci ''{0}'': {1} ({2})
system.err.duplicate_name=Zduplikowane nazwy element\u00f3w podrz\u0119dnych s\u0105 niedozwolone: {0}
-system.err.lucene_not_supported=Podsystem wyszukiwania Lucene nie jest obs\u0142ugiwany. Zobacz https://support.hyland.com/p/alfresco
# Bootstrap configuration check messages
diff --git a/repository/src/main/resources/alfresco/messages/system-messages_pt_BR.properties b/repository/src/main/resources/alfresco/messages/system-messages_pt_BR.properties
index f0a8ce8103..c0b9b1f977 100644
--- a/repository/src/main/resources/alfresco/messages/system-messages_pt_BR.properties
+++ b/repository/src/main/resources/alfresco/messages/system-messages_pt_BR.properties
@@ -5,7 +5,6 @@
system.err.property_not_set=Property ''{0}'' has not been set: {1} ({2})
system.err.duplicate_name=Duplicate child name not allowed: {0}
-system.err.lucene_not_supported=The lucene search subsystem is not supported. Please see https://support.hyland.com/p/alfresco
# Bootstrap configuration check messages
diff --git a/repository/src/main/resources/alfresco/messages/system-messages_ru.properties b/repository/src/main/resources/alfresco/messages/system-messages_ru.properties
index 7a2dbc1568..f497c11037 100755
--- a/repository/src/main/resources/alfresco/messages/system-messages_ru.properties
+++ b/repository/src/main/resources/alfresco/messages/system-messages_ru.properties
@@ -5,7 +5,6 @@
system.err.property_not_set=Property ''{0}'' has not been set: {1} ({2})
system.err.duplicate_name=Duplicate child name not allowed: {0}
-system.err.lucene_not_supported=The lucene search subsystem is not supported. Please see https://support.hyland.com/p/alfresco
# Bootstrap configuration check messages
diff --git a/repository/src/main/resources/alfresco/messages/system-messages_sv.properties b/repository/src/main/resources/alfresco/messages/system-messages_sv.properties
index b928534a10..7295c6e5ee 100644
--- a/repository/src/main/resources/alfresco/messages/system-messages_sv.properties
+++ b/repository/src/main/resources/alfresco/messages/system-messages_sv.properties
@@ -5,7 +5,6 @@
system.err.property_not_set=Egenskap ''{0}'' har inte st\u00e4llts in: {1} ({2})
system.err.duplicate_name=Dubbelt underordnat namn inte till\u00e5tet: {0}
-system.err.lucene_not_supported=Lucene-s\u00f6kundersystemet st\u00f6ds inte. Se https://support.hyland.com/p/alfresco
# Bootstrap configuration check messages
diff --git a/repository/src/main/resources/alfresco/messages/system-messages_zh_CN.properties b/repository/src/main/resources/alfresco/messages/system-messages_zh_CN.properties
index cb7ff78959..666aa5a2b6 100755
--- a/repository/src/main/resources/alfresco/messages/system-messages_zh_CN.properties
+++ b/repository/src/main/resources/alfresco/messages/system-messages_zh_CN.properties
@@ -5,7 +5,6 @@
system.err.property_not_set=Property ''{0}'' has not been set: {1} ({2})
system.err.duplicate_name=Duplicate child name not allowed: {0}
-system.err.lucene_not_supported=The lucene search subsystem is not supported. Please see https://support.hyland.com/p/alfresco
# Bootstrap configuration check messages
diff --git a/repository/src/main/resources/alfresco/repository.properties b/repository/src/main/resources/alfresco/repository.properties
index 39aac6d0e5..c1ad7f7f30 100644
--- a/repository/src/main/resources/alfresco/repository.properties
+++ b/repository/src/main/resources/alfresco/repository.properties
@@ -1402,3 +1402,10 @@ default.async.folder.items=1000
default.nodeSize.corePoolSize=5
default.nodeSize.maximumPoolSize=10
default.nodeSize.workQueueSize=100
+
+# Documentation URLs properties
+alfresco.documentation.baseurl=https://support.hyland.com/access?dita:id=
+alfresco.documentation.acsVersion=&vrm_version=25.2
+alfresco.documentation.searchVersion=&vrm_version=2.0
+alfresco.documentation.searchEnterpriseVersion=&vrm_version=5.1
+alfresco.documentation.defaultDocumentationUrl=https://support.hyland.com/p/alfresco
diff --git a/repository/src/main/resources/alfresco/subsystems/email/OutboundSMTP/mail-template-services-context.xml b/repository/src/main/resources/alfresco/subsystems/email/OutboundSMTP/mail-template-services-context.xml
index b98ccd5a3b..171c1b8061 100644
--- a/repository/src/main/resources/alfresco/subsystems/email/OutboundSMTP/mail-template-services-context.xml
+++ b/repository/src/main/resources/alfresco/subsystems/email/OutboundSMTP/mail-template-services-context.xml
@@ -161,4 +161,25 @@
+
+
+
+ documentationUrl
+
+
+ ${alfresco.documentation.baseurl}
+
+
+ ${alfresco.documentation.acsVersion}
+
+
+ ${alfresco.documentation.searchVersion}
+
+
+ ${alfresco.documentation.searchEnterpriseVersion}
+
+
+ ${alfresco.documentation.defaultDocumentationUrl}
+
+
diff --git a/repository/src/main/resources/alfresco/template-services-context.xml b/repository/src/main/resources/alfresco/template-services-context.xml
index 62bfc3bb56..f4d86d1758 100644
--- a/repository/src/main/resources/alfresco/template-services-context.xml
+++ b/repository/src/main/resources/alfresco/template-services-context.xml
@@ -171,4 +171,25 @@
urldecode
+
+
+
+ documentationUrl
+
+
+ ${alfresco.documentation.baseurl}
+
+
+ ${alfresco.documentation.acsVersion}
+
+
+ ${alfresco.documentation.searchVersion}
+
+
+ ${alfresco.documentation.searchEnterpriseVersion}
+
+
+ ${alfresco.documentation.defaultDocumentationUrl}
+
+
diff --git a/repository/src/test/java/org/alfresco/AllUnitTestsSuite.java b/repository/src/test/java/org/alfresco/AllUnitTestsSuite.java
index 3c594e091b..6ece232c21 100644
--- a/repository/src/test/java/org/alfresco/AllUnitTestsSuite.java
+++ b/repository/src/test/java/org/alfresco/AllUnitTestsSuite.java
@@ -271,7 +271,8 @@ import org.alfresco.util.testing.category.NonBuildTests;
org.alfresco.util.schemacomp.SchemaDifferenceHelperUnitTest.class,
org.alfresco.repo.tagging.TaggingServiceImplUnitTest.class,
- org.alfresco.repo.serviceaccount.ServiceAccountRegistryImplTest.class
+ org.alfresco.repo.serviceaccount.ServiceAccountRegistryImplTest.class,
+ org.alfresco.repo.template.DocumentationURLMethodTest.class
})
public class AllUnitTestsSuite
{}
diff --git a/repository/src/test/java/org/alfresco/repo/template/DocumentationURLMethodTest.java b/repository/src/test/java/org/alfresco/repo/template/DocumentationURLMethodTest.java
new file mode 100644
index 0000000000..555f8175b7
--- /dev/null
+++ b/repository/src/test/java/org/alfresco/repo/template/DocumentationURLMethodTest.java
@@ -0,0 +1,111 @@
+/*
+ * #%L
+ * Alfresco Repository
+ * %%
+ * Copyright (C) 2005 - 2025 Alfresco Software Limited
+ * %%
+ * This file is part of the Alfresco software.
+ * If the software was purchased under a paid Alfresco license, the terms of
+ * the paid license agreement will prevail. Otherwise, the software is
+ * provided under the following open source license terms:
+ *
+ * Alfresco is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * Alfresco is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with Alfresco. If not, see
.
+ * #L%
+ */
+package org.alfresco.repo.template;
+
+import static org.junit.Assert.assertEquals;
+
+import java.util.Arrays;
+import java.util.Collections;
+
+import freemarker.template.SimpleScalar;
+import freemarker.template.TemplateModelException;
+import org.junit.Before;
+import org.junit.Test;
+
+public class DocumentationURLMethodTest
+{
+
+ public static final String BASE_URL = "baseUrl";
+ public static final String ACS_VERSION = "_acs_";
+ public static final String SEARCH_VERSION = "_solr_";
+ public static final String SEARCH_ENTERPRISE_VERSION = "_es_";
+ public static final String DEFAULT_DOCUMENTATION_URL = "defaultDocumentationUrl";
+ DocumentationURLMethod documentationURLMethod;
+
+ @Before
+ public void setUp() throws Exception
+ {
+ documentationURLMethod = new DocumentationURLMethod();
+ documentationURLMethod.setAcsVersion(ACS_VERSION);
+ documentationURLMethod.setAlfrescoSearchVersion(SEARCH_VERSION);
+ documentationURLMethod.setAlfrescoSearchEnterpriseVersion(SEARCH_ENTERPRISE_VERSION);
+ documentationURLMethod.setDocumentationBaseUrl(BASE_URL);
+ documentationURLMethod.setDefaultDocumentationUrl(DEFAULT_DOCUMENTATION_URL);
+ }
+
+ @Test
+ public void testGetDocumentationUrl_NoArgs() throws TemplateModelException
+ {
+ Object result = documentationURLMethod.exec(Collections.emptyList());
+ assertEquals("defaultDocumentationUrl", result);
+ }
+
+ @Test
+ public void testGetDocumentationUrl_EmptyTopicUidAndUrlComponent() throws TemplateModelException
+ {
+ Object result = documentationURLMethod.exec(Arrays.asList(
+ new SimpleScalar(""),
+ new SimpleScalar("")));
+ assertEquals("defaultDocumentationUrl", result);
+ }
+
+ @Test
+ public void testGetDocumentationUrl_WithTopicUid_AcsVersion() throws TemplateModelException
+ {
+ Object result = documentationURLMethod.exec(Collections.singletonList(new SimpleScalar("/topic")));
+ assertEquals(BASE_URL + "/topic" + ACS_VERSION, result);
+ }
+
+ @Test
+ public void testGetDocumentationUrl_WithTopicUidAndUrlComponent_AcsVersion() throws TemplateModelException
+ {
+ Object result = documentationURLMethod.exec(Arrays.asList(
+ new SimpleScalar("/topic"),
+ new SimpleScalar("urlComponent")));
+ assertEquals(BASE_URL + "/topic" + ACS_VERSION + "urlComponent", result);
+ }
+
+ @Test
+ public void testGetDocumentationUrl_WithSolrVersion() throws TemplateModelException
+ {
+ Object result = documentationURLMethod.exec(Arrays.asList(
+ new SimpleScalar("/topic"),
+ new SimpleScalar("urlComponent"),
+ new SimpleScalar("solr")));
+ assertEquals(BASE_URL + "/topic" + SEARCH_VERSION + "urlComponent", result);
+ }
+
+ @Test
+ public void testGetDocumentationUrl_WithElasticSearchVersion() throws TemplateModelException
+ {
+ Object result = documentationURLMethod.exec(Arrays.asList(
+ new SimpleScalar("/topic"),
+ new SimpleScalar("urlComponent"),
+ new SimpleScalar("elasticsearch")));
+ assertEquals(BASE_URL + "/topic" + SEARCH_ENTERPRISE_VERSION + "urlComponent", result);
+ }
+
+}