Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Wordpress plugin to show Songkick events http://wordpress.org/extend/plugins/s…
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 * Link to event locally or on Songkick * Can use custom templates from your theme * 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]'); ?>` = Customize Templates = Copy the templates from the plugin template directory to your themes root directory. Modify to match your sites look and feel exactly. = 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.