Skip to content

emielwolter/bospop-timetable

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

89 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Bospop Timetable Plugin

The Bospop Timetable Plugin provides a comprehensive and flexible way to display the timetable for a music festival, showcasing artist details in a clear and customizable format. This plugin integrates seamlessly with WordPress and Elementor, allowing you to create visually appealing timetables.

Features

  • Display festival timetable with artist details.
  • Various layout options: vertical, horizontal, and A-Z list.
  • Vertical/Horizontal view toggle
  • Fully responsive design.
  • Customizable colors, typography, and border styles for hours, stages, and artists.
  • Easy integration with Elementor page builder.
  • Supports custom post types and taxonomies.

Installation

  1. Download the plugin zip file.
  2. Navigate to Plugins > Add New in your WordPress dashboard.
  3. Click Upload Plugin and select the downloaded zip file.
  4. Click Install Now and then Activate the plugin.

Shortcode Usage

To display the timetable, use the [bospop_timetable] shortcode. The shortcode accepts the following attributes:

  • date (required): The date of the festival in the format d/m/Y.
  • layout (optional): The layout of the timetable, either horizontal, vertical or a-z. Default is vertical.
  • date_format (optional): The format of the date in the database. Default is d/m/Y.
  • time_format (optional): The format of the time in the database. Default is H:i.
  • post_type (optional): The custom post type to display. Default is artist.
  • taxonomy (optional): The taxonomy for stages. Default is stage.
  • stages (optional): Comma-separated term IDs for the stages.
  • starttime_field (optional): The custom field name for start time. Default is starttime.
  • endtime_field (optional): The custom field name for end time. Default is endtime.
  • date_field (optional): The custom field name for date. Default is date.
  • artist_name_field (optional): The custom field name for artist name. Default is post_title.

Example Shortcodes

[bospop_timetable date="25/07/2024" layout="vertical"]

Elementor Integration

Registering the Widget

To register the Bospop Timetable Widget in Elementor:

  1. Ensure Elementor is installed and activated.
  2. The widget will be automatically registered with Elementor upon plugin activation.

Widget Controls

The Bospop Timetable Widget includes the following controls:

General Settings

  • Layout: Choose between Horizontal and Vertical layouts.
  • Date: Select the festival date.
  • Date Format: Specify the date format used in the database.
  • Time Format: Specify the time format used in the database.

Data Settings

  • Post Type: Select the custom post type to display.
  • Stages Taxonomy: Select the taxonomy for stages.
  • Stages: Enter the term IDs for the stages, comma-separated.
  • Start Time Field: Enter the custom field name for start time.
  • End Time Field: Enter the custom field name for end time.
  • Date Field: Enter the custom field name for date.
  • Artist Name Field: Enter the custom field name for artist name.

Style Settings

Hours
  • Hour Background Color: Set the background color for hour labels.
  • Hour Text Color: Set the text color for hour labels.
  • Hour Typography: Customize the typography for hour labels.
  • Hour Border Color: Set the border color for hour labels.
  • Hour Border Radius: Adjust the border radius for hour labels.
Stage
  • Stage Background Color: Set the background color for stage headers.
  • Stage Text Color: Set the text color for stage headers.
  • Stage Typography: Customize the typography for stage headers.
  • Stage Border Color: Set the border color for stage headers.
  • Stage Border Thickness: Adjust the border thickness for stage headers.
  • Stage Border Radius: Adjust the border radius for stage headers.
Artist
  • Artist Background Color: Set the background color for artist blocks.
  • Artist Border Color: Set the border color for artist blocks.
  • Artist Border Thickness: Adjust the border thickness for artist blocks.
  • Artist Border Radius: Adjust the border radius for artist blocks.
  • Artist Text Color: Set the text color for artist blocks.
  • Artist Typography: Customize the typography for artist blocks.
  • Time Text Color: Set the text color for time labels.

Changelog

1.3.2

  • Merged vertical and horizontal logic
  • Sticky stage names

1.3.1

  • Fixed Elementor style controls

1.3

  • Added timetable view toggle

1.2.1

  • Fixed artist block size calculations when horizontal and vertical template are on the same page

1.2

  • Combined horizontal and vertical templates
  • Unified classes

1.1

  • Added a new layout option a-z to display an alphabetical list of artists.

1.0

  • Initial release.

Author: Emiel Wolter Version: 1.3.2