Using the Shortcode

The shortcode is only available on the Pro version.

the basic shortcode is

[wfea]

Layouts

The Pro plugin comes with 7 default layouts.1 – ( the default ) which is full page width and CSS that works well with Genesis and TwentySeventeen among others

divi – built to use the divi theme classes to pick up button design

grid – a responsive grid format based on the default themes

divigrid – a responsive grid suitable for divi

cal – uses a calendar layout –  ( language translation will be attempted automatically see note here about languages )

cal_list  a monthly calendar view in list format

widget – uses the same layout as the widget

You can define which layout is used like this, different layouts may warrant different total number of events ( limit )

[wfea layout='1']
[wfea layout='divi']
[wfea layout='grid' limit='6']
[wfea layout='divigrid' limit='9']
[wfea layout='cal' limit='9999']
[wfea layout='cal_list'  limit='9999']

Which can be used on pages or post as appropriate.

There are many additional shortcode options giving you flexibility to chose what you need. You can see many examples of these in action on the demo website.

booknow [default true] (true or false) if true displays a call to action button

booknow_text [default Register »] (text) text for the call to action button

content [default false] (true or false) setting content=’true’ will display the HTML markup from Eventbrite, and the excerpt, length, readmore and readmore_text parameters will be ignored

cssID: [default nothing] (text) sets the CSS ID for the whole section, used by developers

css_class: [default nothing] (text) sets and additional CSS class for the whole section, used by developers

date  [default true] (true or false) if true displays the date / time of the event

debug: [default false] (true or false) displays a dump of all your selected events, useful if you are having trouble finding out organizer_id or venue_id, or extending one of the default templates.

excerpt [default true] (true or false) if true an excerpt of the Summary on Eventbrite will be displayed – please note Eventbrite UI provides the Summary description to the API, this is limited by Eventbrite to 140 characters. If you want the full description set long_description to true.

filter_location [default nothing] (text / encoded regex ) filter_allows allows you to filter on the location name in the same manner as filtering the title above.

filter_title [default nothing] (text / encoded regex ) filter_title allows you to select just events where the title matches this filter. The filter can be a simple text string e.g. Singing which will display all events with Singing anywhere in the title.  Note this is case sensitive. You can also use a regex without the delimiters ( if you want to use delimiters use / )e.g. /singing/i for case insensitive or ^ Singing  for all titles staring with Singing  or  ^(Singing|Shouting) for example using regex or structure etc or any regex features ( you can check your regex at sites like https://regex101.com/ ). Except as regex can include [ ] a.g  ^[Ss]inging   the reg ex has to be url-encoded –  you can use the input field below to generate the encoded field  e.g.   ^[Ss]inging becomes %5E%5BSs%5Dinging

Regular expressions (regex) are very powerful, for instance you can use them to filter out strings too, e.g. ^((?!badword).)*$  see https://www.regextester.com/95714 for a useful testing tool.

layout [default 1] (text)  defines the layout template, this is an advanced developer feature to allow custom templates.

length [default 50]  ( +ve integer ) the number of words of description to display ( length will be ignored if you set content to true to get the full html )

limit  [default 5] ( +ve integer ) sets the number of events to display, the soonest first, good idea on calendar layouts to set this to a large number like 9999

long_description: [default false] Use the long description rather than summary ( only use this for the new interface where you get both summary and full description options ), optionally you may want to use this when content=’true’ to get the HTML markup.

newtab [default false]  (true or false) if true any clicked link will be open in a new tab

order_by: [default asc] (text  asc | desc) asc = ascending date, desc = descending   – useful if showing events in the past see demo here

organizer_id: [default nothing]  (integer) limit to a specific organiser id if you have several – finding the organizer_id isn’t simple as you need the internal number – this guide( Finding Organizer Id) is one way to get that information.

popup [default false] (true or false) if popup=’true’ all click actions ( except readmore ) will open a ticket purchase popup / modal on your site. Additionally the tickets and newtab parameters are ignored ( Please note: it is not possible to embed the full checkout process into a popup due to restrictions imposed by Eventbrite on framing their website )

readmore [default true] (true or false) if true will display a read more link after excerpt

readmore_text [default Read More »] (text) text for the read more link

search: [default nothing] keyword(s) to search across titles, location names and  description

start_date_range_start  & start_date_range_end [default none] (date strings) always use a start and end pair or it will be ignored.   The date range can (and should) be relative  e.g. start_date_range_start=’-3 months’ start_date_range_end=’+1 year’   would show the prior 3 months and the next year  ( would require also status=’ended,started,live’ )

status: [default live] (text  live,started,ended,cancelled,draft,all ) comma separated list of event status, e.g. if you want prior events used ended,started

tickets  [default false]  (true or false) default is false, if true the call to action button link goes straight to the ticket pop up on the Eventbrite page

thumb [default true] (true or false) if true displays the thumbnail image from Eventbrite, please note Eventbrite only provide an image limited in size ( approx 400px to 450px depending on various factors ), bear this in mind when designing wide layouts. They do not currently have a ‘hero’ image size.

thumb_align [default eaw-aligncenter(true or false) Widget Template Only – class for the thumbnail image alignment, preset values are eaw-alignleft, eaw-aligncenter, eaw-alignleft.

thumb_default [default https://placehold.it/600×400/f0f0f0/ccc] (text url) link to a default image that will be used if no image provided by Eventbrite. You may need to adjust this to suit your template.

thumb_width [default 300 ] (integer) Widget Template Only – sets the thumbnail width as in the way the widget can

venue_id : [default nothing]  (integer) limit to a specific venue id – finding the venue_id isn’t simple as you need the internal number – this guide( Finding Venue Id) is one way to get that information.

widgetwrap [default true ] (true or false) Widget Template Only – add an additional widget wrapper around the output to use the default widget style – when the shortcode is used in an article. Set to false if the shortcode is used in a text widget or you are custom styling.

Was this helpful?