Below, you’ll find a detailed guide on how to add the Spiffy Calendar Shortcodes to your WordPress website, including their parameters, examples, and PHP function code. Additionally, we’ll assist you with common issues that might cause the Spiffy Calendar Plugin shortcodes not to show or not to work correctly.
Before starting, here is an overview of the Spiffy Calendar Plugin and the shortcodes it provides:
"Spiffy Calendar is a fully customizable and feature-rich WordPress plugin. It allows you to design, manage, and display your events in a user-friendly calendar format on your website."
- [spiffy-calendar]
- [spiffy-minical]
- [spiffy-upcoming-list]
- [spiffy-todays-list]
- [spiffy-week]
Spiffy Calendar [spiffy-calendar] Shortcode
The Spiffy-Calendar shortcode is a functional tool that inserts a calendar into your WordPress site. This shortcode enqueues necessary scripts and styles, extracts attributes like ‘title’ and ‘cat_list’, and applies filters to the calendar output. It allows customization of the calendar view based on the category list and title.
Shortcode: [spiffy-calendar]
Parameters
Here is a list of all possible spiffy-calendar shortcode parameters and attributes:
title
– sets a specific title for the calendar displaycat_list
– defines the category list for the calendar events
Examples and Usage
Basic example – A simple usage of the ‘spiffy-calendar’ shortcode without any additional parameters. This will display the calendar with its default settings.
[spiffy-calendar /]
Advanced examples
Using the ‘spiffy-calendar’ shortcode with the ‘title’ attribute. This will display the calendar with a custom title.
[spiffy-calendar title="My Custom Calendar" /]
Using the ‘spiffy-calendar’ shortcode with the ‘cat_list’ attribute. This will display the calendar filtered by the specified category list.
[spiffy-calendar cat_list="1,2,3" /]
Using the ‘spiffy-calendar’ shortcode with both ‘title’ and ‘cat_list’ attributes. This will display the calendar with a custom title and filtered by the specified category list.
[spiffy-calendar title="My Custom Calendar" cat_list="1,2,3" /]
PHP Function Code
In case you have difficulties debugging what causing issues with [spiffy-calendar]
shortcode, check below the related PHP functions code.
Shortcode line:
add_shortcode('spiffy-calendar', array($this, 'calendar_insert'));
Shortcode PHP function:
function calendar_insert($attr)
{
global $spiffy_calendar_views;
$this->enqueue_frontend_scripts_and_styles();
/*
** Standard shortcode defaults that we support here
*/
extract(shortcode_atts(array(
'title' => '',
'cat_list' => '',
), $attr));
$cal_output = apply_filters ('spiffycal_calendar', $spiffy_calendar_views->calendar($cat_list, $title), $attr);
return $cal_output;
}
Code file location:
spiffy-calendar/spiffy-calendar/spiffy-calendar.php
Spiffy Calendar [spiffy-minical] Shortcode
The Spiffy Calendar plugin shortcode ‘spiffy-minical’ is designed to insert a miniature calendar on your page. This PHP function allows you to customize the calendar’s title and category list. It enqueues front-end scripts and styles, extracts the shortcode attributes, and generates the calendar output.
Shortcode: [spiffy-minical]
Parameters
Here is a list of all possible spiffy-minical shortcode parameters and attributes:
title
– Defines the title of the mini calendar.cat_list
– Determines the category list to be displayed on the mini calendar.
Examples and Usage
Basic example – Displays a spiffy mini calendar without any specific category or title.
[spiffy-minical /]
Advanced examples
Display a spiffy mini calendar with a specific title. The title will be displayed above the calendar.
[spiffy-minical title='My Spiffy Calendar' /]
Display a spiffy mini calendar with events from a specific category. The category is referenced by its ID.
[spiffy-minical cat_list='5' /]
Display a spiffy mini calendar with a specific title and events from multiple categories. The categories are referenced by their IDs, separated by commas.
[spiffy-minical title='My Spiffy Calendar' cat_list='5,6,7' /]
PHP Function Code
In case you have difficulties debugging what causing issues with [spiffy-minical]
shortcode, check below the related PHP functions code.
Shortcode line:
add_shortcode('spiffy-minical', array($this, 'minical_insert'));
Shortcode PHP function:
function minical_insert($attr) {
global $spiffy_calendar_views;
$this->enqueue_frontend_scripts_and_styles();
/*
** Standard shortcode defaults that we support here
*/
extract(shortcode_atts(array(
'title' => '',
'cat_list' => '',
), $attr));
$cal_output = $spiffy_calendar_views->minical($cat_list, $title);
return $cal_output;
}
Code file location:
spiffy-calendar/spiffy-calendar/spiffy-calendar.php
Spiffy Calendar [spiffy-upcoming-list] Shortcode
The Spiffy Calendar shortcode ‘spiffy-upcoming-list’ is designed to display a list of upcoming events. The attributes include title, category list, limit, style, none found, and number of columns.
Shortcode: [spiffy-upcoming-list]
Parameters
Here is a list of all possible spiffy-upcoming-list shortcode parameters and attributes:
title
– sets the title displayed above the upcoming events listcat_list
– filters the events by specific categorieslimit
– restricts the number of upcoming events shownstyle
– defines the appearance of the upcoming events listnone_found
– customizes the message displayed when no events are foundnum_columns
– determines the number of columns in the upcoming events list
Examples and Usage
Basic example – Displays an upcoming events list using the ‘spiffy-upcoming-list’ shortcode without any specific parameters. The events will be displayed based on the plugin’s default settings.
[spiffy-upcoming-list /]
Advanced examples
Displays an upcoming events list with a specific title, ‘Upcoming Concerts’. The title will be displayed above the event list.
[spiffy-upcoming-list title='Upcoming Concerts' /]
Displays an upcoming events list with events from a specific category. The ‘cat_list’ parameter is used to specify the category by its ID, in this case, ‘3’.
[spiffy-upcoming-list cat_list='3' /]
Displays an upcoming events list with a limit to the number of events displayed. The ‘limit’ parameter is used to set this limit, in this case, ‘5’ events will be displayed.
[spiffy-upcoming-list limit='5' /]
Combines multiple parameters to display an upcoming events list with a specific title, from a specific category, and with a limit to the number of events displayed.
[spiffy-upcoming-list title='Upcoming Concerts' cat_list='3' limit='5' /]
PHP Function Code
In case you have difficulties debugging what causing issues with [spiffy-upcoming-list]
shortcode, check below the related PHP functions code.
Shortcode line:
add_shortcode('spiffy-upcoming-list', array($this, 'upcoming_insert'));
Shortcode PHP function:
function upcoming_insert($attr) {
global $spiffy_calendar_views;
$this->enqueue_frontend_scripts_and_styles();
/*
** Standard shortcode defaults that we support here
*/
extract(shortcode_atts(array(
'title' => '',
'cat_list' => '',
'limit' => '',
'style' => '',
'none_found' => '',
'num_columns' => '',
), $attr));
$cal_output = '';
if ($title != '') {
$cal_output .= '<h2>' . esc_html($title) . '</h2>';
}
$cal_output .= '<div class="spiffy page-upcoming-events spiffy-list-' . $style . '">'
. $spiffy_calendar_views->upcoming_events($cat_list, $limit, $style, $none_found, $title, $num_columns)
. '</div>';
return $cal_output;
}
Code file location:
spiffy-calendar/spiffy-calendar/spiffy-calendar.php
Spiffy Calendar [spiffy-todays-list] Shortcode
The Spiffy Calendar shortcode is a powerful tool that allows you to display today’s events on your website. This shortcode fetches and lists today’s events from the Spiffy Calendar. It supports customization options like title, category list, limit, style, show date, and more. The output is wrapped in a div with a custom class for easy styling.
Shortcode: [spiffy-todays-list]
Parameters
Here is a list of all possible spiffy-todays-list shortcode parameters and attributes:
title
– customizes the title displayed above the events listcat_list
– filters the events based on specific categorieslimit
– sets the maximum number of events displayedstyle
– applies a specific styling to the events listshow_date
– decides whether to display the event date or notnone_found
– custom message when no events are foundnum_columns
– sets the number of columns for the events list
Examples and Usage
Basic example – A simple usage of the shortcode to display today’s events.
[spiffy-todays-list /]
Advanced examples
Displaying today’s events with a specific title, and limiting the number of events to 5.
[spiffy-todays-list title="Today's Top Events" limit=5 /]
Showing today’s events from a specific category (e.g., category id is 3), and displaying the date for each event.
[spiffy-todays-list cat_list=3 show_date="true" /]
Displaying today’s events in a specific style (e.g., style id is ‘modern’) and arranging them in 3 columns.
[spiffy-todays-list style="modern" num_columns=3 /]
Showing a custom message when no events are found for today.
[spiffy-todays-list none_found="No events for today, check back tomorrow!" /]
PHP Function Code
In case you have difficulties debugging what causing issues with [spiffy-todays-list]
shortcode, check below the related PHP functions code.
Shortcode line:
add_shortcode('spiffy-todays-list', array($this, 'todays_insert'));
Shortcode PHP function:
function todays_insert($attr) {
global $spiffy_calendar_views;
$this->enqueue_frontend_scripts_and_styles();
/*
** Standard shortcode defaults that we support here
*/
extract(shortcode_atts(array(
'title' => '',
'cat_list' => '',
'limit' => '',
'style' => '',
'show_date' => 'false',
'none_found' => '',
'num_columns' => '',
), $attr));
$cal_output = '';
if ($title != '') {
$cal_output .= '<h2>' . esc_html($title) . '</h2>';
}
$cal_output .= '<div class="spiffy page-todays-events spiffy-list-' . $style . '">'
. $spiffy_calendar_views->todays_events($cat_list, $limit, $style, $show_date, $none_found, $title, $num_columns)
. '</div>';
return $cal_output;
}
Code file location:
spiffy-calendar/spiffy-calendar/spiffy-calendar.php
Spiffy Calendar [spiffy-week] Shortcode
The Spiffy Calendar plugin shortcode is designed to display a weekly calendar view on your website. It enqueues frontend scripts and styles, and supports customization of the title and category list. The output is a weekly calendar view based on the specified parameters.
Shortcode: [spiffy-week]
Parameters
Here is a list of all possible spiffy-week shortcode parameters and attributes:
title
– sets the title displayed on the weekly calendar viewcat_list
– specifies categories to include in the weekly calendar
Examples and Usage
Basic example – Displays the weekly calendar without any specific category or title.
[spiffy-week]
Advanced examples
Displaying the weekly calendar with a specific title, but without any category.
[spiffy-week title="My Weekly Calendar"]
Displaying the weekly calendar with a specific category, but without any title.
[spiffy-week cat_list="5"]
Displaying the weekly calendar with both a specific title and category.
[spiffy-week title="My Weekly Calendar" cat_list="5"]
In these advanced examples, replace “My Weekly Calendar” with your desired calendar title, and “5” with your desired category ID. The shortcode will generate a weekly calendar view filtered by these parameters.
PHP Function Code
In case you have difficulties debugging what causing issues with [spiffy-week]
shortcode, check below the related PHP functions code.
Shortcode line:
add_shortcode('spiffy-week', array($this, 'weekly_insert'));
Shortcode PHP function:
function weekly_insert($attr) {
global $spiffy_calendar_views;
$this->enqueue_frontend_scripts_and_styles();
/*
** Standard shortcode defaults that we support here
*/
extract(shortcode_atts(array(
'title' => '',
'cat_list' => '',
), $attr));
$cal_output = $spiffy_calendar_views->weekly($cat_list, $title);
return $cal_output;
}
Code file location:
spiffy-calendar/spiffy-calendar/spiffy-calendar.php
Conclusion
Now that you’ve learned how to embed the Spiffy Calendar Plugin shortcodes, understood the parameters, and seen code examples, it’s easy to use and debug any issue that might cause it to ‘not work’. If you still have difficulties with it, don’t hesitate to leave a comment below.
Leave a Reply