Requires: phpFox version 4.6.0 or higher.
phpFox allows admin to configure component blocks by using Block Settings.
Example, admin can configure how many item will be shown, and visibility of this block, etc...
...
In order to add ability, add new method getSettings()
to your block, this method return returns a list of fields will be shown in settings page.
Code Block |
---|
|
<?php
class Friend_Component_Block_Mini extends Phpfox_Component
//..
/**
* Settings of block
* @return array
*/
public function getSettings()
{
return [
[
'info' => _p('friend_block_mini_limit_info'),
'description' => _p('friend_block_mini_limit_description'),
'value' => 7,
'var_name' => 'limit',
'type' => 'integer',
]
];
}
//..
?>
|
Field Visibility
is prepended before your settings field automatically.
In case you would like to validate input value, add method getValidation
to your class.
...
<?php
class Fiend_Component_Block_Mini extends Phpfox_Component {
// ...
/**
* Get array of validation rules
*/
public function getValidation(){
return [
'limit'=> [
'def' => 'int:required',
'min' => 0,
'title'=>'Invalid number'
]
];
}
//...
}
|
In order to get configured value:
Code Block |
---|
|
<?php
class Fiend_Component_Block_Mini extends Phpfox_Component {
public function process(){
/**
* return configured value or "7" if the value is empty.
*
*/
$iLimit = $this->getParam('limit',7);
//..
}
//...
}
|
...
- string
- large_string
- password
- integer
- boolean
- currency
- select
- array
- multi_text
- multi_checkbox
string
Code Block |
---|
|
return [
[
'var_name' => 'example_name',
'info' => 'example label',
'description' => 'example description',
'type' => 'string',
'value' => 'default_value',
],
];
|
large_string
Code Block |
---|
|
return [
[
'var_name' => 'example_name',
'info' => 'example label',
'description' => 'example description',
'type' => 'large_string',
'value' => 'default_value',
],
];
|
password
Code Block |
---|
|
return [
[
'var_name' => 'example_name',
'info' => 'example label',
'description' => 'example description',
'type' => 'password',
'value' => 'default_value',
],
];
|
integer
Code Block |
---|
|
return [
[
'var_name' => 'example_name',
'info' => 'example label',
'description' => 'example description',
'type' => 'integer',
'value' => 10,
],
];
|
boolean
Code Block |
---|
|
return [
[
'var_name' => 'example_name',
'info' => 'example label',
'description' => 'example description',
'type' => 'boolean',
'value' => 0,
],
];
|
currency
Code Block |
---|
|
return [
[
'var_name' => 'example_name',
'info' => 'example label',
'description' => 'example description',
'type' => 'currency',
'value' => ['USD' => 0],
],
];
|
select
Code Block |
---|
|
return [
[
'var_name' => 'example_name',
'info' => 'example label',
'description' => 'example description',
'type' => 'select',
'value' => 'value_1',
'options' => [
'value_1' => 'Value Label 1',
'value_2' => 'Value Label 2',
]
],
];
|
array
Code Block |
---|
|
return [
[
'var_name' => 'example_name',
'info' => 'example label',
'description' => 'example description',
'type' => 'array',
'value' => [1,2,3,4],
],
];
|
multi_text
Code Block |
---|
|
return [
[
'var_name' => 'example_name',
'info' => 'example_label',
'description'=>'example description',
'type'=> 'multi_text',
'value'=> [
'key1' =>'example value 1',
'key2' =>'example value 2',
'key3'=>'example value 3'
],
],
];
|
multi_checkbox
Code Block |
---|
|
return [
[
'var_name' => 'example_name',
'info' => 'example labele',
'description' => 'example description',
'type' => 'multi_checkbox',
'value' => ['value_1', 'value_2'],
'options' => [
'value_1' => 'Value Label 1',
'value_2' => 'Value Label 2',
'value_3' => 'Value Label 3'
]
],
];
|