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

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

Board Topics Posts
Main Forum New 48607 505107
Everything Else New 13303 250333
Project Announcements New 6561 198336
Software Forum New 16096 130127
Buy/Sell/Trade - non-retail New 17939 96761
Monitor/Video Forum New 12490 88845
Consoles New 4048 58101
Miscellaneous Arcade Talk New 4140 46873
Artwork New 5399 42279
GroovyMAME New 2954 37536

Top Topics

Shows top topics by the number of replies or views.

Code (show by number of views)

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

Result

Code (show by number of replies)

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

Result

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

Please welcome tusken4, our newest member.

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

10212 Guests, 3 Users
YoBoys, fcolmedo, DrAlves

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

10213 Guests, 3 Users
YoBoys, fcolmedo, DrAlves

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

Welcome, Guest. Please login or register.
Did you miss your activation email?

Today's Calendar Function

Code

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

Result

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 Members: 56513
Total Posts: 1732835
Total Topics: 152713
Total Categories: 7
Total Boards: 47

News Function

Shows random forum news.

Code

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

Result

Support this site
Shop Amazon Video Games through our link. Thank you!


This site is being essentially DDOSed by bots slamming the forum, taking down the web server. We’re looking into mitigation options but they’re kicking our bottom right now.

Board News Function

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

Code

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

Result


question LEDBlinky issues freezes in CoinOps

June 06, 2026, 03:30:30 pm by jlcpremier
I just got a Ultimarc Pac Drive board and set up LEDBlinky (trial version for now)  When CoinOps starts the buttons light up and animate for a few seconds, then freeze. If I launch a game though, the buttons used will light up correctly. Exiting out of the game the same stuck buttons light up in CoinOps FE. If I exit CoinOps I get an error from LEDBlinky.

Any idea how to fix this?
2 comments | Write Comment

clip Cloning a Golden Tee 2025 spring drive to ssd

June 05, 2026, 09:53:28 am by ericb215
Hello,

I have made several attempts to clone a spinning hard drive to SSD with no luck.  I have tried R Disk Image, Macrium, Disk Genius.  I have read the raw copy is the best, but I am having a difficult time with it since the source drive is 500gb and my target is 128gb.  Golden Tee only uses about 55gb of space.  Has anyone done this recently, any tips?
3 comments | Write Comment

xx New mame build, need to power monitor help??

June 03, 2026, 09:53:55 pm by excaliburlives
   Hello, i'm making a new mame build from an empty gutted arcade 1up cab. I already built the pc and want to install a a 23" acer monitor that runs off a 12V power supply. Can i just tap into a 12v rail on my pc's PSu and get abarrel connector to power ir? I'm thinking i might mess something up. I'm afraid of the amps not the volts. Is this possible anybody? Looking for an expeert in this sort of thing. Thnaks for any help or advice i can get.
10 comments | Write Comment

xx Upgrading current single LED buttons to RGB and control

May 28, 2026, 05:45:43 pm by jlcpremier
I have a standard 2 player controller setup with 6 buttons per player, plus start/select and 4 admin buttons, all are static lit by the encoder board when the PC is on.

I only really care about controlling the 8 buttons per player and just leaving the admin buttons static so a Pac64 LED should be all I need from a LED control standpoint and then I’m planning to use LEDBlinky with the latest CoinOps ARISE build. This should work with that right? I’m currently using a single 2P encoder board from Amazon but my concern is the potential for the ports to change between the input board and LED control board. In which case maybe the iPac Ultimate would ensure that isn’t an issue. Is there a different option for a controller I can use? My buttons currently have labels for A,B,C etc so which RGB buttons would allow me to retain use of those?

Really just looking for the most economical way to accomplish this. Thanks!
1 comment | Write Comment

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

File Posted by Downloads Filesize
screen4.png motoschifo 21 179.31kB
screen3.png motoschifo 22 152.85kB
screen2.png motoschifo 18 134.52kB
screen1.png motoschifo 21 116.24kB
IMG_3695 Large.jpeg skottles 35 276.47kB
IMG_3692 Large.jpeg skottles 34 229.91kB
neoSD_-_4.jpeg Joaquim2020 105 228.02kB
Happyfishb.jpg Joaquim2020 102 43.21kB
IMG_5071.jpg TheViz 105 811.22kB
IMG_5068.jpg TheViz 100 241.11kB

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