MusicIDB Events Calendar

描述

An interactive website calendar for live music and event listings.

Built for Artists, Venues, Bars, Restaurants and the Music Industry. This plugin uses the MusicIDB API to seamlessly display your events list and calendar onto any WordPress page via a shortcode or theme hooks.

With an intuitive dashboard, instant updates to your website, and integration of artists’ music, videos, social links and bios, MusicIDB Event Calendar makes it possible to easily launch a fully featured calendar for your website visitors.

Artists

  • Modern, compact list view launched for artists
  • While creating any event, tag or add any venue you play at
  • Each event can display with Facebook event links or ticket links
  • You can tag / add other bands on any show you play, for easy link-sharing with other bands
  • Drop view templates in your local theme to override

Request an API key here: Artist API Key Request

Venues

  • List View and calendar view available
  • Highly configurable
  • Tag or add any artist / band in the world
  • Tagging bands enables you to build a network of artists to drop on your calendar
  • 10,000+ artists in the database
  • Website visitors can enjoy instantly watching videos and playing music of artists tagged on your events in an elegant overlay on your website calendar page
  • Drop view templates in your local theme to override
  • Artist media can be embedded from YouTube, Bandcamp, SoundCloud, Spotify and any other services that provide embeddable media.
  • MusicIDB calendars display event images on each date
  • Pro – Create recurring events such as weekly Open Mic, Karaoke or Trivia events, or weekly promotional events such as food specials, and much more.

This plugin requires a MusicIDB.com account and API key, which you can generate from your venue page once it has been claimed and approved.

Visit MusicIDB.com to create your account.

API Developer information.

螢幕截圖

  • Event list with pictures example (popular for venues - dark theme)
  • Calendar view example (dark theme)
  • Simple list example (popular for artists)
  • View Event pop-up with artist media
  • Featured events slider examples
  • Connecting API Key and adding additional Artists or Venues
  • Shortcode generator and options
  • A light theme calendar view example
  • Creating an Event
  • Generate API Key from Venue page on MusicIDB

安裝

For instructions with screenshots View our Plugin Documentation.

  1. From your WordPress dashboard, visit Plugins > Add New
  2. Search for “MusicIDB Events Calendar” and install and activate the plugin
  3. Visit MusicIDB.com, and create and log in to your account
  4. Create and claim your venue listing or artist listing
  5. While your claim is being processed, create a few of your upcoming events by clicking on your MusicIDB.com dashboard calendar (tag your artist or venue listing and make it the default venue with the checkbox)
  6. Venues – Once your venue claim has been approved, visit your venue’s page on MusicIDB.com (page link on left side or use search box), click “Embed Widgets”, click the “WordPress Plugin” tab (in the pop-up) and then click “Generate API Key
  7. Artists – Request an API key from the link above and skip to step 8.
  8. Back on your WordPress Dashboard, click on “MusicIDB Calendar” from the left side nav
  9. Enter your API Key, and click “Save Settings”. You should see “Connected :)” (as long as you have created at least one upcoming event on MusicIDB.com).
  10. Click on the “Shortcodes” tab, and use the options to customize and generate your shortcode which can be pasted into any page through the WordPress editor.

常見問題

Do I need a MusicIDB.com Account?

Yes, you will need an account on MusicIDB before you will be able to use this plugin. Registration is easy, click here to create an account.

You won’t need to log in to your website to update your events, you’ll be able to manage your website events directly from your MusicIDB.com dashboard. The ability to create and manage events from within your website is intended to be available in a future version of the plugin.

How do I create an API Key?

For venues – once you have created an account on MusicIDB.com, create and claim your venue listing.

Once your venue claim has been approved, you can visit your venue’s page on MusicIDB.com (you can search for it or click on the left side nav), click Embed Widgets, click the WordPress Plugin tab of the pop-up, and then click Generate API Key.

For artists – request an api key here: Artist API Key Request

How do I get support?

Either chat with us through our website or blog by clicking the orange chat icon in the footer, or email support [at] musicidb.com. Questions are generally answered within one business day.

We answer questions related to usage, implementation, and customization of MusicIDB Events Calendar. We cannot guarantee resolutions for issues that may be due to custom theme code or 3rd party plugin conflicts & compatibility.

What calendar options are available? How can I add my MusicIDB Events from within a template?

To add MusicIDB Events from a theme template, you can use code like this wrapped in PHP tags:

musicidb_events(array(
    'theme' => 'light',
    'view' => 'list',
    'descrip' => 'true',
    'display' => 'img'
));   

The passed array parameter names and values are exactly the same as the shortcode attributes, and can be copied from the shortcode generator.

Here are the available parameters, all of which can be configured in the shortcode generator.

id: venue:123,artist:123,venue:456
Used to specify the entities you wish to list events for. Should be a comma separated string. Can be generated with shortcode generator.

view: cal or list
When viewing Calendar/ Event List, declares which view will display initially on page load

display: text or img
On calendar view only, option declares whether only text or images (when available) are visible within each calendar date of the full month view.

numevents: Integer
Maximum number of events to load, per page, in the Event List (default is 15).

theme: light or dark
If you have a dark background, use dark and your MusicIDB events will be styled to match your theme better. Use light if you have a white or light background color.

style: full or compact
This controls the list style.
full = “Event List with Pictures” (popular for venues)
compact = “Simple List” (popular for artists)

descrip: visible or hidden
When list view is shown, declares whether the Event Description area is visible prior to expanding the event

buttons: left, center, or right
Control the button position on the “Event List with Pictures” style event list

showvenue: show or hide
If you want to show or hide the venue name in your event list you can use this option to do so. By default venue is hidden on the “Event List with Pictures” list style, and shown on the “Simple List” list style.

showartist: show or hide
If you want to show or hide the artist names in your event list you can use this option to do so. By default artists are hidden on the “Simple List” list style, and shown on the “Event List with Pictures” list style.

All parameters can be viewed here.

What featured events slider options are available? How can I add the MusicIDB Featured Events slider from within a template?

To add MusicIDB Featured Events from a theme template, you can use code like this wrapped in PHP tags:

musicidb_featured_events(array(
    'ticketdefault' => 'https://website.com/tickets',
    'leftflag' => 'Featured Events',
    'titlesize' => '22',
    'numevents' => '8',
    'background' => '#000000',
    'fallbackimage' => 'https://website.com/image.jpg',
));  

Shortcode version example: [musicidb-featured-slider titleSize=”22″ numevents=”8″ background=”#000000″ fallbackImage=”https://website.com/image.jpg” leftFlag=”Featured Events” ticketDefault=”https://website.com/tickets”]

ticketdefault: URL
If you want users to automatically visit a master tickets site or webpage, you can fill this one to automatically create a ticket link for all events.

leftflag: Text flag over left side
Flag over all featured events at top left corner, for example “Coming to The Music Shack”.

titlesize: Integer
Font size for title of event (Which includes automatically printed names of tagged artists)

numevents: Integer
Maximum number of events to load in the slider (absolute limit is 12).

background: Hex Code
Background color behind text, over image. Will automatically become partially translucent.

fallbackimage: URL
An image to be used for this featured event slide when the featured event image, event poster, and artist photos attached to tagged artists are not found.

How do I get the artist videos and music to appear?

There are over 10,000 artists currently listed on MusicIDB, many of which already have media attached to their artist listing. If you are entering a new artist, you can add their media by searching for them after tagging them on an event, then edit their Artist Library on MusicIDB.com and include the embed code from their media channels such as YouTube, Bandcamp, Soundcloud, etc.

Our team spends time each week improving the database, so in some cases you might find we have helped fill in missing information or media for certain artists.

Artists can also choose to update their own listings at their leisure, so they can contribute their latest release to their page, giving your website visitors the best possible experience to intice visitors to attend events.

Can I customize the list templates?

Yes! The plugin first checks a child theme, followed by a parent theme, and finally falls back to the templates provided in the plugin.

Inside of your theme, create a directory called ‘musicidb-calendar’. Then copy the template that you want to override into that directory. The list templates are in the plugin directory, under wp-content/plugins/musicidb-calendar, and the files you can override are:

  • musicidb-compact-events-list.php
  • musicidb-full-events-list.php
  • musicidb-event-detail.php

評價

2019年5月1日
The business of owning a venue that has live music can be very challenging because of the unorganized platforms used to find and book entertainers. This is a must have service that organizes everything music related from booking, to logging profits and data, to finding other bands and seeing whos popular with other people. Id recommend to anyone whos associated with this service from venues to entertainers themselves.
2019年4月3日 1 reply
The results for this plugin are outstanding. Small learning curve but easy to use. This plugin is a real game changer for increasing user time on your page. A must have plugin for any music venue.
閱讀全部2個評價

貢獻者及開發者

“MusicIDB Events Calendar” 是一個開源的軟體。以下的人對這個外掛作出了貢獻。

貢獻者

將 MusicIDB Events Calendar 外掛本地化為台灣繁體中文版。

對開發相關資訊感興趣?

任何人均可瀏覽程式碼、查看 SVN 存放庫,或透過 RSS 訂閱開發記錄

修改日誌

2.5.10

  • Tested up to WP 6.3.2
  • Tested up to PHP 8.2
  • Fixed WP Core styles overriding tab styles in Add Events modal
  • Added numevents shortcode attribute to the Event List shortcode
  • Fixed PHP 8.2 Deprecation warnings

2.5.9

  • Tested for WordPress 6.0
  • Modified featured events slider for adaptive height
  • Minor cleanups and improvements

2.5.8

  • Tested with latest WordPress versions
  • Improved some of the back-end code for validation

2.5.7

  • Fixed a theme conflict with load more button

2.5.6

  • Fixed a bug saving API key for first-time visitors

2.5.5

  • Resolved mobile issues for some cases

2.5.4

  • Improved styles on event list and event detail pop-up

2.5.3

  • Fixed a bug with the shortcode rendering properly

2.5.2

  • Improved some layout details on Artists View

2.5.0

  • Artist API Keys implemented
  • Artist simple event list view added
  • Support for multiple entities, you can add several venues or artists to any event list by finding the venue or artist ID from their search result URL on MusicIDB

2.0.0

  • Implemented MusicIDB API v2 with more efficient database queries and expandable options
  • Fixed same-day events from disappearing after 8pm due to server time issue
  • Improved security with escaping & sanitization improvements in all templates

1.4.3

  • Fixed bug with featured images appearing properly in event list

1.4.2

  • Fixed bug with connecting to API in some cases

1.4

  • Increased max image size for Featured Events slider
  • Errors no longer display when no events are upcoming
  • Lazy Loading Images

1.3

  • Introducing Featured Events Slider View & Shortcode

1.2

  • API Key Generator has been built and implemented (See Installation instructions if you need a key)
  • You can now click outside of the event details pop-up to close the pop-up
  • Scrolling is now disabled in the background when the event details pop-up is open
  • Fixed bug with Social Links not displaying for tagged artists on mobile view
  • Fixed bug on event details pop-up – for some themes, when multiple artists were tagged, the slider arrows were not visible to scroll between tagged artists’ media on desktop
  • Moved “Event Link” from event details pop-up to footer of pop-up as most information is already visible and users often do not need to click off and view the event on MusicIDB
  • Hiding double lines surrounding Facebook and Ticket Link in event details pop-up when there is no Facebook Link or Ticket link available
  • Several other minor improvements and fixes implemented

1.1

  • Fixed some non-SSL image references
  • Fixed duplicate image in footer on calendar view