...
- getPackageFields
- getAdminAddFields
- getClientAddFields
- getAdminEditFields
- getClientEditFields
Creating ModuleFields
Creating fields using the ModuleFields class allows you to define a set of input fields that may be displayed in a variety of contexts, without worrying about how those fields are contained. There are three aspects of creating a field, described below, that include: creating the field label, creating the field, and attaching the field to the label.
...
Code Block | ||||
---|---|---|---|---|
| ||||
<?php class MyModule extends Module { ... public function getPackageFields($vars=null) { // Create the label $fields = new ModuleFields(); $my_label = $fields->label("My Field Label", "my_field_id"); // Create the field $my_field = $fields->fieldText("my_field_name", "default value", array('id' => "my_field_id")); $fields->setField($my_label); return $fields; } } ?> |
...
Code Block | ||||
---|---|---|---|---|
| ||||
<?php
class MyModule extends Module {
...
public function getPackageFields($vars=null) {
// Create the label
$fields = new ModuleFields();
$my_label = $fields->label("My Field Label", "my_field_id");
// Create the field
$my_field = $fields->fieldText("my_field_name", "default value", array('id' => "my_field_id"));
// Attach the field to the label
$my_label->attach($my_field);
// OR, attach the label to the field, instead
// $my_field->setLabel($my_label);
$fields->setField($my_label);
return $fields;
}
}
?> |
...
Code Block | ||||
---|---|---|---|---|
| ||||
<?php
class MyModule extends Module {
...
public function getPackageFields($vars=null) {
// Create the label
$fields = new ModuleFields();
$my_label = $fields->label("My Field Label", "my_field_id");
// Create and attach the field to the label
$my_label->attach($fields->fieldText("my_field_name", "default value", array('id' => "my_field_id")));
// Attach a tooltip to the label
$my_label->attach($fields->tooltip("This is my tooltip"));
$fields->setField($my_label);
return $fields;
}
}
?> |
...
Info | ||
---|---|---|
| ||
... but that would be silly. |
...
Complex Fields
Blesta supports ModuleFields up to two levels deep. This allows you to easily create a set of checkboxes or radio buttons associated with a single field.
Code Block | ||||
---|---|---|---|---|
| ||||
<?php class MyModule extends Module { ... public function getPackageFields($vars=null) { // Create the label $fields = new ModuleFields(); $my_label = $fields->label("My Field Label", "my_field_id"); ## # TODO: FINISH THIS EXAMPLE # ## // Create a field label displayed next to the checkbox $field_label = $fields->label("My Value", "my_field_my_value_id"); // Create and attach the field to the label, set as checked (3rd param) if necessary $my_label->attach($fields->fieldCheckbox("my_field_name", "my_value", (isset($vars->my_field_name) && $vars->my_field_name == "my_value"), array('id' => "my_field_my_value_id"), $field_label)); // Attach a tooltip to the label $my_label->attach($fields->tooltip("This is my tooltip")); $fields->setField($my_label); return $fields; } } ?> |
...