Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/fi1a/bitrixvalidation

Модуль 1С-Битрикс "Валидация полей и свойств"
https://github.com/fi1a/bitrixvalidation

bitrix bitrix-module php validation validator

Last synced: about 1 month ago
JSON representation

Модуль 1С-Битрикс "Валидация полей и свойств"

Host: GitHub
URL: https://github.com/fi1a/bitrixvalidation
Owner: fi1a
License: mit
Created: 2022-11-12T00:06:14.000Z (about 2 years ago)
Default Branch: main
Last Pushed: 2023-03-15T06:48:13.000Z (almost 2 years ago)
Last Synced: 2024-04-25T05:01:24.161Z (8 months ago)
Topics: bitrix, bitrix-module, php, validation, validator
Language: PHP
Homepage:
Size: 1.77 MB
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        # Модуль 1С-Битрикс "Валидация полей и свойств"

[![Latest Version][badge-release]][packagist]

[![Software License][badge-license]][license]

[![PHP Version][badge-php]][php]

[![Total Downloads][badge-downloads]][downloads]

[![Support mail][badge-mail]][mail]

Осуществляет настройку и валидацию полей и свойств инфоблоков и highloadblock'ов в 1С-Битрикс.

Предоставляет удобный интерфейс для определения правил проверки (валидации) для полей и свойств.

Модуль использует для проверки (валидации) библиотеку [fi1a/validation](https://github.com/fi1a/validation).

## Установка модуля из Маркетплейса 1С-Битрикс

Модуль можно установить из Маркетплейса 1С-Битрикс

["Валидация полей и свойств"](http://marketplace.1c-bitrix.ru/solutions/fi1a.bitrixvalidation/)

Перед установкой модуля следует установить модуль

["Обертка над composer для установки зависимостей"](http://marketplace.1c-bitrix.ru/solutions/fi1a.bitrixrequire/)

если он еще не установлен.

Модуль необходим для установки зависимостей через composer.

После чего модуль устанавливается и удаляется как любой модуль из маркетплейса.

## Установка модуля через composer

В вашем composer.json проекта необходимо указать:

- в блоке require указать инсталятор `"fi1a/installers": "^2.1"`;

- в блоке require указать модуль `"fi1a/bitrixvalidation": "^3.0"`;

- указать путь до 1С-Битрикс (`bitrix-dir`) для копирования модулей при установке `fi1a/installers`.

Пример файла composer.json проекта расположенного в папке `$DOCUMENT_ROOT/local`:

```json

{

  "name": "fi1a/project",

  "type": "project",

  "license": "MIT",

  "authors": [

    {

      "name": "Fi1a",

      "email": "[email protected]"

    }

  ],

  "require": {

    "fi1a/installers": "^2.1",

    "fi1a/bitrixvalidation": "^3.0"

  },

  "extra": {

    "bitrix-dir": "../bitrix"

  }

}

```

Затем выполняем установку пакетов командой `composer install`.

Если у вас не подключен composer autoload.php, его необходимо подключить в файле local/php_interface/init.php

```php

require_once __DIR__ . '/../vendor/autoload.php';

```

Если модуль не установили через composer, то его необходимо установить из админки 1С-Битрикс

(Marketplace > Установленные решения > модуль "Валидация полей и свойств (fi1a.bitrixvalidation)").

**После установки проверьте права на чтение файлов и папок модуля.**

## Использование

После установки появится пункт меню: "Контент" > "Валидация полей и свойств".

Настроить права для групп пользователей можно на странице "Настройки" > "Настройки продукта" > "Настройки модулей" > "Валидация полей и свойств"

## Изображения модуля

Список доступных инфоблоков и highloadblock'ов для задания правил проверки:

![Список доступных инфоблоков и highloadblock](images/fi1a.bitrixvalidation-screen-1.png)

Задание правил проверки (валидации) для полей и свойств инфоблока:

![Задание правил проверки (валидации) для полей и свойств инфоблока](images/fi1a.bitrixvalidation-screen-2.png)

Проверка (валидация) при сохранении элемента инфоблока:

![Проверка (валидация) при сохранении элемента инфоблока](images/fi1a.bitrixvalidation-screen-3.png)

## Доступные правила проверки (валидаторы значений)

- (alphaNumeric) Буквенно-цифровое значение;

- (alpha) Буквенное значение;

- (betweenCount) Максимальная и минимальная количество значений;

- (betweenDate) Максимальная и минимальная дата;

- (betweenLength) Максимальная и минимальная длина строки;

- (between) Максимальное и минимальное значение;

- (boolean) Логическое значение;

- (date) Дата и время;

- (email) E-mail адрес;

- (equal) Проверяет число на равенство;

- (equalDate) Проверяет дату на равенство;

- (in) Допустимые значения (не строгая проверка);

- (integer) Целое число;

- (json) JSON-строка;

- (maxCount) Максимальное количество значений;

- (maxDate) Максимальная дата;

- (maxLength) Максимальная длина строки;

- (max) Максимальное значение;

- (minCount) Минимальное количество значений;

- (minDate) Минимальная дата;

- (minLength) Минимальная длина строки;

- (min) Минимальное значение;

- (notIn) Не допустимые значения (не строгая проверка);

- (numeric) Число;

- (regex) Регулярное выражение;

- (strictIn) Допустимые значения (строгая проверка);

- (strictNotIn) Не допустимые значения (строгая проверка);

- (unique) Уникальное значение;

- (url) Url адрес.

[badge-release]: https://img.shields.io/packagist/v/fi1a/bitrixvalidation?label=release

[badge-license]: https://img.shields.io/github/license/fi1a/bitrixvalidation?style=flat-square

[badge-php]: https://img.shields.io/packagist/php-v/fi1a/bitrixvalidation?style=flat-square

[badge-downloads]: https://img.shields.io/packagist/dt/fi1a/bitrixvalidation.svg?style=flat-square&colorB=mediumvioletred

[badge-mail]: https://img.shields.io/badge/mail-support%40fi1a.ru-brightgreen

[packagist]: https://packagist.org/packages/fi1a/bitrixvalidation

[license]: https://github.com/fi1a/bitrixvalidation/blob/master/LICENSE

[php]: https://php.net

[downloads]: https://packagist.org/packages/fi1a/bitrixvalidation

[mail]: mailto:[email protected]