Difference between revisions of "Extensions/website/submission"

Revision as of 17:01, 22 August 2007

General

http://extensions.services.openoffice.org

There are several places where the informations are used:

• Teaser: in List views limited informations are shown
• Extension page: A separate page, where the extension information is displayed
• Update feed
• Extension release page: All informations regarding the binary are show
• Extension download process

Extension page

On creating the general extensions page:

• You need to be logged in on the site
• On the left: Submit Extension -> http://extensions.services.openoffice.org/node/add/project-project

Needed informations:

• Extension name: String maximal 128 characters;

  The display name of the extension;

• Extension description: String/HTML text;

  The first part is also displayed as a summary (maximal 200 characters).

  To force the break before 200 characters insert: <!--break-->

• Short extension name: String maximal 50 characters;

  This is used in the url of the extension:

  http://extensions.services.openoffice.org/project/<short_name>

• License category: Select one of the entries:

  open source, free ware, shareware, commercial

• Teaser image: 150x150 pixel;

  Will always be shown right to the description;

• Provider Title: String maximal 255 characters;

  Name that is used, instead of the user name on the site;

• Provider URL: URL maximal 255 characters;

  Link that will be on the Provider Title

• Provider logo: width: 100 pixel, height: 50 pixel

  Will be shown to show the origin;

• Categories: To which application does the extension belong to:

  Multi selection is possible:

  OpenOffice.org, Writer, Calc, Base, Chart, Draw, Impress, Math.

  (Or a new suggestion)

  At least one has to be selected

• Tags: A free text field, to provide tags, describing the extension;

  Seperate entries by ,

Optional:

• License link: URL maximal 255 characters;

  A link to a page where the license is displayed;

• Screen shots: URL maximal 255 characters;

  A link to one or a page with several screen shots;

• Sources: URL maximal 255 characters;

  A link to a webcvs/viewcvs site where the source can be viewed;

Don't forgett to mark the extension as published.

Extension Release

Upload an extension release binary: On an extension page you have a link 'Add new release', if you created the extensions; This goes to a link like: http://extensions.services.openoffice.org/node/add/project_release/xxx

Binary download/upload options

There are several options, how to provide the extension binary; There exist the following fields:

• File: Upload a file (.oxt) not greater than 100MB
• Download binary from URL: URL to an file (.oxt) maximal 255 characters
• Download from page / Open follow up page URL: URL, maximal 255 characters

  To either a page from where the extension can be downloaded, or a page that will open during download.

How do these fields work together? Possible combinations:

  1. File
  Download button go to a page with a link to the final download;
  Download starts automatically;
  (Update feed can be generated)

  2. File + Open follow up page URL
  Download button go to a page with a link to the final download;
  Download starts automatically;
  A second page opens with the provided URL
  (Update feed can be generated)

  3. Download binary from URL
  Download button go to a page with a link to the final download;
  Download starts automatically;
  (Update feed might be generated)

  4. Download binary from URL + Open follow up page URL
  Download button opens a new page with a link to the final download and with the provided URL;
  Download starts automatically;
  The provided URL is loaded automatical. (Only works with activated JavaScript)
  (Update feed might be generated)

  5. Download from page
  Download button opens a new page with a link to the final download;
  The provided URL is loaded automatically.
  (Update feed can't get generated)

Further needed informations:

• Operating System: Select at least one entry, multi selection possible:

  System independent, Windows 2003, Solaris, Linux, MacOS X

• Binary type: Select one entry:

  OOo extension (.oxt), Other binary download

  Update feed is only generated for oxt-packages.

  There is an icon displayed in the presentation, if oxt is selected

• Currently manual, when description.xml is evaluated the information of that file is used;

  Major: Minor: Patch-level: Each string 20 maximal numbers

  Status: String maximal 50 characters

  Will be used like: 1.2.3-dev (If the values are entered: 1, 2, 3, dev)

• Release notes: String/HTML that will be used in the update feed and on the extension release and download page.

Don't forgett to mark the extension as published.