Link rendering: Add support for UrlMode parameter in HtmlLocalLinkParser

[rickbutterfield]

Prerequisites

• I have added steps to test this contribution in the description below

Related issue: umbraco/Umbraco.Forms.Issues#1414

Description

This is the first part of a fix for the issue linked above.

This PR adds a new overload for EnsureInternalLinks in the HtmlLocalLinkParser that accepts a UrlMode parameter. The aim of this is to allow the Umbraco Forms "Send email with template" workflow to correctly render localLinks in the Header/Body/Footer fields as absolute URLs rather than relative ones.

The changes are completely backwards compatible and non-breaking, with unit tests added too. The fix should be able to be cherry picked to v16.

[Copilot]

Pull Request Overview

This PR adds support for a UrlMode parameter to the HtmlLocalLinkParser class to enable control over URL generation modes (relative vs absolute). This enhancement is needed to fix an issue where Umbraco Forms email templates require absolute URLs for proper rendering.

• Adds new overloads for EnsureInternalLinks methods that accept a UrlMode parameter
• Updates internal method calls to pass the URL mode through to the URL providers
• Maintains backward compatibility by keeping existing method signatures

Reviewed Changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File	Description
src/Umbraco.Core/Templates/HtmlLocalLinkParser.cs	Adds new overloads with UrlMode parameter and updates internal URL generation calls
tests/Umbraco.Tests.UnitTests/Umbraco.Core/Templates/HtmlLocalLinkParserTests.cs	Adds comprehensive unit tests covering various URL modes for both content and media links

[Copilot]

Pull Request Overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated 4 comments.

[AndyButland]

Thanks @rickbutterfield - all looks to work as expected. I've verified also via:

@inject HtmlLocalLinkParser LocalLinkParser;
<div>@LocalLinkParser.EnsureInternalLinks("a href=\"{localLink:4148}\"")</div>
<div>@LocalLinkParser.EnsureInternalLinks("a href=\"{localLink:4148}\"", UrlMode.Absolute)</div>

And see the expected results.