Using the upcoming events gadget, you add a clickable list of upcoming events, with each event linking to a detailed description of the event.
Unlike an event calendar gadget that can display all events, including past ones, the upcoming event gadget displays only a limited number of upcoming events.
For each upcoming event, the gadget displays the event title, starting date and time, and location.
The events displayed in this gadget are automatically drawn from your events list. Whether an event appears in the gadget depends on the event visibility and the access restrictions set as part of the event settings, as well as the upcoming events gadget settings.
You can insert the upcoming events gadget into a page onto your site, or into a page template so that all pages that use that template will automatically display the gadget. For instructions on inserting, moving, and deleting gadgets, see Gadgets.
Upcoming events gadget settings
Using the gadget's settings, you can control its appearance and content.
For instructions on displaying gadget settings, see Gadgets.
The following settings are available for upcoming events gadgets:
Show next x events
Choose the number of upcoming events you want to display in the list.
Filter events by tag
You can filter the list of upcoming events so that it displays only events with certain event tags. To filter the list, check only those event tags you want represented in the list. To display events without an event tag, check the uncategorized check box.
Show restricted events to public
Choose whether to show events with restricted access to public visitors – those who are not signed in as members or administrators.
Text to show when there are no events
Specify the text to be displayed if there are no upcoming events to display in the list. Maximum 2,000 characters.
Gadget title
If you specify a gadget title, the title will appear specially formatted within the gadget. Depending on the gadget style you choose, the title may appear in a heading box.
For Casefile and Kaleidoscope themes, use a Headline gadget instead of specifying a gadget title.
Gadget style
The gadget style determines the physical appearance of the gadget. The style you choose will determine the color and format of the gadget title, the gadget content, and the gadget border. You can choose from theme-specific styles and styles that are common to all themes. For Terra and Firma themes, the Opacity 60% style results in a semi-transparent gadget background.
Margins
The amount of space – in pixels – that appears outside the gadget. You can set top, bottom, left, and right margins separately.
Padding
(Casefile and Kaleidoscope themes only) The amount of space – in pixels – that appears between the content of the gadget and the outer limits of the gadget. You can set top, bottom, left, and right padding separately. If you have set a fixed height for the gadget, the bottom padding will be ignored.
Advanced
Within the Advanced section, you can enter CSS code or classes to further control the appearance and behavior of the gadget. For more information, see Gadget settings.
Changing colors and fonts
You can change the colors, text styles, and backgrounds used in your website from the Colors and styles screen. For more advanced fine-tuning, you can use CSS customization and theme overrides.
For upcoming events gadgets, you can modify the following elements from the Colors and styles screen:
Gadget title
- General formatting or Typography > H4
- Gadgets or Gadget styles > Title
(Blueprint, Clean Lines, Dark Impact, Fiesta, Firma, Homestead, Showcase, Skyline, Terra, and White Space themes)
Event name/link
- General formatting or Typography > Text/Normal, Link
Date and location
- General formatting or Typography > Text/Normal
- Gadgets/Gadget styles > Location
(Blueprint, Building Blocks, Clean Lines, Dark Impact, Fiesta, Firma, Homestead, Kaleidoscope, Showcase, Skyline, Terra, Tinted Tiles, and White Space themes) - Typography > Location
(Bookshelf themes)
Any changes you make will be applied to other gadgets that use the same settings.
