grunt-concrete-package-uploader v1.1.1

grunt-concrete-package-uploader

Automatically deploy packages to concrete5.org

This grunt plug-in automatically deploys concrete5 themes + add-ons to the cocnrete5.org Marketplace. This plugin allows to upload complety new packages and also to update existing packages.

Getting Started

This plugin requires Grunt ~0.4.5

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

npm install grunt-concrete-package-uploader --save-dev

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:

grunt.loadNpmTasks('grunt-concrete-package-uploader');

The "concrete_package_uploader" task

Overview

In your project's Gruntfile, add a section named concrete_package_uploader to the data object passed into grunt.initConfig().

grunt.initConfig({
  concrete_package_uploader: {
    // Task-specific options go here.
  },
});

Options

credentials.username

Type: String

Default value:

Required: Yes

-

Username of your concrete5.org user account.

credentials.password

Type: String

Default value:

Required: Yes

-

Password of your concrete5.org user account.

packageInformations.productType

Type: String

Default value: add_on

Required: Yes

-

You can use on of these values:

packageInformations.packageHandle

Type: String

Default value: (Empty)

Required: Yes

packageInformations.shortDescription

Type: String

Default value: (Empty)

Required: Yes

packageInformations.description

Type: String

Default value: (Empty)

Required: Yes

packageInformations.keywords

Type: String

Default value: (Empty)

Required: Yes

packageInformations.exampleUrl

Type: String

Default value: (Empty)

Required: No

packageInformations.screencast

Type: String

Default value: (Empty)

Required: No

packageInformations.dependencies

Type: Array

Default value: (Empty)

Required: No

-

Array with marketplace ids of required add-ons.

packageInformations.singlePrice

Type: Number

Default value: 0

Required: Yes

-

Leave this 0 for free or at least $15.

packageInformations.fivePrice

Type: Number

Default value: 0

Required: Yes

-

If you set a single price and leave this field empty this field will be the quadruple of the single price.

packageInformations.purchaseMessage

Type: String

Default value: Thank you for your purchase. If you take the time to submit a review, I'd love to give you a 10% discount on the next copy of this you purchase.

Required: Yes

packageInformations.requiredVersion

Type: String

Default value: 5.7.0.4

Required: Yes

-

You can use one of the following values:

packageInformations.version

Type: String

Default value: 1.0

Required: No

-

Before submitting to marketplace version number should be 0.9.

packageInformations.packageFile

Type: String

Default value: (Empty)

Required: Yes

-

Expects a file path.

packageInformations.licenseType

Type: String

Default value: Standard

Required: Yes

-

You can use one of the following values:

packageInformations.licenseText

Type: String

Default value: (Empty)

Required: No

-

This field is only required when you have setted the license type to "Custom".

packageInformations.supportPlan

Type: Number

Default value: 1

Required: Yes

-

You can use one of the following values:

packageInformations.supportHostedOffsite

Type: Boolean

Default value: false

Required: Yes

packageInformations.supportHostedOffsiteUrl

Type: String

Default value: (Empty)

Required: No

packageInformations.offersPaidSupport

Type: String

Default value: (Empty)

Required: Yes

packageInformations.supportPrice

Type: Number

Default value: (Empty)

Required: No

packageInformations.pageTypes

Type: String

Default value: (Empty)

Required: No

-

Only required for themes.

packageInformations.customizableStyles

Type: Boolean

Default value: false

Required: No

-

Only required for themes.

packageInformations.skillLevel

Type: String

Default value: Beginner

Required: Yes

-

You can use one of the following values:

packageInformations.containsPageTypes

Type: String

Default value: (Empty)

Required: No

-

Only required for themes.

packageInformations.versionHistory

Type: String

Default value: (Empty)

Required: No

packageInformations.themeThumbnail

Type: String

Default value: (Empty)

Required: No

-

Only required for themes. Expects a file path.

packageInformations.notes

Type: String

Default value: (Empty)

Required: No

packageInformations.screenshots

Type: Array

Default value: (Empty)

Required: No

-

Expects an array of file pathes.

packageInformations.categories

Type: Array

Default value: (Empty)

Required: Yes

For add-ons you can use 1-3 values of the following table:

For themes you can use 1-3 values of the following table:

Usage Example

grunt.config.init({
	concrete_package_uploader: {
		credentials: {
			username: "your_username",
			password: "your_password"
		},

		packageInformations: {
			packageHandle: "your_package_handle",
			packageFile: "build/your_package_file.zip",
			title: "My package",
			version: '0.9.0',
			singlePrice: 15,
			keywords: 'some, keywords',
			shortDescription: 'This is a short description.',
			description: 'This is a long description.',
			categories: [16, 50],
			screenshots: ["screenshots/1.png", "screenshots/2.png"]
		}
	}
});

grunt.registerTask('default', ['concrete_package_uploader']);