Zimbra Gallery:How to Contribute

From Zimbra :: Wiki

Jump to: navigation, search

You can easily contribute Extensions (for example: Zimlets, Themes and Extras) to the Zimbra Gallery. This document provides a brief overview contribution process.

Contents

Step 1: Register

You must be a registered user of the Zimbra Gallery before adding an Extension. You can register by clicking the "Sign up" link located in the upper-right of the Zimbra Gallery pages.

Note: Your Zimbra Forums account will work with the Zimbra Gallery.

Step 2: Login

After obtaining an account, you can login by entering your username and password on the Gallery login page. After logging in, the "Add Extension" link will be available in the top navigation area of the Zimbra Gallery.

Gallery-add-extension-link.jpg

Step 3: Terms of Use

Click the "Add Extension" link. If this is the first time you are contributing to the Zimbra Gallery, you will be presented with the Zimbra Community Terms of Use. You must read and agree to the Terms of Use. Scroll to the bottom of the Terms of Use page, enter your name in the provided box and click "I Accept" to continue.

Gallery-terms-of-use-accept.jpg

Step 4: Add Extension Form

The following describes the "Add Extension" form fields:

Name Required Description
Name of Extension Yes This is the visible name of the extension.
Type Yes Select the type of extension. Options include: zimlet, theme or extra
Description No Enter a brief description of your extension. This can be left blank.
Version Yes Enter the version of your extension. For example, "1.0".
Screenshots No You can upload 1 or more screenshots. Screen shots are displayed as thumbnails when someone views the extension details, with the first screenshot in your list as the primary image. You can modify the order of screenshots by drag-and-drop when editing your extension. Max size is 20MB and supported formats include: png gif jpg jpeg
Useful Links No You can enter 1 or more links to external websites that are relevant to the extension. This can be more detailed documentation, release notes, company or personal websites, etc.
Bugzillas No You can enter 1 or more Zimbra Bugzilla numbers (for example, 12345) and those Bugzillas will be linked on the extension details page.
Categories Yes Select 1 or more categories to list your extension.
Compatibility Yes Select 1 or more Zimbra product and version combinations your extension supports.
Binary Yes Upload your extension binary file or enter an external link where the extension is hosted. Note: if you upload your binary to the Zimbra Gallery, it must be governed under the Apache License. If you plan to have your extension governed under any other license, you must host and distribute your extension via an external link.
Active No Mark your extension as "active". When "active", your extension is published and available in the Gallery.
Versioning No This allows you post more than one version of your extension to the Gallery under the same name.

Step 5: Making Updates

You can see a list of the extensions you have contributed by browsing to your personal page on the Zimbra Gallery. After logging-in, you are brought to your personal page and list of contributed extensions is shown. You can click on an extension to edit update extension properties, upload new versions or mark the extension is "inactive" which makes it unavailable for browsing and download from the public site but still available for you to edit. After login, you can return to your personal page at any time by clicking on your name in the upper-right of the Zimbra Gallery pages.


Verified Against: n/a Date Created: 1/19/2010
Article ID: http://wiki.zimbra.com/index.php?title=Zimbra_Gallery:How_to_Contribute Date Modified: 07/11/2010
Personal tools