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:

Code: [Select]
<?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)

Code: [Select]
<?php ssi_recentTopics(); ?>

Code (advanced mode)

Code: [Select]
<?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

Code: [Select]
<?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

Recent Poll Function

Code

Code: [Select]
<?php ssi_recentPoll(); ?>

Result

Top Boards Function

Shows top boards by the number of posts.

Code

Code: [Select]
<?php ssi_topBoards(); ?>

Result

Foro Temas Mensajes
L53 Nuevo 247 9140
Klaskan Renacimiento Nuevo 396 7417
La Taberna Nuevo 218 6591
General Nuevo 239 2859
2 República Nuevo 29 2222
FAQ y Normas oficiales de juego Nuevo 109 1795
Bienvenidos Nuevo 105 1331
India Nuevo 19 907
Génova Nuevo 17 677
Kent Nuevo 11 646

Top Topics

Shows top topics by the number of replies or views.

Code (show by number of views)

Code: [Select]
<?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)

Code: [Select]
<?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 Poll Function

Shows the most-voted-in poll.

Code

Code: [Select]
<?php ssi_topPoll(); ?>

Result

Top Poster Function

Shows the top poster's name and profile link.

Code

Code: [Select]
<?php ssi_topPoster(); ?>

Result

Latest Member Function

Shows the latest member's name and profile link.

Code

Code: [Select]
<?php ssi_latestMember(); ?>

Result

Por favor, da la bienvenida a DavidCorbeta, nuestro usuario más reciente.

Member of the Day

Shows one random member of the day. This changes once a day.

Code

Code: [Select]
<?php ssi_randomMember('day'); ?>

Result

Who's Online Function

This function shows who are online inside the forum.

Code

Code: [Select]
<?php ssi_whosOnline(); ?>

Result

19 Visitantes, 0 Usuarios

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

Code: [Select]
<?php ssi_logOnline(); ?>

Result

19 Visitantes, 0 Usuarios

Login Function

Shows a login box only when user is not logged in.

Code

Code: [Select]
<?php ssi_login(); ?>

Result

 
 

Logout Function

Shows a logout link only when user is logged in.

Code

Code: [Select]
<?php ssi_logout(); ?>

Result

Welcome Function

Greets users or guests, also shows user's messages if logged in.

Code

Code: [Select]
<?php ssi_welcome(); ?>

Result

Bienvenido(a), Visitante. Por favor, ingresa o regístrate.

Today's Calendar Function

Code

Code: [Select]
<?php ssi_todaysCalendar(); ?>

Result

Cumpleaños próximos: Moderno (290)

Today's Birthdays Function

Code

Code: [Select]
<?php ssi_todaysBirthdays(); ?>

Result

Today's Holidays Function

Code

Code: [Select]
<?php ssi_todaysHolidays(); ?>

Result

Today's Events Function

Code

Code: [Select]
<?php ssi_todaysEvents(); ?>

Result

Recent Calendar Events Function

Code

Code: [Select]
<?php ssi_recentEvents(); ?>

Result

Forum Stats

Shows some basic forum stats: total members, posts, topics, boards, etc.

Code

Code: [Select]
<?php ssi_boardStats(); ?>

Result

Total de Usuarios: 310
Total de Mensajes: 57536
Total de Temas: 3084
Total de Categorías: 8
Total de Foros: 147

News Function

Shows random forum news.

Code

Code: [Select]
<?php ssi_news(); ?>

Result

Actualizado el foro a la última versión... colores sin solucionar aún

Board News Function

Shows the latest posts from read only boards, or a specific board.

Code

Code: [Select]
<?php ssi_boardNews(); ?>

Result

xx Hola queridos!

17 de Septiembre de 2016, 02:45:32 pm por Phil Spectrum
Acabo de cambiarme la chaqueta para hacer la visita por estos lares.

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 :)
2 comentarios | Escribir comentario

xx Bienvenida Bonnie

10 de Julio de 2016, 08:10:52 pm por dehm
Buenas!!! bienvenida al  :KingIkthusiussCastle:

Disculpa mi confusión a veces :arteest: yerra
9 comentarios | Escribir comentario

dioses Bienvenida, Shiva

30 de Junio de 2016, 03:03:26 pm por AZ
Pues ya tenemos registrado un nuevo usuario, el primero desde hace algún tiempo...  

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!

:hello:



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.
9 comentarios | Escribir comentario

xx hola hola hay alguien ahi?

18 de Mayo de 2016, 09:17:47 pm por Nix
Pues hemos vuelto después de un largo sueño, algunos correos misteriosos aparecieron en mi bandeja y dije es buen momento de explorar, pero pues esto parece medio desierto, así que si hay alguien con vida pues hágase presente, al menos para saber que no soy el unico por aca...

De cualquier forma un saludo a todo aquel que le de la gana leerme...

 :mf_swordfight:
23 comentarios | Escribir comentario

xx Hello despues de mucho tiempo . . .

23 de Enero de 2015, 08:02:42 pm por El_Tamih
Esto aun funciona??? Hay por aqui aun alguno de mis antiguos amigos??

Salu2
8 comentarios | Escribir comentario

Menubar Function

Displays a menu bar, like one displayed at the top of the forum.

Code

Code: [Select]
<?php ssi_menubar(); ?>

Result

Quick Search Function

Code

Code: [Select]
<?php ssi_quickSearch(); ?>

Result

Recent Attachments Function

Code

Code: [Select]
<?php ssi_recentAttachments(); ?>

Result

Show Single Poll

Shows a poll in the specified topic.

Code

Code: [Select]
<?php ssi_showPoll($topicID); ?>

Result

Not shown because it needs specific topic ID that contains a poll.

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

Code: [Select]
<?php ssi_fetchPosts($postIDs, $isOverride); ?>

Result

Not shown because it needs a specific post ID.

Show Single Member

Shows the specified member's name and profile link.

Code

Code: [Select]
<?php ssi_fetchMember($memberIDs); ?>

Result

Not shown because it needs a specific member ID.

Show Group Members

Shows all members in a specified group.

Code

Code: [Select]
<?php ssi_fetchGroupMembers($groupIDs); ?>

Result

Not shown because it needs specific membergroup IDs.

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

Code: [Select]
<?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>

Result