atlas-create-jira-plugin-module

This page describes the shell script atlas-create-jira-plugin-module, part of the Atlassian Plugin SDK.

There is a specific version of this shell script for each Atlassian application. The shell script described on this page is for Jira.

Basic usage

 atlas-create-jira-plugin-module [options] - Prompts you for plugin module type and related details, then creates an example of a Jira plugin module that you can adapt to suit your own plugin's needs. (Runs mvn jira:create-plugin-module.) Passes all parameters straight through to Maven.  

The script will automatically add the changes to your atlassian-plugin.xml and generate the appropriate Java code.

Parameters

This shell script is a Maven wrapper script. All parameters are passed straight through to Maven.

Getting help

The shell script will display some help text if you enter one of the following as the first argument:

  • -?
  • -h
  • help
  • -help
  • --help

For example:

1
2
atlas-create-jira-plugin-module -?
atlas-create-jira-plugin-module -help

Examples

Let's assume you want to add a new plugin module to your existing Jira plugin.

  1. Create your plugin (atlas-create-jira-plugin) and install it into the application (atlas-run) as usual.

  2. Go to the root directory for your plugin (where the pom.xml is located).

  3. Run this command:

    1
    2
    atlas-create-jira-plugin-module
    
  4. Follow the prompts to specify the type of plugin module that you want, and further information required to create the basic module. For example, let's assume you want to create a web item.

  5. The script added the required module to my atlassian-plugin.xml:

    1
    2
    <?xml version="1.0" encoding="UTF-8"?>
     
    <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>
      <web-item name="Sarah Option" i18n-name-key="sarah-option.name" key="sarah-option" section="system.top.navigation.bar" weight="1000">
        <description key="sarah-option.description">The Sarah Option Plugin</description>
        <label key="sarah-option.label"></label>
        <link linkId="sarah-option-link">http://ffeathers.wordpress.com</link>
      </web-item>
      <resource type="i18n" name="i18n" location="atlassian-plugin"/>
    </atlassian-plugin>
    
  6. Where relevant, the script will add the Java classes to your plugin's .java file too.

Working with the SDK

Rate this page: