Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/dotzero/yii-amocrm

Расширение для Yii Framework реализующее клиент для работы с API amoCRM
https://github.com/dotzero/yii-amocrm

amocrm extension php yii yii-extension

Last synced: 13 days ago
JSON representation

Расширение для Yii Framework реализующее клиент для работы с API amoCRM

Awesome Lists containing this project

README

        

# Yii AmoCRM

[![Latest Stable Version](https://poser.pugx.org/dotzero/yii-amocrm/version)](https://packagist.org/packages/dotzero/yii-amocrm)
[![License](https://poser.pugx.org/dotzero/yii-amocrm/license)](https://packagist.org/packages/dotzero/yii-amocrm)

**EAmoCRM** это расширение для **Yii PHP framework** реализующее клиент для работы с API amoCRM
используя библиотеку [amocrm-php](https://github.com/dotzero/amocrm-php).

## Требования:

- [Yii Framework](https://github.com/yiisoft/yii) 1.1.14 или выше
- [Composer](http://getcomposer.org/doc/)

## Установка

### Через composer:

```bash
$ composer require dotzero/yii-amocrm
```

- Добавить `amocrm` в секцию `components` конфигурационного файла:

```php
'aliases' => array(
...
'vendor' => realpath(__DIR__ . '/../../vendor'),
),
'components' => array(
...
'amocrm' => array(
'class' => 'vendor.dotzero.yii-amocrm.EAmoCRM',
'subdomain' => 'example', // Персональный поддомен на сайте amoCRM
'login' => '[email protected]', // Логин на сайте amoCRM
'hash' => '00000000000000000000000000000000', // Хеш на сайте amoCRM

// Для хранения ID полей можно воспользоваться хелпером
'fields' => [
'StatusId' => 10525225,
'ResponsibleUserId' => 697344,
],
),
),
```

## Пример использования:

```php
try {
$amo = Yii::app()->amocrm->getClient();

// Получение экземпляра модели для работы с аккаунтом
$account = $amo->account;

// Вывод информации об аккаунте
print_r($account->apiCurrent());

// Получение экземпляра модели для работы с контактами
$contact = $amo->contact;

// Заполнение полей модели
$contact['name'] = 'ФИО';
$contact['request_id'] = '123456789';
$contact['date_create'] = '-2 DAYS';
$contact['responsible_user_id'] = Yii::app()->amocrm->fields['ResponsibleUserId'];
$contact['company_name'] = 'ООО Тестовая компания';
$contact['tags'] = ['тест1', 'тест2'];
$contact->addCustomField(448, [
['+79261112233', 'WORK'],
]);

// Добавление нового контакта и получение его ID
print_r($contact->apiAdd());

} catch (\AmoCRM\Exception $e) {
printf('Error (%d): %s' . PHP_EOL, $e->getCode(), $e->getMessage());
}
```

## Документация

Смотреть документацию к библиотеке [amocrm-php](https://github.com/dotzero/amocrm-php).

## Лицензия

Библиотека доступна на условиях лицензии MIT: http://www.opensource.org/licenses/mit-license.php