Revision as of 23:03, 20 November 2020

We recommend that all custom PHP logic be performed via hooks. Hooks are the only future-proof way of performing your own PHP logic at the time of page rendering.

Historically, Smarty has allowed you to define custom PHP logic directly within system theme and order form template files. This has often been used by users and third-party developers as a quick and convenient way of performing additional logic and defining additional system theme and order form template output.

However, as of Smarty 3, support for the {php} block has been removed, and we are only providing legacy support to ease the transition for developers and users who work with our platform and rely on this functionality.

Example Hook File

The below example demonstrates how a hook can be used to perform additional PHP logic and define variables for use in system theme and order form template files.

<?php
/**
 * Hook sample for defining additional template variables
 *
 * @param array $vars Existing defined template variables
 *
 * @return array
 */
function hook_template_variables_example($vars)
{
    $extraTemplateVariables = array();
 
    // set a fixed value
    $extraTemplateVariables['fixedValue'] = 'abc';
 
    // fetch clients data if available
    $clientsData = isset($vars['clientsdetails']) ? $vars['clientsdetails'] : null;
 
    // determine if client is logged in
    if (is_array($clientsData) && isset($clientsData['id'])) {
        $userId = $clientsData['id'];
        // perform calculation here
        $extraTemplateVariables['userSpecificValue'] = '123';
        $extraTemplateVariables['anotherUserOnlyValue'] = '456';
    }
 
    // return array of template variables to define
    return $extraTemplateVariables;
}
 
add_hook('ClientAreaPageViewTicket', 1, 'hook_template_variables_example');

The above hook defines the additional system theme and order form template {$fixedValue} variable and, in the case of a logged-in user, {$userSpecificValue} and {$anotherUserOnlyValue} variables. You can them use them inside the associated system theme and order form template file (in this case, viewticket.tpl).

<p>The fixed value is {$fixedValue}.</p>
 
{if $userSpecificValue && $anotherUserOnlyValue}
    <p>I also have this {$userSpecificValue} and {$anotherUserOnlyValue} to show you.</p>
{/if}