portospire/suitecrmclient

A free client library for use with SuiteCRM to abstract the various API usage to enable easier integrations. Provided by PortoSpire

0.1.3.3 2024-03-02 16:20 UTC

Requires

• php: ^7.0 || ^8.0 || ^8.1 || ^8.2
• guzzlehttp/guzzle: >=7.7

Requires (Dev)

• phpunit/phpunit: ^8.4

Suggests

• laminas/laminas-log: A psr-3 log-implementation provider

LGPL-3.0-or-later

• SuiteCRM
• portospire
• SuiteCRM api v8
• SuiteCRM rest api
• SuiteCRM person form
• SuiteCRM web to lead form

README

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

Table of Contents

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

Introduction

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.

Setup

Add to your project's composer.json

composer require portospire/suitecrmclient

Usage

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

Mezzio

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.

Laminas MVC

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

Standalone

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