MusicIDB Events Calendar

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.

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

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.

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.

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.

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.

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