SSI-Funktionen
Aus SMFPortal.de Wiki
Das SMF bietet von Haus aus die Möglichkeit, Teile des Forums in eine externe Seite einzubinden. Dazu bringt es die sogenannten SSI-Funktionen mit.
Inhaltsverzeichnis |
SSI.php integrieren
Um SSI-Funktionen nutzen zu können muss die SSI.php aus dem Forum-Ordner mittels der PHP-Funktion require in die externe PHP-Seite eingebaut werden. Erst dann lassen sich die Funktionen nutzen. Wichtig dabei ist, dass der Pfad zur SSI.php als absoluter Pfad angegeben wird.
Ein Beispiel:
<?php require("/home/www/web1/html/forum/SSI.php"); ?>
Falls man sich nicht sicher ist, welchen Pfad man nehmen muss, bietet das SMF in der ssi_examples.php (ssi_examples.php des SMFPortals) die Möglichkeit diesen zu kopieren. Dazu muss man als Administrator im Forum eingeloggt sein und diese Datei im Browser aufrufen.
Im roten Textfeld steht übersetzt:
Um die SSI.php auf Deiner Seiten nutzen zu können, füge ganz oben auf deiner Seite noch vor dem <html> tag auf Zeile 1 folgendes ein:
SSI-Funktionen
Nachdem die SSI.php eingebunden wurde, können die verschiedenen SSI-Funktionen verwendet werden. Der einfachste Funktionsaufruf sieht folgendermaßen aus:
<?php funktionsname(); ?>
wobei funktionsname durch den Namen einer der im Folgenden aufgeführten Funktionen ersetzt werden muss. Anpassungen der Ausgabe mit Hilfe der Funktionsparameter werden auf den einzelnen Seiten der Funktionen detailliert erklärt.
Ausgabe der aktuellsten Daten
- ssi_recentTopics - die neusten Themen
- ssi_recentPosts - die neusten Beiträge
- ssi_recentPoll - die neuste Umfrage
Kalender-Funktionen
- ssi_todaysBirthdays - Mitglieder, die an dem "heutigen Tag" Geburtstag haben
- ssi_todaysHolidays - Feiertage des "heutigen Tages"
- ssi_todaysEvents - Termine des "heutigen Tages"
- ssi_todaysCalendar - Ausgabe der Daten der drei vorherigen Funktionen
- ssi_recentEvents - Feiertage, Geburtstage und Termine der nächsten k Tage
News-Funktionen
- ssi_news - ein zufälliger Eintrag der News
- ssi_boardNews - die ersten Beitrag der (ersten k) Themen eines Forums, absteigend sortiert nach dem Erstellungsdatum
Online-Funktionen
- ssi_login - zeigt nicht-eingeloggten Besuchern ein Loginformular an
- ssi_logout - zeigt eingeloggten Besuchern einen Link zum Ausloggen an
- ssi_welcome - zeigt einen vom Onlinestatus abhängigen Willkommensgruß an
- ssi_whosOnline - die Mitglieder, die momentan online sind
- ssi_logOnline - die Mitglieder, die momentan online sind; zusätzlich wird der Online-Status des Betrachters aktualisiert
Statistiken
- ssi_topBoards - Foren mit den meisten Antworten nach deren Anzahl sortiert
- ssi_topTopicsViews - Themen mit den meisten Aufrufen nach deren Anzahl sortiert
- ssi_topTopicsReplies - Themen mit den meisten Antworten nach deren Anzahl sortiert
- ssi_topPoll - Umfrage mit den meisten Stimmen
- ssi_topPoster - Mitglied mit den meisten Beiträgen
- ssi_latestMember - Mitglied, das sich zuletzt angemeldet hat
- ssi_boardStats - liefert die Gesamtanzahlen an Mitgliedern, Beiträgen, Themen, Kategorien und Foren
sonstige Funktionen
- ssi_menubar - zeigt das Menü des aktuellen Themes an
- ssi_quickSearch - zeigt ein Formuar zur "Schnellsuche" an
- ssi_fetchPosts - zeigt einzelne Beiträge an
Zusätzliche SSI-Funktionen
Manche Modifikationen bieten ebenfalls SSI-Funktionen an. Diese werden meist auch in der ssi_examples.php dargestellt.
Beispiele für Mods welche diese Option anbieten sind: