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 48582 504952
Everything Else New 13303 250338
Project Announcements New 6554 198220
Software Forum New 16085 130088
Buy/Sell/Trade - non-retail New 17931 96745
Monitor/Video Forum New 12484 88760
Consoles New 4048 58100
Miscellaneous Arcade Talk New 4137 46867
Artwork New 5398 42274
GroovyMAME New 2938 37395

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 eastofedenpdfhicky, 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

vicckcls
I want to build my own arcade controls!

Who's Online Function

This function shows who are online inside the forum.

Code

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

Result

5924 Guests, 0 Users

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

5924 Guests, 0 Users

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

Groundhog Day

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: 56301
Total Posts: 1732063
Total Topics: 152606
Total Categories: 7
Total Boards: 47

News Function

Shows random forum news.

Code

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

Result

Support this site
Shop Amazon Arcade Stuff through our link. Thank you!




SSL certificate renewed today. Let me know if you see anything wonky with SSL access.

Board News Function

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

Code

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

Result

xx 6 buttons in opt for 750 elf jammer

January 29, 2026, 05:56:59 pm by Tumuchfun8487
Hello,  New to the DIY arcade.
Built a 60 in 1 counter top arcade with no issues.

Now on my second  DIY arcade with 56 pin harness and a 750 n 1 elf Jammer.    Directions state to not hook up pin 27 which is a ground and 28 pin however that's what the jumper grounds are connected to.   Game boots up no problem and joy stick 1 works ok, along with the test switch button but none of the 6 buttons work on player 1 or 2.  I'm sure it's a ground issue but didn't know if anyone has experienced that or resolved the issue.

Would appreciate any suggestions.
4 comments | Write Comment

xx Speaker installation

January 11, 2026, 11:23:45 am by kkgrafics
Hello,

I have a question: do the speakers always have to be installed under the marquee? Can they also be installed on the sides, left and right?

Mario aus Germany
1 comment | Write Comment

clip Golden Tee Setup - Happ3 to UTrak to USB Issues

January 11, 2026, 08:36:38 am by Roushy
Completely lost at this point and hope that someone can help me.   I purchased a Happ3 trackball as well as the Happ3 to U-Trak and U-Trak to USB adapters (links below).   I installed per the images but all I get is a right click of the mouse, a little X-axis movement, and no y-axis movement.   I've confirmed that each axis on the Happ trackball is receiving a solid 5V.   I also noticed that nothing works unless I plug in both harnesses.   Is anyone else knowledgeable about this setup and can send some guidance on what to test or how to wire it?

https://www.arcaderenovations.com/suzo-happ-to-ultimarc-utrak-arcade-trackball-adapter.html
https://www.arcaderenovations.com/suzo-happ-to-ultimarc-utrak-arcade-trackball-adapter.html
2 comments | Write Comment

xx Anywhere to buy a name cab anymore?

January 10, 2026, 10:54:50 pm by patm95
Hello all. I’ve been out of the loop for a long time. I was starting to entertain the idea of building a mame cab (been a goal for over a decade). I went to north coast customs site and seems they are out of business now. Are there any reputable sellers left that sell cabs?
7 comments | Write Comment

xx Atari Showcase 33 Cab button and stick replacements

January 10, 2026, 04:26:28 pm by Demo85
Hello, won a Capcom vs SNK cab off a auction sight unseen. While it did turn on and work it's in rough shape. After evaluating the cab and seeing it doesn't have a CRT (has the cheapest 16:9 monitor I've ever seen in it) and how the wiring has been spliced and cut a whole bunch I've decided to pull everything out and just rebuild it with a emulation PC in it with a 35 inch Arcooda monitor in it. I'm mostly a console type of guy so I don't know anything about arcade sticks and buttons. My first question is what buttons and sticks do I put in it? It can with IL button that take a microswitch in the bottom and oddly I had a ton of that style switch from modding lightgun triggers, not sure if that's the way to go. I've heard of the name brand Sanwa before, not sure if that's the move? For the stick I have no clue, I know you have different gates and I see so many styles. Can anyone shed some light on this for me? The buttons are 30mm and the stick hole is 45mm. Is the Ultimarc I-PAC the way to go to get this to interface with a computer once I'm done? If not what do I use?



Here is the current control deck. Thinking of just doing a fresh vinyl wrap on the metal deck, shouldn't be hard. I do want to replace the plexiglass, I see sources online for the 1/8th thick sheets online. Any tips for cutting it and drilling the holes? I haven't worked with plexiglass in 20 years and then I just made a custom cluster for my old Mustang.

Thanks for reading, sorry if these questions are super basic.
9 comments | 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

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