Advanced Product Settings

What this solution does

The Native Settings module enables the creation of custom site settings for use in scripts. Its key feature is the ability to define significantly more options for a parameter than standard system settings allow. Parameter settings can be distributed across sections for easier management.

The primary goal of the module is to minimize the use of constants and frequently used variables in code. For example, a store operating mode parameter can be defined in the settings and retrieved in the site template. If needed, an administrator can change the parameter value via the admin section without requiring constant edits to the template code.

Key capabilities:

1. Placing parameters into menu sections.

2. Specifying the data type for each parameter.

3. Setting dependencies based on language, module, site, or user group.

4. Preventing scripts from overwriting parameter values during execution.

5. Logging events related to parameter actions in the Event Log.

The module automatically converts returned parameter values to the specified data type. If errors occur during value retrieval, they are logged to the system log file, typically named __bx_log.log.

Data caching is handled by the platform's standard functions. The cache duration for table data can be adjusted via the /bitrix/.settings.php file using the cache_flags array.

Key features:

The module is installed in the global menu under 'Extensions'.

All settings can be configured only by users with administrator privileges.

The minimum required PHP version is 8.1 or higher.

Code examples:

// Include the module

\Bitrix\Main\Loader::includeModule('native.settings');

// Retrieve the value of parameter 'parameter-1'.

// If the value is missing or conditions cannot be met, the default value 'N' is returned.

$value = \Native\Settings\Option::get('parameter-1', 'N');

// Set the value 'Y' for parameter 'parameter-1' for the duration of the script execution.

// This is possible only if the parameter is not read-only.

\Native\Settings\Option::set('parameter-1', 'Y');

// Retrieve data based on parameters

The product advanced settings module provides a programmatic interface for managing configuration parameters. Available methods include retrieving the parameter list, displaying the table schema, and performing add, update, and delete operations. The system supports multiple data types: strings, numbers, arrays, JSON objects, dates, and date-time values. All supported value types are defined via class constants to ensure strict type safety.

General iT can install and configure this module and check how it works on your website.