Other applications

You can add external applications such as Gitlab, Jenkins or SonarQube to the Allegra perspectives menu. Combined with an SSO system, this lets you switch quickly between the different applications without having to leave Allegra.

To provide access to external applications, download the portal extension from https://alltena.com/de/ressourcen/erweiterungen/ to your server and copy the file portal-x.y.tpx into your ALLEGRA_HOME/plugins directory.

The file is unpacked there into a directory named ALLEGRA_HOME/plugins/portal-x.y. This directory contains a file named trackplus-plugin.xml. It looks roughly like this:

<trackplus-plugin id="trackplus.plugin" name="PortalPlugin">

    <plugin-info>
        <description>Portal plug-in</description>
        <version>7.0</version>
        <application-version min="7.0" max="10.0"/>
        <vendor name="Alltena - Allegra" url="https://alltena.com"/>
    </plugin-info>

    <!--  ${SERVER} will be replaced by the Allegra server base URL -->
    <!--  including the protocol. You can also use a fixed URL like -->
    <!--  https://www.yourdomain.com                                -->

    <module id="jenkins"
        name="Jenkins"
        iconCls="jenkinsApp"
        useHeader="true"
        description="Jenkins integration"
        url="https://ci.yourdomain.com/internal/jenkins/"/>

    <module id="gitlab"
        name="GitLab"
        iconCls="gitlabApp"
        useHeader="true"
        description="Gitlab integration"
        url="https://ci.yourdomain.com:2244"/>

    <module** id="sonar"
        name="Sonar"
        iconCls="sonarApp"
        useHeader="true"
        description="Sonar integration"
        url="https://www.yourdomain.com/internal/sonar"/>
</trackplus-plugin>

The icons are included via a stylesheet, for example like this

.gitlabApp {
    background-image: url(svg/other/gitlabLogo.svg) !important;
    background-size: 16px;
}

As an administrator, you can adjust the stylesheets accordingly via Administration > Branding.