SMF SSI.php Functions
Current Version: 2.1.7
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.
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
| [New Announcements and Info] | Marlin Crawler 250th Anniversary Sale – 10% Off Sitewide by Marlin Crawler | July 06, 2026, 07:52:33 PM |
| [Project Research and Build-Ups] | Toyota FJ Bro Lift by Jleu511 | July 06, 2026, 10:53:52 AM |
| [Toyota Pickup/4Runner Tech 1979-95] | 1985 truck auto, trans, rebuild or manual swap by Gnarly4X | July 02, 2026, 04:00:35 PM |
| [Parts For Sale] | 3rz 2rz conversion parts: T100 rear-sump pan and pickup (new) $180 by bfin_47 | July 01, 2026, 04:14:36 PM |
| [New Announcements and Info] | 🔥 Marlin Crawler Daily Flash Sales Are Here! 🔥 by Marlin Crawler | June 29, 2026, 10:52:23 AM |
| [Chit Chat Camp] | is there anybody out there? by kneedownnate | June 27, 2026, 08:27:20 PM |
| [Project Research and Build-Ups] | 1992 Daihatsu Rocky Engine swap by RUGER | June 25, 2026, 01:12:05 AM |
| [General 4WD Discussion] | SHOUTBOX by Gnarly4X | June 24, 2026, 05:00:38 PM |
Recent Posts Function
Code
<?php ssi_recentPosts(); ?>
Result
| [New Announcements and Info] | Re: Marlin Crawler 250th Anniversary Sale – 10% Off Sitewide by Marlin Crawler | July 06, 2026, 07:52:33 PM |
| [Project Research and Build-Ups] | Toyota FJ Bro Lift by Jleu511 | July 06, 2026, 10:53:52 AM |
| [New Announcements and Info] | Re: Marlin Crawler 250th Anniversary Sale – 10% Off Sitewide by Marlin Crawler | July 03, 2026, 08:10:24 PM |
| [Toyota Pickup/4Runner Tech 1979-95] | Re: 1985 truck auto, trans, rebuild or manual swap by Gnarly4X | July 02, 2026, 04:00:35 PM |
| [Parts For Sale] | 3RZ Motor swap with Crate JDM motor by bfin_47 | July 01, 2026, 04:14:36 PM |
| [New Announcements and Info] | Marlin Crawler 250th Anniversary Sale – 10% Off Sitewide by Marlin Crawler | June 29, 2026, 11:09:13 AM |
| [New Announcements and Info] | 🔥 Marlin Crawler Daily Flash Sales Are Here! 🔥 by Marlin Crawler | June 29, 2026, 10:52:23 AM |
| [Toyota Pickup/4Runner Tech 1979-95] | 1985 truck auto, trans, rebuild or manual swap by sourdoughben | June 28, 2026, 10:36:36 AM |
Top Boards Function
Shows top boards by the number of posts.
Code
<?php ssi_topBoards(); ?>
Result
| Board | Topics | Posts |
|---|---|---|
| Chit Chat Camp New | 6,966 | 195,175 |
| Project Research and Build-Ups New | 3,653 | 177,444 |
| Parts For Sale New | 12,509 | 102,904 |
| Toyota Pickup/4Runner Tech 1979-95 New | 7,833 | 82,175 |
| Engine New | 5,794 | 69,774 |
| Rig Gallery New | 1,044 | 65,092 |
| General 4WD Discussion New | 4,367 | 62,421 |
| New Member Check-In! New | 4,259 | 46,831 |
| Trail Reports, Events, and Gatherings New | 1,992 | 39,942 |
| Parts Wanted New | 8,277 | 38,876 |
Top Topics
Shows top topics by the number of replies or views.
Code (show by number of views)
<?php ssi_topTopicsViews(); ?>
Result
| Views | Replies | |
|---|---|---|
| Word association | 1,972,437 | 19,743 |
| Get Better Glen Thread! (some skin shown) | 1,297,026 | 5,577 |
| The Official 3RZ Knowledge and Database Thread | 1,044,743 | 1,524 |
| Disgrace to Off-Road Pics. | 1,027,117 | 4,181 |
| Making Of The Willy Mammoth | 1,021,798 | 3,680 |
| * The MACHO TACO * | 1,006,013 | 4,572 |
| BigMike's Big Project | 930,197 | 1,166 |
| BigMike's Big Journey: A 2016 Tacoma Build Thread | 859,076 | 1,151 |
| Random picture thread | 816,538 | 3,537 |
| Glen's budget rebuild | 743,276 | 3,123 |
Code (show by number of replies)
<?php ssi_topTopicsReplies(); ?>
Result
| Views | Replies | |
|---|---|---|
| Word association | 1,972,437 | 19,743 |
| Get Better Glen Thread! (some skin shown) | 1,297,026 | 5,577 |
| YOU!!!!!! | 733,289 | 4,642 |
| * The MACHO TACO * | 1,006,013 | 4,572 |
| Disgrace to Off-Road Pics. | 1,027,117 | 4,181 |
| Making Of The Willy Mammoth | 1,021,798 | 3,680 |
| Random picture thread | 816,538 | 3,537 |
| Silly Jokes | 674,348 | 3,175 |
| Glen's budget rebuild | 743,276 | 3,123 |
| What Are You Listening To Right At This Moment | 459,206 | 3,102 |
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
Prismo
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
Prismo
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 Posts: 1,086,757
Total Topics: 75,554
Total Categories: 6
Total Boards: 138
Board News Function
Shows the latest posts from read only boards, or a specific board.
Code
<?php ssi_boardNews(); ?>
Result
Panamint Valley Days, Nov 9-11, 2012!
Event info: http://www.cal4wheel.com/events/panamint-valley-days
We are looking forward to seeing and wheeling with many of our friends there!

Here are many pics from a past event: http://board.marlincrawler.com/index.php?topic=16401.0
Panamint Valley Days, A Cal-4-Wheel Event 11-12 to 14, 2010
http://www.cal4wheel.com/index.php?option=com_content&view=article&id=63&Itemid=92
Panamint Valley Days Nov. 9th - 11th 2007
http://board.marlincrawler.com/index.php?topic=38064.0
PANAMINT VALLEY DAYS NOV. 10 - 12, 2006
Hope you guys have fun.
For those of you that are going use this thread for getting together, The Spinnin' Fours will try to get their usual spot just east of the main camp. I've included a link to directions to Panamint.
http://www.spinninfours.com/forums/viewtopic.php?t=987
Here's a link to Cal4Wheels Panamint page.
http://cal4wheel.com/pvd/index.html
CALIFORNIA ASSOCIATION OF FOUR WHEEL DRIVE CLUBS INC.

Join the association, it helps keep our trails open plus you may win a cool Jeep. Then you'll join some Jeep board and we won't have to hear your crap anymore.

Quote
WE ARE ... Dedicated ... Determined ... On the Move...
We're the California Association of 4 Wheel Drive Clubs, Inc. Since 1959, our non-profit organization has actively promoted the advancement of vehicle oriented outdoor recreation. Today, the Association represents over 8,000 members and 160 member clubs. We are the largest organization of this type in the State and represent owners of all makes and models of 4WD vehicles, as well as non-owners who support responsible vehicle oriented recreation.
Helping 4 Wheelers...
We maintain a full time office in Sacramento. Our staff and volunteers work closely with legislators and land use managers to provide input, influence, expertise, and manpower to keep lands open to 4WD vehicle access. Many successful battles have been waged and won to keep trails open all over the State. We keep our members informed about important issues and changing laws through our monthly newspaper (In Gear)
Having fun...
Members enjoy Association-sponsored events all year round. These events cover every type of terrain in every corner of the State. Whether you are interested in extremely challenging "hard rock" trails for the experienced enthusiast, or milder runs for the new 4-wheeler, we have several events just for you. Member clubs also sponsor monthly runs open to all.
Making a difference...
Our members are active in conservation projects throughout the State. Projects, which are coordinated with local agencies, can range from tree planting to removing junk cars from remote areas, from closing off entrances of hazardous mine shafts to repairing trail damage. We have received national recognition for winning "Take Pride in California" awards, and "Volunteers For Public Lands National Awards." Many clubs also have Adopt-A-Trails they are responsible for.
http://cal4wheel.com/
Recent Attachments Function
Code
<?php ssi_recentAttachments(); ?>
Result
| File | Posted by | Downloads | Filesize |
|---|---|---|---|
| sourdoughben | 21 | 791.43KB | |
| CrazyYota | 43 | 266.47KB | |
| CrazyYota | 49 | 969.14KB | |
| CrazyYota | 43 | 993.84KB | |
| CrazyYota | 49 | 908.53KB | |
| CrazyYota | 50 | 971.05KB | |
| vvaldez | 45 | 60.2KB | |
| napco4x4 | 29 | 386.75KB | |
| napco4x4 | 25 | 416.15KB | |
| napco4x4 | 28 | 418.97KB |
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 overridden 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>
<html>
<head>
<title>SSI.php example for home page</title>
<style>
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="noopener" rel="license" href="https://creativecommons.org/licenses/publicdomain/"><img alt="Creative Commons License" style="border-width:0" src="https://i.creativecommons.org/l/publicdomain/88x31.png"></a>
This sample website layout is dedicated to the <a target="_blank" rel="noopener" rel="license" href="https://creativecommons.org/licenses/publicdomain/">Public Domain</a>.
</div>
</div>
</body>
</html>