The basic button shortcode<\/h4>\n\n\n\n
To create a button you will place the following code into your page editor. If you are using a page with content blocks, choose the Rich Content Editor block.<\/p>\n\n\n\n
[button url=\"https:\/\/umaine.edu\/\"] Button Example [\/button]<\/p>\n\n\n\n
The button shortcode has two attributes.<\/h4>\n\n\n\n\n- \u00a0The first attribute is to create the link.\u00a0 An example of this attribute is url=”http:\/\/umaine.edu\/”<\/strong>, this is placed in the first set of brackets after the word button.<\/li>\n\n\n\n
- The second attribute controls the capitalization of the words, an example of this attribute is\u00a0caps=”capitalize”<\/strong>.\u00a0 By default the attribute sets every letter uppercase. The options for this attribute are lowercase, capitalize, and none. Capitalize will capitalize the first letter of each word, lowercase will lowercase all letters, none will display your text as you typed it.<\/li>\n<\/ol>\n\n\n\n
Example of complete button shortcode<\/h4>\n\n\n\n
[button url=\"https:\/\/umaine.edu\/\" caps=\"none\"] Button Example [\/button]<\/p>\n\n\n\n
Button Example Set To Capitalize<\/a>
Button Example set to Lowercase<\/a>
buTton eXample Button Example sEt tO NoNe<\/a><\/p>\n\n\n\nShow child pages<\/h3>\n\n\n\n
The Show Child shortcode will display all children of the present page in a bulleted list. You may place this code anywhere in your page to present the list.<\/p>\n\n\n\n
Example of children being displayed<\/h4>\n\n\n\n![\"Bulleted](\"https:\/\/umaine.edu\/userguide\/wp-content\/uploads\/sites\/33\/2018\/03\/Screen-Shot-2018-03-21-at-11.22.33-AM.png\")
<\/figure>\n\n\n\nComplete shortcode to display children<\/h4>\n\n\n\n
[show_children]<\/p>\n\n\n\n
Progress Bar<\/h3>\n\n\n\n
The progress bar short code is a way of visually representing progress of a campaign or project.<\/p>\n\n\n\n
Example of a progress bar<\/h4>\n\n\n\n\t\n\t\t\n\t\t\t<\/div>\n\t\t<\/div>\n\t\t30% to Goal<\/caption>\n\t<\/div>\n\n\n\n\nThe progress bar has two attributes<\/h4>\n\n\n\n\n- The first attribute is percentage and this controls how much of the progress bar is filled in. An example of the percentage attribute is percentage=”30″<\/strong>.<\/li>\n\n\n\n
- The second attribute is text_value, this controls what is displayed in the progress bar caption; ideally this explains what the value of the progress bar and what it’s about. An example of text_value=”30% to goal”<\/strong>.<\/li>\n<\/ol>\n\n\n\n
Example of complete button shortcode<\/h4>\n\n\n\n
[progress percentage=\"30\" text_value=\"30% to Goal\"]<\/p>\n\n\n\n
How to embed a Google Map<\/a><\/h3>\n\n\n\nHours of Operation shortcode<\/h3>\n\n\n\n
Do you need to display your hours of operation on the website, but do not want to list different hours for days of the week? There is a feature available in Settings called “Hours of Operation” that can help. Within that screen on the dashboard, you may specify the hours of operation for the different days of the week (Sunday – Saturday). Leave a day blank\/empty if you are closed that day.<\/p>\n\n\n\n
Once this is in place, you can use this shortcode to display the hours of operation on any page:<\/p>\n\n\n\n
[hours]<\/p>\n\n\n\n
To see this in practice, we have added “hours of operation” to this user guide to indicate our operating hours of 8:00 a.m. – 4:30 p.m. Monday-Friday. Here is the “hours” shortcode on the page below:<\/p>\n\n\n\nOpen Today: 8:00 a.m. - 4:30 p.m.\n\n\n\n
If you have different hours of operation at different times of the year, you can alter the hours of operation up to 6 days in advance\u2014 by updating the upcoming Monday hours on Tuesday, the upcoming Wednesday hours on Thursday, etc.<\/p>\n\n\n\n
Call to action feature box shortcode<\/h3>\n\n\n\n
[cta title=\"Headline appears here\"]<\/p>\n\n\n\n
Text appears here.<\/p>\n\n\n\n
[\/cta]<\/p>\n\n\n\n
results in:<\/p>\n\n\n
Headline appears here<\/h2><\/p>\n
Text appears here.<\/p>\n
<\/div>\n\n\n\n
UMS Post Picker<\/h3>\n\n\n\n
This feature is utilized to pull posts from one site and display them within another site using shortcodes, taxonomy criteria, and other options. The feature was developed and is maintained by the UMS Web Development Team, and the specific templates created for displaying information are developed and maintained by the UMS Web Technologies Team. The main uses for this feature are to display news, events, and other types of content across our websites to avoid duplicating content, in much the same way as our article and event list content blocks.<\/p>\n\n\n\n
A useful example: embed the Academic Calendar events<\/h4>\n\n\n\n
To illustrate this feature, here is the shortcode needed to display the next five upcoming events in the academic calendar: [ums-post-picker site_id=\"15\" post_type=\"tribe_events\" taxonomy_terms=\"tribe_events_cat:academic-calendar\" order_by=\"meta_value\" meta_key=\"_EventEndDate\" template=\"ums_event_summary_list\" omit_past_posts=true order=\"ASC\" limit=\"5\" options=\"no_excerpt\"]<\/p>\n\n\n\n
The details are explained below:<\/p>\n\n\n\n
site_id<\/strong>: The sub-site ID to pull content from. If omitted, the post picker will pull content from your site. The ID of calendar.umaine.edu (where the Academic Calendar events are published) is 15<\/strong>.<\/p>\n\n\n\npost_type<\/strong>: The type of WordPress post to search. The post type for events is tribe_events<\/strong>.<\/p>\n\n\n\ntaxonomy_terms<\/strong>: A list of taxonomies and terms to match. The format is taxonomy_terms=”taxonomy_name:term_slug”. For event calendar categories the taxonomy name is tribe_events_cat<\/strong>, and the Academic Calendar category term slug is academic-calendar<\/strong>.<\/p>\n\n\n\norder_by<\/strong>: The post field to order posts by. While the default for this is the post publish date, event calendar items have a special “meta” value to identify when a future event begins. For this reason, the order_by value for event calendar items is meta_value<\/strong>.<\/p>\n\n\n\nmeta_key<\/strong>: This attribute is used in conjunction with the above meta_value<\/strong> to set the order of posts when the default publish date isn’t helpful. For event calendar items, this meta_key is _EventEndDate<\/strong>. NOTE: because this sorts by the event’s end<\/em> date, events that span multiple days may appear to be out-of-order in your event list (which lists the event’s start<\/em> date). Our recommended best practice is to list multi-day events as sequential single-day events.<\/p>\n\n\n\ntemplate<\/strong>: This sets the template to use for the content. Templates can be specific to custom post types such as events, or generic and applicable to all post types. For calendar listings, the template is ums_event_summary_list<\/strong>.<\/p>\n\n\n\nomit_past_posts<\/strong>: This is an on\/off (true\/false) setting that controls whether the list should exclude posts earlier than the current date. If left out, the list will include past posts, but for event calendar items this is set to true<\/strong> in order to only display events that are upcoming.<\/p>\n\n\n\norder<\/strong>: The sort order, which can be either ascending (ASC) or descending (DESC). For a list of upcoming events, this is set to ASC<\/strong>.<\/p>\n\n\n\nlimit<\/strong>: Shows at most this many posts. If left out the default is 50 posts. For this Academic Calendar example, setting this to 5<\/strong> will show the next five upcoming events.<\/p>\n\n\n\noptions<\/strong>: This is used in conjunction with the earlier template attribute to include options that are not otherwise included in the shortcode parameters. In the case of the event summary list template, the option no_excerpt<\/strong> will exclude any excerpt text from the listings.<\/p>\n\n\n\nThat was a lot to take in, is there more?<\/h4>\n\n\n\n
There are still more options that can be used for event listings that we will document in our user guide over time. Displaying event image thumbnails, displaying the events in a horizontal row, and combining multiple categories of events together are all possible. If you want to explore what is possible with listing events on your site, contact us at um.weboffice@maine.edu<\/a>.<\/p>\n\n\n\n
Example of complete button shortcode<\/h4>\n\n\n\n
[button url=\"https:\/\/umaine.edu\/\" caps=\"none\"] Button Example [\/button]<\/p>\n\n\n\n
Button Example Set To Capitalize<\/a> The Show Child shortcode will display all children of the present page in a bulleted list. You may place this code anywhere in your page to present the list.<\/p>\n\n\n\n [show_children]<\/p>\n\n\n\n The progress bar short code is a way of visually representing progress of a campaign or project.<\/p>\n\n\n\n [progress percentage=\"30\" text_value=\"30% to Goal\"]<\/p>\n\n\n\n Do you need to display your hours of operation on the website, but do not want to list different hours for days of the week? There is a feature available in Settings called “Hours of Operation” that can help. Within that screen on the dashboard, you may specify the hours of operation for the different days of the week (Sunday – Saturday). Leave a day blank\/empty if you are closed that day.<\/p>\n\n\n\n Once this is in place, you can use this shortcode to display the hours of operation on any page:<\/p>\n\n\n\n [hours]<\/p>\n\n\n\n To see this in practice, we have added “hours of operation” to this user guide to indicate our operating hours of 8:00 a.m. – 4:30 p.m. Monday-Friday. Here is the “hours” shortcode on the page below:<\/p>\n\n\n\nOpen Today: 8:00 a.m. - 4:30 p.m.\n\n\n\n If you have different hours of operation at different times of the year, you can alter the hours of operation up to 6 days in advance\u2014 by updating the upcoming Monday hours on Tuesday, the upcoming Wednesday hours on Thursday, etc.<\/p>\n\n\n\n [cta title=\"Headline appears here\"]<\/p>\n\n\n\n Text appears here.<\/p>\n\n\n\n [\/cta]<\/p>\n\n\n\n results in:<\/p>\n\n\n Text appears here.<\/p>\n <\/div>\n\n\n\n This feature is utilized to pull posts from one site and display them within another site using shortcodes, taxonomy criteria, and other options. The feature was developed and is maintained by the UMS Web Development Team, and the specific templates created for displaying information are developed and maintained by the UMS Web Technologies Team. The main uses for this feature are to display news, events, and other types of content across our websites to avoid duplicating content, in much the same way as our article and event list content blocks.<\/p>\n\n\n\n To illustrate this feature, here is the shortcode needed to display the next five upcoming events in the academic calendar: [ums-post-picker site_id=\"15\" post_type=\"tribe_events\" taxonomy_terms=\"tribe_events_cat:academic-calendar\" order_by=\"meta_value\" meta_key=\"_EventEndDate\" template=\"ums_event_summary_list\" omit_past_posts=true order=\"ASC\" limit=\"5\" options=\"no_excerpt\"]<\/p>\n\n\n\n The details are explained below:<\/p>\n\n\n\n site_id<\/strong>: The sub-site ID to pull content from. If omitted, the post picker will pull content from your site. The ID of calendar.umaine.edu (where the Academic Calendar events are published) is 15<\/strong>.<\/p>\n\n\n\n post_type<\/strong>: The type of WordPress post to search. The post type for events is tribe_events<\/strong>.<\/p>\n\n\n\n taxonomy_terms<\/strong>: A list of taxonomies and terms to match. The format is taxonomy_terms=”taxonomy_name:term_slug”. For event calendar categories the taxonomy name is tribe_events_cat<\/strong>, and the Academic Calendar category term slug is academic-calendar<\/strong>.<\/p>\n\n\n\n order_by<\/strong>: The post field to order posts by. While the default for this is the post publish date, event calendar items have a special “meta” value to identify when a future event begins. For this reason, the order_by value for event calendar items is meta_value<\/strong>.<\/p>\n\n\n\n meta_key<\/strong>: This attribute is used in conjunction with the above meta_value<\/strong> to set the order of posts when the default publish date isn’t helpful. For event calendar items, this meta_key is _EventEndDate<\/strong>. NOTE: because this sorts by the event’s end<\/em> date, events that span multiple days may appear to be out-of-order in your event list (which lists the event’s start<\/em> date). Our recommended best practice is to list multi-day events as sequential single-day events.<\/p>\n\n\n\n template<\/strong>: This sets the template to use for the content. Templates can be specific to custom post types such as events, or generic and applicable to all post types. For calendar listings, the template is ums_event_summary_list<\/strong>.<\/p>\n\n\n\n omit_past_posts<\/strong>: This is an on\/off (true\/false) setting that controls whether the list should exclude posts earlier than the current date. If left out, the list will include past posts, but for event calendar items this is set to true<\/strong> in order to only display events that are upcoming.<\/p>\n\n\n\n order<\/strong>: The sort order, which can be either ascending (ASC) or descending (DESC). For a list of upcoming events, this is set to ASC<\/strong>.<\/p>\n\n\n\n limit<\/strong>: Shows at most this many posts. If left out the default is 50 posts. For this Academic Calendar example, setting this to 5<\/strong> will show the next five upcoming events.<\/p>\n\n\n\n options<\/strong>: This is used in conjunction with the earlier template attribute to include options that are not otherwise included in the shortcode parameters. In the case of the event summary list template, the option no_excerpt<\/strong> will exclude any excerpt text from the listings.<\/p>\n\n\n\n There are still more options that can be used for event listings that we will document in our user guide over time. Displaying event image thumbnails, displaying the events in a horizontal row, and combining multiple categories of events together are all possible. If you want to explore what is possible with listing events on your site, contact us at um.weboffice@maine.edu<\/a>.<\/p>\n\n\n\n
Button Example set to Lowercase<\/a>
buTton eXample Button Example sEt tO NoNe<\/a><\/p>\n\n\n\nShow child pages<\/h3>\n\n\n\n
Example of children being displayed<\/h4>\n\n\n\n
<\/figure>\n\n\n\nComplete shortcode to display children<\/h4>\n\n\n\n
Progress Bar<\/h3>\n\n\n\n
Example of a progress bar<\/h4>\n\n\n\n\t
The progress bar has two attributes<\/h4>\n\n\n\n
\n
Example of complete button shortcode<\/h4>\n\n\n\n
How to embed a Google Map<\/a><\/h3>\n\n\n\n
Hours of Operation shortcode<\/h3>\n\n\n\n
Call to action feature box shortcode<\/h3>\n\n\n\n
Headline appears here<\/h2><\/p>\n
UMS Post Picker<\/h3>\n\n\n\n
A useful example: embed the Academic Calendar events<\/h4>\n\n\n\n
That was a lot to take in, is there more?<\/h4>\n\n\n\n