SSI recentPoll

Aus SMFPortal.de Wiki

Die SSI Funktion ssi_recentPoll zeigt die zuletzt erzeugte Umfrage an. Wenn das Mitglied eingeloggt ist wird ihm auch ein Möglichkeit angeboten abzustimmen.

SMF 1.1.x / SMF 2.0.x

Funktionsbeschreibung

ssi_recentPoll($output_method = 'echo', $topPollInstead = false)

$output_method (STRING)

Damit wird ausgewählt, ob die Funktion als normal Ausgabe erfolgen soll oder ein 'array' ausgegeben wird.

$topPollInstead (BOOL)

Bei true wird anstelle der letzten Umfrage die Umfrage mit den meisten Stimmen angezeigt

Normale Ausgabe

Bild der Standard Ausgabe für ssi_recentPoll().

Array Ausgabe

Für diese Art der Ausgabe, sollten Grundkenntnisse in PHP vorhanden sein!

Eine Ausgabe in einen Array erfolge über die $output_method Array.

Hier ist der Ausgabe aufbau des Arrays welches die Funktion ausgibt.

array(
	'id' => ID der Umfrage 
	'image' => Icon für die Umfrage (Normalerweise "poll")
	'question' => Die Frage zur Umfrage
	'total_votes' => Gesamtzahl der Stimmen
	'is_locked' => geschlossene Umfrage (BOOL)
	'topic' => ID des Themas
	'options' => Die Auswahlmöglichkeiten der Umfrage 
		array( 
			'0' =>
			array(
				'id' => Festgelegt ID der Auswahl
				'percent' => Prozentualen zustimmung
				'votes' => Anzahl der Stimmen
				'bar' => Der prozentualen Balken für die Auswahl
				'option' => Die BBC geparste Version der Auswahl
				'vote_button' => Der Vote Button (Checkbox oder Radio Button, je nach Umfrage Typ)
			),
			'1' =>
			array(
				Weitere Auswahlmöglichkeiten
			),
		)
);

Array in SMF 2.0.x

Der einzige Unterschied zur SMF 1.1.x, besteht in der zusätzlichen Ausgabe der Option

	'allow_view_results' => Darf das Mitglied die Ergebnisse der Umfrage sehen (BOOL)

Der Rest hat den gleichen Aufbau wie in der SMF 1.1.x.

Beispiele für Anwendung

ssi_recentPoll();

Gibt einfach die Normale Ausgabe aus.

ssi_recentPoll('echo', true);

Gibt die Umfrage mit den meisten Stimmen aus.

$meinArray = ssi_recentPoll('array');

Liefert die letzte Umfrage und übergibt diese als Array an die Variable $meinArray

Weiterführende Informationen

SSI-Funktionen