Adding Screen Shots To Your WordPress.org Plugins Page

People love images, especially nice looking ones don’t you think?

If you want to make your plugin page on WordPress.org look appealing, why not add some nice looking screen shots of your plugins features.

After 5 hours of studying various tutorials on the subject, i’ve worked out one of the best ways to add screen shots to the plugin directory.

I could not find any clear documentation on this matter so i thought i’d write about it.

I’ll describe what i think is the best way to add screenshots to your plugins page on the official WordPress plugin directory.

What Images To Take

In my opinion, its best to take screenshots of both the backend and front end features your plugins produces.

Image Sizes

The best image sizes are the ones which don’t need scaling/resizing.

If you can, use 530 px width.

Screenshot Application

I like Snagit as it enables you to create nice looking screenshots.

You can also create effects, use color and many other features to make your images look more appealing.

Naming Screen Shots

Name your images:

screenshot-1

screenshot-2

PNG file format or JPG

Adding Images To Repository

The correct location to add your images is in your Assets folder.

After naming them, simply drag them into your assets folder.

assets folder screenshots

Displaying Screenshots On WordPress Plugins Page

Simply use:

1. Add your screenshot description here for your first image

2. Add your screenshot description here for your second image

And so on.

Readme.txt File

Add the description for each image under the screenshots heading in your trunks readme.txt file

plugin read me text file

This will display your images under the screenshots tab on your WordPress.org plugins page menu.

WordPress Plugins Page

Update Before Commit

Update using your SVN client before committing.

Screenshots On Installation Screen

When a new user clicked the install button after finding your plugin, they’ll also get the chance to view screen shots of your plugin as well.

Install Plugins

More Useful Tips For Creating A Better Plugins Page

You might also want to run your readme.txt file through the validator.

You could also use the online generator to create your readme.txt file. At the same time, it might be a good idea to also improve your plugins readme text file as this will also get you more downloads.


Comments

4 responses to “Adding Screen Shots To Your WordPress.org Plugins Page”

  1. Ben Racicot Avatar
    Ben Racicot

    Hey Brad, so maybe my issue is that you cannot use screenshots within the description area? Even with markdown and nothing saying that the screenshots tab is the only place you can?!

    1. Brad Dalton Avatar
      Brad Dalton

      You can add HTML for your image to the archive intro text field to display your image.

      1. Ben Racicot Avatar
        Ben Racicot

        Hey Brad,
        Not too sure what the archive intro text field is but Otto got back to me:
        “We don’t have any way for you insert arbitrary screenshots inline with your description. It is not a full markdown implementation, only a subset that fits our needs.

        Screenshots must be named “screenshot-1.png” and similar, they should be in the assets directory, and they must have a description in the readme.txt file for them. They appear on the Screenshots tab with their descriptions. There is no way to insert them inline into the main body text of the plugin.

        However, inline videos are supported in the main plugin description body as described by this post:
        http://make.wordpress.org/core/2010/02/20/plugins-can-now-include-videos-in-their-readme-txt-files/

        1. Brad Dalton Avatar
          Brad Dalton

          Ok so you’re referring to adding screenshots to the description section of your plugins page on WordPress?

Leave a Reply

Join 5000+ Followers

Get The Latest Free & Premium Tutorials Delivered The Second They’re Published.