AEM 6.5 RTE appends .html to links

[abhisheks351843]

In AEM 6.5 I am having an issue with the link feature of RTE. It appends .html by default to any link starting with a "/". My application is Single Page so I want only the route. How can I override this default behavior? https://helpx.adobe.com/experience-manager/6-3/sites/administering/using/configure-rich-text-editor-... does not have any insights.

[abhisheks351843]

I already tried to overlay /libs/clientlibs/granite/richtext/core/js/HtmlRules.js and comment "obj.href = href + CUI.rte.Constants.EXTENSION_HTML + query + anchor;".

[Theo_Pendle · Accepted solution]

Hi,

First of all, those are good instincts! 

However the solution is the following:

1. Under the RTE node, create a child called htmlRules
2. Under htmlRules create a child called links
3. Add the following property to links:

ensureInternalLinkExt  --  Boolean  --  false​

Here is the resulting node structure:

PS: don't forget to add the htmlRules and links nodes to each RTE (the one in the cq:dialog and the in cq:editConfig for example).

This fixes the issue as you can see from this GIF:

[abhisheks351843]

Thanks a lot. That worked. However, I wanted to know what would be the correct approach to this problem resolution. I mean how could I have come to know myself about adding these nodes and properties would resolve the issue. The documentation at https://docs.adobe.com/content/help/en/experience-manager-65/administering/operations/configure-rich... does not have this information.

[Theo_Pendle]

I agree, the documentation on this point is pretty terrible. I'd actually done this before but I had to remind myself 

So if you look at the code that you commented, you see that it is inside some if-blocks (here is a snippet of richtext.js

// add extension to internal links if necessary (relative links are considered
// internal links as well)
if (this.ensureInternalLinkExt && this.isPage(href)) {
    var anchor = '';
    if (anchorPos > 0) {
        anchor = href.substring(anchorPos, href.length);
        href = href.substring(0, anchorPos);
    }
    var query = '';
    var queryPos = href.indexOf('?');
    if (queryPos > 0) {
        query = href.substring(queryPos, href.length);
        href = href.substring(0, queryPos);
    }
    // add extension to href if necessary
    var extSepPos = href.lastIndexOf('.');
    var slashPos = href.lastIndexOf('/');
    var hasClosingSlash = (slashPos === (href.length - 1));
    if (((extSepPos <= 0) || (extSepPos < slashPos)) && !hasClosingSlash) {
        obj.href = href + CUI.rte.Constants.EXTENSION_HTML + query + anchor;
    }
}

The top-most condition checks a boolean variable called ensureInternalLinkExt. If we keep searching, we find that ensureInternalLinkExt comes from config, which is the same object that gives us the protocols:

config = config || {};
var defaults = {
'cssMode': 'auto',
'protocols': [
    'http://',
    'https://',
    'ftp://',
    'mailto:'
],
'targetConfig': {
    'mode': 'blank'
},
'ensureInternalLinkExt': true
};

 The documentation you linked to, if you read through it, does in fact explain how to set the protocols configuration (link to the relevant section here). So by logical deduction, we can assume that the same technique will work for ensureInternalLinkExt 
So yeah, if you are not familiar with the documentation or if you don't know much about RTE and editor plugins it's pretty hard to find (I remember when I first did this it probably took me over 2 hours to figure out, even though it seems kinda obvious now). It really should be documented better, but that's true of a LOT of things in AEM. On the plus side, that's why we get paid more than Java Spring developers or something XD If it was too easy, anybody could do it haha 

[Swati2212]

How to do this for content fragments where RTE is being used ?

[hello299]

Hi Swati,
Did you find any solution on this?

[ZeelTr1]

Hello @Swati2212 and @hello299. Can you help me to resolve this problem in content fragement RTE? It would be a great help

[hello299]

Hi @ZeelTr1 

We basically need to use Jsoup since this is an RTE for removing the .html