Description
This plugin lets you display upcoming or past events for a Songkick user, artist, venue, or metro area on your WordPress blog.
Events can be displayed by adding the Songkick widget to your template, or by adding the shortcode [songkick_concerts_and_festivals] anywhere in your blog.
Features
- Upcoming events for an artist
- Past events for an artist
- Upcoming events for a venue
- Upcoming events for a user
- Past events for a user
- Upcoming events for a metro area. A metro area is a city or a collection of cities that Songkick uses to notify users of concerts near them.
- Widget or shortcode format
- Show events for multiple artists, users, venues, or metro areas.
- Paginated list of events
- HTML markup with support for events as defined by Schema.org
Requirements
- This plugin uses a non-commercial Songkick API key. If you have a commercial website, you’ll need your own Songkick API key. Please read through Songkick’s API terms of use. Apply for a key here: Songkick API docs
- This plugin requires PHP 5.6.20 or higher
Settings
Go to the Settings page to configure default options for the plugin. You can also specify your settings under Plugins/Widget or via shortcode options.
- For a user, simply put your username in the admin interface.
- For an artist, you should use the artist’s Songkick id, as shown in the url for your artist page. For example, the url “https://www.songkick.com/artists/123-your-name” has the id “123”.
- The same goes for metro areas: “https://www.songkick.com/metro_areas/123-city-name” has the id “123”.
- And venues: “https://www.songkick.com/venues/123-venue-name” has the id “123”.
Widget
Go to the admin Widgets page and simply drag the widget into a sidebar and configure it.
Shortcode
Add the shortcode [songkick_concerts_and_festivals] in the content of any blog post.
When using a shortcode, you can set which artist, venue, metro area, or user you want to display events for, allowing you to show events for different entities:
- Users:
[songkick_concerts_and_festivals songkick_id=your_username songkick_id_type=user] - Artists:
[songkick_concerts_and_festivals songkick_id=your_artist_id songkick_id_type=artist] - Venues:
[songkick_concerts_and_festivals songkick_id=your_venue_id songkick_id_type=venue] - Metro areas:
[songkick_concerts_and_festivals songkick_id=your_metro_area_id songkick_id_type=metro_area]
Override shortcode settings:
- gigography=true|false
- number_of_events=integer
- show_pagination=true|false
- no_calendar_style=true|false — removes the calendar style from the event dates
- order=asc|desc – sort order for artist or user events
PHP code
You can call the shortcode method directly in your PHP code:
Blogs using this plugin
Know any blogs using this plugin? Let me know!
Contribute
This is an open source project that I maintain during my spare time. I welcome contributions!
The code lives on Github. To send your contribution, fork my project, make your lovely changes, and send me a pull request. Thanks ??
Screenshots
Widget for a user.
Installation
- Upload the directory “songkick_concerts_and_festivals” to the “/wp-content/plugins/” directory
- Activate the plugin through the “Plugins” menu
- Go to the Settings page for Songkick or the Widgets page and set your username/artist/venue/metro area ID.
- Please read through Songkick’s API terms of use. If you have a commercial website, please apply for your own API key here: https://www.songkick.com/developer and configure it on the Settings page.
- Add the widget to a sidebar or the shortcode anywhere in your blog.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Songkick Concerts and Festivals” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Songkick Concerts and Festivals” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
0.6
- Added shortcode.
0.7
- Fixed some warnings.
- Made calendar date style inline.
0.8
- Fixed bug where shortcode content would always display on top of other content.
0.9
- Default options can be overridden when calling shortcode function. This means you can use the plugin for different users and artists.
See Songkick’s admin settings for details.
0.9.1
- Refactored events and presentable event code.
- Improved exception handling and error logging (thanks Ethan).
- Improved documentation.
- Added option to hide calendar style for dates (no_calendar_style=true)
0.9.2
- Support for displaying metro area events.
0.9.3
- Support for displaying venue events.
- Markup with support for events as defined by Schema.org
- Paginated list of events for shortcode option.
0.9.4
- Reimplementation of the Widget class. Allows for multilple Widget instances.
- Remove requirement for an API key for non-commercial websites.
0.9.4.1
- Fixing up and removing warnings
0.9.4.2
- Sort order of past events is descending
0.9.4.3
- Bug fix: Fixing error when displaying a user’s upcoming events
0.9.4.4
- Catching any error when testing Songkick API key. Some users reported seeing a “name lookup” error on the Settings page.
0.9.4.5
- Option to turn off API caching.
0.9.4.6
- Display end date of festivals.
0.9.4.7
- Add Italian translation
0.9.4.8
- Use __construct instead of classname as this will be deprecated
0.9.4.9
- BUG fix: correctly localise date strings in calendar
0.9.5
- Upgrade to support PHP 8
0.9.6
- Bug fix: prevent settings page from breaking when Songkick API is unavailable
0.9.7
- Use https to connect to Songkick API