{"id":5055,"date":"2026-04-24T12:38:35","date_gmt":"2026-04-24T10:38:35","guid":{"rendered":"https:\/\/cevento-plugin.com\/docs\/001-shortcode-builder\/"},"modified":"2026-04-24T12:38:35","modified_gmt":"2026-04-24T10:38:35","slug":"001-shortcode-builder","status":"publish","type":"docs","link":"https:\/\/cevento-plugin.com\/en\/docs\/001-shortcode-builder\/","title":{"rendered":"Shortcode Builder"},"content":{"rendered":"\n<p>Cevento allows you to insert event views anywhere on your website where WordPress shortcodes are supported, using a shortcode. This way, you can also embed multiple different views (e.g. filtered by category). You can find the Shortcode Builder in the WordPress dashboard under <span class=\"cevento-docs__term\">Cevento<\/span> &rarr; <span class=\"cevento-docs__term\">Shortcode Builder<\/span>.<\/p>\n<p><strong>Examples of use:<\/strong><\/p>\n<ul>\n<li>place only the next 3 upcoming events as a list on your homepage  <\/li>\n<li>insert only events from the category &ldquo;Workshops&rdquo; into a blog post in a grid layout  <\/li>\n<li>display all past events with pagination in a compact view on a year-in-review page  <\/li>\n<\/ul>\n<h2 id=\"create-a-shortcode\">Create a shortcode<\/h2>\n<p>In the left panel of the Shortcode Builder, you&rsquo;ll find the configuration options for your shortcode. In the right panel, you&rsquo;ll see the generated shortcode. By clicking the icon, you can copy the shortcode and insert it into your website. The following sections explain the different configuration options. You can adjust the display and filter which events will be output.<\/p>\n<div uk-lightbox><a href=\"wp-content\/uploads\/cevento-docs\/en\/004-001-shortcode-builder_uebersicht.jpg\" data-caption=\"Shortcode Generator\"><img decoding=\"async\" src=\"wp-content\/uploads\/cevento-docs\/en\/004-001-shortcode-builder_uebersicht.jpg\" alt=\"Shortcode Generator\"><\/a><\/div>\n<p><span class=\"cevento-docs__caption\">[1] Shortcode settings, [2] Shortcode (copyable)<\/span><\/p>\n<h3>Display<\/h3>\n<p>These settings control the output and appearance of your event view.<\/p>\n<h4>Display Type<\/h4>\n<p>In the <span class=\"cevento-docs__term\">Display Type<\/span> dropdown, you can choose a layout for your event view (List, Grid or Summary).<\/p>\n<div uk-lightbox><a href=\"wp-content\/uploads\/cevento-docs\/en\/cevento-view-liste.png\" data-caption=\"Example &ldquo;List&rdquo;\"><img decoding=\"async\" src=\"wp-content\/uploads\/cevento-docs\/en\/cevento-view-liste.png\" alt=\"Example &ldquo;List&rdquo;\"><\/a><\/div>\n<p><span class=\"cevento-docs__caption\">Example archive layout &ldquo;List&rdquo;<\/span><\/p>\n<div uk-lightbox><a href=\"wp-content\/uploads\/cevento-docs\/en\/cevento-view-raster.png\" data-caption=\"Example &ldquo;Grid&rdquo;\"><img decoding=\"async\" src=\"wp-content\/uploads\/cevento-docs\/en\/cevento-view-raster.png\" alt=\"Example &ldquo;Grid&rdquo;\"><\/a><\/div>\n<p><span class=\"cevento-docs__caption\">Example archive layout &ldquo;Grid&rdquo;<\/span><\/p>\n<div uk-lightbox><a href=\"wp-content\/uploads\/cevento-docs\/en\/cevento-view-kompakt.png\" data-caption=\"Example &ldquo;Summary&rdquo;\"><img decoding=\"async\" src=\"wp-content\/uploads\/cevento-docs\/en\/cevento-view-kompakt.png\" alt=\"Example &ldquo;Summary&rdquo;\"><\/a><\/div>\n<p><span class=\"cevento-docs__caption\">Example archive layout &ldquo;Summary&rdquo;<\/span><\/p>\n<h4>ID Attribute<\/h4>\n<p>You can assign an ID Attribute to the container of your event view, e.g. for creating anchor links. Depending on usage, make sure you follow ID requirements. A safe practice is to use only lowercase letters and hyphens.<\/p>\n<h4>Order<\/h4>\n<p>Sort your event view by date, ascending or descending.<\/p>\n<h4>Limit<\/h4>\n<p>Enter the maximum number of events to display per page. If you don&rsquo;t enable Pagination, only the first X events will be shown. If no Limit is set, all events matching the shortcode will be displayed.<\/p>\n<h4>Pagination<\/h4>\n<p>If enabled, Pagination will add navigation links at the end of the list, so users can browse through all your events.<\/p>\n<h4>Category Filter<\/h4>\n<p>If you enable the <span class=\"cevento-docs__term\">Category Filter<\/span>, a navigation bar will appear above the event list, allowing users to filter displayed events by category.<\/p>\n<h3>Filter Settings<\/h3>\n<p>These options let you pre-filter which events are displayed by the shortcode.<\/p>\n<h4>Date Filter<\/h4>\n<p>Choose whether to display only <span class=\"cevento-docs__term\">Future Events<\/span>, <span class=\"cevento-docs__term\">Past Events<\/span> or <span class=\"cevento-docs__term\">All Events<\/span>.<\/p>\n<h4>Single Event<\/h4>\n<p>Here you can define whether to display only a single event, and select which one.<\/p>\n<h4>Categories<\/h4>\n<p>Select one or more categories of events to display. If no categories are selected, all events will be shown. If categories are selected, only events from those categories will be displayed.  <\/p>\n<p>To select multiple categories, hold <kbd>Shift<\/kbd> or <kbd>Ctrl \/ Cmd<\/kbd> and click on the categories.<br>\nTo deselect a category, hold <kbd>Shift<\/kbd> and click on it again.  <\/p>\n<h4>Category Relation<\/h4>\n<p>Define how the selected categories are combined. If you choose <span class=\"cevento-docs__term\">AND<\/span>, only events assigned to all selected categories will be shown. If you choose <span class=\"cevento-docs__term\">OR<\/span>, events from any of the selected categories will be displayed.<\/p>\n<h4>Exclude Categories<\/h4>\n<p>Select categories that should be excluded from the event view. Any event assigned to one or more of the excluded categories will not be displayed. This works the same way as the Categories selection above.<\/p>\n<h2 id=\"insert-shortcode-into-your-website\">Insert shortcode into your website<\/h2>\n<p>In the right panel, you&rsquo;ll see the generated shortcode. It will look something like this and may include several attributes depending on your settings:<\/p>\n<p>You can copy it to your clipboard by clicking the icon. In the WordPress block editor, add a block called &ldquo;Shortcode&rdquo; and paste the shortcode there. If you are not using the block editor, paste the shortcode directly into the content of a page or post. At that location, the generated event view will be displayed.<\/p>\n<h2 id=\"structure-of-a-shortcode\">Structure of a shortcode<\/h2>\n<p>A Cevento shortcode for an event view consists of the keyword <span class=\"cevento-docs__term\">cevento_eventlist<\/span> and its attributes. It looks something like this and may include more or different attributes:<\/p>\n<pre><code class=\"language-css\">[cevento_eventlist limit=\"10\" link=\"true\" category=\"12\"]<\/code><\/pre>\n<div class=\"uk-overflow-auto\">\n<table>\n<thead>\n<tr>\n<th>Below you&rsquo;ll find a table describing all possible attributes.<\/th>\n<th>Name<\/th>\n<th>Default<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>display<\/td>\n<td><code>\"list\"<\/code><\/td>\n<td>Defines how events are displayed. Options: List (<code>\"list\"<\/code>), Grid (<code>\"grid\"<\/code>), or Summary (<code>\"summary\"<\/code>).<\/td>\n<\/tr>\n<tr>\n<td>limit<\/td>\n<td><code>10<\/code><\/td>\n<td>Maximum number of events per page. Only whole numbers are accepted.<\/td>\n<\/tr>\n<tr>\n<td>link<\/td>\n<td><code>true<\/code><\/td>\n<td>Determines whether the listed events should link to their single event view.<\/td>\n<\/tr>\n<tr>\n<td>id<\/td>\n<td><code>null<\/code><\/td>\n<td>Defines the ID attribute of the event list container.<\/td>\n<\/tr>\n<tr>\n<td>category-filter<\/td>\n<td><code>0<\/code><\/td>\n<td>Determines whether a category filter navigation should be displayed above the event view.<\/td>\n<\/tr>\n<tr>\n<td>category<\/td>\n<td><code>null<\/code><\/td>\n<td>Restricts output to one or more categories. Categories can be passed by ID or slug, separated by commas.<\/td>\n<\/tr>\n<tr>\n<td>category-relation<\/td>\n<td><code>\"OR\"<\/code><\/td>\n<td>Defines how multiple selected categories are combined. <code>\"OR\"<\/code> = at least one must match, <code>\"AND\"<\/code> = all must match.<\/td>\n<\/tr>\n<tr>\n<td>category-exclude<\/td>\n<td><code>null<\/code><\/td>\n<td>Excludes events assigned to specific categories. Categories can be passed by ID or slug, separated by commas. All excluded categories are combined with <code>\"OR\"<\/code>.<\/td>\n<\/tr>\n<tr>\n<td>event-id<\/td>\n<td><code>null<\/code><\/td>\n<td>Displays only a single event if its ID is provided.<\/td>\n<\/tr>\n<tr>\n<td>pagination<\/td>\n<td><code>0<\/code><\/td>\n<td>Enables pagination if set to <code>1<\/code>. A pagination bar will appear at the bottom of the list.<\/td>\n<\/tr>\n<tr>\n<td>filter<\/td>\n<td><code>\"future\"<\/code><\/td>\n<td>Defines which events are displayed: <code>\"future\"<\/code> (upcoming), <code>\"past\"<\/code> (past), or <code>\"all\"<\/code> (all).<\/td>\n<\/tr>\n<tr>\n<td>order<\/td>\n<td><code>\"ASC\"<\/code><\/td>\n<td>Sort order of events by date. Possible values: <code>\"ASC\"<\/code> (ascending) or <code>\"DESC\"<\/code> (descending).<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n\n","protected":false},"featured_media":0,"parent":0,"template":"","meta":{"_acf_changed":false},"thema":[680],"class_list":["post-5055","docs","type-docs","status-publish","hentry","thema-shortcodes"],"acf":{"excerpt":"Insert event views at custom positions on your website","toc":"<ol class=\"toc\">\n<li><a href=\"#create-a-shortcode\"  uk-scroll=\"offset: 120\">Create a shortcode<\/a><\/li>\n<li><a href=\"#insert-shortcode-into-your-website\"  uk-scroll=\"offset: 120\">Insert shortcode into your website<\/a><\/li>\n<li><a href=\"#structure-of-a-shortcode\"  uk-scroll=\"offset: 120\">Structure of a shortcode<\/a><\/li>\n<\/ol>\n"},"_links":{"self":[{"href":"https:\/\/cevento-plugin.com\/en\/wp-json\/wp\/v2\/docs\/5055","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/cevento-plugin.com\/en\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/cevento-plugin.com\/en\/wp-json\/wp\/v2\/types\/docs"}],"wp:attachment":[{"href":"https:\/\/cevento-plugin.com\/en\/wp-json\/wp\/v2\/media?parent=5055"}],"wp:term":[{"taxonomy":"thema","embeddable":true,"href":"https:\/\/cevento-plugin.com\/en\/wp-json\/wp\/v2\/thema?post=5055"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}