The Events Feed Theme block is used with the Events feature within the WordPress theme. You can choose to dynamically display events, or manually choose which events to display.
Events Feed Block Guidelines
- Follow all Image and Media Requirements and Best Practices. If you are creating events using The Events Calendar plugin in WordPress for use in an Events Feed block, ensure that images in the event do not contain text or that all of the relevant event information is included as text web content in the event.
- Review the Recommendations for Accessible Theme Blocks page to learn more about requirements for headings, images, links, and media published in this block.
- Use of this block for an undocumented purpose or in a non-standard way is discouraged and may not be supported.
How to Configure the Events Feed Block
- In the page editor, click on the blue box with the plus sign located at the top left of the page. The alternative text for this link is called “toggle block inserter”. This will open a menu of available blocks to select from.
- A list of blocks sorted into 6 groups will be displayed. Scroll down to the group called THEME and click on the block called Events Feed. This will add the block to the page.
- Each block comes with its own toolbar that appears on top of the block. The buttons change depending on the block. This is what the Events Feed toolbar looks like:
- Note: To move the block text fields from the narrow right column to the middle of the editor, go to the block’s toolbar and click on the pencil icon. This will move the fields to the middle of the page. If you want to preview the page as you are building it, click on the monitor icon and the text fields will move back to the right side of the editor. You can toggle between these two options.
Content Fields
- Title: Content entered here will appear as the Events Feed block heading.
- Description: Enter a brief, optional description for the events feed. Note that to keep the Events Feed block optimized for mobile display, text entered in the Description field will not display on small screen sizes. Do not include critical information or instructions in this field.
- All Events Link: Use this option to link to your main events page. You can use either the https:// address of your main events page, or simply your site’s primary website address (e.g., boisestate.edu/news). Staying in the same tab is recommended.
- Data Source: If you’re displaying events configured on your website, choose the “Local Events” option. If you’re pulling in events from another Boise State website, choose either the JSON or RSS option (note that you may need assistance from the WordPress Support team to determine the feed addresses for the JSON or RSS options).
- Local Posts > Manual: This option allows you to specifically choose which event items you’d like to appear in the block. Minimum is 5, maximum is 11. Click on the word “Select” in the Events box. When you do this all available events will appear in a dropdown menu. If you are looking for a specific event, begin typing a keyword for your event to narrow the list to choose from or to find your specific event. Keywords are based on the event title. Click and drag events to desired order.
- Local Posts > Dynamic: This option will dynamically pull your site’s events into the block and display them in descending, reverse chronological order. The Content Type – dropdown should say “Events”. For Max Results – choose the maximum number of event items to display. For Event Categories – if categories were created, the category options will display. By default all event categories will display in the block unless you limit the display by selecting the categories. You can filter events by categories, tags or date.
Settings Fields
- Custom Language: The default language is English. Language options will generate markup signifying that content as being in the selected language.
- Presentation: Select whether the content should display as cards or a list.
- Accent Color: Select either orange or blue.
- Title Color: This selection determines the color of your block title heading. The default selection is black. The choices are black, orange, or blue.
- Layout: Select Five-Up, Seven-Up or Eleven-Up depending on the number of events you would like to display. Note that each event title in the block will be marked as a heading and will be read out to assistive technology users who are scanning through the headings on the page. Perform a review of all the headings on your page to make sure the headings are easily scannable and that all users can quickly access the most relevant and important content on your page.
- Heading Size: The block title will appear on the page as H2. Do not change this to H1 unless otherwise directed.
- Add Top Padding: Defaults to Yes, which means there is the standard empty space above the block. You can change it to No if you want less empty space, but the recommendation is to leave it set to Yes.
- Add Bottom Padding: Defaults to Yes, which means there is the standard empty space below the block. You can change it to No if you want less empty space, but the recommendation is to leave it set to Yes.
Example Events Feed Block
This is an example Events Feed block displaying events from the University events calendar.
Graduate Defense: Sandra Velazco Salvatierra
Nov 21
Dissertation Defense
Graduate Defense: Sandra Velazco Salvatierra
Bronco Percussion Group Fall Concert
Nov 21
Department of Music