. * * @author Amir Hossein Jafari * @copyright 2016-2025 Amir Hossein Jafari * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\EventHandler\Poll; use danog\MadelineProto\EventHandler\AbstractPoll; use danog\MadelineProto\EventHandler\Message\Entities\MessageEntity; use danog\MadelineProto\StrTools; /** Represents a quiz (with wrong and correct answers, results shown in the return type) poll */ final class QuizPoll extends AbstractPoll { /** Explanation of quiz solution */ public readonly ?string $solution; /** @var list Message [entities](https://core.telegram.org/api/entities) for styled text in quiz solution */ public readonly array $solutionEntities; /** @internal */ public function __construct(array $rawPoll) { parent::__construct($rawPoll); $this->solution = $rawPoll['results']['solution'] ?? null; $this->solutionEntities = MessageEntity::fromRawEntities($rawPoll['results']['solution_entites'] ?? []); } protected readonly string $htmlSolution; protected readonly string $htmlSolutionTelegram; /** * Get an HTML version of the solution. * * @psalm-suppress InaccessibleProperty * * @param bool $allowTelegramTags Whether to allow telegram-specific tags like tg-spoiler, tg-emoji, mention links and so on... */ public function getSolutionHTML(bool $allowTelegramTags = false): ?string { if ($this->solution === null) { return null; } if (!$this->solutionEntities) { return StrTools::htmlEscape($this->solution); } if ($allowTelegramTags) { return $this->htmlSolutionTelegram ??= StrTools::entitiesToHtml($this->solution, $this->solutionEntities, $allowTelegramTags); } return $this->htmlSolution ??= StrTools::entitiesToHtml($this->solution, $this->solutionEntities, $allowTelegramTags); } }