This page contains useful tips to create themes that will be compatible with future versions of JIRA and Confluence:


Learn from existing Extensions

Look into the Sample Extensions to see how other extensions work. And read the detailed blogpost about how the "Language Switcher Extension" has been built.

Increase the probability of compatibility for your extension

Troubleshooting

 

Scope your Template HTML 

If your Extension HTML should only be available in certain pages 

#Confluence
## example HTML only for Dashboard
#if($req.getRequestURL().toString().endsWith("dashboard.action"))
	your scoped HTML
#end
 
#JIRA
## example HTML only for Dashboard
#if($request.getRequestURL().toString().endsWith("Dashboard.jspa"))
	Your HTML code
#end


 

#Confluence
## example HTML only for space with key "ds"
#if($space.key.equals("ds"))
	your scoped HTML
#end


#JIRA
## example HTML only for project with key "DEMO"
#if($project.key.equals("DEMO"))
	Your HTML code
#end