Admin Boxes Method fillAdminBox()

public function fillAdminBox(
$path, $settingGroup, &$box, &$fields, &$values
) { //...your PHP code...// }

Summary

Use this method to set or modify the contents of an Admin Box when it is first opened.

Context

This method is called when an administrator opens one of your Admin Boxes, or when an Admin Box that you have modifications in is opened.

Where You Can Use It

From Zenario 7.0.0 onwards.

Description

You should use this method to load any information needed in your Admin Box.

For example, if the administrator is viewing/editing something that already exists, you would want to set the values of each field.

This method will only be called the first time that an administrator opens your Admin Box, and not when it is validated or saved.

Parameters

$path

The path of the Admin Box opened.

$settingGroup

When showing an Admin Box for Plugin Settings or Site Settings, this variable will contain the name of the Module or Settings Group.

$box

The TUIX that defines your Admin Box, in the form of a PHP array.

You should make changes to this array as needed.

$fields

Shortcuts to the field definitions in your Admin Box.

E.g. $fields['tab_name/field_name'] references $box['tabs']['tab_name']['fields']['field_name']

$values

Shortcuts to the field values in your Admin Box.

E.g. $values['tab_name/field_name'] references $box['tabs']['tab_name']['fields']['field_name']['value']

Return Value

No return value is needed.