Last modified by Raphaël Jakse on 2026/03/23 14:34

Show last authors
1 First, make sure you are familar with the concepts of the [[URL Mapping module>>doc:documentation.extensions.admin.url-mapping.WebHome]].
2
3 You can add your own custom mappers that will be picked up by the Confluence URL prefix handler.
4
5 For this, you can take model on https://github.com/xwiki-contrib/confluence/tree/master/confluence-url-mapping, and especially the ##URLMapper## class.
6
7 1. Write components that extend the [[##ConfluenceURLMapper##>>url:https://github.com/xwiki-contrib/confluence/blob/master/confluence-url-mapping/src/main/java/org/xwiki/contrib/confluence/urlmapping/ConfluenceURLMapper.java]] interface
8 11. call ##super(your regex)## in the constructor
9 11. implement convert such that it returns the desired resource reference. It can return null if the url isn't handled after all
10 1. Make sure the `pom.xml` file of the extension that will hold these clases specifies that the module be installed on the root namespace: ##<properties> <xwiki.extension.namespaces>{root}</xwiki.extension.namespaces> </properties>##

Get Connected