# Highrise (0.12.0)

## What is it?

This gem provides a set of classes to access information on [Highrise] via the published [API]:

Comment, Company, Email, Group, Case, Membership, Note, Person, Subject, Tag, Task, User.

All these classes are inherited from ActiveResouce::Base. Refer to the [ActiveResouce] documentation for more information.

## Installing

gem install kmayer-highrise

### Dependencies

  • ActiveResorce >= 2.2.2

  • ActiveSupport >= 2.1

  • Curb

  • Hpricot

### Configure your key

require 'rubygems'
require 'highrise'

Highrise::Base.site = 'http://your_api:login@your_site.highrisehq.com/'

or

Highrise::Base.site = 'http://your_site.highrisehq.com'
Highrise::Base.user = 'api-auth-token'

and, if you want [caching]:

Highrise::Base.connection.cache_store= <your normal ActiveSupport::Caching options>

If you are using this in a Rails application, putting this code in a config/initializers/highrise.rb file is recommended. See config_initializers_highrise.rb in the examples/ directory.

## Usage

@tags = Highrise::Tag.find(:all)

@people = Highrise::Person.find_all_across_pages(:params => {:tag_id => 12345})

@person.tag!("VIP")

## License

This code is free to be used under the terms of the [MIT license].

## Bugs, Issues, Kudos and Catcalls

Comments are welcome. Send your feedback through the [issue tracker on GitHub]

## Contributors

  • Marcos Tapajós][mt
  • Nicolas Bianco][nb
  • Luis Gustavo][lg
  • Thiago Lelis][tl
  • Ken Mayer][km

## Special Thanks

Rails Envy Podcast Episode #77][re

for mentioning

How to Cache Anything With ActiveSupport][rh

on the very day I started writing the cache code. Thank you, Rein

for writing an excellent tutorial and [posting your source] on GitHub.

[api]: developer.37signals.com/highrise [ar]: api.rubyonrails.org/classes/ActiveResource/Base.html [c]: api.rubyonrails.org/classes/ActiveSupport/Cache [co]: github.com/kmayer [e]: github.com/primedia/endeca/tree/master [h]: www.highrisehq.com/ [i]: github.com/kmayer/highrise/issues [ii]: www.improveit.com.br/en [km]: github.com/kmayer [lg]: github.com/luisbebop [mit]:www.opensource.org/licenses/mit-license.php [mt]: www.improveit.com.br/en/company/tapajos [nb]: github.com/slainer86 [re]: www.railsenvy.com/2009/4/29/rails-envy-podcast-episode-077-04-29-2009 [rh]: reinh.com/blog/2009/04/27/how-to-cache-anything-with-activesupport.html [tl]: github.com/ThiagoLelis