Giter Club home page Giter Club logo

apex-volunteermatch's Introduction

apex-volunteermatch

Volunteermatch API Integration for force.com / Salesforce, written in Apex - supports searching the extensive Volunteermatch database for organizations and volunteer opportunities.

Read all about the VolunteerMatch API at http://solutions.volunteermatch.org/solutions/integrations.

Usage:

// Initialize the API class with the Account Name and Secret API Key, test the connection
// with Hello World
VolunteerMatch vm = new VolunteerMatch('MyAccountName', 'MySecretAPIKey');
System.debug(vm.helloWorld('Chris').result);

// Initialize the API class with the Account Name and Secret API Key stored in Custom
// Settings, VolunteerMatch_Settings__c
vm = new VolunteerMatch();
System.debug(vm.helloWorld('Chris').result);

// Get MetaData example
for(VolunteerMatch.Category c : vm.getMetaData().categories) {
    System.debug(c.id + ' => ' + c.name);
}

////////////////// searchOrganizations examples //////////////////

// Search for Organization with ID 78154
System.debug(vm.searchOrganizationsById('78154').name);

// Search all Organizations in San Francisco (simplified)
for(VolunteerMatch.Organization o : vm.searchOrganizations('San Francisco, CA', 5, 1).organizations) {
	System.debug(o.name + ' (' + o.id + ')');
}

// Search all Organizations in San Francisco (simplified) and order by name
for(VolunteerMatch.Organization o : vm.searchOrganizations('San Francisco, CA', 5, 1, 'name', 'asc').organizations) {
	System.debug(o.name + ' (' + o.id + ')');
}

// Search all Organizations in San Francisco (advanced)
for(VolunteerMatch.Organization o : vm.searchOrganizations(null, null, new List<String>{'id', 'name'}, null, null, 'San Francisco, CA', null, null, null, null, 20, null, 1, null, '', '', '', null).organizations) {
	System.debug(o.name + ' (' + o.id + ')');
}

// Search all Organizations with all return values
for(VolunteerMatch.Organization o : vm.searchOrganizations(null, null, new List<String>{'id', 'name', 'url', 'location', 'description', 'plaintextDescription', 'mission', 'plaintextMission', 'imageUrl', 'created', 'updated', 'numReviews', 'avgRating', 'contact', 'categoryIds', 'vmUrl', 'type', 'ein', 'classification'}, null, null, 'San Francisco, CA', null, null, null, null, 20, null, 1, null, '', '', '', null).organizations) {
	System.debug(o.name + ' (' + o.id + ')');
}

// Search Organizations for specific category IDs
for(VolunteerMatch.Organization o : vm.searchOrganizations(new List<Integer>{30, 38}, null, new List<String>{'id', 'name'}, null, null, 'San Francisco, CA', null, null, null, null, 20, null, 1, null, '', '', '', null).organizations) {
	System.debug(o.name + ' (' + o.id + ')');
}

// Search Organizations for specific descriptions
for(VolunteerMatch.Organization o : vm.searchOrganizations(null, new List<String>{'olympic'}, new List<String>{'id', 'name'}, null, null, 'San Francisco, CA', null, null, null, null, 20, null, 1, null, '', '', '', null).organizations) {
	System.debug(o.name + ' (' + o.id + ')');
}

// Search Organizations for specific ids
for(VolunteerMatch.Organization o : vm.searchOrganizations(null, null, new List<String>{'id', 'name'}, new List<String>{'78154', '695410'}, null, 'San Francisco, CA', null, null, null, null, 20, null, 1, null, '', '', '', null).organizations) {
	System.debug(o.name + ' (' + o.id + ')');
}

// Search Organizations for specific keywords
for(VolunteerMatch.Organization o : vm.searchOrganizations(null, null, new List<String>{'id', 'name'}, null, new List<String>{'food', 'sport'}, 'San Francisco, CA', null, null, null, null, 20, null, 1, null, '', '', '', null).organizations) {
	System.debug(o.name + ' (' + o.id + ')');
}

// Search Organizations for specific words in mission
for(VolunteerMatch.Organization o : vm.searchOrganizations(null, null, new List<String>{'id', 'name'}, null, null, 'San Francisco, CA', new List<String>{'community', 'fund'}, null, null, null, 20, null, 1, null, '', '', '', null).organizations) {
	System.debug(o.name + ' (' + o.id + ')');
}

// Search Organizations for specific words in names
for(VolunteerMatch.Organization o : vm.searchOrganizations(null, null, new List<String>{'id', 'name'}, null, null, 'San Francisco, CA', null, new List<String>{'community', 'fund'}, null, null, 20, null, 1, null, '', '', '', null).organizations) {
	System.debug(o.name + ' (' + o.id + ')');
}

// Search Organizations for national orgs - doesn't seem to filter
for(VolunteerMatch.Organization o : vm.searchOrganizations(null, null, new List<String>{'id', 'name'}, null, null, 'San Francisco, CA', null, null, new List<String>{'heart', 'stroke'}, null, 20, null, 1, null, '', '', '', null).organizations) {
	System.debug(o.name + ' (' + o.id + ')');
}

// Search Organizations by EIN
for(VolunteerMatch.Organization o : vm.searchOrganizations(null, null, new List<String>{'id', 'name'}, null, null, 'San Francisco, CA', null, null, null, '94-1186169', 20, null, 1, null, '', '', '', null).organizations) {
	System.debug(o.name + ' (' + o.id + ')');
}

// Search Organizations by OrganizationTypes - doesn't seem to filter
for(VolunteerMatch.Organization o : vm.searchOrganizations(null, null, new List<String>{'id', 'name'}, null, null, 'San Francisco, CA', null, null, null, null, 20, new List<String>{'nonvm', 'specialevent'}, 1, null, '', '', '', null).organizations) {
	System.debug(o.name + ' (' + o.id + ')');
}

// Search Organizations by Partners
for(VolunteerMatch.Organization o : vm.searchOrganizations(null, null, new List<String>{'id', 'name'}, null, null, 'San Francisco, CA', null, null, null, null, 20, null, 1, new List<Integer>{55, 59}, '', '', '', null).organizations) {
	System.debug(o.name + ' (' + o.id + ')');
}

// Search Organizations by Radius
for(VolunteerMatch.Organization o : vm.searchOrganizations(null, null, new List<String>{'id', 'name'}, null, null, 'San Francisco, CA', null, null, null, null, 20, null, 1, null, '0.5', '', '', null).organizations) {
	System.debug(o.name + ' (' + o.id + ')');
}

// Sort Organizations by distance
for(VolunteerMatch.Organization o : vm.searchOrganizations(null, null, new List<String>{'id', 'name'}, null, null, 'San Francisco, CA', null, null, null, null, 20, null, 1, null, '', 'distance', '', null).organizations) {
	System.debug(o.name + ' (' + o.id + ')');
}

// Sort Organizations by distance (descending)
for(VolunteerMatch.Organization o : vm.searchOrganizations(null, null, new List<String>{'id', 'name'}, null, null, 'San Francisco, CA', null, null, null, null, 20, null, 1, null, '', 'distance', 'desc', null).organizations) {
	System.debug(o.name + ' (' + o.id + ')');
}

// Get all US Corps-related Organizations 
for(VolunteerMatch.Organization o : vm.searchOrganizations(null, null, new List<String>{'id', 'name'}, null, null, 'San Francisco, CA', null, null, null, null, 20, null, 1, null, '', '', '', new List<Integer>{2, 4, 5, 6, 7,
	8}).organizations) {
	System.debug(o.name + ' (' + o.id + ')');
}

////////////////// searchOpportunities examples //////////////////

// Search for Opportunity with ID 1289402
System.debug(vm.searchOpportunitiesById('1289402').title);

for(VolunteerMatch.VolunteerOpportunity o : vm.searchOpportunitiesByOrgId(26434, 5, 1).opportunities) {
	System.debug(o.title + ' (' + o.id + ')');
}

// Search all Opportunities in San Francisco (simple)
for(VolunteerMatch.VolunteerOpportunity o : vm.searchOpportunities('San Francisco', 5, 1).opportunities) {
	System.debug(o.title + ' (' + o.id + ')');
}

// Search all Opportunities in San Francisco (simple) sorted by distance
for(VolunteerMatch.VolunteerOpportunity o : vm.searchOpportunities('San Francisco', 5, 1, 'distance', 'asc').opportunities) {
	System.debug(o.title + ' (' + o.id + ')');
}

// Search all Opportunities in San Francisco (advanced)
for(VolunteerMatch.VolunteerOpportunity o : vm.searchOpportunities(null, null, null, new List<String>{'id', 'title'}, null, null, null, 'San Francisco', 20, null, null, null, '', 1, null, '', null, '', '', '', null).opportunities) {
	System.debug(o.title + ' (' + o.id + ')');
}

// Search all Opportunities in San Francisco with all return values
for(VolunteerMatch.VolunteerOpportunity o : vm.searchOpportunities(null, null, null, new List<String>{'allowGroupInvitations', 'allowGroupReservation', 'availability', 'beneficiary', 'categoryIds', 'contact', 'created', 'currentPage', 'description', 'greatFor', 'hasWaitList', 'id', 'imageUrl', 'location', 'minimumAge', 'numReferred', 'parentOrg', 'plaintextDescription', 'plaintextRequirements', 'plaintextSkillsNeeded', 'referralFields', 'requirements', 'requirementsMap', 'requiresAddress', 'resultsSize', 'skillsList', 'skillsNeeded', 'spacesAvailable', 'status', 'tags', 'title', 'type', 'updated', 'virtual', 'vmUrl', 'volunteersNeeded'}, null, null, null, 'San Francisco', 20, null, null, null, '', 1, null, '', null, '', '', '', null).opportunities) {
	System.debug(o.title + ' (' + o.id + ')');
}

// Search all Opportunities with specific Category IDs
for(VolunteerMatch.VolunteerOpportunity o : vm.searchOpportunities(new List<Integer>{30, 38}, null, null, new List<String>{'id', 'title'}, null, null, null, 'San Francisco', 20, null, null, null, '', 1, null, '', null, '', '', '', null).opportunities) {
	System.debug(o.title + ' (' + o.id + ')');
}

// Search all Opportunities between two dates
VolunteerMatch.DateRange dr = new VolunteerMatch.DateRange();
dr.startDate = '2015-01-01';
dr.endDate = '2015-02-01';

List<VolunteerMatch.DateRange> drList = new List<VolunteerMatch.DateRange>();	
drList.add(dr);

for(VolunteerMatch.VolunteerOpportunity o : vm.searchOpportunities(null, drList, null, new List<String>{'id', 'title'}, null, null, null, 'San Francisco', 20, null, null, null, '', 1, null, '', null, '', '', '', null).opportunities) {
	System.debug(o.title + ' (' + o.id + ')');
}

// Search all Opportunities with "dogs" in the description
for(VolunteerMatch.VolunteerOpportunity o : vm.searchOpportunities(null, null, new List<String>{'dogs'}, new List<String>{'id', 'title'}, null, null, null, 'San Francisco', 20, null, null, null, '', 1, null, '', null, '', '', '', null).opportunities) {
	System.debug(o.title + ' (' + o.id + ')');
}

// Search all Opportunities that are great for kids
for(VolunteerMatch.VolunteerOpportunity o : vm.searchOpportunities(null, null, null, new List<String>{'id', 'title'}, new List<String>{'k'}, null, null, 'San Francisco', 20, null, null, null, '', 1, null, '', null, '', '', '', null).opportunities) {
	System.debug(o.title + ' (' + o.id + ')');
}

// Search Opportunity with a specific ID
for(VolunteerMatch.VolunteerOpportunity o : vm.searchOpportunities(null, null, null, new List<String>{'id', 'title'}, null, new List<String>{'1455735'}, null, 'San Francisco', 20, null, null, null, '', 1, null, '', null, '', '', '', null).opportunities) {
	System.debug(o.title + ' (' + o.id + ')');
}

// Search all Opportunities with "homeless" in the keywords
for(VolunteerMatch.VolunteerOpportunity o : vm.searchOpportunities(null, null, null, new List<String>{'id', 'title'}, null, null, new List<String>{'homeless'}, 'San Francisco', 20, null, null, null, '', 1, null, '', null, '', '', '', null).opportunities) {
	System.debug(o.title + ' (' + o.id + ')');
}

// Return only 3 results
for(VolunteerMatch.VolunteerOpportunity o : vm.searchOpportunities(null, null, null, new List<String>{'id', 'title'}, null, null, null, 'San Francisco', 3, null, null, null, '', 1, null, '', null, '', '', '', null).opportunities) {
	System.debug(o.title + ' (' + o.id + ')');
}

// Search all Opportunities that are private - only works if API key doesn't operate 
// on public opportunities
for(VolunteerMatch.VolunteerOpportunity o : vm.searchOpportunities(null, null, null, new List<String>{'id', 'title'}, null, null, null, 'San Francisco', 20, new List<String>{'private'}, null, null, '', 1, null, '', null, '', '', '', null).opportunities) {
	System.debug(o.title + ' (' + o.id + ')');
}

// Search all Opportunities with a specific Org ID
for(VolunteerMatch.VolunteerOpportunity o : vm.searchOpportunities(null, null, null, new List<String>{'id', 'title'}, null, null, null, 'San Francisco', 20, null, new List<Integer>{26434}, null, '', 1, null, '', null, '', '', '', null).opportunities) {
	System.debug(o.title + ' (' + o.id + ')');
}

// Search all Opportunities with a specific organization name
for(VolunteerMatch.VolunteerOpportunity o : vm.searchOpportunities(null, null, null, new List<String>{'id', 'title'}, null, null, null, 'San Francisco', 20, null, null, new List<String>{'Castro'}, '', 1, null, '', null, '', '', '', null).opportunities) {
	System.debug(o.title + ' (' + o.id + ')');
}

// Search all Opportunities with a specific EIN - doesn't seem to work
for(VolunteerMatch.VolunteerOpportunity o : vm.searchOpportunities(null, null, null, new List<String>{'id', 'title'}, null, null, null, 'San Francisco', 20, null, null, null, '94-3088881', 1, null, '', null, '', '', '', null).opportunities) {
	System.debug(o.title + ' (' + o.id + ')');
}

// Search all Opportunities with associated partner IDs
for(VolunteerMatch.VolunteerOpportunity o : vm.searchOpportunities(null, null, null, new List<String>{'id', 'title'}, null, null, null, 'San Francisco', 20, null, null, null, '', 1, new List<Integer>{3, 5}, '', null, '', '', '', null).opportunities) {
	System.debug(o.title + ' (' + o.id + ')');
}

// Search all Opportunities within a 25 mile radius of San Francisco
for(VolunteerMatch.VolunteerOpportunity o : vm.searchOpportunities(null, null, null, new List<String>{'id', 'title'}, null, null, null, 'San Francisco', 20, null, null, null, '', 25, null, '', null, '', '', '', null).opportunities) {
	System.debug(o.title + ' (' + o.id + ')');
}

// Search all Opportunities by skill "programming"
for(VolunteerMatch.VolunteerOpportunity o : vm.searchOpportunities(null, null, null, new List<String>{'id', 'title'}, null, null, null, 'San Francisco', 20, null, null, null, '', 1, null, '', new List<String>{'programming'}, '', '', '', null).opportunities) {
	System.debug(o.title + ' (' + o.id + ')');
}

// Search all Opportunities sorting by distance in descending order
for(VolunteerMatch.VolunteerOpportunity o : vm.searchOpportunities(null, null, null, new List<String>{'id', 'title'}, null, null, null, 'San Francisco', 20, null, null, null, '', 1, null, '', null, 'distance', 'desc', '', null).opportunities) {
	System.debug(o.title + ' (' + o.id + ')');
}

// Search all Opportunities updated since a certain date
for(VolunteerMatch.VolunteerOpportunity o : vm.searchOpportunities(null, null, null, new List<String>{'id', 'title'}, null, null, null, 'San Francisco', 20, null, null, null, '', 1, null, '', null, '', '', '2015-05-08T19:11:04Z', null).opportunities) {
	System.debug(o.title + ' (' + o.id + ')');
}

// Search all US-Corps related Opportunities
for(VolunteerMatch.VolunteerOpportunity o : vm.searchOpportunities(null, null, null, new List<String>{'id', 'title'}, null, null, null, 'San Francisco', 20, null, null, null, '', 1, null, '', null, '', '', '', new List<Integer>{2, 4, 5, 6, 7, 8}).opportunities) {
	System.debug(o.title + ' (' + o.id + ')');
}

The package includes a custom setting where you can store your Account Name and Secret API Key. This way, you won't have to pass them in when you initialize the API class.

You can install the package into a Salesforce instance using the following URL: https://githubsfdeploy.herokuapp.com/?owner=SalesforceFoundation&repo=apex-volunteermatch

Comments and contributions are welcome!

apex-volunteermatch's People

Contributors

sfckemp avatar svc-scm avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.