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:
<?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)
<?php ssi_recentTopics(); ?>
Code (advanced mode)
<?php ssi_recentTopics($num_recent = 8, $exclude_boards = null, $include_boards = null, $output_method = 'echo'); ?>
Result
[Contributions] | HTML Intellistar 2 Simulator by Jessecar | December 15, 2024, 12:08:41 AM |
[General Discussion] | What's Your Speedtest and Pingtest results? by vice86 | December 11, 2024, 03:01:30 AM |
[Emulator Videos] | Intellistar 1 SD Emulator - Accessible Through the Web! by AndreDias7576 | November 28, 2024, 12:58:23 PM |
[Programming and Graphics] | Does anyone know where I can find TWC weather icons? by hainesnoids | November 23, 2024, 11:45:47 PM |
[General Discussion] | TWC extends weekday live coverage to 10pm by crazybangles | November 01, 2024, 01:57:40 PM |
[Local Forecast] | Local Forecast video clips that were on the old TWC Today website by Dylan | August 10, 2024, 12:26:01 AM |
[Local Forecast] | Question about songs airing on multiple flavors in the 1990s by Dylan | July 06, 2024, 05:18:20 PM |
[TWC Fan Art] | tomcat's fanart by tomcat | June 26, 2024, 10:36:12 PM |
Recent Posts Function
Code
<?php ssi_recentPosts(); ?>
Result
[Contributions] | Re: HTML Intellistar 2 Simulator by Jessecar | December 15, 2024, 12:08:41 AM |
[General Discussion] | Re: What's Your Speedtest and Pingtest results? by vice86 | December 11, 2024, 03:01:30 AM |
[Contributions] | Re: HTML Intellistar 2 Simulator by JesseLikesWeather | December 10, 2024, 02:15:47 PM |
[Emulator Videos] | Re: Intellistar 1 SD Emulator - Accessible Through the Web! by AndreDias7576 | November 28, 2024, 12:58:23 PM |
[Emulator Videos] | Intellistar 1 SD Emulator - Accessible Through the Web! by JesseLikesWeather | November 27, 2024, 03:00:17 PM |
[Programming and Graphics] | Re: Does anyone know where I can find TWC weather icons? by hainesnoids | November 23, 2024, 11:45:47 PM |
[Programming and Graphics] | Does anyone know where I can find TWC weather icons? by Godly2009 | November 19, 2024, 03:41:31 PM |
[General Discussion] | Re: TWC extends weekday live coverage to 10pm by crazybangles | November 01, 2024, 01:57:40 PM |
Top Boards Function
Shows top boards by the number of posts.
Code
<?php ssi_topBoards(); ?>
Result
Board | Topics | Posts |
---|---|---|
General Discussion | 1313 | 55394 |
The Game Room | 69 | 35718 |
Local Forecast | 667 | 23834 |
Everything Else TWC | 367 | 17128 |
Programming and Graphics | 277 | 7845 |
General Weather Chat | 197 | 7097 |
OCMs & Personalities | 273 | 6615 |
TWC Today News | 131 | 4879 |
TWC Fan Art | 127 | 4716 |
Your Local Weather | 104 | 4461 |
Top Topics
Shows top topics by the number of replies or views.
Code (show by number of views)
<?php ssi_topTopicsViews(); ?>
Result
Views | Replies | |
---|---|---|
General TWC Discussion | 2142732 | 9697 |
The Front Porch | 2040859 | 15151 |
The Pot Belly Stove | 1508748 | 14426 |
General LF Discussion | 1270794 | 5546 |
Windows 7 - "Consider replacing your battery" | 1026819 | 7 |
What's the weather in your area? | 708986 | 4725 |
Ban the Person above you | 578523 | 6045 |
Which would you prefer? | 522550 | 4822 |
"In my pants" Game | 445344 | 3878 |
AL Roker Should Be on Weekends Too | 376424 | 27 |
Code (show by number of replies)
<?php ssi_topTopicsReplies(); ?>
Result
Views | Replies | |
---|---|---|
The Front Porch | 2040859 | 15151 |
The Pot Belly Stove | 1508748 | 14426 |
General TWC Discussion | 2142732 | 9697 |
Ban the Person above you | 578523 | 6045 |
General LF Discussion | 1270794 | 5546 |
Which would you prefer? | 522550 | 4822 |
What's the weather in your area? | 708986 | 4725 |
"In my pants" Game | 445344 | 3878 |
Guess the Next Poster | 369335 | 3267 |
Word Association | 332103 | 3048 |
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
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
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
Upcoming Birthdays: nickosarus2008 (30), Vanmax22 (29), kyl416 (39), OHRiverMudcat (66), Dj0287 (45), twcc_Dj0287 (45), Spring Rubber (35)
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
Board News Function
Shows the latest posts from read only boards, or a specific board.
Code
<?php ssi_boardNews(); ?>
Result
Some changes on the Forum
-Fixed the email subsystem, which would affect new users signing up, or exchanging personal messages.
-Removed a bunch of unused user groups, mostly because those people are no longer patrons of the forum anymore.
-Combined all of Matt's "TWCClassics.com"-related forums into one grouping.
-Eliminated the old website which has not been touched ~10 years. Visiting twctodayforums.com will immediately redirect to the forum.
There have been thoughts on adding a "home" page which integrates with our forum, and perhaps bringing some of the old website content back to that in a better curated format.
BIG NEWS: I have set up the integration between the forum and the Tapatalk app for mobile devices. This will allow easy mobile access to collaborate and discuss on this forum.
Coming soon, perhaps a visual re-theme and new logo -- something to fit our time.
I know an old legacy admin 'Stephen' patronizes this forum from time to time, and I would like to hear his input, along with everyone else who visits here.
Martin's passing and the future of TWC Today
As for the future of TWC Today, it remains uncertain at this time. Martin has not shared any of the hosting details with anyone so unfortunately there is no possible way to obtain the data at this time. The twctodayforums.com domain name is registered through June 2016, however I am uncertain how long the hosting will be live. I will be in contact with the admins of the forums and we will, together, figure something out. After a respectful mourning period, we will get in to contact with the Cornicks and see if we can get the hosting details so we can move the forums to a new host.
I know most of you don't want to see TWC Today or the forums end, but we will try to do everything we can.
Rest in Peace, Martin Cornick. October 22, 1991 - October 30, 2015. You will be missed.
Obituary
Slow and laggy
Weather in posts?
Not only was it interesting to see the local weather for every member, but it made it so much easier to find out where each member was posting from.
I understand a forum upgrade took this feature away from us, but I haven't heard any updates recently about whether any progress has been made towards getting it back.
SMF 2.0.2 upgrade complete!...
Recent Attachments Function
Code
<?php ssi_recentAttachments(); ?>
Result
File | Posted by | Downloads | Filesize |
---|---|---|---|
Screenshot 2024-06-25 233352.png | tomcat | 178 | 904.04kB |
extfcst1.png | tomcat | 195 | 569.67kB |
16129980481.png | crazybangles | 191 | 49.22kB |
TWCHD_20231208_0857 (02).jpg | IceManNYR | 374 | 199.2kB |
TWCHD_20231107_0657.jpg | IceManNYR | 367 | 187.57kB |
TWCHD_20231208_0657.jpg | IceManNYR | 392 | 164.23kB |
TWCHD_20231107_0657 (02).jpg | IceManNYR | 385 | 223.62kB |
TWCHD_20231206_0657.jpg | IceManNYR | 388 | 202.61kB |
TWCHD_20231107_0657.jpg | IceManNYR | 384 | 176.37kB |
Rob Weiss - Cold Front.mp3 | Dylan | 162 | 1875.96kB |
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 overriden 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 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>