3 * @copyright Copyright (C) 2010-2023, the Friendica project
5 * @license GNU AGPL version 3 or any later version
7 * This program is free software: you can redistribute it and/or modify
8 * it under the terms of the GNU Affero General Public License as
9 * published by the Free Software Foundation, either version 3 of the
10 * License, or (at your option) any later version.
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU Affero General Public License for more details.
17 * You should have received a copy of the GNU Affero General Public License
18 * along with this program. If not, see <https://www.gnu.org/licenses/>.
22 namespace Friendica\Object\Api\Mastodon;
24 use Friendica\BaseDataTransferObject;
25 use Friendica\Util\DateTimeFormat;
30 * @see https://docs.joinmastodon.org/entities/poll/
32 class Poll extends BaseDataTransferObject
36 /** @var string|null (Datetime) */
37 protected $expires_at;
39 protected $expired = false;
41 protected $multiple = false;
43 protected $votes_count = 0;
45 protected $voters_count = 0;
47 protected $voted = false;
48 /** @var array|null */
49 protected $own_votes = false;
51 protected $options = [];
53 protected $emojis = [];
56 * Creates a poll record.
58 * @param array $question Array with the question
59 * @param array $options Array of question options
60 * @param bool $expired "true" if the question is expired
61 * @param int $votes Number of total votes
62 * @param array $ownvotes Own vote
64 public function __construct(array $question, array $options, bool $expired, int $votes, array $ownvotes = null)
66 $this->id = (string)$question['id'];
67 $this->expires_at = !empty($question['end-time']) ? DateTimeFormat::utc($question['end-time'], DateTimeFormat::JSON) : null;
68 $this->expired = $expired;
69 $this->multiple = (bool)$question['multiple'];
70 $this->votes_count = $votes;
71 $this->voters_count = $this->multiple ? $question['voters'] : null;
73 $this->own_votes = $ownvotes;
74 $this->options = $options;