MVC functions

  • config()
  • theme()
  • module()
  • page()

Usage:

<?php page()->getValue(‘pageTitle’); ?>

Parameters available for config():

  • SystemName
  • SystemLogoFilename
  • InstitutionName
  • InstitutionAbbreviation
  • InstitutionLogoFilename
  • GeneralSupportEmailAddress
  • GenerealSupportPhoneNumber
  • SystemTheme
  • DefaultEMSRegistrationURL

In addition, the following functions are available:

  • getPage($module, $action)
  • getPageParent($parent)
  • getTheme()
  • getSystemName()
  • getModule($moduleProgrammaticName)
  • getCMSCategories()
  • getConfigurationValues($xpath)
  • getDefaultEMSRegistrationURL()

Parameters available for theme()

  • ?

Parameters available for module()

  • FullName
  • ProgrammaticName
  • ShortName
  • Abbreviation
  • DescriptionCMSCategory
  • ModuleTheme
  • ModuleEmailAddress
  • ModulePhoneNumber
  • ModuleContacts

Parameters available for page()

  • Title
  • PageModule
  • PageAction
  • PageParent
  • PageTheme
  • PageTemplate
  • PageDescription
  • PageCMSCategories
  • PageLegacyPath
  • PagePermission
  • PageShowInMenu

Add a message template to EMS

To create an email, first navigate to the Message template tab from the main dashboard of your event. In there, you will need to create a new template.

In Template Name, type in a name that you can identify the template by. This name will only show up in the admin, i.e., users won’t see it when they receive an email.

Subject is the subject line of the email.

Default Send From is the person the email will be sent from using the email message management through the form builder.

Type corresponds to the icon on the main dashboard next to a person’s name. If you set a message template as an invitation and then send the invitation to a person in the list, the invitation icon will show up next to their name.

Template lets you choose a pre-defined template (header and footer for the email), if any are available.

Tags are the way to dynamically populate an email. If you would like your email to read Dear [first name], position your cursor in the correct spot in the body of the email, find the tag First Name (or other appropriate tag) in the tags drop down and click add.

Signatures allow you to add a signature for a person to an email if any are available. Position your cursor in the correct spot in the body of the email, find the appropriate signature in the Signature drop down and click add.

The large box in the middle is the message body. It is a wysiwyg editor which allows you to do simple formatting like bold italic & bullets. You can also insert links. More advanced html may be inserted through the source button in the menu.

Attachments can also be added. Click browse and upload an attachment. The file that is uploaded in this section will be attached to the message when it is sent.

When finished editing, click the save icon in the top menu. Your message will now be available when sending an email to a list of people.

Buttons

<input type="button" value="submit" class="redHightlightButton" />

<a class="redHightlightButton" />link</a>

link

<a class="redHightlightButton" />link</a>

link

<a class="highlightedLink" />link</a>

link

<a class="highlightedLink disabled" />link</a>

link

Message Boxes

Message Title

<div class=”GoodMessageBox”><h3>Message Title</h3>Message text</div>

Message Title

<div class=”WarningMessageBox”><h3>Message Title</h3>Message text</div>

Message Title

<div class=”ErrorMessageBox”><h3>Message Title</h3>Message text</div>

Message Title

<div class=”NoteMessageBox”><h3>Message Title</h3>Message text</div>

Grid system

To implement, use the class names from below. Ex: <div class="grid6">. For the first column in a row (the left-most column), you must add the class first. Ex: <div class="grid6 first">

 

grid1
grid11
grid2
grid10
grid3
grid9
grid4
grid8
grid4
grid4
grid4
grid5
grid7
grid6
grid6
grid3
grid3
grid1
grid5
grid1
grid5
grid3
grid3
3
3
3
3
5
2
2
3
3
2
1
1
6
4

 

Examples:

<div class=”grid3 first gridTopBottomPadding”>

This is an example of columns with some padding: gridTopBottomPadding. Margin can also be used: gridTopBottomMargin

<div class=”grid9 gridTopBottomPadding”>

<div class=”grid3 first gridTopBottomPadding”>

This is an example of columns with the divider line gridLeftDividerLine:

<div class=”grid9 gridTopBottomPadding gridLeftDividerLine”>

Set up an EMS form with the form builder

This article is in reference to the Event Management System (EMS).

There are two sides to EMS, what the public sees (front end) and what the event managers see (back end). This tutorial covers what the event managers see on the back end. When a new event is created and a public link to that event is sent out, users on the front end will see a page which allows them to register and fill out the appropriate fields set up by an event manager.

Once a new EMS event is created, the form builder for that event is available. If you have just created the event and saved it, chances are you will automatically be taken to the form builder page. Otherwise, from the EMS homepage, select the event you would like to edit. Once in that event, click on the edit button in the upper right hand corner of the screen. This will take you to a page where you can edit the event’s information and also build a form.

Form builder elements

The form builder components on the left are separated into three sections: Default elements, Auxiliary elements and Extra elements. Each of these elements can be dragged into the “Build Registration Page Here” section or into the “Hidden fields” section. When and element is added to the page builder section, that element will show up on the front end web page. When it is added to the hidden fields section, it will not show up on the front end, but will be added to each registrant so data for that specific field can be tracked on the back end.

Default elements

Default elements are form elements we have found get used the most. General things like first name, last name email address etc. Once a default element is dragged over to the page builder section, the properties can be expanded by clicking on the button on the right of that element. Expanding the properties for a default element will show one option: Required?. On the front end, if an element is required for a user to fill out, check this box.

Auxiliary elements

Auxiliary elements are dynamic elements which can be used in a variety of ways. They are meant to fill in when there isn’t an element in the default elements that satisfies need for a particular form. Once an auxilary element is dragged over to the page builder section, the properties can be expanded by clicking on the button on the right of that element. Expanding the properties for a default element will show many options:

  • Name is the text of the element that will show up on the front end for a user.
  • Type is the type of form element.
    • Text Box is a simple text entry box.
    • Text Area is a larger text entry box.
    • Check Box is a box which can be checked yes or no.
    • Radio Button is a series of options the user can choose one from.
    • Combo Box is also a series of options the user can choose one selection from, but in a drop-down box format.
    • Simple Repeating Element is an element which allows multiple pieces of data to be collected from a user as many times as necessary.
  • Enter a number in Word Limit and the system will check the input on the auxiliary input field to make sure it does not exceed a certain number of words.
  • If Required is selected the system will mark an element is required and will require the user to enter information for this element on the front end.

If Radio Button, Combo Box or Simple Repeating Element are selected, an extra box titled Other Attributes will appear at the bottom of the screen. For a radio button or combo box, enter the values in this box that you would like the user to choose between. For example If you enter “Do you like dogs?” in the Name field, select Radio Button and then enter
Yes
No
Still Deciding

In the Other Attributes box, the front end registration page will look like this:

Do you like dogs?
Yes
No
Still Deciding

If the type is selected to be a Simple Repeating Element, the values you enter for that will become text boxes where the user can input information. There will also be an add button for the user to click when they are finished entering information into that section, which will save the information entered into the text boxes and allow them to enter additional information if desired. For instance, if “Please list the dogs you own” is entered in the title and
Name
Breed
Age
Sex
is entered into the Other Fields box. The front end will look like this:

Please list the dogs you own
Name: 

Breed: 

Age: 

Sex: 

In this case, when a users enters their dog’s information and selects add, it will save the information and allow then to continue to submit information for as many dogs as they would like.

Extra elements

Extra elements are simple elements that do not count as form input elements. Add one to the page builder section by clicking the add button. You cannot drag these elements since multiple extra elements may be added to a form.

  • Divider line adds a visual divider line to the form.
  • Text will add a text box to the form where you can enter any text desired. Information about the form, instructions for the form or for an element or information about the event are generally types of text entered into a text element.
  • Heading will add a section heading in larger font (<h3>) which will act as a heading for a section.

Moving elements

When elements are added to the page builder section, they can be arranged in order. Roll over the title and when the mouse changes to the move icon (IC77373), click and drag the element to it’s desired location.

Hidden fields

Hidden fields are a way to manage pieces of information about invitees without them seeing that information. Similar to paper forms that have an “office use only” section. For instance, if users are asked to enter their information it register for a conference, but after they have registered, you would like to track if they have paid or not paid, you can add an auxiliary element called “paid.” The paid field will show up on the back end in the manual invitee edit and also in the invitee spreadsheet csv.

CSS & jQuery editing

For more advanced users, simple css and jQuery can be added to the form. Click on the CSS or jQuery button in the top left corner of the form builder and a window will come up. With the css advanced page layout is possible. JQuery allows a lot of different advanced features, but the most often used feature is to let jQuery control a field hiding and showing on the front end based on the answer of a different field. The selector for each element is listed beside each element in the form bulder.