Views: 15194
Last Modified: 18.09.2014
Last Modified: 18.09.2014
|
|
|
The file .parameters.php contains the description of the input parameters of the component. The file data are needed exclusively to create the form to enter the properties of the component in Bitrix Framework environment (e.g., in a visual editor). This description is used for work with the component and also during work in the website editing mode. The description is not used and the said file is not connected during the operation of the component itself (when the page with the component is requested). The fil .parameters.php must be located in the component folder. The language file is connected automatically (it must be located in the folder /lang/<language>/.parameters.php, of the component folder). The file determines the array $arComponentParameters, which describes the input parameters of the component. If necessary, any additional data are selected. E.g., all active types must be selected in order to establish a drop-down list of information block types (input parameter IBLOCK_TYPE_ID). The structure of the typical file .parameters.php (based on the example of the components that operate with the module Information Block): <?
CModule::IncludeModule("iblock");
$dbIBlockType = CIBlockType::GetList(
array("sort" => "asc"),
array("ACTIVE" => "Y")
);
while ($arIBlockType = $dbIBlockType->Fetch())
{
if ($arIBlockTypeLang = CIBlockType::GetByIDLang($arIBlockType["ID"], LANGUAGE_ID))
$arIblockType[$arIBlockType["ID"]] = "[".$arIBlockType["ID"]."] ".$arIBlockTypeLang["NAME"];
}
$arComponentParameters = array(
"GROUPS" => array(
"SETTINGS" => array(
"NAME" => GetMessage("SETTINGS_PHR")
),
"PARAMS" => array(
"NAME" => GetMessage("PARAMS_PHR")
),
),
"PARAMETERS" => array(
"IBLOCK_TYPE_ID" => array(
"PARENT" => "SETTINGS",
"NAME" => GetMessage("INFOBLOCK_TYPE_PHR"),
"TYPE" => "LIST",
"ADDITIONAL_VALUES" => "Y",
"VALUES" => $arIblockType,
"REFRESH" => "Y"
),
"BASKET_PAGE_TEMPLATE" => array(
"PARENT" => "PARAMS",
"NAME" => GetMessage("BASKET_LINK_PHR"),
"TYPE" => "STRING",
"MULTIPLE" => "N",
"DEFAULT" => "/personal/basket.php",
"COLS" => 25
),
"SET_TITLE" => array(),
"CACHE_TIME" => array(),
"VARIABLE_ALIASES" => array(
"IBLOCK_ID" => array(
"NAME" => GetMessage("CATALOG_ID_VARIABLE_PHR"),
),
"SECTION_ID" => array(
"NAME" => GetMessage("SECTION_ID_VARIABLE_PHR"),
),
),
"SEF_MODE" => array(
"list" => array(
"NAME" => GetMessage("CATALOG_LIST_PATH_TEMPLATE_PHR"),
"DEFAULT" => "index.php",
"VARIABLES" => array()
),
"section1" => array(
"NAME" => GetMessage("SECTION_LIST_PATH_TEMPLATE_PHR"),
"DEFAULT" => "#IBLOCK_ID#",
"VARIABLES" => array("IBLOCK_ID")
),
"section2" => array(
"NAME" => GetMessage("SUB_SECTION_LIST_PATH_TEMPLATE_PHR"),
"DEFAULT" => "#IBLOCK_ID#/#SECTION_ID#",
"VARIABLES" => array("IBLOCK_ID", "SECTION_ID")
),
),
)
);
?>
Let us have a closer look at the keys of the array $arComponentParameters. GROUPSThe value of this key is an array of component parameter groups. In the visual means of the Bitrix Framework (e.g., in a visual editor), the parameters are grouped. The groups in the Bitrix Framework environment are located according to the order set in the file. The array of the component parameter groups consists of the following types of elements: "group code" => array(
"NAME" => "name of the group in the current language"
"SORT" => "sorting",
)
List of standard groups:
PARAMETERSThe value of this key is an array of component parameters. In each parameter group, the parameters are located in the order set in the file. The array of regular parameters of the component consists of the following types of elements: "parameter code" => array(
"PARENT" => "group code", // if not - ADDITIONAL_SETTINGS shall be established
"NAME" => "parameter name in the current language",
"TYPE" => "type of the control element in which the parameter will be established",
"REFRESH" => "refresh settings or not after selection (N/Y)",
"MULTIPLE" => "single/multiple value (N/Y)",
"VALUES" => "array of values for the list (TYPE = LIST)",
"ADDITIONAL_VALUES" => "show the field for the values to be entered manually (Y/N)",
"SIZE" => "number of lines for the list (if a list which is not a drop-down list is needed)",
"DEFAULT" => "default value",
"COLS" => "field width in characters",
),
The following values are available for the TYPE control element type:
The physical appearance of the list changes depending on whether the MULTIPLE and ADDITIONAL_VALUES keys are available/absent:
The REFRESH parameter permits to refresh the entire form with parameters following value selection. This is done, for example, to select an infoblock of a specific type. I.e., we have two parameters: infoblock type and infoblock code. The starting point is as follows: the first parameter contains all types of infoblocks, the second parameter contains a list of all infoblocks of this website; after the selection of a certain type of infoblock, component parameters are refreshed, and we can only see the infoblocks of the selected type. Externally, for the LIST - type parameters, this key is represented as the OK button located close to the relevant parameter (see screenshots above). If a certain parameter must appear or remain hidden depending on another parameter, the procedure is as follows. For example, we need to display the list of properties of an infoblock. Assuming that the infoblock ID is contained in the IBLOCK_ID component parameter, let us name the parameter containing property list PROP_LIST. The parameter IBLOCK_ID must have the key REFRESH = 'Y' established. The code: if (0 < intval($arCurrentValues['IBLOCK_ID'])
{
$arPropList = array();
$rsProps = CIBlockProperty::GetList(array(),array('IBLOCK_ID' => $arCurrentValues['IBLOCK_ID']));
while ($arProp = $rsProps->Fetch())
{
$arPropList[$arProp['ID']] = $arProp['NAME'];
}
$arComponentParameters['PARAMETERS']['PROP_LIST'] => array(
'NAME' => 'parameter title',
'TYPE' => 'LIST'
'VALUES' => $arPropList,
);
}
There are special parameters that are standardized so that there is no need to describe them in detail. It is sufficient just to indicate that they exist. For example, "SET_TITLE" => array(), "CACHE_TIME" => array(), The first of the indicated parameters shows whether the component should set a page header and the second one shows all cache-related settings. Only composite components can work in a SEF mode or redefine the variables coming from an HTTP request. In this case, two special parameters must be indicated among the parameters:
From product version 12 on (new core D7) there is an option to add a control element into the component parameters that permits to indicate color (COLORPICKER). To do so, the following must be indicated in the component parameter file .parameters.php:
$arParams["COLOR"] = Array(
"PARENT" => "BASE",
"NAME" => 'Colour selection',
"TYPE" => "COLORPICKER",
"DEFAULT" => 'FFFF00'
);
Courses developed by Bitrix24
|
