Four Square Tips

Gives details about a tip, including which users (especially friends) have marked the tip to-do or done.

Figure 1a. Instantiate Tips
$tips = eden('foursquare')->tips($_SESSION['oauth_token']);
Figure 1b. Usage: Check in to a place.
$tips
	->broadcast('facebook')					//optional
    ->setEventId('[EVENT_ID]')				//optional
    ->checkin('VENUE_ID', 'YOUR TEXT HERE');
Figure 1c. Usage: Retrive a List of Users Have Done this Tip.
$tips
	->setLimit('[INTEGER]')					//optional
    ->setOffset('[INTEGER]')				//optional
    ->getTips('TIP_ID');
Figure 1d. Usage: Mark a Tip Done.
$tips->markDone('TIP_ID');
Figure 1e. Usage: Mark a Tip to-do.
$tips->markToDo('TIP_ID');
Figure 1f. Usage: Remove a Tip from your To-Do List or Done List.
$tips->unmark('TIP_ID');
Figure 1g. Tips Methods
Method Arguments Returns Description
$tips->setUrl($url);
  1. string
Eden_Foursquare_Tips The url of the homepage of the venue.
$tips->setLocation($longtitude, $latitude);
  1. int|float
  2. int|float
Eden_Foursquare_Tips Set location by setting longtitide and latitude
$tips->setLimit($limit);
  1. integer
Eden_Foursquare_Tips Number of results to return, up to 50.
$tips->setFilter($filter);
  1. string
Eden_Foursquare_Tips If set to friends, only show nearby tips from friends.
$tips->setQuery($query);
  1. string
Eden_Foursquare_Tips Only find tips matching the given term, cannot be used in conjunction with friends filter.
$tips->broadcast($broadcast);
  1. string
Eden_Foursquare_Tips Whether to broadcast this tip. Send twitter if you want to send to twitter, facebook if you want to send to facebook, or twitter,facebook if you want to send to both.
$tips->setGroup($group);
  1. string
Eden_Foursquare_Tips Can be created, edited, followed, friends, other. If no acting user is present, only other is supported.
$tips->checkin($venueId, $text);
  1. string
  2. - The venue where the user is checking in
  3. string
  4. - The text of the tip, up to 200 characters.
array Check in to a place.
$tips->search($near);
  1. string
  2. - The venue where the user is checking in
array Returns a list of tips near the area specified.
$tips->getTips($tipId);
  1. string
  2. - Identity of a tip to get users who have marked the tip as done.
array Returns an array of users have done this tip.
$tips->getTipsList($tipId);
  1. string
  2. - Identity of a tip to get lists for.
array Returns lists that this tip appears on
$tips->markDone($tipId);
  1. string
  2. - The tip you want to mark done.
array Allows the acting user to mark a tip done.
$tips->markToDo($tipId);
  1. string
  2. - The tip you want to mark done.
array Allows you to mark a tip to-do.
$tips->unmark($tipId);
  1. string
  2. - The tip you want to mark done.
array Allows you to remove a tip from your to-do list or done list.

© 2012 Openovate Labs. All rights reserved.