TracCloud: Twig: Difference between revisions

Formatting Text in TracCloud with Twig and HTML

Many text boxes throughout TracCloud support Twig, this allows greater control in determining how emails are formatted and what data is included. HTML is also supported, allowing to you adjust the formatting of text. From font sizes, colors, and types, to embedding images and video.

Twig allows you to pull data from various TracCloud fields to be included in emails and texts via our tag system. We can also use Twig to apply logic to our text. Maybe we only want to include a block of text if the student selected a specific reason, or if a certain Recommendation was selected in a SAGE referral.

This chapter will be going over several Twig options available, however, this is not an in-depth guide. Twig isn’t exclusive to TracCloud, and there are many resources available online for more complex configurations if you’d like to go a step further. The point of this chapter is to give some brief examples and possible configuration ideas that you can build off of.

Most of the examples here will be formatted for an appointment confirmation email, but Twig can also be utilized in SAGE referral emails and in the upcoming appointments screen for students and consultants. The same concepts apply across the board.

if

if statements will likely be the most commonly used Twig command for most use-cases. This allows you to write out statements such as “if the student selected reason “Exam Help,” then include this piece of text.” Or in the example below, if the appointment is online, include text to specify this.

In the statement, we’re using the same tags that are used for emails, but without the curly brackets.

Hello {{Student.First_Name}},
<br><br>
{% if Appointment.Online == "Online" %}
This is an online appointment.
{% endif %}
<br><br>
Please be ready for the appointment at the time you selected.

If the if statement is true, all text up to the endif line will be printed in the email. Since the appointment this student booked is online, the “This is an online appointment” text was included. Otherwise, it would jump straight to “Please be ready for the appointment…”

We aren’t limited to just “equals” either. Similar examples with different logic can be found below.

{% if Course.Subject starts with "Chem" %}
this text is only included if our subject starts with “Chem”. This is case-sensitive. 
{% endif %}

{% if Course.Subject ends with "101" %}
This text is only included if our subject ends with “101”
{% endif %}

{% if Appointment.Online != "Online" %}
This text is only included if the appointment is not online
{% endif %}

{% if Course.Subject == "Math" or Course.Subject == "Chem" %}
This text is only included if the subject is Math or Chem
{% endif %}

{% if (CalcMissedAppointments(Student.Sequence, Center.ProfileID) > 0) %}
You have {{CalcMissedAppointments(Student.Sequence, Center.ProfileID)}} missed 
appointments since {{CalcMissedDate(Center.ProfileID)}}.
{% endif %}

else

An else statement allows us to include a block of text or an additional instruction if an if statement ends up not being true. For example, if our appointment above turns out to be an in-person appointment, maybe we want to include a different string of text.

Hello  {{Student.First_Name}},
<br><br>
{% if  Appointment.Online == "Online" %}
This is an online appointment.
{% else %}
This is an in-person appointment.
{% endif %}
<br><br>
Please be ready for the appointment at the time you selected.

Since the appointment wasn’t online, we get the “This is an in-person…” text in our confirmation email instead.

elseif

An elseif statement allows us to ask additional if questions, assuming the answer to the prior question was No.

Hello  {{Student.First_Name}},
<br><br>
{% if Course.Subject == "Math" %}
This appointment is for Math
{% elseif Course.Subject == "Chem" %}
This appointment is for Chem
{% endif %}
<br><br>
Please be ready for the appointment at the time you selected.

Since our appointment was for Chemistry, we receive the following email. If the appointment was for neither Chemistry nor Math, we wouldn’t see a middle block of text at all.

if (for arrays)

When you want to use an if statement for arrays, such as the Reasons and Recommendations for SAGE referrals, the formatting is a little bit different. In this context, you would want to know if the Reasons array contains the reason you’re looking for. This would be formatted as such:

Hello  {{Student.First_Name}},
<br>
{% if "Poor Grades" in Reasons %}
This referral is being submitted due to the reason “Poor Grades”
{% endif %}

Since “Poor Grades” was the reason our faculty member selected when submitting this referral, we receive the following email.

We can also search for the opposite, specifying “not in” instead:

{% if "Poor Grades" not in Reasons %}
This referral was *not* created with the reason “Poor Grades”
{% endif %}

for (listing sequence contents)

The for command allows us to list out the contents from a specific sequence. This would frequently be used for listing out Reasons or Recommendations in SAGE referral emails.

This referral is being submitted because of these reasons:
<br>
{% for key,value in Reasons %}
    {{ value }} <br>
{% endfor %}
<br><br>
And these recommendations:
<br>
{% for key,value in Recommendations %}
    {{ value }} <br>
{% endfor %}

Alternatively, Array tags such as ReferralType.Reasons will need to be formatted as such:

{% for item in ReferralType.Reasons %}
{{ item.value|e }}
{% endfor %}

SAGE Questions

Custom questions within SAGE have one more moving part to take into consideration. When creating a custom question, there’s a field named “Code Reference.” This is the code used when referring to this question in emails and reports.

These questions/answers are part of an array, utilized just like the Reasons and Recommendations above.

Hi, this referral has been submitted:
<br><br>
{% if Answers.VisitQuestion != '' %}
You answered {{Answers.VisitQuestion}} to the question {{Questions.VisitQuestion}}
{% endif %}
<br><br>
{% for key,value in Answers %}
The answer to question {{ attribute(Questions, key) }} is {{ value }}
<br>
{% endfor %}

First, we’re looking for a specific question and answer. To pull this information, we’re using the tags “Answers.[Code Reference]” and “Questions.[Code Reference]”, with the code reference portion being replaced with whatever we entered in the SAGE custom question. If this question was answered, we’re going to include our answer and the question itself in the email.

Secondly, we want to go through all of our answers to all of our questions. This would be an array just like Reasons and Recommendations, and is formatted similarly. Once we receive this email, we will see the answers selected by our faculty member.

Actions (for SAGE)

Actions can be used as commands in addition to Twig. At this time, the only Action that has been implemented is #ACTION:DO NOT SEND#, which prevents the email from being sent. This would be useful in situations where not all of your SAGE referrals need to result in an email being sent. For example, you could have a dedicated recommendation for “No recommendations at this time”, and we could use that to determine whether or not an email gets sent.

{% if "No recommendations at this time" not in Recommendations %}
This referral is being submitted because of these reasons:
<br>
{% for key,value in Reasons %}
    {{ value }} <br>
{% endfor %}
<br><br>
And these recommendations:
<br>
{% for key,value in Recommendations %}
    {{ value }} <br>
{% endfor %}
{% else %}
#ACTION:DO NOT SEND#
{% endif %}

With this email configuration in place, if our faculty member submits a referral with the recommendation “No recommendations at this time,” no email would be sent. An email will only be sent if that recommendation wasn’t selected, which would then follow the rest of the example above, listing out reasons and recommendations.

Tag List

The remainder of this chapter will display all of the email tags available in TracCloud with definitions. Note that the double curly brackets are the Print statement. When these tags are included with these brackets, they will be replaced with the corresponding value when the email is sent. The curly brackets are not required when using the value in an if statement, for example.

Student
Student.First_Name	Student's first name
Student.Last_Name	Student's last name
Student.Legal_First	Student's legal first name
Student.Full_Name	The student's full name, formatted as "Last, First M."
Student.Full_Name2	The student’s full name, formatted as “First M. Last”
Student.Home_Phone	Student's home phone number
Student.Work_Phone	Student's work phone number
Student.Cell_Phone	Student's cell phone number
Student.Email	Student’s email address
Student.ID	Student's ID number
Student.Other_ID	An optional unique identifier for this student, like a handle or username
Student.Other_ID2	A second optional unique identifier for this student
Student.Barcode	Student's barcode number
Student.Major	Student's major
Student.Class	Student's class
Student.DegreeGoal	Student's degree goal
Student.Cohort	Student's cohort
Student.College	Student's college
Student.Grad_Und	Student's undergraduate
Student.FirstLast	Student's full name, formatted as "First Last"
Student.LastFirst	Student's full name, formatted as "Last, First M"
Student.CustomData.cf_0	Custom fields, hover over each field in the Email Tag list to find the correct tag

Appointment
Appointment.StartDT	Appointment start day/time, formatted as "2020-01-31 14:00:00"
Appointment.EndDT	Appointment end day/time, formatted as "2020-01-31 15:00:00"
Appointment.Fund	Appointment fund choice
Appointment.Location	Appointment location choice
Appointment.Online	If the appointment is online, this tag will display as "1", otherwise it will be blank.
Appointment.OnlineURL	If the appointment is held online, this tag will display the specified URL to the online room.
Appointment.StartTime	Appointment start time, formatted as "02:00pm"
Appointment.StartDate	Appointment start date, formatted as "01/31/20"
Appointment.EndTime	Appointment end time, formatted as "03:00pm"
Appointment.EndDate	Appointment end date, formatted as "01/31/20"
Appointment.isCancelled	Cancelled status, displayed as "True" or "False"
Appointment.DisplayTime	Appointment time, formatted as "200p" (minutes will display noticeably smaller than hours)
Appointment.DisplayDate	Appointment date, formatted as "Fri, Jan 31"
Appointment.OnlineText	If the appointment is online, this tag will display as "Online", otherwise it will be blank. (for example, "...Your Appointment.OnlineText appointment..." will include or exclude the word "Online")
Appointment.CustomData.cf_0	Custom fields, hover over each field in the Email Tag list to find the correct tag

Center
Center.Name	The appointment/visit center

Reason
Reason.ReasonName	The appointment/visit reason

Section
Section.Code	The section code
Section.CRN	The section CRN number
Section.SubjectTermCode	Subject + Section + Term Code, “CHEM321 A2 20202”
Section.SubjectTitle	Subject + Title, “CHEM321 Chemistry”

Course
Course.Subject	Subject, "CHEM"
Course.Course	Course, "321"
Course.Title	Title, "Chemistry"
Course.SubjectCourse	Subject + Course, "CHEM321"
Course.SubjectCourseTitle	Subject + Course + Title, "CHEM231 Chemistry"

Faculty
Facutly.FirstName	Faculty's first name
Faculty.LastName	Faculty's last name
Faculty.Salutation	Faculty member salutation, for example, "Dr."
Faculty.Phone	Faculty's phone number
Faculty.Email	Faculty's email address
Faculty.SalutationFullName	Full name with salutation, for example, "Dr. Phil Roberts"
Faculty.SalutationLastName	Last name with salutation, for example, "Dr. Roberts"
Faculty.CustomData.cf_0	Custom fields, hover over each field in the Email Tag list to find the correct tag

Consultant
Consultant.First_Name	Consultant's first name
Consultant.Last_Name	Consultant's last name
Consultant.LastFirst	Consultant's full name, formatted as "Last, First"
Consultant.FirstLast	Consultant's full name, formatted as "First Last"
Consultant.Alias	Consultant's alias
Consultant.Email	Consultant's email address
Consultant.CustomData.cf_0	Custom fields, hover over each field in the Email Tag list to find the correct tag

Visit (only for visit emails)
Visit.EnteredDT	The date and Time the student entered the Center
Visit.TimeIn	The date and Time the student started receiving help.
Visit.TimeOut	The date and time the student left the center.
Visit.Duration	Visit duration in minutes
Visit.WaitTime	Visit wait time in minutes
Visit.EnteredTime	Start time of visit, including wait time, formatted as “09:45pm”
Visit.EnteredDate	Start date of visit, including wait time, formatted as “04/05/21”
Visit.StartTime	Start time of visit, formatted as “09:48pm”
Visit.StartDate	Start date of visit, formatted as “04/05/21”
Visit.EndTime	End time of visit, formatted as “09:48pm”
Visit.EndDate	End date of visit, formatted as “04/05/21”
Visit.CustomData.cf_0	Custom fields, hover over each field in the Email Tag list to find the correct tag

@@ Line 350: / Line 350: @@
+{| class="wikitable"
+|+ Faculty
+|-
+| Facutly.FirstName || Faculty's first name
+|-
+| Faculty.LastName || Faculty's last name
+|-
+| Faculty.Salutation || Faculty member salutation, for example, "Dr."
+|-
+| Faculty.Phone || Faculty's phone number
+|-
+| Faculty.Email || Faculty's email address
+|-
+| Faculty.SalutationFullName || Full name with salutation, for example, "Dr. Phil Roberts"
+|-
+| Faculty.SalutationLastName || Last name with salutation, for example, "Dr. Roberts"
+|-
+| Faculty.CustomData.cf_0 || Custom fields, hover over each field in the Email Tag list to find the correct tag
+|}
+{| class="wikitable"
+|+ Consultant
+|-
+| Consultant.First_Name || Consultant's first name
+|-
+| Consultant.Last_Name || Consultant's last name
+|-
+| Consultant.LastFirst || Consultant's full name, formatted as "Last, First"
+|-
+| Consultant.FirstLast || Consultant's full name, formatted as "First Last"
+|-
+| Consultant.Alias || Consultant's alias
+|-
+| Consultant.Email || Consultant's email address
+|-
+| Consultant.CustomData.cf_0 || Custom fields, hover over each field in the Email Tag list to find the correct tag
+|}
+{| class="wikitable"
+|+ Visit (only for visit emails)
+|-
+| Visit.EnteredDT || The date and Time the student entered the Center
+|-
+| Visit.TimeIn || The date and Time the student started receiving help.
+|-
+| Visit.TimeOut || The date and time the student left the center.
+|-
+| Visit.Duration || Visit duration in minutes
+|-
+| Visit.WaitTime || Visit wait time in minutes
+|-
+| Visit.EnteredTime || Start time of visit, including wait time, formatted as “09:45pm”
+|-
+| Visit.EnteredDate || Start date of visit, including wait time, formatted as “04/05/21”
+|-
+| Visit.StartTime || Start time of visit, formatted as “09:48pm”
+|-
+| Visit.StartDate || Start date of visit, formatted as “04/05/21”
+|-
+| Visit.EndTime || End time of visit, formatted as “09:48pm”
+|-
+| Visit.EndDate || End date of visit, formatted as “04/05/21”
+|-
+| Visit.CustomData.cf_0 || Custom fields, hover over each field in the Email Tag list to find the correct tag
+|}
 |}
 {{DISPLAYTITLE:<span style="position: absolute; clip: rect(1px 1px 1px 1px); clip: rect(1px, 1px, 1px, 1px);">{{FULLPAGENAME}}</span>}}

TracCloud: Twig: Difference between revisions

From Redrock Wiki

Revision as of 14:50, 30 July 2021

Profile Preferences

Prefs

Tags