SSI recentPosts

Aus SMFPortal.de Wiki

Die SSI Funktion ssi_recentPosts zeigt die neusten Posts an. Diese werden absteigend sortiert nach dem Datum des letzten Beitrages ausgegeben.

SMF Version 1.1.x

Funktionsbeschreibung

ssi_recentPosts($num_recent = 8, $exclude_boards = null, $output_method = 'echo')

$num_recent (INT)

Hier wird angegeben wie viele Themen ausgegeben werden sollen. Der Standardwert ist 8.

$exclude_boards (ARRAY)

Hier wird eingetragen welche Boards ausgeschlossen werden sollen. Dazu müssen alle Boards, welche nicht geladen werden dürfen, in ein Array zusammengefasst werden. Dabei müssen die IDs der auszuschließenden Boards verwendet werden.

Der Standardwert ist "null", was bedeutet, dass alle Boards mit einbezogen werden.

$output_method (STRING)

Damit wird ausgewählt, ob die Funktion als normale Ausgabe erfolgen oder ein Array zurückgegeben werden soll. Für ein Array wird der Wert 'array' verwendet und für die direkte Ausgabe auf den Browser der Wert 'echo'.

Normale Ausgabe

Bild der Standard Ausgabe für ssi_recentPosts().

Array Ausgabe

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

Eine Ausgabe in ein Array erfolgt über den Wert "array" des Parameters $output_method.

Im Folgenden sieht man den Aufbau des Ausgabearrays der Funktion.

array(
	'board' => array(
		'id' => ID des Boards
		'name' => Der Namen des Boards
		'href' => Die URL des Boards
		'link' => Einen Link zum Board komplett mit Boardnamen
	),
	'topic' => ID des Themas,
	'poster' => array(
		'id' => ID des Mitgliedes
		'name' => Namen des Mitgliedes
		'href' => URL zum Profil des Mitgliedes
		'link' => Einen Link zum Mitglied komplett mit dem Namen des Posters
	),
	'subject' => Überschrift des Themas
	'short_subject' => Überschrift des Themas auf 25 Zeichen gekürzt
	'preview' => Vorschau auf den letzen post Inhalt.
	'time' => Zeitpunkt des letzten Beitrages in der voreingestellten Formatierung des Forums oder Users
	'timestamp' => Unix Timestamp
	'href' => URL des Themas
	'link' => Link zum Thema mit der Überschrift
	'new' => Bereits gelesen (BOOL)
	'new_from' => ????,
);

Anwendungsbeispiele

ssi_recentPosts();

Gibt die "Normale Ausgabe" aus

ssi_recentPosts(10);

Gibt die letzten 10 Posts aus

ssi_recentPosts(10, array(1,2));

Gibt die letzten 10 Posts, die nicht aus den Boards mit den IDs 1 und 2 sind, aus

$meinArray = ssi_recentPosts(10, null, 'array');

Liefert die letzten 10 Posts zurück und übergibt diese als Array an die Variable $meinArray

SMF Version 2.0.x

Funktionsbeschreibung

ssi_recentPosts($num_recent = 8, $exclude_boards = null, $include_boards = null, $output_method = 'echo')

$num_recent (INT)

Hier wird angegeben wie viele Themen ausgegeben werden sollen. Der Standardwert ist 8.

$exclude_boards (ARRAY)

Hier wird eingetragen welche Boards ausgeschlossen werden sollen. Dazu müssen alle Boards, welche nicht geladen werden dürfen, in ein Array zusammengefasst werden. Dabei müssen die IDs der auszuschließenden Boards verwendet werden.

Der Standardwert ist "null", was bedeutet, dass alle Boards mit einbezogen werden.

$include_boards (ARRAY)

Hier wird eingetragen welche Boards verwendet werden sollen. Dazu müssen alle Boards, welche verwendet werden dürfen, in ein Array zusammengefasst werden. Dabei müssen die IDs der zu ladenden Boards verwendet werden.

Der Standardwert ist "null", was bedeutet, dass alle Boards mit einbezogen werden.

$output_method (STRING)

Damit wird ausgewählt, ob die Funktion als normale Ausgabe erfolgen oder ein Array zurückgegeben werden soll. Für eine Array wird der Wert 'array' verwendet und für die direkte Ausgabe auf den Browser der Wert 'echo'.

Normale Ausgabe

Bild der Standard Ausgabe für ssi_recentPosts().

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 unterschieden nach der SMF Version. Es wird jeder geladen Post in diesen Array ausgegeben.

array(
	'board' => array(
		'id' => ID des Boards
		'name' => Der Namen des Boards
		'href' => URL des Boards
		'link' => Einen Link zum Board komplett mit Boardnamen
	),
	'topic' => ID des Themas,
	'poster' => array(
		'id' => ID des Mitgliedes
		'name' => Namen des Mitgliedes
		'href' => URL zum Profil des Mitgliedes
		'link' => Einen Link zum Mitglied komplett mit dem Namen des Posters
	),
	'subject' => Überschrift des Themas
	'replies' => Anzahl der Antworten auf das Themas
	'views' => Anzahl der Aufrufe des Themas
	'short_subject' => Überschrift des Themas auf 25 Zeichen gekürzt
	'preview' => Vorschau auf den letzen post Inhalt.
	'time' => Zeitpunkt des letzten Themas in der voreingestellten Formatierung des Forums oder Users
	'timestamp' => Unix Timestamp
	'href' => URL des Themas
	'link' => Link zum Thema mit der Überschrift.
	//"new" ist nur noch aus Gründen der Kompatibilität enthalten und kann jederzeit entfallen, es sollte dafür "is_new" verwendet werden!
	'new' => Bereits gelesen (BOOL)
	'is_new' => Bereits gelesen (BOOL)
	'new_from' => ????
	'icon' => Beinhaltet das Symbol des Themas, welches für den letzten Post festgelegt worden ist
);

Anwendungsbeispiele

ssi_recentPosts();

Gibt die "Normale Ausgabe" aus

ssi_recentPosts(10);

Gibt die letzten 10 Posts aus

ssi_recentPosts(10, array(1));

Gibt die letzten 10 Posts, die nicht aus dem Board mit der ID 1 sind, aus

ssi_recentPosts(10, null, array(1));

Gibt die letzten 10 Posts des Boards mit der ID 1 aus

ssi_recentPosts(10, null, array(1,3));

Gibt die letzten 10 Posts der Boards mit den IDs 1 und 3 aus

$meinArray = ssi_recentPosts(10, null, null, 'array');

Liefert die letzten 10 Posts zurück und übergibt diese als Array an die Variable $meinArray.

Weiterführende Informationen

SSI-Funktionen