pco

This project is not affiliated with Planning Center Online.

PCO is a developer focussed module that leverages guzzle to connect to the Planning Center Online API.

Installation and Configuration

1. composer require 'drupal/pco:^2.0'
2. If you haven't already, create a personal access token. Be sure to record your API token and secret for later use.
3. Enable the PCO Drupal Module.
4. After enabling the module set the necessary API credentials in Drupal at /admin/config/pco-api You will need to setup your API secret using the required Key module. Storing keys in files outside the webroot or as environment variables is recommended.

Requirements

Key module is required to securely store API credentials.

Code Example

// This would get 50 people from Planning Center.
$client = Drupal::service('pco.client');
$query = [
  'per_page' => 50,
  'include' => 'emails',
];
$request = $client->connect('get', 'people/v2/people', $query, []);
$results = json_decode($request);

Warning moving from 8.x-1.0 to 2.0.x

2.0.x finally addresses the namespace inconsistency where the Drupal project is pco and the namespace was pco_api. It is now the pco for both.

Please take care if you are already using this module. You will need to update your Drupal::service('pco.client'); references and anywhere you have implemented dependency injection.