Skip to content
This repository has been archived by the owner on Apr 14, 2018. It is now read-only.
/ ranger Public archive

A node.js library for interacting with Campfire. UNMAINTAINED

License

Notifications You must be signed in to change notification settings

mrduncan/ranger

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

58 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Ranger

Ranger is a node.js library for interacting with Campfire.

Install

Install ranger using npm.

npm install ranger

API

Create a new client with the following:

var client = require("ranger").createClient("account", "api-key");

The createClient function takes two parameters:

  1. The account name, which is the subdomain of your account url. If your account url is 37signals.campfire.com then your account name would be 37signals.
  2. The api key of the user to connect as. You can get it from the "My info" link once logged into Campfire.

Client

Get a room by id:

client.room(12345, function (room) { console.log(room); });

Get an array of all rooms:

client.rooms(function (rooms) { console.log(rooms); });

Get an array of all rooms the api user is in:

client.presence(function (rooms) { console.log(rooms) });

Search for messages containing terms:

client.search("party time", function (messages) { console.log(messages) });

Get a user by id:

client.user(12345, function (user) { console.log(user); });

Get the api user:

client.me(function (user) { console.log(user); });

Room

Speak a message:

room.speak("hello world");

Paste some text:

room.paste("hello\nworld");

Play a sound:

room.play("trombone");

Show a tweet:

room.tweet("https://twitter.com/#!/jack/status/20");

Update the room:

room.update({ name: "Lounge", topic: "Anything goes" });

Join the room:

room.join();

Leave the room:

room.leave();

Lock the room:

room.lock();

Unlock the room:

room.unlock();

Get an array of users in the room:

room.users(function (users) { console.log(users); });

Get an array of up to 5 recent file uploads in the room:

room.recentUploads(function (uploads) { console.log(uploads); });

Get an array of up to 100 recent messages in the room:

room.recentMessages(function (messages) { console.log(messages); });

Listen for messages in the room:

room.listen(function (message) { console.log(message); });

Get whether messages are being listened for:

room.isListening();

Stop listening for messages in the room:

room.stopListening();

Get an array of messages for a day:

room.transcript(function (messages) { console.log(messages); });

var newYears = new Date(2011, 0, 1);
room.transcript(newYears, function (messages) { console.log(messages); });

Message

Star the message:

message.star();

Unstar the message:

message.unstar();

Get the upload details for the message:

message.upload(function (upload) { console.log(upload); });

Examples

The following example joins room 123456 and plays the vuvuzela sound whenever anyone uses the word "soccer".

var client = require("ranger").createClient("account", "api-key");
client.room(123456, function (room) {
  room.join(function () {
    room.listen(function (message) {
      if (message.type === "TextMessage" && message.body.match(/soccer/i)) {
        room.play("vuvuzela");
      }
    });
  });
});

Contributing

  1. Fork Ranger
  2. Create a topic branch - git checkout -b mybranch
  3. Push to your branch - git push origin mybranch
  4. Create a new pull request

Author

Matt Duncan | mattduncan.org | [email protected]

About

A node.js library for interacting with Campfire. UNMAINTAINED

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published