Category: Assets

Advanced Forms

The Forms asset within the CMS includes the ability for advanced functionality. This functionality may change on a frequent basis, so be sure to check back often for the latest information. If you have a specific form need that is not addressed with the current advanced features available, please contact cmshelp@mtu.edu.

Some of the advanced functionality includes legends, additional classes, fieldsets, sizes, and prebuilt datasets. You can also set up a form to email different people depending on a certain radio button selection.

  • Each element has the Advanced field attribute.
  • Every declaration in the Advanced field must be terminated with a semicolon (;).
  • Attributes are always lowercase.

Advanced Field Reference Table

Attribute Name Syntax Example Description
fieldset_start fieldset_start=true; Defines the opening tag for a fieldset tag within the form. This is used in conjunction with fieldset_end to set off a group of elements. It can also be used with fieldset_label to define a label for the group.
fieldset_end fieldset_end=true; Defines the closing tag for a fieldset and is used in conjunction with fieldset_start and fieldset_label.
fieldset_label fieldset_label=About; Defines the label of the fieldset. For example, if the group should be labeled “About” then that can be defined here. It can be entered without quotes and can include spaces.
rows rows=10; Adds a rows attribute with the specified value to a multi-line text field. It specifies the number of visible lines for a text area, but does not determine the number of allowed input characters.
dataset dataset=state; Adds a predefined dataset to a radio button, checkbox, drop-down, or multi-select element. This is useful for data that are frequently used, but tedious to type. For example, the “state” dataset includes all 50 United States. See the next table for available datasets.
emails emails=name@something.com|option2@example.com|email3@mtu.edu; Generates email based on radio button selection. This code would go in the advanced field of the radio button element with the email for each option separated by | in the same order as the options. In the To field of the email setup, reference the radio button element name, like {{radioelement}}.
field_type field_type=tel; On Single Line Text elements, sets the field type to determine what keypad is displayed on mobile devices. Options are “number”, “tel”, or “email” (without quotation marks).

Available Datasets

Dataset Displayed Data
state Alabama,  Alaska,  Arizona,  Arkansas,  California,  Colorado,  Connecticut,  Delaware,  Florida,  Georgia,  Hawaii,  Idaho,  Illinois,  Indiana,  Iowa,  Kansas,  Kentucky,  Louisiana,  Maine,  Maryland,  Massachusetts,  Michigan,  Minnesota,  Mississippi,  Missouri,  Montana,  Nebraska,  Nevada,  New Hampshire,  New Jersey,  New Mexico,  New York,  North Carolina,  North Dakota,  Ohio,  Oklahoma,  Oregon,  Pennsylvania,  Rhode Island,  South Carolina,  South Dakota,  Tennessee,  Texas,  Utah,  Vermont,  Virginia,  Washington,  West Virginia,  Wisconsin,  Wyoming
state_michigan (the default for this dataset is set to Michigan) Alabama,  Alaska,  Arizona,  Arkansas,  California,  Colorado,  Connecticut,  Delaware,  Florida,  Georgia,  Hawaii,  Idaho,  Illinois,  Indiana,  Iowa,  Kansas,  Kentucky,  Louisiana,  Maine,  Maryland,  Massachusetts,  Michigan,  Minnesota,  Mississippi,  Missouri,  Montana,  Nebraska,  Nevada,  New Hampshire,  New Jersey,  New Mexico,  New York,  North Carolina,  North Dakota,  Ohio,  Oklahoma,  Oregon,  Pennsylvania,  Rhode Island,  South Carolina,  South Dakota,  Tennessee,  Texas,  Utah,  Vermont,  Virginia,  Washington,  West Virginia,  Wisconsin,  Wyoming
state_ab AK, AL, AR, AZ, CA, CO, CT, DC, DE, FL, GA, HI, IA, ID, IL, IN, KS, KY, LA, MA, MD, ME, MI, MN, MO, MS, MT, NC, ND, NE, NH, NJ, NM, NV, NY, OH, OK, OR, PA, RI, SC,  SD, TN, TX, UT, VA, VT, WA, WI, WV, WY
state_ab_mi (the default for this dataset is set to MI) AK, AL, AR, AZ, CA, CO, CT, DC, DE, FL, GA, HI, IA, ID, IL, IN, KS, KY, LA, MA, MD, ME, MI, MN, MO, MS, MT, NC, ND, NE, NH, NJ, NM, NV, NY, OH, OK, OR, PA, RI, SC,  SD, TN, TX, UT, VA, VT, WA, WI, WV, WY
country (the default for this dataset is set to United States) Afghanistan, Albania, Algeria, Andorra, Angola, Antigua and Barbuda, Argentina, Armenia, Australia, Austria, Azerbaijan, Bahamas, Bahrain, Bangladesh, Barbados, Belarus, Belgium, Belize, Benin, Bhutan, Bolivia, Bosnia and Herzegovina, Botswana, Brazil, Brunei, Bulgaria, Burkina Faso, Burma, Burundi, Cambodia, Cameroon, Canada, Cape Verde, Central African Republic, Chad, Chile, China, Colombia, Comoros, Congo (Brazzaville), Congo (Kinshasa), Costa Rica, Cote d"Ivoire, Croatia, Cuba, Cyprus, Czech Republic, Denmark, Djibouti, Dominica, Dominican Republic, East Timor, Ecuador, Egypt, El Salvador, Equatorial Guinea, Eritrea, Estonia, Ethiopia, Fiji, Finland, France, Gabon, Gambia, Georgia, Germany, Ghana, Greece, Grenada, Guatemala, Guinea, Guinea-Bissau, Guyana, Haiti, Honduras, Hungary, Iceland, India, Indonesia, Iran, Iraq, Ireland, Israel, Italy, Jamaica, Japan, Jordan, Kazakhstan, Kenya, Kiribati, North Korea, South Korea, Kuwait, Kyrgyzstan, Laos, Latvia, Lebanon, Lesotho, Liberia, Libya, Liechtenstein, Lithuania, Luxembourg, Macedonia, Madagascar, Malawi, Malaysia, Maldives, Mali, Malta, Marshall Islands, Mauritania, Mauritius, Mexico, Federated States of Micronesia, Moldova, Monaco, Mongolia, Montenegro, Morocco, Mozambique, Namibia, Nauru, Nepal, Netherlands, New Zealand, Nicaragua, Niger, Nigeria, Norway, Oman, Pakistan, Palau, Panama, Papua New Guinea, Paraguay, Peru, Philippines, Poland, Portugal, Qatar, Romania, Russia, Rwanda, Saint Kitts & Nevis, Saint Lucia, Saint Vincent and the Grenadines, Samoa, San Marino, Sao Tome and Principe, Saudi Arabia, Senegal, Serbia, Seychelles, Sierra Leone, Singapore, Slovakia, Slovenia, Solomon Islands, Somalia, South Africa, Spain, Sri Lanka, Sudan, Suriname, Swaziland, Sweden, Switzerland, Syria, Tajikistan, Tanzania, Thailand, Togo, Tonga, Trinidad & Tobago, Tunisia, Turkey, Turkmenistan, Tuvalu, Uganda, Ukraine, United Arab Emirates, United Kingdom, United States, Uruguay, Uzbekistan, Vanuatu, Venezuela, Vietnam, Yemen, Zambia, Zimbabwe
year 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020
month Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec
alphabet
A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y, Z
numbers  1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100

Continue Reading


Global Asset Listing

There are several assets created and maintained by University Marketing and Communications, described below, that can be  used on your website. As the data included in these assets changes, we will update them and the updated information will automatically update on any pages where the asset is used. Check back as this list gets updated as new assets are added. Suggestions for new assets can be sent to cmshelp@mtu.edu. These assets will all begin with [Global].

  • Apply Now Button (/apply/): This asset is a gold button with the text “Apply Now” that links to the Banweb application page.
  • Apply Now No-Box Sidebar Button (Banweb): This asset include the Sidebar Right No Box snippet around a gold button with the text “Apply Now” that links to the Banweb application page. It should only be used in a Right Sidebar region.
  • General Enrollment Stat: This asset is only text showing the current advertised enrollment number.
  • Generic Social Media Feed Connect: This asset displays recent social media posts and links to social media for Michigan Tech. At this time, this asset can only display Michigan Tech content. There is no option to customize for a specific department.
    Social Media connect widget.
  • Job Posting Template Campus and Community Section: This is the Campus and Community information section that can be used in the Main Content region of a page that includes a heading, paragraph, and images. This is found in the jobs template.
    Campus and Community global asset content.
  • Job Posting Template Relocation Resources: This is the Relocation Resources section that can be used in the Main Content region of a page that includes a heading, text, and links. This is found in the jobs template.
    Relocation Resources asset content.
  • Jobs Page Template About Michigan Tech Sidebar: This asset is a Sidebar Right Boxed snippet with a title of “About Michigan Tech” then links to various informational pages. It should only be used in a Right Sidebar region.
    About Michigan Tech boxed sidebar.
  • Tout #: The assets beginning with “Tout #” are most commonly used in List Spread Tout Buttons snippets in the Button Text (Linked) field. This is the number or statistic portion of the statement. Use this asset in conjunction with the matching “Tout Text” asset. Where possible, the content is linked to an appropriate webpage, creating the Go button functionality of the touts.
  • Tout Text: The assets beginning with “Tout Text” are used in conjunction with the matching “Tout #” asset. This is the text portion of the statement. In a List Spread Tout Buttons snippet, this asset is used in the Content After field.
  • Undergraduate Admissions Sidebar: This asset is a Sidebar Right Boxed snippet with a title of “Admissions” then links to important admissions information. It should only be used in a Right Sidebar region.
    Admissions boxed right sidebar with links.

Continue Reading


Assets

Assets are pieces of content that are saved in a central location that can be used on multiple pages or in multiple sites. If the asset content is changed that change is applied to all pages using it.

To insert an asset, click the asset icon asset-icon, select the asset you want to use, and click Insert. The actual asset content will not be visible while you are editing. You will be able to see it from the preview. Some University-wide assets have already been created for you to use including university-wide touts. Since it can change frequently, a description of available assets can be found at blogs.mtu.edu/webmaster/asset-listing.

Assets can be created by selecting Assets from the Content menu in the Global Navigation bar. You could create an asset for content that will be used on multiple pages, within your site or among other sites, so you don’t have to recreate it each time you use it and so that all instances of it can be updated at once. There are four types of assets that are available: Web Content, Plain Text, Image Gallery, and Form. Instead of using the Image Gallery asset, you should use the Image Gallery snippet.

After creating the asset, you must publish it. When you edit an asset and publish it, the page(s) that are using the asset are automatically published.

Editing an Existing Asset

When an asset it used on your page, it will appear similar to the following screen shot in the editor screen of the web page.

Screen shot of text showing content is within an asset.

  1. Make note of the title listed in bold.
  2. Go to Content > Assets in the Global Navigation Bar.
  3. Use the filter field at the top of the screen to type in text from the title of the asset to find the correct asset.
  4. Open the asset by clicking on the name in the listing.
  5. Check out the asset by clicking on the lightbulb icon.
  6. Go to the Edit tab.
  7. Edit the content.
  8. Save your changes using the blue Save button at the bottom of the screen.
  9. Publish the asset. This will also publish all pages that are using the asset so they will be updated.

Continue Reading


Form Asset

A form asset can be set up to collect information from users that can be submitted via email with the option to also collect it in a database within the CMS. You can configure form elements, email messages, and success or failure messages.

form-asset

From the assets screen, click on the arrow next to the green +New button in the upper right corner and select Form.

Asset Info and Access Settings

form-asset-info

  • Name: Enter the name for the asset. Start the name with your site URL in brackets to keep things organized.
  • Description: Enter a description for the asset, if desired.
  • Tags: Assets can be filtered by tag. Enter tag information, if desired.
  • Lock to site: Skip this item.
  • Access Group: Select the site name from the dropdown so that only people with access to edit your site can edit your asset.
  • Available To: This can be left at Everyone if you think it may be useful in other sites. If you set this to your site name, it can only be used within your site.

Form Elements

form-elements

Next you will add the Form Elements, the fields that the user will fill out. Click the green plus icon next to the type of field you want to add in the menu on the left. You will be able to rearrange the fields by clicking the header section of the field and dragging it up or down.

Almost all elements, except Instructional Text, have common fields that you will fill out.

  • Label: The text describing the field, such as First Name.
  • Name: This field will automatically populate based on what you entered in the Label field. You can change it to be shorter if desired, but it must be all lower case letters only. This may be used to reference this field in code and as the heading for the field in the database and email.
  • Helper Text: You can choose to enter a longer description to help the user fill out the field.
  • Required: Check the box if the user must fill out this field.
  • Failure Message: This field will appear if you choose Required or one of the Validation methods other than None. Enter text that will appear if the user doesn’t meet the requirement. An example would be “A valid email address is required.”
  • Advanced: This field is used for advanced operations. New operations may be added at any time.

Single-Line Text Field

This element will allow the user to enter short answers. This is good for name, phone number, email, address, or similar fields.

form-single-line

Additional fields you will see in this element are:

  • Default Text: You can choose to enter an example of what should be entered in the field that will disappear when the user clicks into the field.
  • Validation: Choose an option from the dropdown if you want the system to verify the information entered by the user.
    • Email Address: Will make sure the entry includes @ followed by text, a period, and additional text.
    • Minimum Length: Will make sure the entry includes at least a certain number of characters. You will set the minimum length in an additional field that appears if this option is selected.
    • Regular Expression: This is an advanced method for verification using standard Regular Expression code that is entered in an additional field that appears if this option is selected.

Multi-Line Text Field

This element will allow the user to enter longer answers that may include multiple paragraphs. It provides a larger entry box that expands as needed.

form-multi-line

Additional fields you will see in this element are:

  • Default Text: You can choose to enter an example of what should be entered in the field that will disappear when the user clicks into the field.
  • Validation: Choose an option from the dropdown if you want the system to verify the information entered by the user.
    • Email Address: Will make sure the entry includes @ followed by text, a period, and additional text.
    • Minimum Length: Will make sure the entry includes at least a certain number of characters. You will set the minimum length in an additional field that appears if this option is selected.
    • Regular Expression: This is an advanced method for verification using standard Regular Expression code that is entered in an additional field that appears if this option is selected.

Radio Buttons

This element creates a field with multiple, predefined items of which one and only one can be selected by the user. You should use this option instead of drop-down when you have 7 or fewer options to select from.

form-radio

Additional fields you will see in this element are:

  • Items: Click the green +Add button for each option you need to list. Enter the text in the field for each option. You can change the order of the options by clicking and dragging the up/down arrows to the left of each option. Use the x to the right to delete an option.

Checkboxes

This element creates a field with multiple, predefined items of which none, one, or more than one can be selected by the user.

form-checkboxes

Additional fields you will see in this element are:

  • Items: Click the green +Add button for each option you need to list. Enter the text in the field for each option. You can change the order of the options by clicking and dragging the up/down arrows to the left of each option. Use the x to the right to delete an option. If you select one or more of the options when creating or editing the form, those items will be preselected on the live page also.

Drop-Down

This element gives users the ability to select an item from a list of predefined options using a dropdown style menu. You should use this option instead of radio buttons when you have 8 or more options to select from.

form-dropdown

Additional fields you will see in this element are:

  • Items: Click the green +Add button for each option you need to list. Enter the text in the field for each option. You can change the order of the options by clicking and dragging the up/down arrows to the left of each option. Use the x to the right to delete an option.
  • Preview: The option that appears in the Preview field is the default option the user will see on the live page. You can change this by selecting the desired option from the Preview dropdown.

Multi-Select

This element includes the ability to select multiple items from a list using the keyboard shortcut CTRL + click on a PC.

form-multi-select

Additional fields you will see in this element are:

  • Items: Click the green +Add button for each option you need to list. Enter the text in the field for each option. You can change the order of the options by clicking and dragging the up/down arrows to the left of each option. Use the x to the right to delete an option.
  • Preview: The option that appears in the Preview field is the default option the user will see on the live page. You can change this by selecting the desired option from the Preview dropdown.

Date/Time Picker

This element allows users to select a calendar date and/or time of day.

form-date-time

Additional fields you will see in this element are:

  • Format: Choose from Date and Time, Date, or Time.
  • Default Date/Time: Set a default if desired, otherwise leave blank.

Instructional Text

This element allows you to include additional text within the form. A mini-editor will allow you do format and configure the text to be displayed. Images, videos, and other media can NOT be included. Users will not submit any data with this element.

form-instructions

This element does not include all the standard fields that are found in the other elements. Other than Name and Advanced you will enter your text for the user in the mini-editor.

Email Messages

The next section is where you will set up Email Messages. A user submitting a form will trigger the configured message(s) to be sent. You can create multiple messages to be sent and a single message can be sent to multiple people.

Click the green +Add button in the Email Messages section to create a new email message. In any field you can reference one of the form elements to include the data entered in that field by the user. To do this, enter {{Name}} where Name is the value in the Name field for that form element. For example, if you have an element with a Label of Email Address and the Name is emailaddress, you could put {{emailaddress}} in the To field to send an email to the person who submitted the form. Once you type {{ and the first letter, a select list will appear that you can choose from.

form-email

  • To: Enter the email address that the message should be sent to. Separate multiple addresses with a semi-colon (;). If you use a comma or any spaces it will break the form.
  • From: Specify the email address that should appear as the sender.
  • Subject: Enter text to appear in the subject line of the email message.
  • Body: This is the content that will appear in the body of the email. There is a 3,000 character limit.
  • Include all submitted values: Select this checkbox to display all data from the form in the message.

Note: If you are setting the To: to a Google Group email address and the form is submitted by someone with an email address other than mtu.edu, those emails will go into your Pending messages on your Group unless you change the Settings > Moderation > Spam messages option to “Skip the moderation queue and post to the group.”

Google Group moderation settings.

Form Settings

Finally, you will complete the Form Settings section which includes success and failure messages.

form-settings

  • Success Message: From the dropdown, choose Text to create a custom message that will appear on the screen or URL Redirect to specify a different webpage that the user will be brought to when the form is successfully submitted. If you choose Text, enter the content for your message in the mini editor window beneath the dropdown.
  • Failure Message: Enter the content for a message that will appear on the screen is the user tries to submit the form, but does not meet all the required or validated fields.
  • Save Results in Database: Leave this option selected to save all results within a database in the OU Campus system.
  • Submission Button Text: By default, the text on the submission button is “Submit.” Enter text in this field to change that to a different label.
  • Advanced: This field is used for advanced operations. Additional information about the use of this field can be found at mtu.edu/webmaster/advanced-forms as this information may change frequently.

When you have completed all form options, click the blue Create button to create the asset. Be sure to publish the asset then insert the asset onto your page for users to access.

Continue Reading


Plain Text Asset

This asset is only for unformatted text only—no links or additional styling applied. An example of this is the text used in touts that is entered into one of the List Spread Tout Buttons snippets.

plain-text-asset

From the assets screen, click on the arrow next to the green +New button in the upper right corner and select Plain Text.

plain-text-window

  • Name: Enter the name for the asset. Start the name with your site URL in brackets to keep things organized.
  • Description: Enter a description for the asset, if desired.
  • Tags: Assets can be filtered by tag. Enter tag information, if desired.
  • Lock to site: Skip this item.
  • Access Group: Select the site name from the dropdown so that only people with access to edit your site can edit your asset.
  • Available To: This can be left at Everyone if you think it may be useful in other sites. If you set this to your site name, it can only be used within your site.
  • Asset Content: This is where you will create your content. Enter the desired text.
  • Click the blue Create button when you are done to create the asset.
  • Publish the asset so that it will be visible when it is on a live website.

Continue Reading


Web Content Asset

This asset is used for entering formatted text or media items. You might create a snippet (such as a Sidebar Right: Box), linked text, content that includes images or videos, or other formatted content. Content is created in an editor similar to the TinyMCE editor that is used for content.

web-content-asset

From the assets screen, click on the arrow next to the green +New button in the upper right corner and select Web Content.

web-content-window

  • Name: Enter the name for the asset. Start the name with your site URL in brackets to keep things organized.
  • Description: Enter a description for the asset, if desired.
  • Tags: Assets can be filtered by tag. Enter tag information, if desired.
  • Lock to site: Skip this item.
  • Access Group: Select the site name from the dropdown so that only people with access to edit your site can edit your asset.
  • Available To: This can be left at Everyone if you think it may be useful in other sites. If you set this to your site name, it can only be used within your site.
  • Asset Content: This is where you will create your content. The editor is similar to the content editor, though some of the icons may look slightly different.
  • Click the blue Create button when you are done to create the asset.
  • Publish the asset so that it will be visible when it is on a live website.

Continue Reading