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:

  • Villena Castle
  • Bee and Almond blossom
  • Almond blossom
  • Teruel Tower
  • Enjoying the sunshine
  • The Crystal Palace
  • Sunset over the mountains 2
  • Sunset over the mountains
  • Wedding by the sea
  • Face B&W
  • Roman theatre panorama
  • Heron in flight
  • Valldigna Monastery
  • Scary face
  • Lovely smile
  • Black & White
  • Christian warriors
  • Cheeky face
  • Face painting
  • The Nomad

The above uses this format:

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

You could get popular photos from only a specific category:

  • Red poison dart Frog - Costa Rica
  • o#o
  • Fish For Breakfast
  • Stuart Little who ?
  • A Tender Moment
  • Great Butterfly
  • Run! Mommy is not looking
  • first light
  • Cangkurileung Bird
  • King of the backyard
  • Lil Devil
  • Day Dream
  • Untitled
  • Gull in Gold
  • "It's That Way!"
  • Who's there?
  • Panning with Skimmers
  • Giving Advice......
  • In The Late of The Night
  • catch me, my brother

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:

  • Ethiopian Elder
  • Where are they going?
  • interior
  • Chana
  • traditional man
  • Room with view ...
  • Ride Or Die
  • Something Wild
  • Surveillance

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.