500px

Photos from 500px can be included into your posts using Photonic. To display the photos you have to request a Consumer API Key. Once you have your API key and secret, set them in the options under Settings → Photonic → 500px → 500px settings.

The API key is not necessarily approved immediately. Until it is approved you cannot use it to retrieve photos. You can check the status of your API key by looking at your registered application details in the 500px admin screens. For “Approved” it should show “Approved. You’re good to go”.

The following is the basic syntax:

[gallery type='500px' feature='xyz']

The parameter values for feature are described on the API documentation page:

• popular – Returns “popular” photos
• upcoming – Returns “upcoming” photos
• editors – Returns “Editor’s choice” photos
• fresh_today – Returns photos that are “Fresh Today”
• fresh_yesterday – Returns photos that were “Fresh Yesterday”
• fresh_week – Returns photos that are “Fresh this week”
• user – Returns photos for a specified user. Needs either the user_id or the username attribute specified.
• user_friends – Returns photos by users whom the specified user is following. Needs either the user_id or the username attribute specified.
• user_favorites – Returns photos that are the specified user’s favourites. Needs either the user_id or the username attribute specified.

You can get photos by a user and / or restrict them to a specific category. The following are photos by Colin Spencer:

The above uses this format:

[gallery type='500px' feature='user' username='abc']

You could get popular photos from only a specific category:

The above uses the shortcode:

[gallery type='500px' feature='popular' only='animals']

Additionally you can alter the sizes to be returned using the thumb_size and the main_size parameters. There are four sizes defined:

• 1 – Corresponds to 75 × 75 px
• 2 – Corresponds to 140 × 140 px
• 3 – Corresponds to 280 × 280 px
• 4 – Corresponds to the full size

There is a parameter called rpp that controls the number of photos to display. The maximum is 100 and the default is 20. If you use a number higher than 100 the default of 20 photos are returned.

The following demonstrates a size 2 (140 × 140 px) thumbnail with a size 3 (280 × 280 px) popup, with 9 photos:

The above uses the shortcode:

[gallery type='500px' feature='editors' only='Black and White' rpp=9 thumb_size='2' main_size='3']

Lastly you can use the columns parameter to display a certain number of photos per row, just like regular galleries.