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 47429 495555
Everything Else New 13171 247386
Project Announcements New 6354 190074
Software Forum New 15758 127924
Buy/Sell/Trade - non-retail New 17662 95870
Monitor/Video Forum New 12150 86540
Consoles New 3985 57069
Miscellaneous Arcade Talk New 4082 45895
Artwork New 5332 41995
GroovyMAME New 2424 31571

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

waclawa3566
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

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

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

Halloween

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: 52066
Total Posts: 1684795
Total Topics: 148143
Total Categories: 7
Total Boards: 47

News Function

Shows random forum news.

Code

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

Result

Board News Function

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

Code

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

Result

xx How do i use the search feature.

October 28, 2020, 08:49:18 pm by glewis
I get
"Unable to access the search daemon"
when i try to search.
Any idea?

Just found out that searches currently are done through google using the site option i.e "site:forum.arcadecontrols.com"
6 comments | Write Comment

xx Button Selection - Upgrading from Ultimarc gold leaf?

October 28, 2020, 05:58:32 am by wcndave
I was watching a crazy fast track and field technique on YT, when I thought, as a piano player, I should be able to do the same movement.  I don't want to get as fast as that, but none of my friends or I have ever passed the second round of the 100m, or can lift more than the very lightest weight in hyper olympics, so it would be nice to be able to.

I tried with just two fingers, going slowly, and it doesn't work, because the button doesn't come back up by the time the next finger is down.
Then I thought about the fact that none of us ever made it close to the second round 100m, or close to the records, and I think perhaps it's the buttons... does that sound plausible?

I have the Ultimarc gold leaf pushbuttons, which have all kinds of listed benefits, one of which is "no plunger spring".  So there's low force required, but does it come back up much slower?

One of my buttons is broken anyway, so I need to replace at least one, and I figured perhaps there's a better button out there I should consider instead.
The machine is used for the full range of games, from platform to shooter, to fight versus to track and field, but possibly that's the only genre that needs something a little more specific?

Any ideas out there about what would be a good replacement / upgrade?

Many thanks!

Dave


1 comment | Write Comment

exclamation My Arcade Plans and other info

October 27, 2020, 03:28:10 pm by rjpe
Hi Guys,

I found today a few old files, from the Arcade Project I finished 11 years ago.  :)

I uploaded to my blog:

1) Document with some hints for the Windows XP 64 setup with a SCART TV:

https://perdigaosarcade.com/2020/10/27/perdigaos-arcade-1st-version-2009/

2) my Cabinet's Plans:

https://perdigaosarcade.com/2020/10/27/perdigaos-arcade-cabinet-plans/

Hope it helps someone,

Cheers!  :cheers:
0 comments | Write Comment

clip Just about done...

October 27, 2020, 12:08:22 pm by spisi
My add-on steering wheel / 720 cabinet is just about done...just some minor issues left. What do you guys think?
14 comments | Write Comment

xx Starting my Build : Question on Joystick Brand

October 25, 2020, 10:11:21 pm by malangon
Just got this idea in my head to build a cabinet and now I'm obsessed.  Quick question as I explore this new project:
 
I found a joystick/button combo on Amazon.  The brand name is 'Avisiri'.  Looks like it has every thing I need but there is a note that says, "if you're a pro-gamer, you should get a Sanwa brand instead."
 
I'm not a pro-gamer but if the controls have even the slightest bit of latency, I can guarantee it won't work for me.  I'm not sure about these different brands and the controls are crucial.  I'm planning to just use this for my old arcade game memories.
 
Any advice here?  Is this going to be good enough or should I stay away from this brand or something?
 
The link is here:  https://www.amazon.com/gp/product/B07Z38F8NK/ref=ox_sc_act_title_1?smid=ASYNTYA34W82S&psc=1

Thanks for the advice and if you have any other tips, please share!
10 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