NAME

WWW::Kickstarter::Data::Project - Kickstarter project data

SYNOPSIS

use WWW::Kickstarter;

my $email    = '...';  # Your Kickstarter login credentials
my $password = '...';

my $ks = WWW::Kickstarter->new();
$ks->login($email, $password);

my $iter = $ks->projects_ending_soon();
while (my ($project) = $iter->get()) {
   print($project->name, "\n");
}

ACCESSORS

id

my $project_id = $project->id;

Returns the numerical id of the project.

slug

my $project_slug = $project->slug;

Returns creator-selected keyword id of the project, or undef if it doesn't have one.

name

my $project_name = $project->name;

Returns the project's name.

url

my $project_url = $project->url;

Returns the web address of the project's main page.

blurb

my $project_blurb = $project->blurb;

Returns a short plain-text description of the project.

launched_at

my $project_launched_at = $project->launched_at;

Returns the epoch timestamp (as returned by time) of the project's launch.

deadline

my $project_deadline = $project->deadline;

Returns the epoch timestamp (as returned by time) of the project's deadline.

backers_count

my $project_backers_count = $project->backers_count;

Returns the number of backers the project has.

currency

my $currency = $project->currency;

Returns the currency used for this project's goal, its pledges and its rewards.

goal

my $project_goal = $project->goal;

Returns the amount the project is attempting to raise. The amount is in the currency returned by currency.

pledged

my $project_pledged = $project->pledged;

Returns the amount that has been pledged to the project. The amount is in the currency returned by currency.

progress

my $project_progress = $project->progress;

Returns the progress towards the project's goal. For example, a value greater than or equal to 1.00 indicates the goal was reached.

progress_pct

my $project_progress_pct = $project->progress_pct;

Returns the progress towards the project's goal as a percent. For example, a value greater than or equal to 100 indicates the goal was reached

creator

my $user = $project->creator;

Returns the creator of the project as an WWW::Kickstarter::Data::User object.

Some data will not available without a refetch.

location

my $location = $project->location;

Returns the location of the project as an WWW::Kickstarter::Data::Location object.

category

my $category = $project->category;

Returns the category of the project as an WWW::Kickstarter::Data::Category object.

category_id (Deprecated)

my $category_id = $project->category_id;

Returns the id of the category of the project.

Deprecated: Use $project->category->id instead.

category_name (Deprecated)

my $category_name = $project->category_name;

Returns the name of the category of the project.

Deprecated: Use $project->category->name instead.

API CALLS

refetch

$project = $project->refetch();

Refetches this project from Kickstarter.

This ensures the data is up to date, and it will populate fields that may not be provided by objects created by some API calls.

rewards

my @rewards = $project->rewards();
my @rewards = $project->rewards( force => 1 );

Returns the rewards of the specified project as WWW::Kickstarter::Data::Reward objects.

When fetching an individual project, Kickstarter includes "light" reward objects in its response. By default, these are the objects returned by this method.

If these rewards objects are not available, or if force => 1 is specified, the "full" reward objects will be fetched and returned.

VERSION, BUGS, KNOWN ISSUES, DOCUMENTATION, SUPPORT, AUTHOR, COPYRIGHT AND LICENSE

See WWW::Kickstarter