Dev GuideAPI ReferenceUser Guide
HomeDev GuideAPI Reference
Dev GuideAPI ReferenceUser GuideGitHubNuGetDev CommunityDoc feedbackLog In
GitHubNuGetDev CommunityDoc feedback

Note

This example applies to CMS UI 11.21.1 and higher.

This scenario shows how to extend the `HyperLink` editor descriptor and use the TinyMCE custom link dialog to let an editor create links relative to the site. For example, if the site host is `www.alloydemo.com` and the relative link is `news/my-video`, the link will redirect to `www.alloydemo.com/news/my-video`.

  1. Register a new `EditorDescriptor` for `HyperLink UIHint`. Set the `EditorDescriptorBehavior` to `PlaceLast`. As a result, the original descriptor will be executed first, and we can apply custom settings.


  1. In the `ModifyMetadata` method, register the new provider. It will be used to handle custom relative links.
The `Provider` requires a `WidgetType`, which is a Dojo widget class used to edit the value of the new provider. In this case, it is a standard `ValidationTextbox`. After running the site, we should see a dialog box with an additional **Site relative link** field.

  1. To make relative links work in TinyMCE, set the convert\_urls setting to false, to prevent TinyMCE from converting the value.