How to Contribute a Script

From PlayOnLinux
Revision as of 20:45, 3 March 2015 by Tinou (talk | contribs)
Jump to: navigation, search

So, you have a script that you want to submit to PlayOnLinux?

There are a few things that should be followed, as far as our standards for icons, resources for install scripts, posting here for help or submitting to us for publication, and info that make this process more standardized.

Content of your posts in the forum (Your Creations section)

Please use the following tips to help make the posts here more standardized:

  • Make the title of your post something like:
[Script] name of script
  • Post the following information in your post in this order:
  1. Description of the program (just a basic rundown of what it does)
  2. Anything you had to do or install OUTSIDE of Wine or PlayOnLinux to make it work
  3. Any extra notes about installation, or errors that it throws (if any)
  4. Contents of script

Screenshot requirements

When submitting a screenshot, post them in your original post, reply to your own post with either the link to your screenshots, or just paste the screenshots into the post (we can download them and upload to our server.).

Also, do not submit screenshots with your background or desktop. Full-screen, program-only screenshots, unless you are posting the screenshots for troubleshooting of a related issue. What this means:

  • Make sure that you are only taking a screenshot of the program related to this script.
  • Window decorations are OK, as long as the program is the main feature of the picture.
  • No lewd, pornographic, or otherwise controversial screenshots of ANYTHING (this will result in negative action without question.).
  • Be sure to take screenshots of the game ACTUALLY running; no install shots.
  • Though 1 screenshot works, we prefer 2. 3 is what we really like to see.
  • Legible, fairly hi-def shots; no fuzzy text, not stretched/smashed, not distorted.

Icons and install resources

So, there are 4 different icons and pictures that are desired for the script. They are listed as follows with their EXACT dimensions and file type requirements:

Do not forget to add the file extension to the name.

The icon that will be used for the installed program:

  • Name: nameofprogram-48x48
  • File Type: PNG, JPEG
  • Size: 48x48

The icon that will be used in the PlayOnLinux script list and the site:

  • Name: nameofprogram-22x22
  • File Type: PNG, JPEG
  • Size: 22x22

Sideways banner that is on the left side of the first window when script is ran:

  • Name: left.jpg (or left.png)
  • File Type: PNG, JPEG
  • Size: 150x356 (W x H)

Top corner Icon for install script:

  • Name: top.jpg (or top.png)
  • File Type: PNG, JPEG
  • Size: 64x64 (W x H)

What to do after you have tested your script

After you have had your script on the forum, and its been verified to work, and the script is effective, clean, and portable, then submit in the following fashion:

  1. Go to PlayOnLinux or PlayOnMac
  2. Click Supported Software
  3. Click Add a program
  4. Enter the name of the script you want to publish
  5. Fill out the form as completely as you can
  6. After your submit that, click Click here to see it
  7. When you return to your page, click the Contribute button
  8. Enter in a description, and below the description form, click I want to submit an improvement
  9. Copy/paste your script script in that field, and click Send

Now your script is awaiting approval. A staff member will look at the script and either:

  • It will be approved, and will be then available in the POL/POM Install menu
  • It will need improvements, which the staff member will inform you of. Then you just use the Contribute button to submit a new version of the script
  • Your script will be deleted because it is empty, spam, a help request, or something else not related to that section