Using Shortcodes with the UUA WordPress Theme
What Is a Shortcode?
A shortcode is a WordPress-specific code that you can include in the text of a page to display information. A shortcode can display a file or display information that would normally require lots of complicated, ugly code in just one line. Shortcode = shortcut. (More information.)
Enclose the shortcode in square brackets and enter it on a line by itself.
Shortcodes Included with the UUA Theme and Services Plugin
Note that there's an underscore, not a hyphen, in these shortcodes.
- [uuatheme_map] – Shows a Google map of the specified address.
- [uua_services] – Shows a list of upcoming (future) or past services from the UUA Services plugin.
Deprecated Shortcodes (used in earlier versions of the UUA Theme):
- [service-archive] – Replaced by [uua_services type="archive"]
- [upcoming-services] – Replaced by [uua_services]
- [uua_staffer] – Replace with [staffer] included in the Staffer plugin.
Shows a list of staff profiles from the Staffer plugin. We do not recommend the Staffer plugin unless you have a large staff; otherwise, it's easier to create a regular page for each staff and a page that lists them. - [uua_testimonials] – Shows five testimonials from the Testimonials by WooThemes plugin. Use the Jetpack Testimonials feature, as described in the "Our Stories" instructions, and the Jetpack [testimonials] shortcode instead.
Map Shortcode: [uuatheme_map]
Displays a Google Map of the address entered. You can add your Google API Key to the Customizer > Congregation Map settings for more advanced map options. If you don't, it defaults to the free embedded map.
You can use the following attributes with the [uuatheme_map] shortcode:
- address – (Required) Specify the address for the map.
- width – The width of the embedded map. Defaults to 100%
- height – The height of the embedded map. Defaults to 400px
Example:
[uuatheme_map address="6300 A Street, Lincoln, NE 68510"]
Services Shortcode: [uua_services]
Display services by type with support for pagination and sorting, replacing the need for these deprecated shortcodes: [upcoming-services] and [service-archive]. The deprecated shortcodes will be removed in a future release of the UUA Theme.
To specify whether you want past or upcoming services, use the type attribute. The type can be "upcoming" or "archive". If you omit the type, the default value is "upcoming".
Example 1: List the upcoming services:
[uua_services]
Example 2: List an archive of past services, with most recent services first:
[uua_services type="archive"]
We'll introduce other attributes in future versions of the plugin.
Staff Shortcode: [uua_staffer]
Lists the staffers from the Staffer plugin. Note: Early versions of the UUA theme recommended that you use the Staffer plugin to create staff listings. However, unless you have a large staff, just create a page for each staffer and link to it when appropriate. The Staffer plugin is unnecessary.
The [uua_staffer] shortcode will be removed in a future release of the UUA Theme. We recommend using the [staffer] shortcode included with the Staffer plugin instead.
Example: List staff in the RE department in ascending order by staff name:
[staffer department="re"]
Shortcodes Included with Recommended Plugins
These shortcodes are not part of the UUA theme or Services plugin. The explanation of each shortcode includes the name of the plugin from which it comes.
[categories_list]
Displays a list of event categories (which are explained in the Events Manager plugin documentation). Choose Events > Event Categories from the Dashboard to see and add to the list of event categories (which are different from news post categories).
[catlist]
Displays a list of news posts in a single category. E.g., [ catlist name="news" ]. Choose Posts > Categories from the Dashboard to see and add to the list of post categories (which are different from event categories). (List Category Posts plugin)
[contact-form to=’info@yourcongregation.org’][subject=’Contact from the Website’][contact-field label=’Name’ type=’name’ required=’1’/][contact-field label=’Email’ type=’email’ required=’1’/][contact-field label=’Comment’ type=’textarea’ required=’1’/][/contact-form]
Display a contact form via the Jetpack plugin. Replace “info@yourcongregation.org” with the email address to which form entries should be sent.
[events_calendar]
Displays a calendar of events. (Events Manager plugin).
[events_list]
Displays a list of events, with lots of options (which are explained in the Events Manager plugin documentation). This plugin offers a number of other shortcodes.
[image-carousel]
Displays a carousel, also known as a slider or slideshow. (CPT Bootstrap Carousel plugin) We recommend that you use the MetaSlider plugin instead.
[locations_list]
Lists locations where events can occur. Choose Events > Locations from the Dashboard to add locations. (Events Manager plugin)
[staffer]
Lists the staff from the Staffer plugin.
[testimonials]
Lists testimonials from the Jetpack plugin. Example: List 5 testimonials with only their titles:
[testimonials showposts="5" display_content=false]
This article about installing and using Jetpack for testimonials includes a list of shortcode options.