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

[San Stefanos news and views] Beach bar wars by WINKIE Yesterday at 04:51:49 PM
[San Stefanos news and views] Nafsika webcam by WINKIE July 09, 2025, 04:34:11 PM
[San Stefanos news and views] My holiday review by Tredegar Boy July 08, 2025, 10:51:50 AM
[Where to stay] Paralia. by geordieborn2 July 07, 2025, 11:25:17 PM
[San Stefanos news and views] Here now…. by geordieborn2 June 30, 2025, 11:40:12 PM
[San Stefanos news and views] San Stefanos webcam by geordieborn2 June 21, 2025, 01:51:42 PM
[Where to stay] Hotel Olga by Georgie2002 June 09, 2025, 01:22:23 PM
[Where to eat out in San Stefanos?] Condor Restaurant. by carl nottingham June 04, 2025, 09:26:26 PM

Recent Posts Function

Code

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

Result

[San Stefanos news and views] Re: Beach bar wars by WINKIE Yesterday at 04:51:49 PM
[San Stefanos news and views] Beach bar wars by AndrewK Yesterday at 02:10:08 PM
[San Stefanos news and views] Re: update! by WINKIE July 09, 2025, 04:34:11 PM
[San Stefanos news and views] Re: update! by Scottygirl July 08, 2025, 06:49:49 PM
[San Stefanos news and views] Re: My holiday review by Tredegar Boy July 08, 2025, 10:51:50 AM
[Where to stay] Re: Paralia. by geordieborn2 July 07, 2025, 11:25:17 PM
[Where to stay] Re: Paralia. by BAJ July 07, 2025, 09:44:00 PM
[Where to stay] Paralia. by WINKIE July 07, 2025, 03:27:22 PM

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

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

256 Guests, 2 Users
Tredegar Boy, Gillywoo

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

255 Guests, 2 Users
Tredegar Boy, Gillywoo

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.

Today's Calendar Function

Code

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

Result

Upcoming Birthdays: crsfaz (52)

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: 1254
Total Posts: 83329
Total Topics: 2698
Total Categories: 5
Total Boards: 9

News Function

Shows random forum news.

Code

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

Result

Welcome to San Stefanos in North West Corfu
- We will review/approve new member registrations within 24/48 hrs

Board News Function

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

Code

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

Result

xx Beach bar wars

Yesterday at 02:10:08 PM by AndrewK
There now appears to be no less than eight establishments fighting out the right to take our cash

From left to right looking from the sea
Havana
Pictures
Mango
Joia
180 degrees
Athina
Waves
Sandhill
Manthos

Can they all make it pay?
1 comment | Write Comment

xx My holiday review

July 02, 2025, 02:10:36 AM by Tredegar Boy
Got back last Friday (27th) after our 2 week stay at Fedra and our first visit since 2019.

Well there have been lots of changes of which some were good others less so.
Staying at Fedra was once again brilliant. Dimi and Charitini have again raised their game with excellent accommodation, service and a breakfast which is so extensive you don't need anything else to eat until the evening.

The overall quality of food in the places we ate was very good indeed. We ate at Fantasea, Manthos, Mistral, Sandhill, Waves, Cicala, Olympia, Little Prince and Zorba's. Surprisingly we found you had to book a table for most places especially Manthos, Sandhill and Olympia. You had no chance of getting a table by just rocking up as in previous years. The only place we ate at which didn't seem especially busy was Cicala which was difficult to understand as the food was very very good. Prices were very much higher than our last visit and in some cases very much on a par with what we experience here in south Wales.

The weather was gorgeous.....30 degrees each day with a variable breeze.

The beach was a different matter. The area to the left of the stream was covered in seaweed which by the time we left was 3/4 foot high. No clearance in the 2 weeks we were there. On top of that dogs were being allowed onto the beach especially in the evenings where we saw some owners allowing their dog to do their busy at the waters edge. Seeing this was a first for us. Apparently the responsibility for the cleanliness of the beach falls to the mayor. He's clearly failing in that duty. The sunbeds to the right of the stream were packed together as the license is based on the space rather than the number of beds. It looked a bit like Benidorm from a distance. 

Even though the beach was relatively quiet the taverna's were very busy from what we saw. Disappointingly the Condor was the only place that had any live music and that was a bit ropey.       

All in all it was a lovely holiday. A special trip to celebrate our 40th wedding anniversary but I don't see us going back in the immediate future as the amount of money we spent was comparable to our Sky Princess cruise last September and then we didn't have to fly.
4 comments | Write Comment

xx Tereza

May 29, 2025, 02:48:58 PM by spesh49
Is there anyone staying at the Tereza in the coming weeks ?
Reason I ask is we've booked for next year in a Junior suite with a sea view,  there are no pictures yet on the tui website,  we have had an email from the Tereza saying neither Junior suites have a sea view,  we would really appreciate if anyone is there and confirm either way then we can sort it from there with tui if is hasn't the view.

Many Thanks
0 comments | Write Comment

xx Nottinghamforest

May 24, 2025, 10:03:49 PM by carl nottingham
Hi with no cams running in san stefanos needed to get my fix elsewhere so decided to click on the arillas webcam and nice it is to just see what's waiting for us
0 comments | Write Comment

xx Here now….

May 23, 2025, 08:58:19 AM by Radarman
Arrived yesterday, weather has been mixed, cool at night, cardigan or similar advised. Dined at Little Prince, Aris as friendly as ever, had stamna, was really good, and Mrs, had garlic mushrooms with bread. Village is quieter than normal, many places are seeing fewer visitors, but hopefully pick up today, Friday, as normally a changeover day.
17 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