Skip to main content
Tagging Explained
Updated over a month ago

Purpose: The system uses tagging to help add information and helps reduce administrative work by creating easy to send out the documentation to your customers. Throughout the system, there are modules that may be used to create communications.

The tagging will be explained below:

Most modules have tagging available click the "Use tagging" button.

mceclip1.png



You'll see a side panel open containing the tags such as below, clickt the "Close tagging" button to finish adding tags.

Screenshot 2024-04-25 225356.png



Depending on the module in use, users may encounter limitations on the availability of tags. Attempting to use tags that are unavailable in a particular module, such as trying to utilize a diary tag in a module that does not support it, will result in only the HTML brackets being displayed without proper tagging. This means that the intended tagging will not be executed correctly, potentially leading to formatting issues or unintended display errors. It's important for users to be aware of tag availability within each module to ensure proper functionality and presentation.

Customer Tags

[customer_account_no] - Adds the customer account number

[customer_name] - Adds the on file customer name

[customer_surname] - Adds the on file customer last name

[customer_telephone] - Adds the on file customer LANDLINE number

[customer_mobile] - Adds the on file customer MOBILE number

[customer_email] - Adds the on file customer email address

[customer_address_line_1] -Adds the first line of the address

[customer_address_line_2] - Adds the second line of the address

[customer_address_line_3] - Adds the third line of the address

[customer_town] - Adds the on file customer town

[customer_county] - Adds the on file customer county

[customer_postcode] - Adds the on file customer zipcode / postcode

[customer_advertising] - Adds the advertising choice that is on file with the customer.

Estimate Tags

[estimate_no] - Adds the estimate number

[estimate_created_date] - Adds the estimate created date

[estimate_description] - Adds the estimate description

[estimate_engineer_notes] - Adds the engineer notes from the estimate

[estimate_contact_name] - Adds the estimate contact name

[estimate_address_line_1] - Adds estimate address line 1

[estimate_address_line_2] - Adds estimate address line 2

[estimate_address_line_3] - Adds estimate address line 3

[estimate_address_town] - Adds the estimate town

[estimate_address_county] - Adds the estimate address county

[estimate_address_postcode] - adds the estimate zipcode / postcode

[estimate_contact_telephone] - Adds the Estimate contact LANDLINE number

[estimate_contact_mobile] - Adds the estimate contact MOBILE number

[estimate_contact_email] - Adds the estimate contacts email address

[estimate_address_account_no] - Adds the estimate addresses account number

[estimate_address_name] - Adds the estimate address name

[estimate_portal_url] - Adds the Estimate Portal URL

[estimate_price] - Adds the Estimate Price

Jobs tags

[job_no] - Adds the job number

[job_contact_name] - Adds the Job contacts name

[job_contact_telephone] - Adds the Job contacts LANDLINE number

[job_contact_mobile] - Adds the Job contacts MOBILE number

[job_contact_email] - Adds the Job contacts email address

[job_created_date] - Adds the job created date

[job_description] - Adds the Job description

[job_po_no] - Adds the Job purchase order number

[job_priority] - Adds the job priority level

[job_quoted_amount] - Adds the quoted Job amount

[job_address_name] = Adds the Job address name

[job_address_line_1] - Adds the job address line 1

[job_address_line_2] - Adds the job address line 2

[job_address_line_3] - Adds the job address line 3

[job_address_town] - Adds the job address town

[job_address_county] - Adds the job address county

[job_address_postcode] - Adds the job address zipcode / postfcode

[job_address_account_no] - Adds the job address account number

[after_sales_care_portal_url] - adds the after sales care portal

Service Reminder tags


[service_reminder_name] - Adds the service reminder name

[service_due_date] - Adds the service reminder due date

[service_contact] - Adds the name of the service reminder contact

[service_reminder_booking_portal_url] - Adds the service reminder booking portal

Diary Events tags

[diary_date] - Adds the diary event date

[diary_time] - Adds the diary event time

[diary_start_time] - Adds the start time from the diary event

[diary_end_time] - Adds the end time from the diary event

[diary_engineer] - Adds the diary engineer

[diary_description] - Adds the diary event description

[diary_engineer_notes] - Adds the diary engineers notes

[diary_service_window] - Adds the diary service window.

Invoice Tags

[landlord_name] - Adds the on file landlord name

[invoice_date] - Adds the invoice date

[invoice_no] - Adds the invoice number

[invoice_address_name] - Adds the invoice address name

[invoice_address_line_1] - Adds line 1 of the address

[invoice_address_line_2] - Adds line 2 of the address

[invoice_address_line_3] - Adds line 3 of the address

[invoice_address_town] - Adds the invoice address town

[invoice_address_county] - Adds the invoice addresses county

[invoice_address_postcode] -Adds the invoice address zipcode / postcode

[invoice_description] - Adds the invoice description

[invoice_more_details] - Adds the invoice more details area

[invoice_exl_vat] - Adds the invoiced excluded vat

[invoice_vat] - Adds the invoice VAT amount

[invoice_total] - Adds the invoiced total

[invoice_total_paid] - Adds the total paid from the invoice

[invoice_remainder_to_pay] - adds the remainder amount to pay

[invoice_portal_url] - Adds the invoice portal URL

Supplier tags

[supplier_name] - Adds the supplier name

[supplier_address_line_1] - Adds line 1 of the address

[supplier_address_line_2] - Adds line 2 of the address

[supplier_address_line_3] - Adds line 3 of the address

[supplier_town] - Adds the supplier town

[supplier_county] - Adds the supplier county

[supplier_postcode] - Adds the supplier zipcode / postcode

[supplier_telephone] - Adds the supplier phone number

[supplier_email] - Adds the supplier email address

PO tags

[po_date] - Adds the purchase order date

[po_no] - Adds the purchase order number

[po_description] - Adds the purchase order description

Booking portal tags

[booking_portal_link] - adds the booking portal link


Personalised name tagging

Within the system, we use tagging to allow you to input names into the email, letter, and SMS templates. You can personalise how these names appear in the text by using the following codes.

Input the tag as normal by opening the tagging panel and single-click the tag to use it. Then edit it by adding a colon followed by either title, firstname, or lastname - or any combination of those 3 options to control how the name will display in the final communication. For example:

  • Hello, [job_contact_name] ➡️ Hello, Mrs Sue Smith

    • Unmodified name tags display the title, first name, and last name

  • Hello, [job_contact_name:title lastname] ➡️ Hello, Mrs Smith

    • With this modification, the name tag does not show the first name

  • Hello, [job_contact_name:firstname lastname] ➡️ Hello, Sue Smith

    • This modification removes the title from the name

  • Hello, [job_contact_name:firstname] ➡️ Hello, Sue

    • This modification displays only the first name

Note: It's important to match the styling as above, for example, make sure you don't put a space after the colon or between 'first' and 'name'. Additionally, only 'lastname' is accepted, so, please do not enter 'surname'.


Which tags does this work for?
Any name tags in Commusoft will allow you to modify how they display. The full list is:

[engineer_name]
[diary_engineer]
[customer_name]
[work_address_name]
[job_contact_name]
[estimate_contact_name]
[landlord_name]
[invoice_address_name]


Personalised time/date formats

  • You can personalise how this date appears in the text by using the following codes. Input the tag as shown below - replace the italic text with a format character below.

[diary_date:formatcharacter]

  • You can combine these formats to create sentences. Please view the example below.

work_address_confirmation_email_date_tagging.png

Day

Format Character

Description

Example returned values

d

Day of the month, 2 digits with leading zeros

01 to 31

D

A textual representation of a day, three letters

Mon through Sun

j

Day of the month without leading zeros

1 to 31

l(lowercase 'L')

A full textual representation of the day of the week

Sunday through Saturday

Week

Format Character

Description

Example returned values

W

ISO-8601 week number of year, weeks starting on Monday

Example: 42 (the 42nd week in the year)

Month

Format Character

Description

Example returned values

F

A full textual representation of a month, such as January or March

January through December

m

Numeric representation of a month, with leading zeros

01 through 12

M

A short textual representation of a month, three letters

Jan through Dec

n

Numeric representation of a month, without leading zeros

1 through 12

Year

Format Character

Description

Example returned values

Y

A full numeric representation of a year, 4 digits

Examples: 1999 or 2003

y

A two digit representation of a year

Examples: 99 or 03

Time

Format Character

Description

Example returned values

a

Lowercase Ante meridiem and Post meridiem

am or pm

A

Uppercase Ante meridiem and Post meridiem

AM or PM

B

Swatch Internet time

000 through 999

g

12-hour format of an hour without leading zeros

1 through 12

G

24-hour format of an hour without leading zeros

0 through 23

h

12-hour format of an hour with leading zeros

01 through 12

H

24-hour format of an hour with leading zeros

00 through 23

i

Minutes with leading zeros

00 to 59

s

Seconds, with leading zeros

00 through 59

Full Date and Time

Format Character

Description

Example returned values

c

ISO 8601 date (added in PHP 5)

2004-02-12T15:19:21+00:00

r

» RFC 2822 formatted date

Example: Thu, 21 Dec 2000 16:01:07 +0200


Did this answer your question?