The UW 2014 Theme is available to anyone wishing to apply the Boundless UW brand to their website. This is an overview of the custom widgets, plugins and various features it includes.
- Quick start
- Bugs and feature requests
- Widgets
- Shortcodes
- Features
- Plugin guides
- Creators
- Contributors
- License
Download the UW 2014 theme into the wp-content/themes folder of your local WordPress install. Next, log into the WordPress dashboard and go the Appearance -> Themes page. From here you can activate the UW 2014 theme.
All bugs and feature requests can be issued at the UW Web Team's GitHub account or emailed directly to the UW web team at uweb@uw.edu.
Display the most recent posts on your blog.
Options:
- Title : The title of the widget (Default: Blogroll)
- Excerpt : Uses the excerpt for text if it exists in the post (Default: true)
- Image : Uses the featured image in the respective post (Default: hide)
- Author : Shows the authro (Default: show)
- Post type : Pulls a specific post type (Default: post)
- Category : Pulls from a category ID (Default: none)
- Category name : Pulls from a category name (Default: none)
- Mini blogroll : Creates a minified version of the blogroll for tighter spaces (Default: false)
- Date : Shows the published date (Default: show)
- Number of posts to display : The number of post titles to show in the blogroll (Default: 2)
Embed the location of a UW campus building on your page using the UW branded campus map.
Options:
- Title : The title of the widget (Default: None)
- Building code : The UW campus building code for the desired building to embed, ie: 'kne' for Kane Hall. (Default: None)
Similar to the default WordPress widget Recent Posts but with different options and layout.
Options:
- Title : The title of the widget (Default: None)
- Number of posts to display : The number of posts to show (Default: 1)
- Display more link : Display an anchor tag that links to the blogroll page (Default: false)
Uses the WordPress JetPack API to show a list of posts related to the one currently being views. Requires the JetPack Plugin to be installed otherwise it will not appear in the Widgets admin area.
Options:
- Title : The title of the widget (Default: None)
Requires the JetPack Plugin to be installed.
Similar to the WordPress RSS widget except with a branded layout that displays RSS images.
Options:
- Title : The title of the widget (Default: None)
- Blurb : A small blurb that is shown before the RSS feed (Default: None)
- RSS URL : The URL of the RSS feed to display (Default: None)
- Number of items to display : The number of items in the RSS feed to display (Default: 10)
Displays a single image with a blurb of text below it.
Options:
- Title : The title of the widget (Default: Image Widget)
- Select an image : Select an image from the WordPress media library (Default: None)
- Featured text : A small blurb that is shown below the image (Default: None)
- Link : A URL for the More link text (Default: None)
- More link : The text to display in the more link (Default: Read more)
Shows the most popular posts on your blog.
Options:
- Title : The title of the widget (Default: Image Widget)
- Number of items to display : The number of items in the RSS feed to display (Default: 1)
Requires JetPack to be installed.
Shows the latest tweets from a specific Twitter account.
Options:
- Title : The title of the widget (Default: UW Twitter Feed)
- Screen name : The title of the widget (Default: twitter)
- Number of tweets to show: The number of items in the RSS feed to display (Default: 5)
In order to have the widget display in the widgets a
TWITTER_OAUTH_TOKENconstant must be defined in your wp-config.php file. Requires a Twitter API key.
Displays a multiple list of contacts for the group/department.
Options:
- Title : The title of the widget (Default: Contact us)
- Name : The person's name (Default: None)
- Title : The person's job title (Default: None)
- Phone number : The person's phone number (Default: None)
- Email : The person's email (Default: None)
Displays one of three styles of branded card. Both text and image can be customized.
Options:
- Title : The title of the widget (Default: Image Widget)
- Select an image : Select an image from the WordPress media library (Default: None)
- Featured text : A small blurb that is shown below or on top of the image (Default: None)
- Link : A URL for the More link text (Default: None)
- More link : The text to display in the more link (Default: Read more)
- Card style : Choose one of three styles (Default: None)
Displays a branded call to action button. See some examples.
Attributes:
- color : The color of the button. Options: gold or gray (Default: gray)
- type: Adjusts the image of the button. Options: plus, go, external, play (Default: go)
- small: Adjusts the size of the button. Options: small, large (Default: large)
- url: The URL where the button links to (Default: None)
Example:
[button color=gold type=plus small=true url="http://uw.edu"]Button Text[/button]`
This is a shortcode that wraps the WordPress get_posts function and templates out a blogroll. Any parameter you can pass to
get_postswill be understood along with the following.
Attributes:
- excerpt : Choose whether to show the excerpt in the blogroll. Options: show, hide. (Default: hide)
- trim : Whether or not to trim the words via WordPress wp_trim_words function. Options: true, false. (_Default: _false)
- image: Choose whether to show the featured image thumbnail. Options: show, hide. (Default: hide)
- author: Choose whether to show the author. Options: show, hide. (Default: show)
- date: Choose whether to show the publish date. Options: show, hide. (Default: show)
- titletag: The html element for the post titles. (Default: h2)
- post_type: The post type to look for.(Default: post)
- number: The maximum number of results to return (Default: 5)
- mini: Use the miniture template instead of the default one. (Default: false)
- category: The WordPress category ID to limit the results from. (Default: None)
- category_name: The WordPress category name to limit the results from. (Default: None)
- readmore: Choose whether to show the "Read More" link or not. Options: on, off. (Default: on)
Example:
[blogroll number=3 trim=true readmore='off']
Embed iframes into your post or page content without adjusting WordPress privileges. The iframe url is tested against a list of allowed domains. If the domain is not in the list the iframe will not render.
Attributes:
- src : The source URL of the embedded iframe (Default: none)
- height : The width of the embedded iframe (_Default: WordPress's embed size width setting )
- width : The height of the embedded iframe (_Default: WordPress's embed size height setting )
Example:
[iframe src="https://www.youtube.com/embed/0h33Y9Zw8oQ" height="500" width="700"]
Allowed domains:
uw.edu,
washington.edu,
uwtv.org,
tvw.org,
google.com,
youtube.com,
excition.com,
pgcalc.com,
matchinggifts.com,
docs.google.com,
surveygizmo.com,
uwregents.wufoo.com,
depts.washington.edu,
online.gifts.washington.edu,
secure.gifts.washington.edu,
payroll.gifts.washington.edu,
helperapps.gifts.washington.edu,
This shortcode creates an italicized block of introduction text for the content.
No attributes.
Example:
[intro] A block on introductory text for the content. [/intro]
This is a shortcode embeds an RSS blogroll into the body content. It behaves similarly to the UW RSS Widget.
Attributes:
- url : The URL to parse for the RSS feed. (Default: None)
- number: The maximum number of results to return (Default: 5)
- title: The title for the RSS blogroll in the content (Default: None)
- heading: The html element for the post titles. (Default: h3)
- show_image: Choose whether to show the RSS thumbnail. Options: true, false. (Default: true)
- show_date: Choose whether to show the publish date. Options: true, false. (Default: true)
- show_more: Choose whether to show the author. Options: true, false. (Default: true)
Example:
[rss url="http://www.washington.edu/marketing/topic/wordpress/feed" number=3 title="Web Team Updates" heading="h2" show_image="false" show_date="false"]
Display branded tiles to structure content in elegantly. See an example of tiles here. Each tile is setup as a series of shortcodes wrapped in
[box]shortcode.
Attributes:
- alignment : How the text is aligned in each tile. Options: centered or none (Default: none)
- color : Background color of the tiles. Options: tan (Default: none)
- empty : (Add this to [tile], not [box]). If tile has no content, allow it to be transparent, but take up the normal amount of space. Options: true (_Default: false)
Example:
[box alignment=centered]
[tile] Text for tile one [/tile]
[tile] Text for tile two [/tile]
[tile] Text for tile three [/tile]
[tile] Text for tile four [/tile]
[/box]
Display a Trumba calendar spud in the post or page content.
Attributes:
- name : Required Trumba web name of the desired calendar (Default: none)
- type : The Trumba spud type of the desired calendar. Changing the type will change how the calendar is displayed. A list of all spud types can be found here. (Default: none)
- base : The full url of the desired base calendar. This can be embedded on your site with the spud type='main' (Default: none)
[trumba name='my web name' type='desired spud type' base='teaser base url']
Example:
[trumba name='sea_campus' type='main' base='https://www.washington.edu/calendar']
This is a shortcode embeds a Twitter feed for a desired username. It behaves similarly to the UW Twitter Widget.
Attributes:
- Title : The title of the widget (Default: UW Twitter Feed)
- Screen name : The title of the widget (Default: twitter)
- Number of tweets to show: The number of items in the RSS feed to display (Default: 5)
Example:
[twitter title="Twitter feed" count=10 name=uw]
In order to have the shortcode display a
TWITTER_OAUTH_TOKENconstant must be defined in your wp-config.php file. Requires a Twitter API key.
Embed a YouTube video or playlist into your post content. You will need to obtain a Youtube API key to use this feature. You can acquire one from YouTube using your UW GSuite account or get in touch with us uweb@uw.edu for assistance.
Attributes:
- type : Pick whether to display a single video or playlist. Options: single, playlist. (Default: None)
- id : The youtube video or playlist id (Default: None)
- max-results (OPTIONAL): The maximum number of results to return for a playlist (Default: None)
Example:
[youtube type='playlist' id='PLgNkGpnjFWo9CN_HeVtujhMnUXK05iwgZ' max-results='10']
Embed a slideshow into your post content. Requires the UW Slideshow Plugin (https://github.com/uweb/uw-slideshow).
Attributes:
- id : Enter the ID of the slideshow you have created via the Dashboard > Slideshows. (Default: None)
- simple : The youtube video or playlist id (Default: None)
Example:
[slideshow simple='true' id='1234']
This shortcode lists out all the subpages relative to the current page. There are two views this shortcode can render: list or grid. The list view displays all the subpages as anchor tags in an HTML list element. The grid view displays all the subpages as boxes, with their title, excerpt and author if available.
Attributes:
- link : The text in the anchor tag that will link to the subpage (Default: Read more)
- tilebox : Enable the grid layout of the subpages ( Default: false )
Example:
[subpage-list link="More information here" tilebox=true ]
This is an accessible version of the accordion menu based off of Nicolas Hoffmann's accessible jQuery accordion
Example:
[accordion name='Accessible Accordion']
[section title='Example'] Section[/section]
[section title='Example'] Section[/section]
[section title='Example'] Section[/section]
[/accordion]
This shortcode pulls in a custom menu that can be created under Dashboard > Appearance > Menus. Icons can be added in the class field in the menu builder. View the full set of icons for more information.
Example:
[custommenu menu=Menu-name-here]
Attributes:
- menu : Enter the name of the menu found in Dashboard > Appearance > Menus. (Default: Main menu)
This shortcode embeds a Tagboard feed onto the page. Tagboards that you wish to embed should already be embeddable. You can check that your Tagboard is embeddable by visiting the Tagboard's dashboard and looking for the embed icon.
Attributes:
- slug : the ID of your Tagboard. This can be found by visiting your Tagboard's dashboard and looking for the 6-digit ID at the end of the url. (Default: none)
- layout : the layout of the Tagboard. Options: grid, waterfall, carousel (Default: grid)
- post-count : the number of posts to display (Default: 50)
- mobile-count : the number of posts to display on mobile (Default: 50)
- toolbar : whether or not the toolbar is displayed. Options: default, none. (Default: default)
- feed-type : auto or default. Choosing auto will only show featured posts. If toolbar="default", choosing default will allow the user to show latest posts or featured posts. (Default: default)
Example:
[tagboard slug="435487" layout="waterfall" post-count="30" mobile-count="15" toolbar="none" feed-type="auto"]
This feature provides granular control over where each widget appears on your site. It is based on the JetPack Widget Visibilityj plugin and allows you to choose specific pages, authors, categories etc. to show a widget on. Follow the link for a brief tutorial on its usage.
This feature allows images to have author credits next to them. When an image is selected in the Media Library a field for Media Credit will appear next to its other attributes. This credit will always appear after the image caption.
Additional plugins can be used to extend the functionality of the UW-2014 theme. A number of them can be found at the University Markeitng & Communications Github repository.
This WordPress plugin provides content authors with two short codes they can use on their pages to invoke the Marketo Subscription widget and UW Preference Center widget. The code for both of these widgets are JavaScript files that are provided by the Information Management team in Central Advancement. More information about that code can be found here: https://uwmarketo.freshdesk.com/support/solutions/articles/33000214924-how-can-i-add-a-call-out-button-on-my-website-for-people-to-sign-up-for-our-enews-
The Marketo Subscription widget allows visitors to sign up for one or more Marketo emails/newsletters. To place the Marketo Subscription widget on a page, use the following shortcode:
[uw-subscription-form subscriptionid="1234" fromname="Department of Redundancy Department" fromemail="raddept@uw.edu" showplaceholders="true" hidelabels="true" returnurl=""]
All of the attributes are optional; if no attribute is supplied a default value will be used. The attributes are:
- subscriptionid: This is the ID number of your Marketo email/newsletter. The E-Communications team can get this number for you if you do not already know it. If you want to subscribe to more than one, you can separate ID's with a comma (eg, subscriptionid="1234,1235,1236"). The default subscription is "27." This must be a number!
- fromname: This is name you would like users to see in the From line of the email. The default name is "UW Email Sign Up."
- fromemail: This is the email address associated with the from name. The default address is "mktosubp@uw.edu." This must be a valid email address.
- showplaceholders: This true/false option will show the field names inside of the form field if set to true. The default value is false. If set to false, it is recommended to set hidelables to false.
- hidelabels: This true/false option will hide the labels above the form fields if set to true. The default value is false. If set to true, it is recommended to set showplaceholders to true.
- returnurl: If during the subscription process, you want the user to be taken to another location, enter that here. The default is to send the user back to the same page. It is highly recommended not to change this unless you know what you are doing!
The UW Preference Center widget allows visitors to manage all of their Marketo subscriptions in one place. To place the UW Preference Center widget on a page, use the following shortcode:
[uw-preference-center preferenceid="1234" managepreferences="true" fromname="Department of Redundancy Department" fromemail="raddept@uw.edu" showheader="true"]
All of the attributes are optional; if no attribute is supplied a default value will be used. The attributes are:
- preferenceid: This is the ID number of your Marketo organization (ie, the account under which all of your emails/newsletters live). The E-Communications team can get this number for you if you do not already know it. The default value is "21."
- managepreferences: This true/false value will determine if the user can manage all of their Marketo preferences through this widget. The default value is true, and it is highly recommended to keep that value.
- fromname: This is name you would like users to see in the From line of the email and throughout the Preference Center. The default name is "UW Email Sign Up."
- fromemail: This is the email address associated with the from name. The default address is "mktosubp@uw.edu." This must be a valid email address.
- showheader: This true/false value will determine whether the Preference Center header is shown. The default value is true, but you are advised to try both true and false values to determine which look may be most appropriate for your site.
Contact Form 7 is the contributed form building plugin used by the UMAC Web Team for creating simple web forms.
Spam messages can cause headaches and security issues on any website. It's important to always enable anti-spam meausres when creating any web form. Ensure that name or email address fields are required for all forms. Akismet is highly recommended for all WordPress sites and can be used with Conact Form 7. ensure that Akismet is enabled and add the akisement:author and akisment:author_email are added to the respectives form fields, similar to the example below:
<p>Your Name (required)<br />
[text* your-name akismet:author] </p>
<p>Your Email (required)<br />
[email* your-email akismet:author_email] </p>Further prevention to block spam bots from submitting forms can be added with a simple quiz field appended to your form. Quizzes are required by default. Example:
<p>Spam verification (required)<br />
[quiz quiz-134 "Which of these is a color: hand, purple, grass?|purple"
"What is the capital of France?|Paris"
"Which number is larger, 43 or 16?|43"]</p>
Dane Odekirk Jon Swanson Kilian Frey
GPL-2.0+