{"id":1896551,"date":"2019-10-18T13:19:26","date_gmt":"2019-10-18T17:19:26","guid":{"rendered":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/configuring-the-event-list-widget\/"},"modified":"2025-03-31T09:06:07","modified_gmt":"2025-03-31T13:06:07","slug":"configuring-the-event-list-widget","status":"publish","type":"post","link":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/configuring-the-event-list-widget\/","title":{"rendered":"Events List Widget Settings"},"content":{"rendered":"\n<p>We&#8217;re going to go over the Events List Widget in this tutorial, including how to configure it, things to expect from it, and perhaps some tips and tricks you can use at your next cocktail party. You&#8217;ll be the star of the show, for sure.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"adding\">Adding the Widget to a Sidebar<\/h2>\n\n\n\n<p>The first thing to note about the Events List widget is where to find it. The widget&nbsp;comes packaged with the core version of <a href=\"https:\/\/theeventscalendar.com\/product\/wordpress-events-calendar\/\" target=\"_blank\" rel=\"noreferrer noopener\">The Events Calendar<\/a> (free). You&#8217;ll find it in <strong>Appearance &gt; Widgets<\/strong> from the WordPress dashboard.&nbsp;<\/p>\n\n\n\n<p>You can use this widget to display your calendar on pages other than your default events page. Drag that little guy into the sidebar area of your choice, and you&#8217;re off to the races!<\/p>\n\n\n\n<figure class=\"wp-block-image size-large is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"488\" src=\"https:\/\/images.theeventscalendar.com\/kb\/uploads\/2019\/10\/events-list-free-1024x488.png\" alt=\"\" class=\"wp-image-1964774\" style=\"aspect-ratio:1.6797385620915033;width:1004px;height:auto\" srcset=\"https:\/\/images.theeventscalendar.com\/kb\/uploads\/2019\/10\/events-list-free-1024x488.png 1024w, https:\/\/images.theeventscalendar.com\/kb\/uploads\/2019\/10\/events-list-free-300x143.png 300w, https:\/\/images.theeventscalendar.com\/kb\/uploads\/2019\/10\/events-list-free-768x366.png 768w, https:\/\/images.theeventscalendar.com\/kb\/uploads\/2019\/10\/events-list-free.png 1098w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"settings\">Events Widget Settings<\/h2>\n\n\n\n<p>There are three settings that help customize the Events List widget experience. Let&#8217;s take a look at them:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Title:<\/strong> This is the heading that sits above the widget. By default, this is &#8220;Upcoming Events,&#8221; but it can be changed to anything you&#8217;d like.<\/li>\n\n\n\n<li>Show: This is the maximum number of events you want to display at any given time. Five is the default, but this can be any number between one and ten.<\/li>\n\n\n\n<li>Hide this widget if there are no upcoming events:&nbsp;Check the box for this option and the widget will automatically hide itself if there are no relevant events to list. Otherwise, it will display a handy notice saying there are no upcoming events at this time.<\/li>\n\n\n\n<li>Limit to featured events only:&nbsp;Check the box for this option, and the widget will display <a href=\"https:\/\/staging.theeventscalendar.com\/knowledgebase\/k\/featured-events\/\" target=\"_blank\" rel=\"noreferrer noopener\">featured events<\/a>.<\/li>\n\n\n\n<li><strong>Generate JSON-LD data:<\/strong> Enable this setting if you would like to enable <a href=\"https:\/\/developers.google.com\/search\/docs\/data-types\/events\" target=\"_blank\" rel=\"noreferrer noopener\">structured data<\/a> in the widget. Structured data is what search engines use to recognize calendar content on and display events in the search results if the data is there and processed by the search engine.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Block Editor Widget<\/h2>\n\n\n\n<p>When using the Block Editor, you can add the Events List as a block instead. Simply search for Events List under blocks, and you&#8217;ll find all of the same available options.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img decoding=\"async\" src=\"https:\/\/images.theeventscalendar.com\/kb\/uploads\/2021\/11\/Screen-Shot-2021-11-15-at-2.22.23-PM.png\" alt=\"Events List block\" class=\"wp-image-1951274\"\/><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"configuring\">Configuring the Pro Version<\/h2>\n\n\n\n<p>It&#8217;s important to bear&nbsp;in mind that the Events List widget in <a href=\"https:\/\/theeventscalendar.com\/product\/wordpress-events-calendar-pro\/\" target=\"_blank\" rel=\"noreferrer noopener\">The Events Calendar Pro<\/a> is the same widget that comes with the core version of The Events Calendar. If you have Pro, you&#8217;ll see the same Events List widget under <strong>Appearance &gt; Widgets<\/strong>. In your frontend the Widget will have the same appearance; the only difference is that you have some more filtering options available to set up this.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large is-resized\"><img decoding=\"async\" src=\"\/knowledgebase\/wp-content\/uploads\/2020\/12\/the-events-calendar-event-list-widget.png\" alt=\"Event List Widget in The Events Calendar vs Events Calendar Pro\" class=\"wp-image-1948528\" style=\"width:677px;height:678px\"\/><\/figure>\n\n\n\n<p>As you can see, there are more&nbsp;configurable options when setting up the Pro widget. Add the widget to the sidebar the same way as described above, and now you&#8217;ll see more options. In addition to the same three options in the basic widget, Pro introduces these settings:<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"624\" src=\"https:\/\/images.theeventscalendar.com\/kb\/uploads\/2019\/10\/sidebar-events-list-1024x624.png\" alt=\"\" class=\"wp-image-1964772\" srcset=\"https:\/\/images.theeventscalendar.com\/kb\/uploads\/2019\/10\/sidebar-events-list-1024x624.png 1024w, https:\/\/images.theeventscalendar.com\/kb\/uploads\/2019\/10\/sidebar-events-list-300x183.png 300w, https:\/\/images.theeventscalendar.com\/kb\/uploads\/2019\/10\/sidebar-events-list-768x468.png 768w, https:\/\/images.theeventscalendar.com\/kb\/uploads\/2019\/10\/sidebar-events-list.png 1149w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Display:<\/strong>&nbsp;This is a set of checkboxes that allow you to toggle the display of different bits of information, including:\n<ul class=\"wp-block-list\">\n<li>Venue<\/li>\n\n\n\n<li>Organizer<\/li>\n\n\n\n<li>Street<\/li>\n\n\n\n<li>City <\/li>\n\n\n\n<li>State (US) or Province (Int)<\/li>\n\n\n\n<li>Postal Code<\/li>\n\n\n\n<li>Country<\/li>\n\n\n\n<li>Venue Phone<\/li>\n\n\n\n<li>Price <\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Filter:<\/strong> This is an advanced setting that allows you to filter the events that display in the widget by a number of variables, including Categories and Tags. You can add multiple filters and also multiples instances of the widget- so if you wanted, you could have different widgets for different Event categories<\/li>\n<\/ul>\n\n\n\n<p>Please note that all that settings are responsible only for properly loading events from your database. They don&#8217;t add or remove any visual information in the Widget!<\/p>\n\n\n\n<p>Phew, that&#8217;s a lot of stuff! You really have a lot of options here to customize the widget&#8217;s content without touching a line of code, and that&#8217;s awesome.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Theming the Widget<\/h2>\n\n\n\n<p>We actually have <a href=\"https:\/\/staging.theeventscalendar.com\/knowledgebase\/add-event-content-to-an-event-widget\" target=\"_blank\" rel=\"noreferrer noopener\">another tutorial<\/a> that provides a specific example of how to customize the Events List widget, as well as a <a href=\"https:\/\/staging.theeventscalendar.com\/knowledgebase\/k\/styling-events-widgets\/\" target=\"_blank\" rel=\"noreferrer noopener\">guide to the stylesheets and classes<\/a> used in our widgets.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"V2\">Using Calendar Views<\/h3>\n\n\n\n<p>The template for the core Events List widget can be found at: <code>\/plugins\/the-events-calendar\/src\/views\/v2\/widgets\/widget-events-list.php<\/code>. This single file contains all the content and functionality for the widget. To override it, make a copy of it, then:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Make a new folder in the theme directory called&nbsp;<em>tribe<\/em><\/li>\n\n\n\n<li>Inside the new <em>tribe<\/em> folder make a new folder called <em>events<\/em><\/li>\n\n\n\n<li>Inside events folder, make a folder called <em>v2<\/em><\/li>\n\n\n\n<li>Make a folder in that one called&nbsp;<em>widgets<\/em><\/li>\n\n\n\n<li>Drop the&nbsp;widget-events-list.php copied file in that last folder<\/li>\n<\/ul>\n\n\n\n<p>Now that the template is in the theme, you can modify it to your liking. For example, you can customize&nbsp;the notice for when there are no upcoming events by changing this line:<\/p>\n\n\n<div class=\"wp-block-syntaxhighlighter-code \"><pre class=\"brush: php; gutter: false; title: ; notranslate\" title=\"\">\n&lt;?php $this-&gt;template( &#039;components\/messages&#039; ); ?&gt;\n<\/pre><\/div>\n\n\n<p>&#8230;to something like:<\/p>\n\n\n<div class=\"wp-block-syntaxhighlighter-code \"><pre class=\"brush: php; gutter: false; title: ; notranslate\" title=\"\">\n &lt;p&gt; No events here. Holla! &lt;\/p&gt;\n<\/pre><\/div>\n\n\n<p>The process for customizing the widget in Events Calendar Pro is very similar. Actually both Free and Pro version of The Events Calendar uses the same file to displays the widget. The main difference here is that Pro version gives you more filtering options in WordPress dashboard.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"h-remove-the-end-date-time-from-the-widget\">Remove the end date\/time from the widget<\/h3>\n\n\n\n<p>As you may have noticed, there isn&#8217;t an option to hide the end date\/time. If you need to do so, the following code snippet will help you achieve that. Be sure to check out our <a href=\"https:\/\/staging.theeventscalendar.com\/knowledgebase\/best-practices-for-implementing-custom-code-snippets\/\">snippet guide<\/a> for information on how to apply the code snippet to your site.<\/p>\n\n\n<div class=\"wp-block-syntaxhighlighter-code \"><pre class=\"brush: php; gutter: false; title: ; notranslate\" title=\"\">\nadd_filter ( &#039;tribe_events_event_short_schedule_details&#039;, function ( $schedule ) {\n\t$dash_position = strpos( $schedule, &#039;&gt; - &#039; );\n\t$schedule = substr( $schedule, 0, $dash_position );\n\treturn $schedule;\n} );\n<\/pre><\/div>\n\n\n<h3 class=\"wp-block-heading\" id=\"h-wrapping-up\">Wrapping Up<\/h3>\n\n\n\n<p>There we go! We covered a lot of ground in this tutorial. Hopefully, now you&#8217;ve got a better understanding of the Events List widget, how to configure it, how Pro extends it, and how to customize its templates. Still have some burning questions not covered here? Hit us up <a href=\"https:\/\/support.theeventscalendar.com\/submit_ticket\" target=\"_blank\" rel=\"noreferrer noopener\">at our help desk<\/a> and we&#8217;d be happy to help.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>We&#8217;re going to go over the Events List Widget in this tutorial, including how to configure it, things to expect from it, and perhaps some tips and tricks you can use at your next cocktail party. You&#8217;ll be the star of the show, for sure. Adding the Widget to a Sidebar The first thing to&#8230;<\/p>\n","protected":false},"author":3,"featured_media":1955565,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_kad_blocks_custom_css":"","_kad_blocks_head_custom_js":"","_kad_blocks_body_custom_js":"","_kad_blocks_footer_custom_js":"","_swpsp_post_exclude":false,"_kad_post_transparent":"","_kad_post_title":"","_kad_post_layout":"","_kad_post_sidebar_id":"","_kad_post_content_style":"","_kad_post_vertical_padding":"","_kad_post_feature":"","_kad_post_feature_position":"","_kad_post_header":false,"_kad_post_footer":false,"ep_exclude_from_search":false,"footnotes":""},"categories":[114],"tags":[105],"stellar-product-taxonomy":[158,161],"class_list":["post-1896551","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-calendar-widgets","tag-widgets","stellar-product-taxonomy-events-calendar-pro","stellar-product-taxonomy-the-events-calendar"],"acf":[],"taxonomy_info":{"category":[{"value":114,"label":"Calendar Widgets"}],"post_tag":[{"value":105,"label":"Widgets"}],"stellar-product-taxonomy":[{"value":158,"label":"Events Calendar Pro"},{"value":161,"label":"The Events Calendar"}]},"featured_image_src_large":["https:\/\/images.theeventscalendar.com\/kb\/uploads\/2023\/02\/social-share-1024x538.png",1024,538,true],"author_info":{"display_name":"Jaime Marchwinski","author_link":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/author\/jaimetri-be\/"},"comment_info":0,"category_info":[{"term_id":114,"name":"Calendar Widgets","slug":"calendar-widgets","term_group":0,"term_taxonomy_id":114,"taxonomy":"category","description":"","parent":61,"count":9,"filter":"raw","term_order":"0","cat_ID":114,"category_count":9,"category_description":"","cat_name":"Calendar Widgets","category_nicename":"calendar-widgets","category_parent":61}],"tag_info":[{"term_id":105,"name":"Widgets","slug":"widgets","term_group":0,"term_taxonomy_id":105,"taxonomy":"post_tag","description":"","parent":0,"count":16,"filter":"raw","term_order":"0"}],"_links":{"self":[{"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/posts\/1896551","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/comments?post=1896551"}],"version-history":[{"count":7,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/posts\/1896551\/revisions"}],"predecessor-version":[{"id":1964775,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/posts\/1896551\/revisions\/1964775"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/media\/1955565"}],"wp:attachment":[{"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/media?parent=1896551"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/categories?post=1896551"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/tags?post=1896551"},{"taxonomy":"stellar-product-taxonomy","embeddable":true,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/stellar-product-taxonomy?post=1896551"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}