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 48534 504684
Everything Else New 13294 250345
Project Announcements New 6543 197978
Software Forum New 16072 130026
Buy/Sell/Trade - non-retail New 17919 96707
Monitor/Video Forum New 12472 88709
Consoles New 4046 58096
Miscellaneous Arcade Talk New 4137 46867
Artwork New 5397 42269
GroovyMAME New 2918 37236

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

yibyxrfs
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

2098 Guests, 1 User
PL1

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

2098 Guests, 1 User
PL1

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: 55796
Total Posts: 1730940
Total Topics: 152415
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!




Well, that was weird. Outage sorted out. Thank you SirWoogie for saving the day!

Board News Function

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

Code

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

Result

xx Do you guys play console games on your cabs?

August 25, 2025, 11:35:33 am by javeryh
If so, what games do you think are fun/playable with arcade controls (assuming 8-way stick and buttons)? I am trying to decide how to set up my next single player cabinet and I have been having a lot of fun recently with Game Boy games on my bartop so I think some of those would translate well. So it has me thinking about what else could be playable in short bursts while standing up.

I don't have any "modern" retro set-ups with a widescreen monitor, bezels, a crapload of emulators, etc. All of my cabs are arcade only. Might be time if for nothing else to have some new games to play...
3 comments | Write Comment

question How to secure push-buttons

August 22, 2025, 08:14:55 pm by Rick
Hey all, long time.  :cheers:

Quick question. How are you securing your push-buttons, if at all? I'm finalizing a project, and have noticed that no matter how tight I secure them, after a while of use, they can become loose.

I'd like to have a solution that's not permanent, like blue Loctite would be for metal, but I've seen people use a hot glue gun and even superglue. I tried using a single round of plumbers tape, but it was too thin to make a difference. (I may try multiple layers to see if building it up helps.)

Does anyone have a good idea on how to keep these push-buttons tight?
4 comments | Write Comment

xx Paclink +Xbox 360

August 21, 2025, 08:54:16 am by iRunfast
Hi all,

Not sure of this, ive managed to map all buttons correctly for my liking (default), is it possible to map a key corresponding to the xbox button on the controller? (Only using Sanway buttons and stick +ipac-2 and paclink.

Regards
Robert
Sweden
1 comment | Write Comment

hardware Picture zoomed in in CRT monitor

August 17, 2025, 01:58:16 pm by giannisbizkit
Hello and good evening,
i have an arcade cabinet running pandora box that has a CRT 21" intervideo with a SIVID sl/750012500 chassis and i have an issue with the picture on the screen.
it is very zoomed in and changing the h amp and v amp controls, does nothing. it stays zoomed in.
Any ideas what to look for?
2 comments | Write Comment

xx NBA Showtime / NFL Blitz 4P - wiring between I-40 and AUX PCB

August 15, 2025, 11:23:15 am by mata
Hi everyone,

working on restoring an old NBA Showtime cab, and unfortunately all of my joystick are dead (don't react at all...also in test mode).

Just to get it out of the way, looking for a confirmation of the following wiring setup. Does not look correct, but this is how it is wired on my end...and was working per the prvious owner:

I-40 P1 connector (INPUT) -> AUX OUT ADAPTER
I-40 P2 connector (OUTPUT) -> Player 4 connector

Why are there even two of those connectors on the I-40 PCB, not just one (output)?

Would appreciate any info :D! Thanks!
0 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

File Posted by Downloads Filesize
blip2.0 cp idea 2.png markc74 89 1206.93kB
blip2.0 cp idea.png markc74 104 1015.89kB
Telengard Countersunk Mount 25 Degree 2.JPG PL1 90 182.75kB
Telengard Countersunk Mount 25 Degree 1.JPG PL1 96 181.32kB
Cabal20.JPG roknrol 31 868.3kB
Cabal19.JPG roknrol 27 909.91kB
Cabal18.JPG roknrol 30 1015.17kB
Cabal17.JPG roknrol 28 968.97kB
Cabal16.JPG roknrol 32 1069.9kB
Cabal15.JPG roknrol 34 1008.51kB

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