ElkArte SSI (Server Side Includes) Examples

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

Recent Posts Function

Code

<?php ssi_recentPosts();

Result

Recent Poll Function

Code

<?php ssi_recentPoll();

Result

Top Boards Function

Shows top boards by the number of posts.

Code

<?php ssi_topBoards();

Result

Top Topics

Shows top topics by the number of replies or views.

Code (show by number of views)

<?php ssi_topTopicsViews();

Result

Code (show by number of replies)

<?php ssi_topTopicsReplies();

Result

Top Poll Function

Shows the most-voted-in poll.

Code

<?php ssi_topPoll();

Result

Top Poster Function

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

jadengomes

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

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

Recent Calendar Events Function

Code

<?php ssi_recentEvents();

Result

Forum Stats

Shows some basic forum stats: total members, posts, topics, boards, etc.

Code

<?php ssi_boardStats();

Result

News Function

Shows random forum news.

Code

<?php ssi_news();

Result

Board News Function

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

Code

<?php ssi_boardNews();

Result

Klipy Gifs

January 14, 2026, 08:39:51 am by Spuds

Thanks Google! 

No sooner did I add Tenor gifs, they decide close the API (6/2026) and ask you migrate.  Tenor will still be around they just will not let you use it.  I really should know better then to ever rely on their services, this is just an ongoing thing with them.

So out with Tenor, in with Klipy!  Klipy has a transition API for those moving from Tenor but I chose to use their regular API and just redo the plugin.  Its the same 9 block icon in the toolbar and works the same as Gliphy and/or Tenor.

4 comments | Write Comment

---

Tenor Gifs

December 19, 2025, 06:48:14 pm by Spuds

Sure no one asked, but here you go .. We already had a Giphy plugin for the editor, now I've added a tenor one as well

Giphy some time back changed some pricing / licensing so Tenor began to get some more love.  This plugin adds V2 support, its the 9-box icon next to the swirl (Giphy) icon in the toolbar.  The two should work just the same, enable one, both or none!

Tenor


Giphy


Enjoy !

4 comments | Write Comment

---

Time required between posts from the same IP

August 23, 2025, 04:07:21 pm by nous

Hi, the other day we had a request from a well-established member about the post wait time. I looked in the settings, but I didn't find any way to override the Post Settings / Time required between posts from the same IP per member group: it is reasonable to allow proven users post faster. Is there a way to achieve this? Thanks.

3 comments | Write Comment

---

Stop changing topic icon on attaching

November 21, 2024, 02:11:17 pm by Burke Knight

Is there a way to stop the forum from automatically changing topic icon for posts that have attachments?
I'd like to set the default message icon to stay, instead.

0 comments | Write Comment

---

Translation of user posts ?

June 27, 2024, 11:30:02 am by D.M.

Hello there community ! I was wondering if there is some way of integrating a translator addon/plugin for user posts, topic names/boards ? Something like TranslatePress plugin for wordpress or something similar that would use already known translations for future posts ? Or is there a possibility to code something similar ? Maybe a google translate integration ?

6 comments | Write Comment

Menubar Function

Displays a menu bar, like one displayed at the top of the forum.

Code

<?php ssi_menubar();

Result

Quick Search Function

Code

<?php ssi_quickSearch();

Result

Recent Attachments Function

Code

<?php ssi_recentAttachments();

Result

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

Code

<?php require("SSI.php"); ?>
<!DOCTYPE html>
<html>
<head>
	<title>SSI.php example for home page</title>
	<style>
		html {
			width: 99%;
		}
		body {
			font: 87.5%/150% "Segoe UI", -apple-system, BlinkMacSystemFont, "Roboto", "Oxygen", "Ubuntu", "Cantarell", "Droid Sans", "Helvetica Neue", "Trebuchet MS", Arial, sans-serif;
			background: #DFDFDF;
			color: #FFFFFF;
			margin: 0;
		}
		ul, ol {
			padding-left: 1.25em;
			margin: 0;
		}
		li {
			font-size: 1em;
		}
		h1, h2, h3 {
			margin: 0;
			padding: 0;
		}
		h3 {
			font-size: 1em;
		}
		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: #2A2825;
			clear: both;
			padding: .5em;
		}
		#leftbar {
			background: #DF7E00;
			float: left;
			width: 160px;
			margin: 0;
			padding: 1em;
		}
		#leftbar a {
			color: #000;
			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 the system 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: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