База легковых авто

перейти в Маркетплейс

31 установка

Главная Битрикс модули База легковых авто API модуля, как пользоваться

API модуля, как пользоваться


Не забывайте перед использованием API модуля подключать его:

CModule::IncludeModule("bxmod.autos");

В примерах ниже используется "строка данных". Подробнее о строке данных вы можете узнать на этой странице: http://bxmod.ru/mods/baza-legkovykh-avto/svoystvo-infoblokov-avtomobil.html

Ниже перечислены все методы модуля, которые могут вам пригодиться, примеры и результаты их использования.

 

BxmodAutos::GetMarkList()

Возвращает список всех марок автомобилей, отсортированный по названию

Например, код:

$marks = BxmodAutos::GetMarkList();
print_r($marks);

Выведет массив такого вида:

Array
(
    [0] => Array
        (
            [id_car_mark] => 1
            [name] => AC
        )

    [1] => Array
        (
            [id_car_mark] => 2
            [name] => Acura
        )
    ...
    [211] => Array
        (
            [id_car_mark] => 227
            [name] => УАЗ
        )
)

 

BxmodAutos::GetModelList ( $markId = false )

Возвращает список моделей для марки автомобиля с ID $markId. Если $markId не указан, или равен false, то метод вернет все модели из базы данных.

Например, код:

$models = BxmodAutos::GetModelList ( 227 ); // ID автомобиля марки "УАЗ"
print_r($models);

Выведет массив такого вида:

Array
(
    [0] => Array
        (
            [id_car_model] => 2093
            [id_car_mark] => 227
            [name] => 3151
        )
    ...
    [8] => Array
        (
            [id_car_model] => 2101
            [id_car_mark] => 227
            [name] => Pickup
        )
)

 

BxmodAutos::GetSeriesList ( $modelId = false )

Возвращает список серий для определенной модели автомобиля с ID $modelId. Если $modelId не указан, или равен false, то метод вернет все серии из базы данных.

Например, код:

$series = BxmodAutos::GetSeriesList ( 2101 ); // ID модели автомобиля "УАЗ Pickup"
print_r($series);

Выведет массив такого вида:

Array
(
    [0] => Array
        (
            [id_car_serie] => 9435
            [id_car_model] => 2101
            [name] => УАЗ Pickup I
            [id_car_generation] => 2289
        )

    [1] => Array
        (
            [id_car_serie] => 4612
            [id_car_model] => 2101
            [name] => УАЗ Pickup I Рестайлинг
            [id_car_generation] => 2288
        )

)

 

BxmodAutos::GetModificationList ( $serieId = false, $modelId = false )

Возвращает список модификаций для определенной серии ($serieId) и/или модели ($modelId) автомобиля. Если не указаны $serieId и $modelId, либо они равны false, то метод вернет все модификации из базы данных.

Например, код:

$modification = BxmodAutos::GetModificationList ( 9435 ); // ID серии автомобиля "УАЗ Pickup I"
print_r($modification);

Выведет массив такого вида:

Array
(
    [0] => Array
        (
            [id_car_modification] => 49006
            [id_car_serie] => 9435
            [id_car_model] => 2101
            [name] => 23632 2.7 MT (128 л.с.) 4WD
            [start_production_year] => 2008
            [end_production_year] => 2012
        )

    [1] => Array
        (
            [id_car_modification] => 49005
            [id_car_serie] => 9435
            [id_car_model] => 2101
            [name] => 23638 2.2d MT (114 л.с.) 4WD
            [start_production_year] => 2008
            [end_production_year] => 2012
        )

)

 

BxmodAutos::GetYearsForModification ( $modificationId = false )

Возвращает список годов выпуска для модификации автомобиля с ID $modificationId в виде массива. Если не указан $modificationId, или он равен false, то метод вернет пустой массив.

Например, код:

$years = BxmodAutos::GetYearsForModification ( 49006 ); // ID модификации автомобиля "УАЗ 23632 2.7 MT (128 л.с.) 4WD"
print_r($years);

Выведет массив такого вида:

Array
(
    [0] => 2008
    [1] => 2009
    [2] => 2010
    [3] => 2011
    [4] => 2012
)

 

BxmodAutos::GetFieldData ( $data = false, $level = 5 )

Возвращает данные для полей ввода информации об автомобиле в виде массива.

$data - строка данных об автомобиле
$level - уровень выбора данных

Данный массив полезен для автоматического заполнения полей на стороне пользователя. Метод используется в административной части при выводе полей ввода информации об автомобиле.

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

 

BxmodAutos::GetField ( $fieldName = "", $data = "", $level = 5, $template = false )

Возвращает HTML код полей ввода данных об автомобиле. Проще говоря, метод вернет все селектбоксы для выбора марки, модели и т.д. Количество селектбоксов напрямую зависит от указанного вами $level.

$fieldName - название поля, в которое будет "складываться" информация о выборе пользователя
$data - строка данных об автомобиле
$level - уровень выбора даных
$template - шаблон одного поля. Значение по умолчанию: <div><select class="#CLASS#" disabled="disabled"></select></div>. При необходимости вы можете использовать свой шаблон для поля select, но обязательно указывайте в атрибуте class специальную строку #CLASS#, вместо нее подставляются значения, позволяющие динамически подгружать данные.

 

BxmodAutos::ParseData ( $data, $withProps = false )

Возвращает данные об автомобиле в виде массива. Если $withProps равно true и информация об автомобиле содержит ID модификации, то массив будет содержать все технические характеристики данной модификации.

$data - строка данных об автомобиле
$withProps - выбирать ли свойства автомобиля

Например, код:

$autoData = BxmodAutos::ParseData ( "79,830,3467,18184,2007", true ); // строка данных
print_r($autoData);

Выведет такой массив (массив приведен с сокращениями, с комментариями):

Array
(
    // Название автомобиля
    [TITLE] => Hyundai Getz, Хэтчбек 5 дв., 1.4 MT (97 л.с.), 2007

    // Название автомобиля, разбитое по частям
    [ARR_TITLE] => Array
        (
            [MARK] => Hyundai
            [MODEL] => Getz
            [SERIE] => Hyundai Getz Хэтчбек 5 дв.
            [MODIFICATION] => 1.4 MT (97 л.с.)
            [YEAR] => 2007
        )

    // Данные полей автомобиля
    [ARR_ALL] => Array
        (
            // Марка
            [MARK] => Array
                (
                    [id_car_mark] => 79
                    [name] => Hyundai
                )

            // Модель
            [MODEL] => Array
                (
                    [id_car_model] => 830
                    [name] => Getz
                )

            // Серия
            [SERIE] => Array
                (
                    [id_car_serie] => 3467
                    [name] => Hyundai Getz Хэтчбек 5 дв.
                )

            // Модификация
            [MODIFICATION] => Array
                (
                    [id_car_modification] => 18184
                    [name] => 1.4 MT (97 л.с.)
                    [start_production_year] => 2004
                    [end_production_year] => 2011
                )

            // Год выпуска
            [YEAR] => 2007
        )

    // Строка данных, в виде массива
    [DATA] => Array
        (
            [0] => 79
            [1] => 830
            [2] => 3467
            [3] => 18184
            [4] => 2007
        )

    // Строка данных
    [STR_DATA] => 79,830,3467,18184,2007

    // Массив характеристик автомобиля
    [PROPS] => Array
        (
            [1] => Array
                (
                    // Группа характеристик
                    [name] => Кузов
                    // Характеристики данной группы
                    [values] => Array
                        (
                            // Характеристика
                            [2] => Array
                                (
                                    // ID значения характеристики
                                    [id_car_characteristic_value] => 6040719
                                    // ID характеристики
                                    [id_characteristic] => 2
                                    // Название характеристики
                                    [name] => Тип кузова
                                    // Значение зарактеристики
                                    [value] => Хэтчбек 5 дв.
                                    // Единица измерения
                                    [unit] => 
                                )

                            [3] => Array
                                (
                                    [id_car_characteristic_value] => 6040720
                                    [id_characteristic] => 3
                                    [name] => Количество дверей
                                    [value] => 5
                                    [unit] => 
                                )
                            
                            ...

                            [45] => Array
                                (
                                    [id_car_characteristic_value] => 6040730
                                    [id_characteristic] => 45
                                    [name] => Объем багажника минимальный
                                    [value] => 254
                                    [unit] => л
                                )
                        )
                )

            ...

            [28] => Array
                (
                    [name] => Двигатель
                    [values] => Array
                        (
                            [12] => Array
                                (
                                    [id_car_characteristic_value] => 6040731
                                    [id_characteristic] => 12
                                    [name] => Тип двигателя
                                    [value] => Бензин
                                    [unit] => 
                                )

                            ...

                            [48] => Array
                                (
                                    [id_car_characteristic_value] => 6040740
                                    [id_characteristic] => 48
                                    [name] => Ход поршня
                                    [value] => 78,1
                                    [unit] => мм
                                )
                        )
                )
        )
)
Перейти в Маркетплейс

Бесплатно в Маркетплейсе!

Теперь модуль полностью бесплатен и доступен для установки!

Вам пригодится


Вход по email/телефону
Забыли пароль?
Восстановление пароля
Вы не робот?
поменять
картинку
Введите свой адрес электронной почты или номер телефона, указанный при регистрации. Затем нажмите кнопку "Восстановить".
отмена
Подтверждение номера телефона
Мы отправили на ваш номер телефона СМС с кодом подтверждения. Пожалуйста, введите данный код в поле ниже и нажмите кнопку «Подтвердить»
Восстановление пароля
На ваш адрес электронной почты мы выслали код подтверждения, введите этот код в поле ниже, введите новый пароль, его подтверждение и нажмите кнопку «Установить пароль». Код подтверждения действителен в течение 10 мин.
На ваш номер телефона мы отправили SMS с кодом подтверждения, введите этот код в поле ниже, введите новый пароль, его подтверждение и нажмите кнопку «Установить пароль». Код подтверждения действителен в течение 10 мин.
отмена
Регистрация успешно завершена!

Данная страница будет
обновлена через 5 сек.

обновить страницу

Авторизация прошла успешно!

Данная страница будет
обновлена через 5 сек.

обновить страницу

Пароль успешно изменен!

Данная страница будет
обновлена через 5 сек.

обновить страницу

Неизвестная ошибка!

Произошла неизвестная ошибка.
Обновите страницу и попробуйте заново!

обновить страницу

Вход через соц.сервисы
войдите через один из сервисов