Jump to main content Jump to doc navigation

Event: OnTemplateVarBeforeSave

Loaded right before saving a template variable to database.

  • Service: 1 - Parser Service Events
  • Group: Template Variables

Event Parameters

Name Description
mode Either 'new' or 'upd', depending on the circumstances.
templateVar The instance of modTemplateVar class.
cacheFlag Indicates if the saved TV should be cached and optionally, by specifying an integer value, for how many seconds before expiring.


Previous event
Next event OnTemplateVarSave
File core/model/modx/modtemplatevar.class.php
Class modTemplateVar
Method public function save($cacheFlag = null)


Such a plugin will display the data of the saved TV in the "Error log":

$eventName = $modx->event->name;
switch($eventName) {
    case 'OnTemplateVarBeforeSave':
        //array tv, with all parameters
        //checking for updating or creating the tv itself
        if ($mode == modSystemEvent::MODE_NEW){
            echo 'A new TV was created';
        } elseif ($mode == modSystemEvent::MODE_UPD){
            echo 'Old TV has been updated';

See Also

Support the team building MODX with a monthly donation.

The budget raised through OpenCollective is transparent, including payouts, and any contributor can apply to be paid for their work on MODX.



$0 per month—let's make that $500!

Learn more