Difference between revisions of "Extensions/website/submission"

From Apache OpenOffice Wiki
Jump to: navigation, search
Line 17: Line 17:
 
* Extension description: String/HTML text;
 
* Extension description: String/HTML text;
 
*:The first part is also displayed as a summary (maximal 200 characters).
 
*:The first part is also displayed as a summary (maximal 200 characters).
*:To force the break before 200 characters insert: &gt<!--break-->
+
*:To force the break before 200 characters insert: &gt;!--break--&lt;
 
* Short extension name: String maximal 50 characters;
 
* Short extension name: String maximal 50 characters;
  This is used in the url of the extension:   
+
*:This is used in the url of the extension:   
  http://extensions.services.openoffice.org/project/<shortname>
+
*:http://extensions.services.openoffice.org/project/<short_name>
 
* License category: Select one of the entries:
 
* License category: Select one of the entries:
  opensource, freeware, shareware, commercial
+
*:open source, free ware, shareware, commercial
 
* Teaser image: 150x150 pixel;
 
* Teaser image: 150x150 pixel;
  Will always be shown right to the description;
+
*:Will always be shown right to the description;
 
* Provider Title: String maximal 255 characters;
 
* Provider Title: String maximal 255 characters;
  Name that is used, instead of the username on the site;
+
*:Name that is used, instead of the user name on the site;
 
* Provider URL: URL maximal 255 characters;
 
* Provider URL: URL maximal 255 characters;
  Link that will be on the Provider Title
+
*:Link that will be on the Provider Title
 
* Provider logo: width: 100 pixel, height: 50 pixel
 
* Provider logo: width: 100 pixel, height: 50 pixel
  Will be shown to show the origin;
+
*:Will be shown to show the origin;
 
* Categories: To which application does the extension belong to:
 
* Categories: To which application does the extension belong to:
  Multiselection is possible:
+
*:Multi selection is possible:
  OpenOffice.org, Writer, Calc, Base, Chart, Draw, Impress, Math.
+
*:OpenOffice.org, Writer, Calc, Base, Chart, Draw, Impress, Math.
  (Or a new suggestion)
+
*:(Or a new suggestion)
  At least one has to be selected
+
*:At least one has to be selected
 
* Tags: A free text field, to provide tags, describing the extension;
 
* Tags: A free text field, to provide tags, describing the extension;
  Seperate entries by ,  
+
*:Seperate entries by ,  
  
  
 
Optional:
 
Optional:
 
* License link: URL maximal 255 characters;
 
* License link: URL maximal 255 characters;
  A link to a page where the license is displayed;
+
*:A link to a page where the license is displayed;
* Screenshots: URL maximal 255 characters;
+
* Screen shots: URL maximal 255 characters;
  A link to one or a page with several screenshots;
+
*:A link to one or a page with several screen shots;
 
* Sources: URL maximal 255 characters;
 
* Sources: URL maximal 255 characters;
  A link to a webcvs/viewcvs site where teh source can be viewed;
+
*:A link to a webcvs/viewcvs site where the source can be viewed;
  
 
Don't forgett to mark the extension as published.
 
Don't forgett to mark the extension as published.
Line 59: Line 59:
 
* Download binary from URL: URL to an file (.oxt) maximal 255 characters
 
* Download binary from URL: URL to an file (.oxt) maximal 255 characters
 
* Download from page / Open follow up page URL: URL, 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
+
*:To either a page from where the extension can be downloaded, or a page that will open during download.
  a page that will open during download.
+
  
 
How do these fields work together?
 
How do these fields work together?
Line 66: Line 65:
 
   1. File
 
   1. File
 
   Download button go to a page with a link to the final download;
 
   Download button go to a page with a link to the final download;
   Download starts automatical;
+
   Download starts automatically;
 
   (Update feed can be generated)
 
   (Update feed can be generated)
  
 
   2. File + Open follow up page URL
 
   2. File + Open follow up page URL
 
   Download button go to a page with a link to the final download;
 
   Download button go to a page with a link to the final download;
   Download starts automatical;
+
   Download starts automatically;
 
   A second page opens with the provided URL
 
   A second page opens with the provided URL
 
   (Update feed can be generated)
 
   (Update feed can be generated)
Line 77: Line 76:
 
   3. Download binary from URL
 
   3. Download binary from URL
 
   Download button go to a page with a link to the final download;
 
   Download button go to a page with a link to the final download;
   Download starts automatical;
+
   Download starts automatically;
 
   (Update feed might be generated)
 
   (Update feed might be generated)
  
 
   4. Download binary from URL + Open follow up page URL
 
   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 button opens a new page with a link to the final download and with the provided URL;
   Download starts automatical;
+
   Download starts automatically;
 
   The provided URL is loaded automatical. (Only works with activated JavaScript)
 
   The provided URL is loaded automatical. (Only works with activated JavaScript)
 
   (Update feed might be generated)
 
   (Update feed might be generated)
Line 88: Line 87:
 
   5. Download from page
 
   5. Download from page
 
   Download button opens a new page with a link to the final download;
 
   Download button opens a new page with a link to the final download;
   The provided URL is loaded automatical.
+
   The provided URL is loaded automatically.
 
   (Update feed can't get generated)
 
   (Update feed can't get generated)
  
 
Further needed informations:
 
Further needed informations:
* Operating System: Select at least one entry, multiselection possible:
+
* Operating System: Select at least one entry, multi selection possible:
  System independant, Windows 2003, Solaris, Linux, MacOS X
+
*:System independent, Windows 2003, Solaris, Linux, MacOS X
 
* Binary type: Select one entry:
 
* Binary type: Select one entry:
  OOo extension (.oxt), Other binary download
+
*:OOo extension (.oxt), Other binary download
  Update feed is only generated for oxt-packages.
+
*:Update feed is only generated for oxt-packages.
  There is an icon displayed in the presentation, if oxt is selected
+
*: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;
 
* Currently manual, when description.xml is evaluated the information of that file is used;
  Major: Minor: Patch-level: Each string 20 maximal numbers
+
*:Major: Minor: Patch-level: Each string 20 maximal numbers
  Status: String maximal 50 characters
+
*:Status: String maximal 50 characters
  Will be used like: 1.2.3-dev (If the values are entered: 1, 2, 3, dev)
+
*: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.
 
* 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.
 
Don't forgett to mark the extension as published.

Revision as of 16:57, 22 August 2007

http://extensions.services.openoffice.org

On creating the general extensions page:

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

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.

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

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.

Personal tools