{"id":1958279,"date":"2023-11-10T17:54:53","date_gmt":"2023-11-10T22:54:53","guid":{"rendered":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/?p=1958279"},"modified":"2024-03-01T08:13:46","modified_gmt":"2024-03-01T13:13:46","slug":"shortcodes-custom-fields-and-setting-options","status":"publish","type":"post","link":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/shortcodes-custom-fields-and-setting-options\/","title":{"rendered":"Event Schedule Manager Shortcodes, custom fields, and Setting options"},"content":{"rendered":"\n

Schedule Shortcode<\/h2>\n\n\n\n

[tec_schedule]<\/strong><\/p>\n\n\n\n

Example shortcode:<\/p>\n\n\n

\n[tec_schedule tracks="all" color_scheme="light" session_link="none"]\n<\/pre><\/div>\n\n\n
This would output a schedule with all tracks, using a light color scheme, and session titles not being linked. <\/p>\n\n\n\n
    \n
  • ‘date’ (default: null) – Specifies the date for which the schedule should be displayed; when set to null, the schedule does not display.\n
      \n
    • Supports multiple dates (comma separated)<\/li>\n\n\n\n
    • Creates date tabs<\/li>\n\n\n\n
    • i.e: date=”2023-09-21, 2023-09-22″ <\/li>\n<\/ul>\n<\/li>\n\n\n\n
    • ‘tracks’ (default: all) – Allows the user to specify which tracks should be displayed in the schedule;\n
        \n
      • “all” will display sessions from all tracks.<\/li>\n\n\n\n
      • a comma-separated list of track term slugs displays those specific tracks<\/li>\n<\/ul>\n<\/li>\n\n\n\n
      • ‘session_link’ (default: permalink) – Determines the type of link to be used for the sessions; the options are:\n
          \n
        • “permalink” – each session title will link to the full session details page.<\/li>\n\n\n\n
        • “anchor” – each session title will link to an anchor on the current page.<\/li>\n\n\n\n
        • “none” – session titles will not be linked at all.<\/li>\n<\/ul>\n<\/li>\n\n\n\n
        • ‘color_scheme’ (default: light) – Sets the color scheme for the schedule; the options are:\n
            \n
          • “light” – will use a light color scheme.<\/li>\n\n\n\n
          • “dark” – will use a dark color scheme.<\/li>\n<\/ul>\n<\/li>\n\n\n\n
          • ‘align’ (default: “”) – Defines the alignment of the schedule on the page; the options include:\n
              \n
            • “wide” – will make the schedule wider than the content area.<\/li>\n\n\n\n
            • “full” – will make the schedule take up the full width of the page.<\/li>\n\n\n\n
            • “” (empty string) – will use the default alignment as defined by the theme.<\/li>\n<\/ul>\n<\/li>\n\n\n\n
            • ‘layout’ (default: table) – Specifies the layout to be used for displaying the schedule;\n
                \n
              • “table” will use a table layout for the schedule.<\/li>\n\n\n\n
              • “grid” will use a grid layout<\/li>\n<\/ul>\n<\/li>\n\n\n\n
              • ‘row_height’ (default: match) – Determines the row height for the schedule using the grid view.\n
                  \n
                • “match”, it will ensure that all rows have the same height.<\/li>\n\n\n\n
                • “auto”, rows will size to the content in the row.\u00a0<\/li>\n<\/ul>\n<\/li>\n\n\n\n
                • ‘content’ (default: none) – Defines how the content of each session should be displayed in the schedule;\n
                    \n
                  • “none” means that the session content will not be displayed. <\/li>\n\n\n\n
                  • “full” means all session content is displayed.<\/li>\n\n\n\n
                  • “excerpt” means only the excerpt is displayed.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n
                    Sessions Shortcode<\/h2>\n\n\n\n
                    Single Sessions custom fields<\/h3>\n\n\n\n
                    For the sessions post type.<\/p>\n\n\n\n
                      \n
                    • Conference Session Speakers (_conference_session_speakers) – This field stores the list of speakers for a session as a single text string, which is sanitized before being saved.<\/li>\n\n\n\n
                    • Session Time (_wpcs_session_time) – This field stores the start time of the session, which is computed from the session date, hour, minute, and meridiem values posted from the session edit form.<\/li>\n\n\n\n
                    • Session End Time (_wpcs_session_end_time) – This field stores the end time of the session, computed similar to the session time field but using the end hour, end minute, and end meridiem values.<\/li>\n\n\n\n
                    • Session Type (_wpcs_session_type) – This field stores the type of session, which can be one of three values: “session”, “mainstage”, or “custom”; if an invalid value is posted, it defaults to “session”.\n
                        \n
                      • “custom” is set to “break, lunch, etc..” by default<\/li>\n\n\n\n
                      • Break, Lunch, etc.. session type does not generate a URL to click on when seen in the schedule<\/li>\n<\/ul>\n<\/li>\n\n\n\n
                      • Speaker Display (wpcsp_session_speaker_display) – This radio button field allows users to choose the manner of displaying speakers: either typing the names manually or selecting from a list of speakers from a custom post type (CPT).<\/li>\n\n\n\n
                      • Speaker Name(s) (_wpcs_session_speakers) – This field allows for the manual input of speaker names as a text field; it is conditionally displayed based on the value of the “Speaker Display” field.<\/li>\n\n\n\n
                      • Speakers (wpcsp_session_speakers) – This multi-select field allows users to select and order speakers for the session from a list of speakers stored as a custom post type, and it is conditionally displayed based on the “Speaker Display” field value being “cpt”.<\/li>\n\n\n\n
                      • Sponsors (wpcsp_session_sponsors) – This multi-select field allows users to select and order sponsors for the session from a list of sponsors stored as a custom post type.<\/li>\n<\/ul>\n\n\n\n
                        Speakers Shortcode<\/h2>\n\n\n\n
                        Example shortcode: <\/p>\n\n\n
                        \n[tec_speakers image_size="250" order="asc" speaker_link="permalink"]\n<\/pre><\/div>\n\n\n
                        This would output a list of speakers with a speaker image size of 250 pixels, listed in ascending order, and speakers’ names will be a hyperlink to their posts.<\/p>\n\n\n\n
                        [tec_speakers]<\/strong><\/p>\n\n\n\n
                          \n
                        • show_image (default: true) – This option controls whether to display the speaker’s image or not. If set to true, the speaker’s featured image will be displayed in the output.<\/li>\n\n\n\n
                        • image_size (default: 150) – This defines the size (both width and height) of the speaker’s image in pixels. The image will be displayed as a square with the specified size.<\/li>\n\n\n\n
                        • show_content (default: false) – Determines whether to display the content of the speaker’s post (the description) in the output. If true, the content of each speaker\u2019s post will be displayed.<\/li>\n\n\n\n
                        • posts_per_page (default: -1) – Specifies the number of speaker posts to retrieve and display. The default value of -1 means that all speaker posts will be retrieved and displayed.<\/li>\n\n\n\n
                        • orderby (default: ‘date’) – This option specifies the criterion to be used to order the speaker posts. They can be ordered by ‘date’, ‘title’, or ‘rand’ (random).<\/li>\n\n\n\n
                        • order (default: ‘desc’) – Determines the order of the retrieved posts, either ‘asc’ (ascending) or ‘desc’ (descending), based on the criterion specified in orderby.<\/li>\n\n\n\n
                        • speaker_link (default: ”) – Controls whether to link the speaker’s name to their individual post. If set to ‘permalink’, the speaker’s name will be a hyperlink to their post.<\/li>\n\n\n\n
                        • track (default: ”) – Allows filtering speakers based on the tracks they are associated with. You can provide a comma-separated list of track slugs to filter the speakers.<\/li>\n\n\n\n
                        • groups (default: ”) – Allows filtering speakers based on the groups they are associated with. You can provide a comma-separated list of group slugs to filter the speakers.<\/li>\n\n\n\n
                        • columns (default: 1) – Specifies the number of columns in the grid layout used to display the speakers. The speakers will be displayed in a grid with the specified number of columns.<\/li>\n<\/ul>\n\n\n\n
                            \n
                          • gap (default: 30) – Specifies the gap (in pixels) between the grid items (speakers).<\/li>\n\n\n\n
                          • align (default: ‘left’) – Sets the text alignment within the grid items. The text can be aligned to the ‘left’, ‘center’, ‘right’, etc.<\/li>\n<\/ul>\n\n\n\n
                            Single Speakers custom fields<\/h3>\n\n\n\n
                            For the Speakers post type<\/p>\n\n\n\n
                              \n
                            • First Name – This field allows users to input the first name of a speaker.<\/li>\n\n\n\n
                            • Last Name (wpcsp_last_name) – This field allows users to input the last name of a speaker.<\/li>\n\n\n\n
                            • Title (wpcsp_title) – This field allows users to input the title or position of a speaker.<\/li>\n\n\n\n
                            • Organization (wpcsp_organization) -This field allows users to specify the organization that the speaker is affiliated with.<\/li>\n\n\n\n
                            • Facebook URL (wpcsp_facebook_url) – This field allows users to input the Facebook profile URL of a speaker, and it ensures that the URL uses either the “http” or “https” protocol.<\/li>\n\n\n\n
                            • Twitter URL (wpcsp_twitter_url) – This field allows users to input the Twitter profile URL of a speaker, and it ensures that the URL uses either the “http” or “https” protocol.<\/li>\n\n\n\n
                            • Instagram URL (wpcsp_instagram_url) – This field allows users to input the Instagram profile URL of a speaker, and it ensures that the URL uses either the “http” or “https” protocol.<\/li>\n\n\n\n
                            • LinkedIn URL (wpcsp_linkedin_url) – This field allows users to input the LinkedIn profile URL of a speaker, and it ensures that the URL uses either the “http” or “https” protocol.<\/li>\n\n\n\n
                            • YouTube URL (wpcsp_youtube_url) – This field allows users to input the YouTube profile URL of a speaker, and it ensures that the URL uses either the “http” or “https” protocol.<\/li>\n\n\n\n
                            • Website URL (wpcsp_website_url) – This field allows users to input the personal or professional website URL of a speaker, and it ensures that the URL uses either the “http” or “https” protocol.<\/li>\n<\/ul>\n\n\n\n
                              Sponsors Shortcode<\/h2>\n\n\n\n
                              Example shortcode:<\/p>\n\n\n
                              \n[tec_sponsors title="visible" content="full" excerpt_length="100"] \n<\/pre><\/div>\n\n\n
                              This would display the sponsors with a visible title, full content of the sponsor’s post, and an excerpt length of 100 characters. <\/p>\n\n\n\n
                                \n
                              • link (default: ‘none’) – This option dictates what the sponsor images and titles link to. It can have three possible values:\n
                                  \n
                                • ‘none’: No link is applied to the sponsor images and titles.<\/li>\n\n\n\n
                                • ‘website’: The sponsor images and titles link to the sponsor’s website URL, which is fetched from a custom field (wpcsp_website_url). <\/li>\n\n\n\n
                                • ‘post’: The sponsor images and titles link to the individual sponsor’s post on your WordPress site.<\/li>\n<\/ul>\n<\/li>\n\n\n\n
                                • title (default: hidden) – Controls the visibility of the sponsor title (name). It has two states in the script:\n
                                    \n
                                  • ‘visible’: The sponsor title is displayed. <\/li>\n\n\n\n
                                  • ‘hidden’: The sponsor title is hidden<\/li>\n<\/ul>\n<\/li>\n\n\n\n
                                  • content (default: ‘hidden’) – Determines the content display style for each sponsor. It has three possible states:\n
                                      \n
                                    • ‘full’: Displays the full content of the sponsor’s post.<\/li>\n\n\n\n
                                    • ‘excerpt’: Displays an excerpt of the content, limited to a number of words defined by the excerpt_length attribute.<\/li>\n\n\n\n
                                    • ‘hidden’: The content is hidden<\/li>\n<\/ul>\n<\/li>\n\n\n\n
                                    • excerpt_length (default: 55) – Defines the number of words to be displayed when the content attribute is set to ‘excerpt’. The content will be trimmed to this number of words.<\/li>\n\n\n\n
                                    • heading_level (default: ‘h2’) – Sets the HTML heading level for the sponsor level headings. It controls the HTML tag used for these headings (e.g., ‘h2’, ‘h3’, ‘h4’, etc.). <\/li>\n<\/ul>\n\n\n\n
                                      Single Sponsors custom field<\/h3>\n\n\n\n
                                        \n
                                      • Website URL (wpcsp_website_url) – This field allows users to input the website URL of a sponsor, validating that the URL uses either the “http” or “https” protocol.<\/li>\n<\/ul>\n\n\n\n
                                        Single Sponsor Level Taxonomy<\/strong><\/p>\n\n\n\n
                                          \n
                                        • Logo Height (wpcsp_logo_height) – This field allows users to specify the height (in pixels) of the sponsor’s logo, accepting only numerical values<\/li>\n<\/ul>\n\n\n\n
                                          Settings Options<\/h2>\n\n\n\n
                                            \n
                                          • Schedule Page URL (wpcs_field_schedule_page_url) – Lets the admin set the URL where the conference schedule is embedded, expecting a URL input in a text field.<\/li>\n\n\n\n
                                          • Speakers Page URL (wpcsp_field_speakers_page_url) – Located in “General Settings,” it allows the admin to define the URL of the speakers’ page, accompanied by a sanitization callback for clean data entry.<\/li>\n\n\n\n
                                          • Sponsor URL Redirect (wpcsp_field_sponsor_page_url) – Enables the admin to set the redirection behavior for sponsor links through a dropdown selector; it includes a sanitization callback for input validation.<\/li>\n\n\n\n
                                          • Sponsor Level Order (wpcsp_conference_sponsor_level_order) – In “General Settings,” it enables the admin to order sponsor levels on the sponsors page template using a draggable list, with validation to ensure proper data format.<\/li>\n\n\n\n
                                          • Speaker Group Order (wpcsp_speaker_level_order) – Allows the admin to set the display order of speaker groups on the speaker page template through a draggable list interface, ensuring correct data format through validation.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"
                                            Schedule Shortcode [tec_schedule] Example shortcode: This would output a schedule with all tracks, using a light color scheme, and session titles not being linked. Sessions Shortcode Single Sessions custom fields For the sessions post type. Speakers Shortcode Example shortcode: This would output a list of speakers with a speaker image size of 250 pixels, listed…<\/p>\n","protected":false},"author":34,"featured_media":1955565,"comment_status":"open","ping_status":"open","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":[61],"tags":[],"stellar-product-taxonomy":[205],"class_list":["post-1958279","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-events-features","stellar-product-taxonomy-event-schedule-manager"],"acf":[],"taxonomy_info":{"category":[{"value":61,"label":"Product Features"}],"stellar-product-taxonomy":[{"value":205,"label":"Event Schedule Manager"}]},"featured_image_src_large":["https:\/\/images.theeventscalendar.com\/kb\/uploads\/2023\/02\/social-share-1024x538.png",1024,538,true],"author_info":{"display_name":"jaimem","author_link":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/author\/jaimem\/"},"comment_info":0,"category_info":[{"term_id":61,"name":"Product Features","slug":"events-features","term_group":0,"term_taxonomy_id":61,"taxonomy":"category","description":"","parent":0,"count":31,"filter":"raw","term_order":"0","cat_ID":61,"category_count":31,"category_description":"","cat_name":"Product Features","category_nicename":"events-features","category_parent":0}],"tag_info":false,"_links":{"self":[{"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/posts\/1958279","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\/34"}],"replies":[{"embeddable":true,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/comments?post=1958279"}],"version-history":[{"count":13,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/posts\/1958279\/revisions"}],"predecessor-version":[{"id":1959527,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/posts\/1958279\/revisions\/1959527"}],"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=1958279"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/categories?post=1958279"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/tags?post=1958279"},{"taxonomy":"stellar-product-taxonomy","embeddable":true,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/stellar-product-taxonomy?post=1958279"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}