Fetching latest commit…
Cannot retrieve the latest commit at this time.
=== Songkick Concerts and Festivals === Contributors: saleandro, coox Tags: songkick, concerts, events, festivals, widget Requires at least: 2.8.2, PHP 5 or higher Tested up to: 3.3.1 Stable tag: 0.9.3.2 This plugin lets you display events for a Songkick user, artist, venue, or metro area on your WordPress blog, as a widget or shortcode. == 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](http://www.schema.org/) = Requirements = * You'll need a Songkick API key. Apply for a key here: [Songkick API docs](http://www.songkick.com/developer) * This plugin requires PHP 5 = Settings = Go to the Settings page to configure the plugin. * 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 "http://www.songkick.com/artists/123-your-name" has the id "123". * The same goes for metro areas: "http://www.songkick.com/metro_areas/123-city-name" has the id "123". * And venues: "http://www.songkick.com/venues/123-venue-name" has the id "123". = Widget = After configuring the plugin, go to the admin Widgets page and simply drag the widget into a sidebar. = Shortcode = After configuring the plugin, 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 = PHP code = You can call the shortcode method directly in your PHP code: `<?php echo do_shortcode('[songkick_concerts_and_festivals]'); ?>` = Blogs using this plugin = * [Big Boi](http://bigboi.com/tour/) * [OK Go](http://www.okgo.net/shows/) * [Haircut Records](http://haircutrecords.co.uk/site/) * [Anthrax](http://anthrax.com/tour/) Know any others? 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](http://github.com/saleandro/songkick-wp-plugin). To send your contribution, fork my project, make your lovely changes, and send me a [pull request](http://help.github.com/send-pull-requests/). Thanks :) == Installation == 1. Upload the directory "songkick_concerts_and_festivals" to the "/wp-content/plugins/" directory 1. Activate the plugin through the "Plugins" menu 1. Go to the Settings page for Songkick and set your username/artist/venue/metro area ID and API key. Apply for a key here: http://www.songkick.com/developer 1. Add the widget to a sidebar or the shortcode anywhere in your blog. == Screenshots == 1. Widget for a user. == 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](https://github.com/ezmiller/songkick-plugin-ethanmod)). * 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](http://www.schema.org/) * Paginated list of events for shortcode option.