Available on: Newsmag V1.8+, Newspaper V5+
This API call is used to update only one of the parameters of an existing top bar template.


<?php td_api_top_bar_template::update_key( $id, $key, $value ) ?>


$id (string) (required)

  • the top bar template id – has to match with one of the top bar templates which are already registered in the theme

$key (string) (required)

  • parameter to be replaced, in the following table you can see all parameters but only one can be used because via this method you can update only one parameter:
Key name
img string the top bar template icon, appears in Theme Panel -> Header section
file string the path of the top bar template file

$value (mixed) (required)

  • the data which will replace the parameter existing one, it’s type depends on the selected parameter.


In the following example we’ll update the existing Top Bar Template 1 ,  the ‘file’ key data will be replaced, you can see how the code looks on plugin, you have to modify the file path to match with the plugin current folder, we use the variables which were introduced in the Plugin Method section, ex:

td_api_top_bar_template::update_key('td_top_bar_template_1', 'file', $this->plugin_path . '/parts/header/td_top_bar_template_1.php');