Skip to content

Latest commit

 

History

History
78 lines (59 loc) · 3.32 KB

README.md

File metadata and controls

78 lines (59 loc) · 3.32 KB

SuiteCRM API Client

Version Size License

Client library for use with SuiteCRM

A free (LGPL3) client library for use with SuiteCRM to abstract various API usage to enable easier integrations.

Provided by PortoSpire
PortoSpire - be seen


Table of Contents

1. Introduction
2. Setup
3. Usage
3.1. Mezzio
3.2. Laminas MVC
3.3. Standalone


This package provides a SuiteCRM client to abstract API calls and form submissions to provide and receive data from SuiteCRM instances. It makes use of Person Form campaigns and both the V8 and rest APIs as needed.

Add to your project's composer.json

composer require portospire/suitecrmclient

This package is built to support Laminas Mezzio and Laminas MVC as well as be available as a stand alone library.

An example to get a list of Web campaigns from a SuiteCRM instance:

$SuiteCRMClient->setServerDomain($server_domain);
$SuiteCRMClient->setClientId($client_id);
$SuiteCRMClient->setClientSecret($client_secret);
$filter = new \PortoSpire\SuiteCRMClient\Model\Filter(['campaign_type' => 'Web']);
$json = $SuiteCRMClient->getCampaigns([], ['size' => 20, 'number' => 1], 'name', $filter); // this will contain json of the results
$campaignsFull = $SuiteCRMClient->convertJsonToGenerics($json); // this converts the json to PHP objects

An example to submit a lead into a web-to-lead form in a SuiteCRM instance: (You can extend the provided models (Model/WebToLead, etc) if you have custom fields)

$values = (array) $WebToLead; // expects an array of key=>value pairs where the keys match the different fields from the web-to-lead form
$SuiteCRMClient->setServerDomain($server_domain);
$SuiteCRMClient->setClientId($client_id);
$SuiteCRMClient->setClientSecret($client_secret);
$SuiteCRMClient->submitWebToLead($values, $campaign_id); // this must match the campaign id that the web-to-lead form is associated to in SuiteCRM

Add the ConfigProvider class to the config aggregator (typically found in config/config.php)

$aggregator = new ConfigAggregator([
...
\PortoSpire\SuiteCRMClient\ConfigProvider::class,
...

Then use the client in your handlers/middleware as needed for your use cases.

There should be no additional steps beyond adding to your project's composer.json required to begin using the library with Laminas MVC.

There should be no additional steps beyond adding to your project's composer.json required to begin using the library.