Poll¶

Qualified name: intranet.apps.polls.models.Poll

class intranet.apps.polls.models.Poll(*args, **kwargs)[source]¶

A Poll, for the TJ community.

title¶: A title for the poll, that will be displayed to identify it uniquely.

description¶: A longer description, possibly explaining how to complete the poll.

is_secret¶: Whether the poll is a ‘secret’ poll. Poll admins will not be able to view individual user responses for secret polls.

groups¶: The Groups that can view and vote in the poll. Like Announcements, if there are none set, then it is public to all.

Access questions for the poll through poll.question_set.all()

Parameters:

Relationship fields:

Parameters:: groups (ManyToManyField to Group) – Groups (related name: poll)

Reverse relationships:

Parameters:: question (Reverse ForeignKey from Question) – All questions of this poll (related name of poll)

Methods

`before_end_time`	Has the poll not ended yet?
`before_start_time`	Has the poll not started yet?
`can_vote`
`get_next_by_end_time`	Finds next instance based on `end_time`.
`get_next_by_start_time`	Finds next instance based on `start_time`.
`get_num_eligible_voters`
`get_percentage_voted`
`get_previous_by_end_time`	Finds previous instance based on `end_time`.
`get_previous_by_start_time`	Finds previous instance based on `start_time`.
`get_users_voted`
`get_voted_string`
`has_user_voted`
`in_time_range`	Is it within the poll time range?

Attributes

`description`	Type: `CharField`
`end_time`	Type: `DateTimeField`
`groups`	Type: `ManyToManyField` to `Group`
`id`	Type: `AutoField`
`is_election`	Type: `BooleanField`
`is_secret`	Type: `BooleanField`
`objects`
`question_set`	Type: Reverse `ForeignKey` from `Question`
`start_time`	Type: `DateTimeField`
`title`	Type: `CharField`
`visible`	Type: `BooleanField`