PHPackages                             claramente/claramente.options - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. claramente/claramente.options

ActiveBitrix-module[Utility &amp; Helpers](/categories/utility)

claramente/claramente.options
=============================

Bitrix - Options

1.4.1(3mo ago)2652↓25%MITPHPPHP &gt;=8.0

Since Feb 6Pushed 3mo ago1 watchersCompare

[ Source](https://github.com/claramente-ru/bitrix-options)[ Packagist](https://packagist.org/packages/claramente/claramente.options)[ RSS](/packages/claramente-claramenteoptions/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (9)Dependencies (1)Versions (10)Used By (0)

Модуль опций для Bitrix
=======================

[](#модуль-опций-для-bitrix)

[![Claramente](https://camo.githubusercontent.com/5985a4e502ffba7cf51de8ee2b0edbf140e5228beb09e887606cfb15f93b145a/68747470733a2f2f636c6172616d656e74652e72752f75706c6f61642f636c6172616d656e74652f6132632f686f33726a3470336a3274377363736172746f68676a616a6b6231786b7968302f6c6f676f2e737667)](https://claramente.ru)

Установка через composer
------------------------

[](#установка-через-composer)

Пример composer.json с установкой модуля в local/modules/

```
{
  "extra": {
    "installer-paths": {
      "local/modules/{$name}/": ["type:bitrix-module"]
    }
  },
  "require": {
    "claramente/claramente.options": "dev-master"
  }
}

```

1. Запустить `composer require claramente/claramente.options dev-master`
2. В административном разделе установить модуль **claramente.options** *(/bitrix/admin/partner\_modules.php?lang=ru)*
3. Подключить модуль в `/local/php_interface/init.php` или в `/bitrix/php_interface/init.php` добавив строчку `CModule::IncludeModule('claramente.options')`
4. После установки модуля он будет доступен в разделе Контент =&gt; Параметры сайта (*/bitrix/admin/claramente\_options.php?lang=ru*)

[![](https://camo.githubusercontent.com/466477873f85248fa12dd15ca5a7e1a27e1aa9939769d2226089d3b1e8d64f9c/68747470733a2f2f636c6172616d656e74652e72752f75706c6f61642f636c6172616d656e74652f61646d696e2d6c6566742d6d656e752e706e67)](https://camo.githubusercontent.com/466477873f85248fa12dd15ca5a7e1a27e1aa9939769d2226089d3b1e8d64f9c/68747470733a2f2f636c6172616d656e74652e72752f75706c6f61642f636c6172616d656e74652f61646d696e2d6c6566742d6d656e752e706e67)

Использование модуля
--------------------

[](#использование-модуля)

- Получение значения опции для текущего языка: `cm_option(code, site_id)`
- Получение значения опции для всех языков: `cm_option_all_lang(code, site_id)`
- Установка нового значения опции: `cm_option_set(code, site_id, value)`
- Проверка существования опции для текущего языка: `cm_option_exists(code, site_id)`
- Проверка заполнения опции для текущего языка: `cm_option_filled(code, site_id)`

О модуле
--------

[](#о-модуле)

Этот модуль упрощает работу с опциями сайта, позволяя редактировать контент и хранить важные данные, часто используемые в коде.

Аналог модуля COption из BX, но с расширенными возможностями: поддерживает удобное форматирование строк в административной панели, позволяет задавать тип данных, устанавливать ограничения и создавать новые типы. Модуль поддерживает возможность мультиязычности. Для каждой опции есть настройка - "Одно значение для всех языков", которое позволяет завести одно значение для всех языков или множество значений под конкретный язык.

В системе доступны несколько предустановленных типов данных:

- Строка
- Строки (множественный ввод, поддержка тысяч строк)
- Флаг (true/false)
- Дата
- Список
- Файл

В модуле существует возможность расставлять опции и сортировать их. Для переноса опций в группу необходимо создать новую вкладку. По умолчанию все опции хранятся во вкладке "Опции". После созданий новой вкладки можно создавать опции и помещать их туда, устанавливая сортировку.

Страница настроек параметров сайта
----------------------------------

[](#страница-настроек-параметров-сайта)

[![](https://camo.githubusercontent.com/eb276c9205d4dd268f3cd67d0277703ba69a49ac0466208587030d0d59f523ad/68747470733a2f2f636c6172616d656e74652e72752f75706c6f61642f636c6172616d656e74652f61646d696e2d6d61696e2e6a7067)](https://camo.githubusercontent.com/eb276c9205d4dd268f3cd67d0277703ba69a49ac0466208587030d0d59f523ad/68747470733a2f2f636c6172616d656e74652e72752f75706c6f61642f636c6172616d656e74652f61646d696e2d6d61696e2e6a7067)

Страница настроек параметра
---------------------------

[](#страница-настроек-параметра)

[![](https://camo.githubusercontent.com/1b5a78976c3d04572fb03225d81f39c5ddb53154457c69caeaad0b1913dd020c/68747470733a2f2f636c6172616d656e74652e72752f75706c6f61642f636c6172616d656e74652f61646d696e2d6f7074696f6e2d656469742e706e67)](https://camo.githubusercontent.com/1b5a78976c3d04572fb03225d81f39c5ddb53154457c69caeaad0b1913dd020c/68747470733a2f2f636c6172616d656e74652e72752f75706c6f61642f636c6172616d656e74652f61646d696e2d6f7074696f6e2d656469742e706e67)

Оптимизация работы модуля
-------------------------

[](#оптимизация-работы-модуля)

### 1. Кэширование SQL-запросов

[](#1-кэширование-sql-запросов)

Модуль поддерживает возможность кэширования SQL-запросов. Для кэширования отдельных запросов необходимо передать в `cm_option` последним параметром время кэширования в секундах.

Для включения глобального кэширования следует определить глобальную константу со временем кэша:

```
const CLARAMENTE_OPTIONS_CACHE_TIME = 3600;
```

Обратите внимание, что константа должна быть объявлена **до** вызова метода `cm_option`.

### 2. Предварительная загрузка данных

[](#2-предварительная-загрузка-данных)

Модуль поддерживает возможность загрузки всех опций сразу. Любой вызов метода `cm_option` сначала загружает все данные, после чего последующие запросы используют загруженные данные без дополнительных обращений к базе данных.

Для активации предварительной загрузки необходимо установить глобальную константу:

```
const CLARAMENTE_OPTIONS_PRELOADER = true;
```

Обратите внимание, что константа должна быть объявлена **до** вызова метода `cm_option`.

###  Health Score

42

—

FairBetter than 90% of packages

Maintenance79

Regular maintenance activity

Popularity20

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~44 days

Recently: every ~85 days

Total

9

Last Release

111d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/49289614?v=4)[claramente](/maintainers/claramente)[@claramente](https://github.com/claramente)

---

Top Contributors

[![claramente-ru](https://avatars.githubusercontent.com/u/196751009?v=4)](https://github.com/claramente-ru "claramente-ru (7 commits)")

---

Tags

bitrixbitrix highloadbitrix iblockbitrix optionsbitrix опцииbitrix параметрыbitrix настройки

### Embed Badge

![Health badge](/badges/claramente-claramenteoptions/health.svg)

```
[![Health](https://phpackages.com/badges/claramente-claramenteoptions/health.svg)](https://phpackages.com/packages/claramente-claramenteoptions)
```

###  Alternatives

[bitrix-expert/bbc

Bitrix basis components

10242.9k1](/packages/bitrix-expert-bbc)[bitrix-expert/bbc-module

Module with classes for the basis components

1951.8k1](/packages/bitrix-expert-bbc-module)[andreyryabin/sprint.options

Content options for 1C-Bitrix

185.7k](/packages/andreyryabin-sprintoptions)[webarchitect609/bitrix-user-type

Set of custom Bitrix user property types and basic auxiliary functionality to help develop new types as easy and fast as it possible.

1418.4k1](/packages/webarchitect609-bitrix-user-type)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
