JIRA layout per-project

Question

Would it be possible to use a project-specific stylesheet for JIRA projects?

For example, if I would like to include project X in an iframe, I'd like to hide the logo and possibly the JIRA toolbar - for specific user groups for example (it's only for viewing purpose, it is not a security feature)

Granted that I'd have to implement this myself (through the webservice api for example) - are there templates for the standard issue page?

Thanks in advance!

If you are just trying to make a project read-only, hacking the css wouldn't be a good way to do this. — Mike Miller
no the permission scheme is solid, people just don't need the toolbar. also it is embedded in another portal, so it would be nice to apply the same stylesheet for this particular project. — Stefan Ernst
You could try using javascript to change the output or select a css. — Mike Miller
yes I thought about manipulating the iframe but it seems kinda "hackish". the cleanest way to me seems like a stylesheet based on user groups. — Stefan Ernst
Have you searched plugins.atlassian.com for existing plugins which modify the look and feel? — tokes

Matt Quail Matt Quail · Accepted Answer · 2011-03-31T09:48:57

There is a (currently undocumented) plugin point in JIRA for inserting top navigation components, <top-navigation>.

You can use this plugin point to add your own navigation bar, and perhaps hide the normal bar using an inline CSS stylesheet. The following example triggers this behavior by using a ?hideit=true query parameter, which is the simplest way to approach the "embed in iframe" problem. You could make that "sticky" by storing it in a session or cookie.

Once you have created a plugin that plugins into the <top-navigation>, hiding the top bar is simple. Here is a velocity script that does it:

#if ($hideHeaderHack)
    <style>
        \#header {display:none;}
    </style>
    HIDDEN (remove this message eventually)
#else
    NORMAL (remove this message eventually)
#end

To create such a plugin, use the Atlassian Plugin SDK (use atlas-create-jira-plugin). Your atlassian-plugin.xml should look like:

<atlassian-plugin key="${project.groupId}.${project.artifactId}" name="${project.name}" plugins-version="2">
    <plugin-info>
        <description>${project.description}</description>
        <version>${project.version}</version>
        <vendor name="${project.organization.name}" url="${project.organization.url}" />
    </plugin-info>

    <top-navigation key="standard-navigation-top"
                    name="Tigerblood"
                    class="com.madbean.topnavhack.TopNav" state='enabled'>
        <resource type="velocity" name="view" location="topnav.vm"/>
        <order>5</order>
    </top-navigation>

</atlassian-plugin>

Your top-navigation implementation class (called com.madbean.topnavhack.TopNav above) should look like:

public class TopNav implements PluggableTopNavigation {
    private TopNavigationModuleDescriptor descriptor;

    public void init(TopNavigationModuleDescriptor descriptor)
    {
        this.descriptor = descriptor;
    }

    public String getHtml(HttpServletRequest request) {
        Map<String,Object> params = new HashMap<String, Object>();

        params.put("hideHeaderHack", "true".equals(request.getParameter("hideit")));

        return descriptor.getTopNavigationHtml(request, params);
    }
}

Your plugin will be laid out something like:

./pom.xml
./src/main/java/com/madbean/topnavhack/TopNav.java
./src/main/resources/atlassian-plugin.xml
./src/main/resources/topnav.vm

Disclaimer I work for Atlassian as a developer in the JIRA team.

JIRA layout per-project

4 Answers