Adds an 'event board' to display your events in a responsive posterboard.
Further documentation can be found at http://docs.wp-event-organiser.com/shortcodes/posterboard/.
To display the event posterboard simply use the shortcode [event_board]
on any page or post. Full width pages work best.
The shortcode supports the same arguments as the events list shortcode. This
includes the ability to display only a particular category, or events satisfying a certain query.
For example, to show events only for category “foobar”:
[event_board event_category="foobar"]
To show events starting in the comming 7 days
[event_board event_category="foobar"]
Most arguments supported by the [eo_events]
(see documentation) shortcode will also work with
posterboard. Please note that posts_per_page
should be used instead of
numberposts and the no_events
attributes is not supported.
E.g. to show events which start this week (week starting Monday), three at a time:
[event_board event_start_after="monday this week" event_start_before="sunday this week" posts_per_page=3]
You can add filters at the top of the event board to filter the events. Supported filters include:
For example
[event_board filters="state"]
You can display multiple filters by listing them as a comma delimited list
[event_board event_start_after="now" event_start_before="+1 week"]
You can edit the template used for the event board. See the FAQ.
Installation and set-up is standard and straight forward.
event-organiser-event-board
folder (and all it’s contents!) to the /wp-content/plugins/
directoryYes. By default the plug-in uses the template found in event-organiser-event-board/templates
.
Simply copy that template (single-event-board-item.html
) into your theme and edit it there. Please note
that the template uses underscore.js templating.
Yes, the following code in a plug-in/theme can disable (deregister) the stylesheet, and (optionally) register a replacement:
function my_custom_posterboard_styles(){ //Deregister default styles wp_deregister_style( 'eo_posterboard' ); //Optional, register "event-board.css" from your theme directory. wp_register_style( 'eo_posterboard', get_template_directory_uri() . '/event-board.css', array() ); } add_action( 'init', 'my_custom_posterboard_styles', 999 );
Alternatively you can use the setting in Settings > Event Organiser > General to disable all Event Organiser’s stylesheets. This may affect the
performance of some features if you do not provide your own styling in your theme.
For details on breaking changes and how to restore previous behaviour please see: http://wp-event-organiser.com/blog/announcements/event-organiser-posterboard-3-0-0/
* Breaking change: Filter behaviour is now reversed
* Breaking change: Mark-up has changed, multiple posterboards on one page is now supported
posts_per_page
attribute<%= event_content %>
now displays the event<%= event_excerpt %>
instead.suppress_filters
not set to false in query.eo-pb-
prefix.Initial release