Installation

Step 1: Download / clone the following plugins:

• LinkedIn to Plugin/Linkedin
• HttpSocketOauth plugin (ProLoser fork) to Plugin/HttpSocketOauth
• Apis plugin to Plugin/Apis

Step 2: Setup your database.php

var $linkedin = array(
	'datasource' => 'Linkedin.Linkedin',
	'login' => '<linkedin api key>',
	'password' => '<linkedin api secret>',
);

Step 3: Install the Apis-OAuth Component for authentication

MyController extends AppController {
	var $components = array(
		'Apis.Oauth' => 'linkedin',
	);
	
	function connect() {
		$this->Oauth->connect();
	}
	
	function linkedin_callback() {
		$this->Oauth->callback();
	}
}

Step 4: Use the datasource normally

Look inside the Config map for a list of endpoints or add more yourself! The 'fields' key optionally lets you specify what fields you want returned. Here is a list for reference

Class MyModel extends AppModel {

	function readProfile() {
		$this->setDataSource('linkedin');
		$data = $this->find('all', array(
			'path' => 'people/~',
			'fields' => array(
				'first-name', 'last-name', 'summary', 'specialties', 'associations', 'honors', 'interests', 'twitter-accounts', 
				'positions' => array('title', 'summary', 'start-date', 'end-date', 'is-current', 'company'), 
				'educations', 
				'certifications',
				'skills' => array('id', 'skill', 'proficiency', 'years'), 
				'recommendations-received',
			),
		));
		$this->setDataSource('default');
	}
}

You can also pass search parameters to certain endpoints:

$data = $this->find('all', array(
	'path' => 'people-search',
	'conditions' => array(
		'count' => 500,
		'firstName' => 'bob',
		'lastName' => 'dillan',
		'company' => 'columbia records club',
	),
	'fields' => array(
		'first-name', 'last-name',
		'positions' => array('title', 'company'),
	),
));