TracCloud: Appointment Display Settings: Difference between revisions

From Redrock Wiki

(Created page with "{{TracCloudGuideTabs}} {| style="width:100%; vertical-align:top; " | style="width:250px; vertical-align:top; padding:2px 15px 2px 2px;" | {{TracCloudGuideProfileTOC}} | style=...")
 
No edit summary
 
(18 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{TracCloudGuideTabs}}
{{TracCloudGuideTabs}}
{| style="width:100%; vertical-align:top; "
<div class="tcWidgetPage">
| style="width:250px; vertical-align:top; padding:2px 15px 2px 2px;" | {{TracCloudGuideProfileTOC}}
<div class="categoryWide">
| style="vertical-align:top; padding:20px 20px 20px 2px;" |
{{TracCloudGuideProfileTOC}}
{| style="width:100%; vertical-align:top; "
</div>
Both students and consultants will see upcoming appointments on their dashboard, and staff will see them from the schedule view. The formatting of these appointment info boxes can be customized in your profile settings, allowing you to provide the necessary information in a visually appealing format.
<big><b>Appointment Display</b></big><br>
 
Both [[TracCloudGuideListingsStudents|students]] and [[TracCloudGuideProfileStaff|consultants]] will see upcoming appointments on their dashboard, and staff will see them from the [[TracCloudGuideBasicsSchedule|schedule]] view. The formatting of these appointment info boxes can be customized in your profile settings, allowing you to provide the necessary information in a visually appealing format.
==Student View==
<div class="line"></div>
As a student, we can view our upcoming appointments on the right-side of our dashboard. The information visible and the options available to us are entirely customizable by modifying our Appointment Display preference.
<big><b>Student View</big></b><br>
Students will be able to view their upcoming appointments on the right-side of the dashboard. The fields visible and the format they're in is entirely customizable by modifying the <i>Appointment Display</i> preference.
<br>
<br>
[[File:Yrryj57lk567jty.png|800px]]
[[File:Yrryj57lk567jty.png|800px]]<br><br>


==Consultant View==
<big><b>Consultant View</big></b><br>
Consultants have a similar view to students, which can be modified independently.
Consultants have a similar view to students, which can be modified independently.
<br>
<br>
[[File:6k45jk56l87l6kj7.png|800px]]
[[File:6k45jk56l87l6kj7.png|800px]]<br><br>


==Schedule View==
<big><b>Schedule View</big></b><br>
Lastly, the staff schedule view, which allows us to view and manage our consultants’ availabilities and upcoming appointments. The appointment text visible is also customizable here.
Lastly, the staff schedule view, which allows us to view and manage our consultants’ availabilities and upcoming appointments. The appointment text is also customizable.
<br>
<br>
[[File:467ij63hg457kjhy.png|800px]]
[[File:467ij63hg457kjhy.png|800px]]
<hr>
==Customization==
Within the <i>Appointment Display</i> menu, you will see a text box available for Students, Staff, and the Schedule view for Staff. There's also a preview section beneath each text box allowing you to easily see how your changes will display.<br>
These text boxes support HTML and Twig. HTML support is standard, allowing you to easily tag text as <b><nowiki><b>bold</b></nowiki></b>, <i><nowiki><i>italic</i></nowiki></i>, or <u><nowiki><u>underlined</u></nowiki></u>, or add hyperlinks. Twig on the other hand allows you to pull data from TracCloud into the message, as well as include logic that determines whether or not a portion text is included. For information on Twig, please take a look at our dedicated [[TracCloudGuideProfilePrefsTwig|Twig article here]].<br>
<i>Other > Other Options > Profiles > [Your Profile] > Prefs > Scheduling > Appointment Display</i><br>
[[File:9314845.png|800px]]<br><br>
If you want to reset to the default configuration, simply click on the clipboard icon on the right, which will confirm if you want to erase the existing configuration in favor of the standard one.<br>
[[File:43546j46j4j4j4.png|800px]]<br><br>


==Customizing==
Within the Appointment Display preference, you will see a text box available for Students, Staff, and the Schedule view for Staff. There's also a preview section beneath each text box allowing you to easily see how your changes will display.
<br>
These text boxes support HTML and Twig. HTML support is standard, allowing you to easily tag text as <b>bold</b>, <i>italics</i>, or <u>underlined</u>, or add hyperlinks. Twig on the other hand allows you to pull data from TracCloud into the message, as well as include statements that determine whether or not a portion text is included. For information on Twig, please take a look at our dedicated Twig article.
<br>
<i>Other > Other Options > Profiles > [Your Profile] > Prefs > Scheduling > Appointment Display</i>
<br>
[[File:54j5j46k7k5k57k5.png|800px]]
<br><br>
If you want to reset to the default configuration, simply click on the clipboard icon on the right, which will confirm if you want to erase the existing configuration in favor of the standard one.
<br>
[[File:43546j46j4j4j4.png|800px]]
<br><br>
Here are a couple examples of how you can configure the schedule and upcoming appointment views. This is more-so to give you an idea of how this feature works rather than a direct suggestion of what to use (although you’re welcome to copy these as-is if you’d like). Hopefully this gives you an idea of how the feature can be used, and how you can configure it on your own system.
Here are a couple examples of how you can configure the schedule and upcoming appointment views. This is more-so to give you an idea of how this feature works rather than a direct suggestion of what to use (although you’re welcome to copy these as-is if you’d like). Hopefully this gives you an idea of how the feature can be used, and how you can configure it on your own system.
<hr>
<hr>
<big>Schedule View</big><br>
<b><big>Schedule View</big><br></b>
Here’s a configuration that provides basic information about the appointment. The student’s name and appointment time in bold lettering, the subject and reason, and the consultant’s name. The if statement checks if the appointment has a Reason, and if it does, include a comma after the subject then print the reason.
Here’s a configuration that provides basic information about the appointment. The student’s name and appointment time in bold lettering, the subject and reason, and the consultant’s name. The if statement checks if the appointment has a Reason, and if it does, include a comma after the subject then print the reason.
<br>
<br>
[[File:Piyit3546u574k.png|500px]]
[[File:Piyit3546u574k.png|500px]]
<br>
<br>
<span style="background:#D3D3D3">
<syntaxhighlight lang="twig" line>
<nowiki><div style="float:left; width: 75%;"></nowiki><br>
<div style="float:left; width: 75%;">
<nowiki><p style="font-size:9px"></nowiki><br>
<p style="font-size:9px">
<nowiki><b>{{Student.Full_Name}}</b> at <b>{{Appointment.StartTime}}</b><br></nowiki><br>
<b>{{Student.Full_Name}}</b> at <b>{{Appointment.StartTime}}</b><br>
<nowiki>{{Course.SubjectCourse}}</nowiki><br><br>
{{Course.SubjectCourse}}
<nowiki>{% if Reason.ReasonName != "" %}</nowiki><br>
 
<nowiki>, {{Reason.ReasonName}}</nowiki><br>
{% if Reason.ReasonName != "" %}
<nowiki>{% endif %}</nowiki><br><br>
, {{Reason.ReasonName}}
<nowiki><br>With {{Consultant.FirstLast}}</nowiki><br>
{% endif %}
<nowiki></p></div></nowiki><br>
 
</span>
<br>With {{Consultant.FirstLast}}
</p></div>
</syntaxhighlight>


<hr>
<hr>
<big>Student View</big><br>
<b><big>Student View</big><br></b>
Here’s an example student view configuration. This one reads more like a spoken paragraph, with the important information bolded. Whether the appointment is in-person or online determines the text in the second half.
Here’s an example student view configuration. This one reads more like a spoken paragraph, with the important information bolded. Whether the appointment is in-person or online determines the text in the second half.
<br>
<br>
[[File:4565jh45ij57kj.png|500px]]
[[File:4565jh45ij57kj.png|500px]]
<br>
<br>
<span style="background:#D3D3D3">
<syntaxhighlight lang="twig" line>
<nowiki><div style="float:left; width: 75%;"></nowiki><br>
<div style="float:left; width: 75%;">
<nowiki>{{Appointment.Icon|raw}}</nowiki><br>
{{Appointment.Icon|raw}}
<nowiki><b>{{Center.Name}}</b><br></nowiki><br>
<b>{{Center.Name}}</b><br>
<nowiki>Your appointment with <b>{{Consultant.NameToStudent}}</b> has been booked for <b> {{Appointment.StartTime}}. </b></nowiki><br><br>
Your appointment with <b>{{Consultant.NameToStudent}}</b> has  
<nowiki>{% if Appointment.Online == "Online" %}</nowiki><br>
been booked for <b> {{Appointment.StartTime}}. </b><br>
<nowiki>This is an online appointment, please select the right arrow icon to join your session. The icon will only appear within 10 minutes of your appointment start time.</nowiki><br>
{% if Appointment.Online == "1" %}
<nowiki>{% else %}</nowiki><br>
This is an online appointment, please select the right arrow icon to join your session.
<nowiki>This is an in-person appointment taking place at <b>{{Appointment.Location}}</b>. If any assistance is required, please reach out to <u>{{Consultant.Email}}</u>.</nowiki><br>
The icon will only appear within 10 minutes of your appointment start time.
<nowiki>{% endif %}</nowiki><br><br>
{% else %}
<nowiki><br><br></nowiki><br>
This is an in-person appointment taking place at <b>{{Appointment.Location}}</b>.  
<nowiki>{% if Reason.ReasonName != '' %}</nowiki><br>
If any assistance is required, please reach out to <u>{{Consultant.Email}}</u>.
<nowiki>Reason: {{Reason.ReasonName}}<br/></nowiki><br>
{% endif %}<br>
<nowiki>{% endif %}</nowiki><br>
{% if Reason.ReasonName != '' %}
<nowiki>{% if Course.Subject != '' %}</nowiki><br>
Reason: {{Reason.ReasonName}}<br/>
<nowiki>Subject: {{Course.Subject}}<br/></nowiki><br>
{% endif %}
<nowiki>{% endif %}</nowiki><br><br>
{% if Course.Subject != '' %}
<nowiki></div></nowiki><br>
Subject: {{Course.Subject}}<br/>
<nowiki><div style="line-height: 2;" ></nowiki><br>
{% endif %}<br>
<nowiki>{{Appointment.CancelLink|raw}}<br/></nowiki><br>
</div>
<nowiki>{{Appointment.ActionLink|raw}}<br/></nowiki><br>
<div style="line-height: 2;" >
<nowiki>{{Appointment.EnterOnlineLink|raw}}<br/></nowiki><br>
{{Appointment.CancelLink|raw}}<br/>
<nowiki></div></nowiki><br>
{{Appointment.ActionLink|raw}}<br/>
<nowiki><div style="clear: both;"> </div></nowiki><br>
{{Appointment.EnterOnlineLink|raw}}<br/>
</span>
</div>
<div style="clear: both;"> </div>
</syntaxhighlight>


<hr>
<hr>
<big>Consultant View</big><br>
<b><big>Consultant View</big><br></b>
This one has a few more moving parts. Near the top, we’re saying “if the appointment has been cancelled, say “CANCELLED:” and strikethrough the rest of the contents.” We also have a series of “if this field isn’t blank, include it in the list” as well as the time saying the word “Today” rather than a standard date and time.
This one has a few more moving parts. Near the top, we’re saying “if the appointment has been cancelled, say “CANCELLED:” and strikethrough the rest of the contents.” We also have a series of “if this field isn’t blank, include it in the list” as well as the time saying the word “Today” rather than a standard date and time. A unique option available in the consultant view is the ability to start and stop a visit directly from the dashboard. This can be implemented by including the <b><nowiki>{{Appointment.LoginStudentToAppt|raw}}</nowiki></b> Twig tag in your appointment display configuration. It will display as a clickable button to your staff.
<br>
<br>
[[File:57i75k5j5b5h5rhrht.png|500px]]
[[File:57i75k5j5b5h5rhrht.png|500px]]
<br>
<br>
<span style="background:#D3D3D3">
<syntaxhighlight lang="twig" line>
<nowiki><div style="float:left; width: 75%;"> </nowiki><br>
<div style="float:left; width: 75%;">  
<nowiki>{{Appointment.Icon|raw}}</nowiki><br><br>
{{Appointment.Icon|raw}}<br>
<nowiki>{% if Appointment.isCancelled == 'true' %}</nowiki><br>
{% if Appointment.isCancelled == 'true' %}
<nowiki> CANCELLED: <span class="linethrough" ></nowiki><br>
CANCELLED: <span class="linethrough" >
<nowiki>{% endif %}</nowiki><br><br>
{% endif %}<br>
<nowiki><b>{{Center.Name}}</b><br></nowiki><br><br>
<b>{{Center.Name}}</b>
<nowiki><span title="{{Student.ID}}">{{Student.FirstLast}}</span> - {{Student.Email}}<br> </nowiki><br>
<span title="{{Student.ID}}">{{Student.FirstLast}}</span> - {{Student.Email}}<br>  
<nowiki>{% if Reason.ReasonName != '' %}</nowiki><br>
{% if Reason.ReasonName != '' %}
<nowiki> Reason: {{Reason.ReasonName}}<br/></nowiki><br>
Reason: {{Reason.ReasonName}}<br/>
<nowiki>{% endif %}</nowiki><br>
{% endif %}
<nowiki>{% if Course.Subject != '' %} </nowiki><br>
{% if Course.Subject != '' %}  
<nowiki> Subject: {{Course.SubjectCourseTitle}}<br/></nowiki><br>
Subject: {{Course.SubjectCourseTitle}}<br/>
<nowiki>{% endif %}</nowiki><br>
{% endif %}
<nowiki>{% if Appointment.Location != '' %}</nowiki><br>
{% if Appointment.Location != '' %}
<nowiki> Location: {{Appointment.OnlineText}}{{Appointment.Location}}<br/> </nowiki><br>
Location: {{Appointment.OnlineText}}{{Appointment.Location}}<br/>  
<nowiki>{% endif %}</nowiki><br><br>
{% endif %}<br>
<nowiki>When: <strong>{{Appointment.DisplayDate|raw}}</strong> at <strong>{{Appointment.DisplayTime|raw}}</strong><br/></nowiki><br><br>
When: <strong>{{Appointment.DisplayDate|raw}}</strong> at  
<nowiki>{% if Appointment.isCancelled == 'true' %}</nowiki><br>
<strong>{{Appointment.DisplayTime|raw}}</strong><br/><br>
<nowiki> </span></nowiki><br>
{% if Appointment.isCancelled == 'true' %}
<nowiki>{% endif %}</nowiki><br><br>
</span>
<nowiki></div></nowiki><br>
{% endif %}<br>
<nowiki><div style="line-height: 2;" ></nowiki><br>
</div>
<nowiki> {{Appointment.CancelLink|raw}}<br/></nowiki><br>
<div style="line-height: 2;" >
<nowiki> {{Appointment.ActionLink| raw}}<br/></nowiki><br>
{{Appointment.CancelLink|raw}}<br/>
<nowiki> {{Appointment.EnterOnlineLink|raw}}<br/></nowiki><br>
{{Appointment.ActionLink| raw}}<br/>
<nowiki></div></nowiki><br>
{{Appointment.EnterOnlineLink|raw}}<br/>
<nowiki><div style="clear: both;"> </div> </nowiki><br>
</div>
</span>
<div style="clear: both;"> </div>  
|}
</syntaxhighlight>
{{DISPLAYTITLE:<span style="position: absolute; clip: rect(1px 1px 1px 1px); clip: rect(1px, 1px, 1px, 1px);">{{FULLPAGENAME}}</span>}}
 
<hr>
 
* <b>Online appointment link text</b>
::Allows you to modify the hyperlink/button visible to students within online appointment records. Default is "The location for this online appointment is here."
::[[File:1250627.png|450px]]
 
[[Category:TracCloud]]
<hr>
<i>See Also</i>
 
* [[TracCloudGuideProfilePrefsTwig|Twig Guide]]
 
* [[TracCloud:_Dashboard|TracCloud Dashboard]]
 
* [[TracCloudGuideBasicsSchedule|Scheduling]]
 
</div>

Latest revision as of 16:58, 18 November 2024

Appointment Display
Both students and consultants will see upcoming appointments on their dashboard, and staff will see them from the schedule view. The formatting of these appointment info boxes can be customized in your profile settings, allowing you to provide the necessary information in a visually appealing format.

Student View
Students will be able to view their upcoming appointments on the right-side of the dashboard. The fields visible and the format they're in is entirely customizable by modifying the Appointment Display preference.
Yrryj57lk567jty.png

Consultant View
Consultants have a similar view to students, which can be modified independently.
6k45jk56l87l6kj7.png

Schedule View
Lastly, the staff schedule view, which allows us to view and manage our consultants’ availabilities and upcoming appointments. The appointment text is also customizable.
467ij63hg457kjhy.png


Customization

Within the Appointment Display menu, you will see a text box available for Students, Staff, and the Schedule view for Staff. There's also a preview section beneath each text box allowing you to easily see how your changes will display.


These text boxes support HTML and Twig. HTML support is standard, allowing you to easily tag text as <b>bold</b>, <i>italic</i>, or <u>underlined</u>, or add hyperlinks. Twig on the other hand allows you to pull data from TracCloud into the message, as well as include logic that determines whether or not a portion text is included. For information on Twig, please take a look at our dedicated Twig article here.


Other > Other Options > Profiles > [Your Profile] > Prefs > Scheduling > Appointment Display
9314845.png

If you want to reset to the default configuration, simply click on the clipboard icon on the right, which will confirm if you want to erase the existing configuration in favor of the standard one.

43546j46j4j4j4.png

Here are a couple examples of how you can configure the schedule and upcoming appointment views. This is more-so to give you an idea of how this feature works rather than a direct suggestion of what to use (although you’re welcome to copy these as-is if you’d like). Hopefully this gives you an idea of how the feature can be used, and how you can configure it on your own system.


Schedule View
Here’s a configuration that provides basic information about the appointment. The student’s name and appointment time in bold lettering, the subject and reason, and the consultant’s name. The if statement checks if the appointment has a Reason, and if it does, include a comma after the subject then print the reason.
Piyit3546u574k.png

<div style="float:left; width: 75%;">
<p style="font-size:9px">
<b>{{Student.Full_Name}}</b> at <b>{{Appointment.StartTime}}</b><br>
{{Course.SubjectCourse}}

{% if Reason.ReasonName != "" %}
, {{Reason.ReasonName}}
{% endif %}

<br>With {{Consultant.FirstLast}}
</p></div>

Student View
Here’s an example student view configuration. This one reads more like a spoken paragraph, with the important information bolded. Whether the appointment is in-person or online determines the text in the second half.
4565jh45ij57kj.png

<div style="float:left; width: 75%;">
{{Appointment.Icon|raw}}
<b>{{Center.Name}}</b><br>
Your appointment with <b>{{Consultant.NameToStudent}}</b> has 
been booked for <b> {{Appointment.StartTime}}. </b><br>
{% if Appointment.Online == "1" %}
This is an online appointment, please select the right arrow icon to join your session.
The icon will only appear within 10 minutes of your appointment start time.
{% else %}
This is an in-person appointment taking place at <b>{{Appointment.Location}}</b>. 
If any assistance is required, please reach out to <u>{{Consultant.Email}}</u>.
{% endif %}<br>
{% if Reason.ReasonName != '' %}
Reason: {{Reason.ReasonName}}<br/>
{% endif %}
{% if Course.Subject != '' %}
Subject: {{Course.Subject}}<br/>
{% endif %}<br>
</div>
<div style="line-height: 2;" >
{{Appointment.CancelLink|raw}}<br/>
{{Appointment.ActionLink|raw}}<br/>
{{Appointment.EnterOnlineLink|raw}}<br/>
</div>
<div style="clear: both;"> </div>

Consultant View
This one has a few more moving parts. Near the top, we’re saying “if the appointment has been cancelled, say “CANCELLED:” and strikethrough the rest of the contents.” We also have a series of “if this field isn’t blank, include it in the list” as well as the time saying the word “Today” rather than a standard date and time. A unique option available in the consultant view is the ability to start and stop a visit directly from the dashboard. This can be implemented by including the {{Appointment.LoginStudentToAppt|raw}} Twig tag in your appointment display configuration. It will display as a clickable button to your staff.
57i75k5j5b5h5rhrht.png

<div style="float:left; width: 75%;"> 
{{Appointment.Icon|raw}}<br>
{% if Appointment.isCancelled == 'true' %}
	CANCELLED: <span class="linethrough" >
{% endif %}<br>
<b>{{Center.Name}}</b>
<span title="{{Student.ID}}">{{Student.FirstLast}}</span> - {{Student.Email}}<br> 
{% if Reason.ReasonName != '' %}
	Reason: {{Reason.ReasonName}}<br/>
{% endif %}
{% if Course.Subject != '' %} 
	Subject: {{Course.SubjectCourseTitle}}<br/>
{% endif %}
{% if Appointment.Location != '' %}
	Location: {{Appointment.OnlineText}}{{Appointment.Location}}<br/> 
{% endif %}<br>
When: <strong>{{Appointment.DisplayDate|raw}}</strong> at 
<strong>{{Appointment.DisplayTime|raw}}</strong><br/><br>
{% if Appointment.isCancelled == 'true' %}
	</span>
{% endif %}<br>
</div>
<div style="line-height: 2;" >
	{{Appointment.CancelLink|raw}}<br/>
	{{Appointment.ActionLink| raw}}<br/>
	{{Appointment.EnterOnlineLink|raw}}<br/>
</div>
<div style="clear: both;"> </div>

  • Online appointment link text
Allows you to modify the hyperlink/button visible to students within online appointment records. Default is "The location for this online appointment is here."
1250627.png

See Also