SMF SSI.php Functions
Current Version: 2.0
This file is used to demonstrate the capabilities of SSI.php using PHP include functions. The examples show the include tag, then the results of it.
Include Code
To use SSI.php in your page add at the very top of your page before the <html> tag on line 1 of your php file:
<?php require("SSI.php"); ?>
Some notes on usage
All the functions have an output method parameter. This can either be "echo" (the default) or "array"
If it is "echo", the function will act normally - otherwise, it will return an array containing information about the requested task. For example, it might return a list of topics for ssi_recentTopics.
This functionality can be used to allow you to present the information in any way you wish.
Additional Guides & FAQ
Need more information on using SSI.php? Check out Using SSI.php article or the SSI FAQ.
Recent Topics Function
Code (simple mode)
<?php ssi_recentTopics(); ?>
Code (advanced mode)
<?php ssi_recentTopics($num_recent = 8, $exclude_boards = null, $include_boards = null, $output_method = 'echo'); ?>
Result
[General] | Muchos años después... por Isondel | 24 de Enero de 2024, 05:17:09 pm |
[Klaskan Renacimiento] | Fin de la Partida por dehm | 29 de Julio de 2020, 07:33:15 am |
[Klaskan Renacimiento] | kmm por Dryiceman | 18 de Abril de 2020, 11:55:28 pm |
[General] | Feliz año por dehm | 05 de Mayo de 2019, 06:32:50 pm |
[Algo en la nuca] | La corrala del vecineo (mete caña a los jugadores, visitante) por El_Tamih | 21 de Noviembre de 2016, 05:25:17 pm |
[Machiavelli] | Inscripción y lista de jugadores por Nix | 20 de Septiembre de 2016, 06:16:19 pm |
[Bienvenidos] | Hola queridos! por Raúl | 19 de Septiembre de 2016, 04:54:04 pm |
[General] | ¿Qué juegos queremos ver en Klaskan? por Phil Spectrum | 17 de Septiembre de 2016, 02:54:11 pm |
Recent Posts Function
Code
<?php ssi_recentPosts(); ?>
Result
[General] | Muchos años después... por Isondel | 24 de Enero de 2024, 05:17:09 pm |
[Klaskan Renacimiento] | Re:Fin de la Partida por dehm | 29 de Julio de 2020, 07:33:15 am |
[Klaskan Renacimiento] | Re:Fin de la Partida por Dryiceman | 19 de Abril de 2020, 12:05:23 am |
[Klaskan Renacimiento] | Re:kmm por Dryiceman | 18 de Abril de 2020, 11:55:28 pm |
[Klaskan Renacimiento] | kmm por dehm | 13 de Marzo de 2020, 12:04:27 am |
[General] | Re: Feliz año por dehm | 05 de Mayo de 2019, 06:32:50 pm |
[General] | Re: Feliz año por Raúl | 12 de Marzo de 2019, 04:43:26 pm |
[General] | Re: Feliz año por AZ | 12 de Marzo de 2019, 12:33:46 pm |
Top Boards Function
Shows top boards by the number of posts.
Code
<?php ssi_topBoards(); ?>
Result
Foro | Temas | Mensajes |
---|---|---|
L53 ![]() |
247 | 9140 |
Klaskan Renacimiento ![]() |
396 | 7417 |
La Taberna ![]() |
218 | 6591 |
General ![]() |
239 | 2859 |
2 República ![]() |
29 | 2222 |
FAQ y Normas oficiales de juego ![]() |
109 | 1795 |
Bienvenidos ![]() |
105 | 1331 |
India ![]() |
19 | 907 |
Génova ![]() |
17 | 677 |
Kent ![]() |
11 | 646 |
Top Topics
Shows top topics by the number of replies or views.
Code (show by number of views)
<?php ssi_topTopicsViews(); ?>
Result
Vistas | Respuestas | |
---|---|---|
El ahorcado | 847251 | 2074 |
Mala praxis! | 395529 | 836 |
NFs del Turno 19. | 392220 | 753 |
(POSIBLES) ADELANTOS T23 | 372582 | 591 |
ADELANTOS T17 - AHORA SÍ!! | 353301 | 723 |
NFs del Turno 18. | 325441 | 655 |
Turno 16 | 309061 | 603 |
Turno 20. Comentarios. | 283217 | 478 |
POLVO DE ESTRELLAS! | 275606 | 507 |
Re: Primer Encuentro: La batalla | 221360 | 224 |
Code (show by number of replies)
<?php ssi_topTopicsReplies(); ?>
Result
Vistas | Respuestas | |
---|---|---|
El ahorcado | 847251 | 2074 |
Mala praxis! | 395529 | 836 |
NFs del Turno 19. | 392220 | 753 |
ADELANTOS T17 - AHORA SÍ!! | 353301 | 723 |
NFs del Turno 18. | 325441 | 655 |
Turno 16 | 309061 | 603 |
(POSIBLES) ADELANTOS T23 | 372582 | 591 |
POLVO DE ESTRELLAS! | 275606 | 507 |
Turno 20. Comentarios. | 283217 | 478 |
Turno 15 | 187750 | 346 |
Top Poster Function
Shows the top poster's name and profile link.Code
<?php ssi_topPoster(); ?>
Result
Latest Member Function
Shows the latest member's name and profile link.
Code
<?php ssi_latestMember(); ?>
Result
Member of the Day
Shows one random member of the day. This changes once a day.
Code
<?php ssi_randomMember('day'); ?>
Result
Who's Online Function
This function shows who are online inside the forum.
Code
<?php ssi_whosOnline(); ?>
Result
Log Online Presence
This function logs the SSI page's visitor, then shows the Who's Online list. In other words, this function shows who are online inside and outside the forum.
Code
<?php ssi_logOnline(); ?>
Result
Login Function
Shows a login box only when user is not logged in.
Code
<?php ssi_login(); ?>
Result
Logout Function
Shows a logout link only when user is logged in.
Code
<?php ssi_logout(); ?>
Result
Welcome Function
Greets users or guests, also shows user's messages if logged in.
Code
<?php ssi_welcome(); ?>
Result
Today's Calendar Function
Code
<?php ssi_todaysCalendar(); ?>
Result
Today's Birthdays Function
Code
<?php ssi_todaysBirthdays(); ?>
Result
Today's Holidays Function
Code
<?php ssi_todaysHolidays(); ?>
Result
Today's Events Function
Code
<?php ssi_todaysEvents(); ?>
Result
Forum Stats
Shows some basic forum stats: total members, posts, topics, boards, etc.
Code
<?php ssi_boardStats(); ?>
Result
Total de Mensajes: 57536
Total de Temas: 3084
Total de Categorías: 8
Total de Foros: 147
News Function
Shows random forum news.
Code
<?php ssi_news(); ?>
Result
Board News Function
Shows the latest posts from read only boards, or a specific board.
Code
<?php ssi_boardNews(); ?>
Result
Hola queridos!
Si echo la vista atrás hace unos 10 años más o menos que estuve por aquí. Desde entonces he seguido pasándome cual sombra de vez en cuando, viendo como poco a poco esta casa se iba desmoronando y cada vez era más dificil ver habitantes en ella.
En esta casa yo reí, jugué, disfruté, aprendí e incluso discutí, porque esta casa era en aquellos años una parte muy importante de mi vida. Por eso me encanta ver como Dehm, el "arquitecto", la ha conservado cual album de fotos, para que pueda regresar a ella cuando quiera y recordar quien era yo en aquellos años.
Han cambiado muchas cosas, las suficientes para que ya no me sienta un malkavian, pero la casa siempre ha seguido estando ahí, parece ser que no solo para mi si no también para muchos de los otros habitantes que la poblamos entonces. Incluso a habido intentos de construir la casa en otros sitios, pero ninguno era esta casa.
No se si es una cuestión nostálgica o que, pero en estos últimos meses parece que algunas de las habitaciones siguen con los muebles tapados con sábanas, pero que en otras se ha limpiado un poco el polvo y algunos valientes han comenzado a acomodarse como antaño, por lo que he decidido pasarme a ver si queda un hueco. No se si mi tiempo me permitirá volver a entonar el "quiero turno", pero visto lo visto no me perdería esto por nada del mundo.
Saludos de nuevo a todos, vamos a leernos un poco

Bienvenida Bonnie

Disculpa mi confusión a veces

Bienvenida, Shiva
Así que, demos todos la bienvenida a Shiva, que viene recomendada por Ivam, y que está lista para hacer sus primeros argumentos Matrix Game en la partida de "Algo en la nuca: Ellos".
¡Un fuerte aplauso! ¡No todos los habitantes del foro vamos a ser viejos muertos vivientes!

NOTA A NUEVOS USUARIOS: Recordad todos, que al parecer de momento los nuevos registros requieren activación manual por parte de Su Majestad Dehm I de Klaskan, porque hay spammers malosos que quieren hacer argumentos raros en partidas que no toca. Así que si queréis registraros, contactad con él.
hola hola hay alguien ahi?
De cualquier forma un saludo a todo aquel que le de la gana leerme...

Hello despues de mucho tiempo . . .
Salu2
Show Single Poll
Shows a poll in the specified topic.
Code
<?php ssi_showPoll($topicID); ?>
Result
Show Single Post
Fetches a post with a particular IDs. By default will only show if you have permission to the see the board in question. This can be overriden by passing the 2nd parameter as true.
Code
<?php ssi_fetchPosts($postIDs, $isOverride); ?>
Result
Show Single Member
Shows the specified member's name and profile link.
Code
<?php ssi_fetchMember($memberIDs); ?>
Result
Show Group Members
Shows all members in a specified group.
Code
<?php ssi_fetchGroupMembers($groupIDs); ?>
Result
Home Page Sample
This sample uses the following features: ssi_recentTopics(), ssi_logOnline(), ssi_welcome(), and ssi_boardNews(). ssi_recentTopics() is fetched using the array method, to allow further customizations on the output.Code
<?php require("SSI.php"); ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>SSI.php example for home page</title>
<style type="text/css">
body { font-family: Arial, Tahoma, sans-serif; font-size: 80%; background: #DFDFDF; color: #FFFFFF; margin: 0 }
ul,ol { padding-left: 19px; margin: 0; }
li { font-size: 11px; }
h1,h2,h3 { margin: 0; padding: 0; }
h3 { font-size: 15px; }
a:link,a:visited { color: #FF9000; text-decoration: none; }
a:hover { text-decoration: underline; }
#container { background: #52514E; width: 100%; border: 1px solid midnightblue; line-height: 150%; margin: 0; }
#header,#footer { color: lightgray; background-color: #2A2825; clear: both; padding: .5em; }
#leftbar { background: #DF7E00; float: left; width: 160px; margin: 0; padding: 1em; }
#leftbar a { color: #000000; text-decoration: underline; }
#content { margin-left: 190px; padding: 1em; }
#navigation { float: right; }
#navigation a:link,#navigation a:visited { color: #FF9000; }
</style>
</head>
<body>
<div id="container">
<div id="header">
<div id="navigation">
<a href="#">Link</a> | <a href="#">Link</a> | <a href="#">Link</a> | <a href="#">Link</a> | <a href="#">Link</a>
</div>
<h1 class="header">YourWebsite.com</h1>
</div>
<div id="leftbar">
<h3>Recent Forum Topics</h3>
<ul>
<?php
// Using array method to show shorter display style.
$topics = ssi_recentTopics(8, null, null, 'array');
foreach ($topics as $topic)
{
// Uncomment the following code to get a listing of array elements that SMF provides for this function.
// echo '<pre>', print_r($topic), '</pre>';
echo '
<li><a href=\"', $topic['href'], '\">', $topic['subject'], '</a> ', $txt['by'], ' ', $topics[$i]['poster']['link'], '</li>';
}
unset($topics);
?>
</ul><br />
<h3>Online Users</h3>
<?php ssi_logOnline(); ?>
</div>
<div id="content">
<?php ssi_welcome(); ?><br /><br />
<h2>News</h2>
<?php ssi_boardNews(); ?>
</div>
<div id="footer">
<a target="_blank" rel="license" href="http://creativecommons.org/licenses/publicdomain/"><img alt="Creative Commons License" style="border-width:0" src="http://i.creativecommons.org/l/publicdomain/88x31.png" /></a>
This sample website layout is dedicated to the <a target="_blank" rel="license" href="http://creativecommons.org/licenses/publicdomain/">Public Domain</a>.
</div>
</div>
</body>
</html>