Allows to populate drop-down, radio- or checkbox list fields, which have been added with
cms:onExtendTemplateForm event.
Usually you do not need to use this event for fields which represent
data relations. But if you want a standard
field (corresponding an integer-typed database column, for example), to be rendered as a drop-down list, you should
handle this event.
The event handler should accept 2 parameters - the field name and a current field value. If the current
field value is -1, the handler should return an array containing a list of options. If the current
field value is not -1, the handler should return a string (label), corresponding the value.
public function subscribeEvents()
{
Backend::$events->addEvent('cms:onExtendTemplateModel', $this, 'extend_template_model');
Backend::$events->addEvent('cms:onExtendTemplateForm', $this, 'extend_template_form');
Backend::$events->addEvent('cms:onGetTemplateFieldOptions', $this, 'get_template_field_options');
}
public function extend_template_model($template, $context)
{
$template->define_column('x_color', 'Color');
}
public function extend_template_form($template, $context)
{
$template->add_form_field('x_color')->renderAs(frm_dropdown);
}
public function get_template_field_options($field_name, $current_key_value)
{
if ($field_name == 'x_color')
{
$options = array(
0 => 'Red',
1 => 'Green',
2 => 'Blue'
);
if ($current_key_value == -1)
return $options;
if (array_key_exists($current_key_value, $options))
return $options[$current_key_value];
}
}
