mjmarianetti/zoho

PHP wrapper for ZoHo API

zoho-php

PHP wrapper for Zoho with Laravel 5.* support, _(*1)

PACKAGE UNDER DEVELOPMENT, NOT ALL METHODS DOCUMENTED, _(*2)

Installation

To install this package you must modify your composer.json file and run composer update, _(*3)

"require": {
    "mjmarianetti/zoho": "dev-master"
  }

Or you can run the composer require mjmarianetti/zoho-php, _(*4)

Laravel

Open config/app.php and register the required service provider, _(*5)

'providers' => [
  ...
  Mjmarianetti\Zoho\ZohoServiceProvider::class

]

Then you should publish the config file, _(*6)

php artisan vendor:publish --provider="Mjmarianetti\Zoho\ZohoServiceProvider"

Configuration

You can configure the options provided in you .env file., _(*7)

ZOHO_SCOPE=crmapi
ZOHO_AUTHTOKEN=<INSERT-YOUR-TOKEN-HERE>
ZOHO_FORMAT=json

The default options are:, _(*8)

ZOHO_SCOPE=crmapi
ZOHO_FORMAT=json

Usage

Initialization

Include the ZohoClient in your project/file, _(*9)

use Mjmarianetti\Zoho\ZohoClient;

If you are using Laravel you can inject it as a dependency, _(*10)

public function test(ZohoClient $client)
{

Or if you are using it as a stand-alone library or with another framework, you have to provide a default configuration like:, _(*11)

$config = [
  'authtoken' => 'YOUR-TOKEN',
  'scope' => 'crmapi',
  'format' => 'json', // or xml
  'baseurl' => 'https://crm.zoho.com/crm/private/'
];

$client = new ZohoClient($config);

Methods

After initialization you can call the API., _(*12)

All this methods follow the same pattern, where $resource is the Module you want to call, and $params all the parameters that you want to use., _(*13)

The response returned usually follows the pattern:, _(*14)

$result = $client->getRecords(RESOURCE,$params);

$result->response->nodata;
$result->response->result->FL
$result->response->result->RESOURCE->row

Available $resource values

API format --> https://www.zoho.com/crm/help/api/modules-fields.html, _(*15)

getRecords

https://www.zoho.com/crm/help/api/getrecords.html, _(*16)

$client->getRecords($resource, $params = [])

getRecordsById

https://www.zoho.com/crm/help/api/getrecordbyid.html, _(*17)

$params should contain either id or idlist value., _(*18)

$client->getRecordsById($resource, $params = [])

Note: idlist should be a unique set of Ids separated by semicolon, up to 100 values, _(*19)

getMyRecords

https://www.zoho.com/crm/help/api/getmyrecords.html, _(*20)

$client->getMyRecords($resource, $params = [])

getDeletedRecordIds

https://www.zoho.com/crm/help/api/getdeletedrecordids.html, _(*21)

$client->getDeletedRecordIds($resource, $params = [])

//response->result->DeletedIDs;

getSearchRecordsByPDC

https://www.zoho.com/crm/help/api/getsearchrecordsbypdc.html, _(*22)

$client->getSearchRecordsByPDC($resource, $params = [])

deleteRecords

https://www.zoho.com/crm/help/api/deleterecords.html, _(*23)

  $client->deleteRecords($resource, $params = [])

getRelatedRecords

https://www.zoho.com/crm/help/api/getrelatedrecords.html, _(*24)

$client->getRelatedRecords($resource, $params = [])

getFields

https://www.zoho.com/crm/help/api/getfields.html, _(*25)

$client->getFields($resource, $params = [])

getUsers

https://www.zoho.com/crm/help/api/getusers.html, _(*26)

$client->getUsers($resource, $params = [])

delink

https://www.zoho.com/crm/help/api/delink.html, _(*27)

$client->delink($resource, $params = [])

downloadFile

https://www.zoho.com/crm/help/api/downloadfile.html, _(*28)

$client->downloadFile($resource, $params = [])

deleteFile

https://www.zoho.com/crm/help/api/deletefile.html, _(*29)

$client->deleteFile($resource, $params = [])

downloadPhoto

https://www.zoho.com/crm/help/api/downloadphoto.html, _(*30)

$client->downloadPhoto($resource, $params = [])

deletePhoto

https://www.zoho.com/crm/help/api/deletephoto.html, _(*31)

$client->deletePhoto($resource, $params = [])

getModules

https://www.zoho.com/crm/help/api/getmodules.html, _(*32)

$client->getModules($resource, $params = [])

searchRecords

https://www.zoho.com/crm/help/api/searchrecords.html, _(*33)

$client->searchRecords($resource, $params = [])

Iterator

If you would like to use a iterator to loop through the data received, you can use it like this:, _(*34)

use Mjmarianetti\Zoho\Helpers\ZohoResponseIterator;
use Mjmarianetti\Zoho\ZohoClient;

...
$response = $zc->getRecords('Accounts', []);

$it = new ZohoResponseIterator((array) $response->response->result->Accounts->row);
foreach ($it as $key => $value) {
    //$value->val and $value->content;      
}

For now, you should check that $response->response->result->Resource->row is not null, _(*35)