Difference between revisions of "Extensions/website/submission"
From Apache OpenOffice Wiki
< Extensions | website
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: > | + | *:To force the break before 200 characters insert: >!--break--< |
* Short extension name: String maximal 50 characters; | * 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: | * License category: Select one of the entries: | ||
− | + | *:open source, free ware, shareware, commercial | |
* Teaser image: 150x150 pixel; | * Teaser image: 150x150 pixel; | ||
− | + | *: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 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 | |
* Provider logo: width: 100 pixel, height: 50 pixel | * Provider logo: width: 100 pixel, height: 50 pixel | ||
− | + | *: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: | ||
− | + | *: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; | * Tags: A free text field, to provide tags, describing the extension; | ||
− | + | *: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; | |
− | * | + | * Screen shots: URL maximal 255 characters; |
− | + | *: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 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 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 | + | 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 | + | 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 | + | 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 | + | 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 | + | 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, | + | * Operating System: Select at least one entry, multi selection possible: |
− | + | *:System independent, Windows 2003, Solaris, Linux, MacOS X | |
* Binary type: Select one entry: | * 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; | * 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. | * 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:
- You need to be logged in on the site
- On the left: Submit Extension -> http://extensions.services.openoffice.org/node/add/project-project
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.