atlas-create-crowd-plugin-module

This page describes the shell script atlas-create-crowd-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 Crowd.

Basic usage

atlas-create-crowd-plugin-module [options] - Prompts you for plugin module type and related details, then creates an example of a Crowd plugin module that you can adapt to suit your own plugin's needs. (Runs mvn crowd: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.

Supported plugin module types

The plugin module generation scripts are still under development. Currently, only the Jira script has the full set of modules. All other products contain the applicable common modules, such as REST, web item and servlet. See the list of common modules in the Atlassian Plugin Framework.

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-crowd-plugin-module -?
atlas-create-crowd-plugin-module -help

Examples

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

  1. Create your plugin (atlas-create-crowd-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-crowd-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.

  5. The script will added the required module to your atlassian-plugin.xml file.

  6. Where relevant, the script will add the Java classes to your plugin's .java file too.

Working with the SDK

Rate this page: