SMF SSI.php Functions

Current Version: 2.1.3

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.

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

[Література / Литература] От: Орехоплодные и субтропические плодовые культуры от vitaliyagrostory 26 марта 2023, 19:20
[Тваринництво / Животноводство] От: Разведение маленьких собачек от vitaliyagrostory 26 марта 2023, 19:17
[Бізнес / Бизнес] От: Запрет пальмовго масла в Украине от vitaliyagrostory 26 марта 2023, 19:11
[Агрономія / Агрономия] От: Высадка черенков от vitaliyagrostory 26 марта 2023, 19:08
[Тех. підтримка Agrostory / Тех. поддержка Agrostory] От: Увага, тестування! Внимание, тестирование! от support 23 марта 2023, 11:34
[Маркетинг] От: Магазин строительных материалов от vitaliyagrostory 17 марта 2023, 20:50
[Література / Литература] От: Биопрепараты в органическом земледелии от vitaliyagrostory 17 марта 2023, 20:42
[Тваринництво / Животноводство] От: Разведение домашних животных и птицы от vitaliyagrostory 17 марта 2023, 20:34

Recent Poll Function

Code

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

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

Просмотров Сообщений
Любимые анекдоты, забавные истории, бывальщины 3,217 279
Плейлисты 3,178 243
Смешные видеосюжеты 3,056 173
Приусадебное животноводство. Ветеринария. 2,630 233
Стимуляторы роста растений 2,050 92
Разведение домашних животных и птицы 2,000 156
Бизнес на 25 сотках 1,990 53
Рентабельность промышленного молочного производства КРС 1,895 136
Эффективность системы агромаркетинга 1,882 43
Китайские куры 1,797 95

Code (show by number of replies)

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

Result

Просмотров Сообщений
Любимые анекдоты, забавные истории, бывальщины 3,217 279
Плейлисты 3,178 243
Приусадебное животноводство. Ветеринария. 2,630 233
Смешные видеосюжеты 3,056 173
Разведение домашних животных и птицы 2,000 156
Весенние вредители сада 1,606 146
Что посмотреть вечером 1,500 141
Рентабельность промышленного молочного производства КРС 1,895 136
Китайские куры 1,797 95
Стимуляторы роста растений 2,050 92

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

vitaliyagrostory

Latest Member Function

Shows the latest member's name and profile link.

Code

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

Result

Добро пожаловать, Александр, наш самый новый пользователь.

Member of the Day

Shows one random member of the day. This changes once a day.

Code

Code: [Select]
<?php ssi_randomMember('day'); ?>

Result

dovmont

Who's Online Function

This function shows who are online inside the forum.

Code

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

Result

17 гостей, 0 пользователей

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

17 гостей, 0 пользователей

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

Добро пожаловать на Форум Agrostory. Войдите или зарегистрируйтесь.

Today's Calendar Function

Code

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

Result

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

Всего пользователей: 21,950
Всего сообщений: 4,650
Всего тем: 194
Всего категорий: 3
Всего разделов: 14

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 Индийский чай оптом от дистрибьютора с завода

20 января 2023, 23:21 от Dmitriy1990
Украинский производитель и дистрибьютор чая ищет региональных дилеров для продажи индийского крепкого рассыпного чая по всем областям Украины. Мы чайное предприятие специализирующееся на фасовке и упаковке недорого крепкого чая по оптовым ценам.

Оптовые цены на чай «Ostwind»:

  • 30шт. - 24грн. + бесплатная доставка в любой город Украины
  • 60шт. - 23грн. + бесплатная доставка в любой город Украины
  • 120шт. - 22грн. + бесплатная доставка в любой город Украины
  • 180шт. - 21,50грн + бесплатная доставка
  • 240шт. - 21грн. + бесплатная доставка в любой город Украины

Если вы владелец розничной сети магазинов или дилер который ищет крепкий фасованный индийский чай оптом от дистрибьютора, позвоните нам по телефону в наш отдел продаж и мы ответим на все ваши вопросы касаемо оптовых цен и условий сотрудничества.

+380506049999 Дмитрий

Вы не можете просматривать это вложение.
2 комментариев | Написать комментарий

xx Дозаторы для фасовки

15 августа 2022, 07:57 от elanie
Transferring topic from the old forum
1 комментарий | Написать комментарий

xx Работа моей мечты

19 мая 2022, 16:56 от elanie
Transferring topic from the old forum
5 комментариев | Написать комментарий

xx Идея для бизнеса - обработка полей агродронами

20 января 2022, 10:35 от elanie
Transferring topic from the old forum
6 комментариев | Написать комментарий

xx Техника для сельского хозяйства kolnag.ru

31 августа 2021, 13:27 от elanie
Transferring topic from the old forum
2 комментариев | Написать комментарий

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 overridden 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> <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>

Result