# Shortcodes

Shortcodes - What are they? 
Shortcodes are small bits of code that allow you to do various things with little effort. They allow you to implement functionality that would normally require complicated code to use.
Shortcodes are tied to predefined elements and can be used throughout the system with minimal effort.
Articles detailing different shortcodes available for use are located here.

# System_code Shortcode

## Special System\_Code Shortcode

The system\_code is the most common short code used on the OPS-COM system. It will provide and display the system information related to that page.

For example, if you were to add the system\_code shortcode to the end of the **Permits** page you will see system information related to permits such as available permits and lots.

<span data-colorid="mwrnq6k3ya">If the page is a system page, like /login, and it doesn't have the shortcode anywhere, it will append it to the bottom of the content page at least once.</span>

## Example Uses

### <span data-colorid="s4wn2hus3g">Vehicles Page </span>

<span data-colorid="feka1vltcw">Using the system\_code tag on the **Vehicles** page will show you all of the vehicles you have registered to that user.   
  
</span>

[![image.png](https://opscom.wiki/uploads/images/gallery/2024-06/scaled-1680-/B0wimage.png)](https://opscom.wiki/uploads/images/gallery/2024-06/B0wimage.png)

### <span data-colorid="hsd82hqvij">Permits Page</span>

<span data-colorid="n7drw6fcg0">Using the system\_code tag on the **Permits** page will provide information related to all the permits and lots your users have available to them.   
  
</span>

[![image.png](https://opscom.wiki/uploads/images/gallery/2024-06/scaled-1680-/cw3image.png)](https://opscom.wiki/uploads/images/gallery/2024-06/cw3image.png)

<span data-colorid="lvbi02ngcc">As an option, on the permits page, you can display the current permits the user has. Using the shortcode \[permit\_card\] on the permits page will display the list of the user's current permits. In fact, using this code on whatever page you wish it to be on, will show the permit\_card which is the list of current permits.</span>

[![image.png](https://opscom.wiki/uploads/images/gallery/2024-06/scaled-1680-/Nlzimage.png)](https://opscom.wiki/uploads/images/gallery/2024-06/Nlzimage.png)

<span data-colorid="fvamh4smx0">Here is the resulting page content.  
  
</span>

[![image.png](https://opscom.wiki/uploads/images/gallery/2024-06/scaled-1680-/8q4image.png)](https://opscom.wiki/uploads/images/gallery/2024-06/8q4image.png)

<span data-colorid="fvamh4smx0">  
</span>

### <span data-colorid="k4hawij0j6">Appeals Page</span>

<span data-colorid="y62n3zpsgz"><span data-colorid="smfyeg14ps">Using the system\_code tag on the **Appeals** page will provide a convenient search window to search for plates or tickets.   
  
</span></span>

[![image.png](https://opscom.wiki/uploads/images/gallery/2024-06/scaled-1680-/gPsimage.png)](https://opscom.wiki/uploads/images/gallery/2024-06/gPsimage.png)

# User Information Shortcodes

## Shortcodes

Shortcodes used to display user information.

Keep in mind that the shortcode descriptions are also on the email template page for lost passwords.

<table border="1" id="bkmrk-shortcode-descriptio" style="border-collapse: collapse; width: 85.119%; height: 178.8px;"><colgroup><col style="width: 32.7765%;"></col><col style="width: 67.2216%;"></col></colgroup><tbody><tr style="height: 29.8px;"><td style="height: 29.8px;">**Shortcode**  
</td><td style="height: 29.8px;">**Description**  
</td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;"> \[user show="firstname"\]</td><td style="height: 29.8px;">The first name of the user account receiving the email or messaging. </td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;"> \[user show="lastname"\]</td><td style="height: 29.8px;">The last name of the user account receiving the email or messaging. </td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;"> \[user show="email"\]</td><td style="height: 29.8px;">The email address of the user account receiving the email or messaging. </td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;"> \[user show="username"\]</td><td style="height: 29.8px;">The username of the user account receiving the email or messaging. </td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;"> \[user show="salutation"\]</td><td style="height: 29.8px;">The salutation of the user account receiving the email or messaging. </td></tr></tbody></table>

# User_card Shortcode

## <span data-colorid="yd1sdu1pmo">How to use the Shortcode</span>

To use the **User\_card** shortcode simply add **\[user\_card\]** anywhere to the content of your **Page** or **System Message**.

## Example

Using the **\[user\_card\]** shortcode will display useful user information as seen below.

[![image.png](https://opscom.wiki/uploads/images/gallery/2024-06/scaled-1680-/bq5image.png)](https://opscom.wiki/uploads/images/gallery/2024-06/bq5image.png)

# Lot Information Shortcode

## Lot Information Display

This shortcode can be used anywhere on the site. It does not need to be initialized. You simply need to add it to your template to display it.

The available options are:

<div class="table-wrap" id="bkmrk-option-type-default-"><table class="wrapped confluenceTable" style="width: 100%;"><colgroup><col style="width: 14.0578%;"></col><col style="width: 12.6406%;"></col><col style="width: 24.7914%;"></col><col style="width: 48.5101%;"></col></colgroup><tbody><tr><td class="confluenceTd">**Option**</td><td class="confluenceTd">**Type**</td><td class="confluenceTd">**Default**</td><td class="confluenceTd">**Purpose**</td></tr><tr><td class="confluenceTd">price</td><td class="confluenceTd">boolean</td><td class="confluenceTd">true</td><td class="confluenceTd">Shows the price. Set to false/off/0 etc. to turn off</td></tr><tr><td class="confluenceTd">sold\_out</td><td class="confluenceTd">boolean</td><td class="confluenceTd">false</td><td class="confluenceTd">If true, it will include the lots that are sold out. They will have the warning background to highlight they are sold out</td></tr><tr><td class="confluenceTd">remaining</td><td class="confluenceTd">boolean</td><td class="confluenceTd">false</td><td class="confluenceTd">If true, it will show a column for how many remaining permits are in this lot</td></tr><tr><td class="confluenceTd">type</td><td class="confluenceTd">string</td><td class="confluenceTd">  
</td><td class="confluenceTd">If a value is set, it will filter the list to only show this lot type. Blank, or not set, will show all</td></tr></tbody></table>

</div><div class="code panel pdl conf-macro output-block" data-hasbody="true" data-macro-id="8f7c5a7a-6d2c-45b8-b533-9787b4237b0f" data-macro-name="code" id="bkmrk-%5Bpermitlots-remainin"><div class="codeContent panelContent pdl"><div><div class="syntaxhighlighter sh-midnight nogutter  xml" id="bkmrk-%5Bpermitlots-remainin-1"><table border="0" cellpadding="0" cellspacing="0"><tbody><tr><td class="code"><div class="container" title="Hint: double-click to select code"><div class="line number1 index0 alt2">`[permitlots remaining=true sold_out=true price=true]`</div></div></td></tr></tbody></table>

</div></div></div></div>In the example above, this shortcode would display all lots even if they are sold out, the price of the permits for that lot, and the total number spaces in the lots. Refer to the screenshot below.

[![image.png](https://opscom.wiki/uploads/images/gallery/2024-06/scaled-1680-/IUMimage.png)](https://opscom.wiki/uploads/images/gallery/2024-06/IUMimage.png)

# PermitTempPdf and Conditional Shortcode

## PermitTempPdf Shortcode  


The use of permittemppdf is fairly straight forward.

The shortcode has two different arguments it can accept to change the information it will output: permit and vehicle.

### Permit

Shortcode format:

- **\[permittemppdf permit=\_\_\_\_\_\_\]**

The options to fill the blank space are:

- barcode
- permitno
- lotshortname
- lotname
- location
- expiry

Expiry will show a snippet of html that is not editable because of the complexity of the expiry information.

### Vehicle

Shortcode format:

- **\[permittemppdf vehicle=\_\_\_\_\_\_\]**

The options to fill the blank space are:

- plate
- guest
- year
- colour
- make
- type

## Conditional Shortcode  


The conditional shortcode is somewhat complex.

It will only work with shortcodes that have been set it up for. Right now, that only includes the permittemppdf shortcode.

The formats that can be used are as follows:

- **\[conditional var=\*\*\*\*\*\* test=!!!!!!!!\]CONTENT\[/condtional\]**
- **\[conditional var=\*\*\*\*\*\* test=!!!!!!!! value=\_\_\_\_\_\_\_\_\_\_\]CONTENT\[/condtional\]**

This will test the value of \*\*\*\*\*\*. If the value is a success, then it will show the CONTENT.

The options for var currently are:

- permittemp
- permit

For example, to test if there are hours on a temp permit, the value would be: **var=permittemp.hours**

This is the variable name that has been defined (permittemp) and the case-sensitive column to return the information of.

The second argument "test" can take the following values:

- hasvalue = if not empty or false, returns true 
    - true = if the variable is a boolean true. i.e. 1, true, "true"
    - false = if the variable is a boolean false.
- eq or equal = if the variable matches the contents of "value"
- ne, neq or notequal = if the variable does not match the contents of "value"

<div class="notranslate" id="bkmrk--1" style="all: initial;"></div>

# Form 11 Shortcodes

## Information

When issuing a Form 11, there are a number of shortcodes that can be placed in the template to auto-fill values relating to the violation.

The base short code is formatted like:

- **\[values show=violation.\_\_\_\_\_\]**

The blank value must be filled with a value to pull from the violation info.

For each nested value in the data packet, the packet name must be added as part of the variable name, each part separated by a period, with the variable to be output by the shortcode as the final part of the variable.

The packet itself is called by 'violation', and the name must be placed at the start of any value call.

### Violation Packet

The violation info packet is formatted like this example.

The values on the left are the variable names, the values on the right are the example values returned by this packet.

```json
{
    "ViolationID": 237,
    "SemPermitID": null,
    "Ticket": "TT-19026",
    "VehicleID": 5,
    "Spoiled": 0,
    "TicketType": 1,
    "Issued": "2024-07-17 16:11:00",
    "convNotice": null,
    "Due": "2024-07-27 16:11:00",
    "ViolationTypeID": -1,
    "Fine": "50.0000",
    "AdjustedFine": "20.0000",
    "Towing": "0.0000",
    "taxAmount": "0.0000",
    "Writer": 7,
    "LocationID": 10,
    "Comment": null,
    "TicketAppeal": null,
    "appealType": 0,
    "appealFormat": null,
    "AccessAdminID": 50,
    "ActionedPer": null,
    "Created": "2024-07-17 20:12:08",
    "AppealUserID": 0,
    "AppealProcessDate": null,
    "AppealAdminID": 0,
    "AppealComment": null,
    "AppealAdminComment": null,
    "AutoNotice": 0,
    "ProcessedByCollection": null,
    "SentToCollections": null,
    "PrivateComments": "",
    "DriveAway": 0,
    "UUID": null,
    "VioNotice": null,
    "latitude": null,
    "longitude": null,
    "Warning": null,
    "userid": null,
    "incidentID": null,
    "failToIdentify": null,
    "pin": "YL",
    "duplicate": null,
    "AdjustmentReason": null,
    "notices_count": 1,
  
    "user_info": {
            "UserID": 5,
            "studentNo": null,
            "employNo": "00800147",
            "username": "mashbury",
            "firstName": "Michael",
            "preferredname": null,
            "lastName": "Ashbury",
            "street": "688 Zaproxy Ridge",
            "city": "East Romaineburgh",
            "prov": 9,
            "postal": "K2G5B1",
            "email": "mash-bury@tomahawk.ca",
            "display_name": "Michael Ashbury",
            "account_no": "00800147",
            "prov_name": "Ontario",
    },
  
    "writer": {
            "AdminAccessID": 7,
            "Username": "admin",
            "DisplayName": "Administrator"
    },
  
    "vehicle": {
            "VehicleID": 5,
            "Active": 1,
            "Plate": "MASH",
            "Year": 1998,
            "TotalVio": 12,
            "TotalUnpaid": 2,
            "TotalWarning": 0,
            "vehicleAlert": true,
            "vin": "JNAMA43H9XGE50339",
            "electric_vehicle": false,
          
            "province": {
                    "ProvName": "West Virginia",
                    "ProvCode": "WV",
            },

            "make": {
                  "MakeName": "Toyota"
            },
            
            "colour": {
                  "ColourName": "Black"
            },
            
            "plate_type": {
                  "TypeName": " Passenger"
            }
        
            "vehicle_type": {
                  "TypeName": " Van"
            },
      
    },
  
    "location": {
            "LocationID": 10,
            "LocationName": "Hospital & Administration Building",
    },
  
    "details": {
            "ViolationsDetailID": 359,
            "ViolationID": 237,
            "Ticket": "TT-19026",
            "ViolationTypeID": 16,
            "LocationID": 10,
            "offenceFine": 50,
            "discountFlag": 1,
            "discountAmount": 20,
            "discountHours": 240,
          
            "type": {
                    "ViolationTypeID": 16,
                    "ViolationDescr": "No Parking Snow Route - Mandatory Towing",
                    "DefaultCost": 50,
                    "discountFlag": true,
                    "discountAmount": 20,
                    "discountHours": 240,
            }
    }
}
```

### Examples

An example shortcode is provided for each section. To return a specific value in the same section, replace the provided variable name with the sibling value wanted for output.

<table border="1" id="bkmrk-example-shortcode-de" style="border-collapse: collapse; width: 105.238%; height: 268.2px;"><colgroup><col style="width: 44.8211%;"></col><col style="width: 55.1789%;"></col></colgroup><tbody><tr style="height: 29.8px;"><td style="height: 29.8px;">**Example Shortcode**  
</td><td style="height: 29.8px;">**Description**  
</td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;">\[values show=violation.Ticket\]

</td><td style="height: 29.8px;">Returns the violation ticket number.  
</td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;">\[values show=violation.user\_info.username\]</td><td style="height: 29.8px;">Returns the username of the user the violation belongs to.  
</td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;">\[values show=violation.writer.DisplayName\]</td><td style="height: 29.8px;">Returns the display name of the admin who assigned the violation to the user.  
</td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;">\[values show=violation.vehicle.Plate\]</td><td style="height: 29.8px;">Returns the plate of the vehicle the violation was assigned to, if applicable.  
</td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;">\[values show=violation.vehicle.province.ProvName\]</td><td style="height: 29.8px;">Returns the province or state of the vehicle plate.  
</td></tr><tr><td>\[values show=violation.vehicle.colour.ColourName\]</td><td>Returns the colour of the vehicle.  
</td></tr><tr><td>\[values show=violation.vehicle.plate\_type.TypeName\]</td><td>Returns the plate type of the vehicle.</td></tr><tr><td>\[values show=violation.vehicle.vehicle\_type.TypeName\]</td><td>Returns the type of the vehicle.</td></tr><tr><td>\[values show=violation.vehicle.make.MakeName\]</td><td>Returns the make of the vehicle.</td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;">\[values show=violation.location.LocationName\]</td><td style="height: 29.8px;">Returns the name of the location the infraction happened.  
</td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;">\[values show=violation.details.0.Ticket\]</td><td style="height: 29.8px;">Returns the violation ticket number. Alternate value location.  
</td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;">\[values show=violation.details.0.type.ViolationDescr\]</td><td style="height: 29.8px;">Returns the violation type description.  
</td></tr></tbody></table>