Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

node.js package to make easier to interact with a civicrm server (via REST API, handles CRUD on all the entities)

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 .gitignore
Octocat-spinner-32 .npmignore
Octocat-spinner-32 README.md
Octocat-spinner-32 civicrm.js
Octocat-spinner-32 package.json
README.md

civicrm

Allow to fetch data from a civicrm server. It covers all the entities civicrm api exposes (more than 80) and the basic crud methods. Yes, it can create, update or delete too.

It's assumed you are familiar with the civicrm api, checkout the documentation if you aren't sure.

To avoid running too many queries at the same time and flood the civicrm server, it has a build in queue that doesn't send more than 8 requests in parallel.

you can adjust that by setting config.concurrency = 8;

Installation

$npm install civicrm

Examples

get the first 25 individuals

var config = {
  server:'http://example.org',
  path:'/sites/all/modules/civicrm/extern/rest.php',
  key:'your key from settings.civicrm.php',
  api_key:'the user key'
};
var crmAPI = require('civicrm')(config);

crmAPI.get ('contact',{contact_type:'Individual',return:'display_name,email,phone'},
  function (result) {
    for (var i in result.values) {
      val = result.values[i];
     console.log(val.id +": "+val.display_name+ " "+val.email+ " "+ val.phone);
    }
  }
);

create a new contact

crmAPI.create ('contact',{contact_type:'Individual','first_name':'John','last_name':'Doe'},
  function (result) {
    if (result.is_error) {
       console.log('ERROR '+ result.error_message);
    } else {
       console.log('CREATED CONTACT '+ result.id);
    }
  }
);

delete contact id 42

crmAPI.delete ('contact',{id:42},
  function (result) {
    if (result.is_error) {
       console.log('ERROR '+ result.error_message);
    } else {
       console.log('DELETED CONTACT '+ result.id);
    }
  }
);

lower access

All the above actions relies on the lower level call method. You can call it directly if there is another action you need. For instance the get above can also be called:

crmAPI.call ('contact','get',{contact_type:'Individual',return:'display_name,email,phone'},
  function (result) {
    for (var i in result.values) {
      val = result.values[i];
     console.log(val.id +": "+val.display_name+ " "+val.email+ " "+ val.phone);
    }
  }
);
Something went wrong with that request. Please try again.