This library provides a missing feature of Doodle (https://doodle.com): an API to programmatically access and create polls on the Doodle platform.
I was surprised to find only a basic API to initiate polls (not actually creating them, just pre-filling the form) but not anything else to fetch the list of polls or related participant answers so I contacted them and got this answer on September 25th, 2015:
Unfortunately, Doodle won't be offering an API any longer.
-- Katharina
As such I wrote this PHP client.
$doodleUsername = 'me@example.com';
$doodlePassword = 'my-very-secret-password';
$client = new \Causal\DoodleClient\Client($doodleUsername, $doodlePassword);
$client->connect();
$myPolls = $client->getPersonalPolls();
echo '<h1>My polls</h1>';
echo '<ul>';
foreach ($myPolls as $poll) {
echo '<li>';
echo '<a href="' . htmlspecialchars($poll->getPublicUrl()) . '">' . htmlspecialchars($poll->getTitle()) . '</a>';
echo '<blockquote>' . nl2br($poll->getDescription()) . '</blockquote>';
echo 'Export answers as: ' .
'<a href="' . htmlspecialchars($poll->getExportExcelUrl()) . '">Excel</a> | ' .
'<a href="' . htmlspecialchars($poll->getExportPdfUrl()) . '">PDF</a>';
echo '</li>';
}
echo '</ul>';
// Optional, if you want to prevent actually authenticating over and over again
// with future requests (thus reusing the local authentication cookies)
$client->disconnect();
$newPoll = $client->createPoll([
'type' => 'text',
'title' => 'Dinner',
'location' => 'Restaurant Xtra',
'description' => 'I suggest we meet and have a nice time together',
'name' => 'John Doo',
'email' => 'john.doo@example.com',
'options' => [
'Lasagna',
'Pizza',
'Meat',
],
]);
echo 'link to new poll: ' . $newPoll->getPublicUrl();
$newPoll = $client->createPoll([
'type' => 'date',
'title' => 'Dinner',
'location' => 'Restaurant Xtra',
'description' => 'I suggest we meet and have a nice time together',
'name' => 'John Doo',
'email' => 'john.doo@example.com',
'dates' => [
'20150929' => ['1930', '2000'],
'20150930' => ['2000'],
'20151030' => ['1945', '2000'],
],
]);
echo 'link to new poll: ' . $newPoll->getPublicUrl();
// Selection of a given poll could be based on any "$poll" from the
// foreach loop in "Basic Usage" example or of course "$newPoll".
$emailAdresses = [
'someone@example.tld',
'someone-else@gmail.com',
];
$message = 'Hey there! Please check this doodle!';
$client->inviteParticipants($poll, $emailAddresses, $message);
// Selection of a given poll could be based on any "$poll" from the
// foreach loop in "Basic Usage" example.
$client->deletePoll($poll);
Another example of use, would be to fetch answers for a given poll.
// Selection of a given poll could be based on any "$poll" from the
// foreach loop in "Basic Usage" example.
echo '<table>';
echo '<thead>';
echo '<tr>';
echo '<th></th>';
$options = $poll->getOptions();
foreach ($options as $option) {
echo '<th>' . htmlspecialchars($option) . '</th>';
}
echo '</tr>';
echo '</thead>';
echo '<tbody>';
$participants = $poll->getParticipants();
foreach ($participants as $participant) {
echo '<tr>';
echo '<td>' . htmlspecialchars($participant->getName()) . '</td>';
foreach ($participant->getPreferences() as $preference) {
switch ($preference) {
case '0':
$value = 'NO';
$color = '#ffccca';
break;
case '1':
$value = 'YES';
$color = '#d1f3d1';
break;
case '2':
$value = 'If needed';
$color = '#ffeda1';
break;
default:
$value = '?';
$color = '#eaeaea';
break;
}
echo '<td style="background-color:' . $color . '">' . htmlspecialchars($value) . '</td>';
}
echo '</tr>';
}
echo '</tbody>';
echo '</table>';