Event Organiser Posterboard

May 26, 2021

Event Organiser Posterboard Plugin

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/.

Basic Usage

To display the event posterboard simply use the shortcode [event_board] on any page or post. Full width pages work best.

Advanced Usage

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] 

Filters

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

Installation and set-up is standard and straight forward.

  1. Upload event-organiser-event-board folder (and all it’s contents!) to the /wp-content/plugins/ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. Add the shortcode to a page.

Screenshots

  1. Event posterboard

    Event posterboard

  2. Event posterboard

    Event posterboard

FAQ

Can I change the content of the event boxes?

Yes. 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.

Can I disable/change the styling?

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.

Changelog

3.0.1 – 13th September 2016

  • Fixed a bug where the ‘Loading…’ text did not revert to ‘Load more’

3.0.0 – 9th September 2016

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

2.1.0 – 18th July 2016

  • Added support for translations
  • Added filter for the posterboard query and added context attribute
  • The featured image now links to the event
  • Added French translation

2.0.1 – 6th April 2015

  • Fixed bug with posts_per_page attribute

2.0.0

  • Breaking change (for those using customised templates): <%= event_content %> now displays the event
    content not excerpt. Use <%= event_excerpt %> instead.
  • Fixes grid not refreshed after images loaded (can cause board items to overlap).
  • Fixes suppress_filters not set to false in query.

1.1.0

  • Supports query arguments. E.g. [event_board event_start_after=”now” event_start_before=”+1 week”]. See readme for details.
  • Allows stylesheet to be replaced/disabled (see FAQ)
  • Disables stylesheet if this option is set in Settings > Event Organiser > General

1.0.2

  • Fixes bug on some installs where the “load more” bar does not appear.
  • Fixes rogue “dot” appearing
  • Added Hungarian translation (thanks to Daniel Kocsis).

1.0.1

  • Renamed classes to use eo-pb- prefix.
  • Fixed bug where draft events appeared on the board.
  • Fixed bug where ‘load more’ would appear when there were fewer than 10 events.
  • Corrected documentation in readme

1.0.0

Initial release

Details

  • Version: 3.0.1
  • Active installations: 2,000
  • WordPress Version: 3.3
  • Tested up to: 5.7.12

Ratings


5 Stars
4 Stars
3 Stars
2 Stars
1 Stars