SMF SSI.php Functions
Current Version: 2.0 RC3
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
| [أخبار شعب آشور] | رئيس أساقفة كركوك: مقتل ألف مسيحي منذ 2003 وأميركا مسؤولة عما يحدث بواسطة Assyria | الأمس في 11:25:21 |
| [ Iraq News] | U.S. drone down in Diala بواسطة NINEVEH | الأمس في 10:53:44 |
| [ Iraq News] | Robert Gates in Baghdad بواسطة NINEVEH | الأمس في 10:51:37 |
| [أخبار العراق] | العراقية: لا خلاف بين علاوي والمطلك بواسطة Assyria | الأمس في 10:47:15 |
| [أخبار العراق] | الشمري يحمل الحكومة المركزية مسؤولية تدهور الأوضاع الأمنية في الموصل بواسطة Assyria | الأمس في 10:44:07 |
| [أخبار العراق] | مقتل أحد مهربي الآثار وضبط 13 قطعة أثرية غرب الموصل بواسطة Assyria | الأمس في 10:40:31 |
| [أخبار العراق] | الإعلان رسمياً عن تكتل "التيار الوطني المعتدل" داخل القائمة العراقية بواسطة Assyria | الأمس في 10:33:45 |
| [أخبار العراق] | قناص يقتل جندي أمريكي وسط تكريت بواسطة Assyria | آب 31, 2010, 08:14:04 |
Recent Posts Function
Code
<?php ssi_recentPosts(); ?>
Result
| [أخبار شعب آشور] | رئيس أساقفة كركوك: مقتل ألف مسيحي منذ 2003 وأميركا مسؤولة عما يحدث بواسطة Assyria | الأمس في 11:25:21 |
| [ Iraq News] | U.S. drone down in Diala بواسطة NINEVEH | الأمس في 10:53:44 |
| [ Iraq News] | Robert Gates in Baghdad بواسطة NINEVEH | الأمس في 10:51:37 |
| [أخبار العراق] | العراقية: لا خلاف بين علاوي والمطلك بواسطة Assyria | الأمس في 10:47:15 |
| [أخبار العراق] | الشمري يحمل الحكومة المركزية مسؤولية تدهور الأوضاع الأمنية في الموصل بواسطة Assyria | الأمس في 10:44:07 |
| [أخبار العراق] | مقتل أحد مهربي الآثار وضبط 13 قطعة أثرية غرب الموصل بواسطة Assyria | الأمس في 10:40:31 |
| [أخبار العراق] | الإعلان رسمياً عن تكتل "التيار الوطني المعتدل" داخل القائمة العراقية بواسطة Assyria | الأمس في 10:33:45 |
| [أخبار العراق] | قناص يقتل جندي أمريكي وسط تكريت بواسطة Assyria | آب 31, 2010, 08:14:04 |
Top Boards Function
Shows top boards by the number of posts.
Code
<?php ssi_topBoards(); ?>
Result
| منتدى | مواضيع | مشاركات |
|---|---|---|
أخبار العراق ![]() |
2161 | 2161 |
Iraq News ![]() |
1123 | 1123 |
أخبار شعب آشور ![]() |
137 | 137 |
Assyria News ![]() |
97 | 97 |
مقالات مختارة ![]() |
89 | 89 |
المنبر الحر ![]() |
48 | 48 |
Political Discussion ![]() |
31 | 31 |
Assyrian Educational ![]() |
17 | 17 |
المنبر الثقافي ![]() |
13 | 13 |
Articles of Interest ![]() |
13 | 13 |
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 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
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
إجمالي المشاركات: 3751
إجمالي المواضيع: 3751
إجمالي التصنيفات: 2
إجمالي المنتديات: 16
Board News Function
Shows the latest posts from read only boards, or a specific board.
Code
<?php ssi_boardNews(); ?>
Result
رئيس أساقفة كركوك: مقتل ألف مسيحي منذ 2003 وأميركا مسؤولة عما يحدث
كرخ سلوخ الآشورية (كركوك) / بلاد آشور - العراق
01-09-2010
أكد رئيس أساقفة كركوك للطائفة الكلدانية لويس ساكو أن ألف شخص من المسيحيين قتلوا جراء أعمال العنف التي ضربت مناطق مختلفة في العراق منذ 2003 محملاً القوات الأميركية مسؤولية ما حصل في البلاد من ترد في الأوضاع على كافة الأصعدة وقال لويس ساكو إن "عمليات استهداف المسيحيين في العراق إرتفعت بشكل عام بعد 2003 إذ تم تسجيل مقتل قرابة ألف مسيحي في مختلف محافظات البلاد وحدثت أكبر أعمال العنف ضدهم في مدينة الموصل وبخاصة في عام 2008" مشيراً الى أنه "تم خطف وقتل رئيس أساقفة الموصل المطران فرج رحو وتهجير وفرار أكثر من ثلاثة آلاف أسرة من المدينة" وأضاف ساكو أن "حالات اختطاف المسيحيين ازدادت في الآونة الأخيرة إما لكسب المال من قبل اللصوص وعصابات الخطف أو لممارسة ضغوط سياسية لإفراغ البلد من المسيحيين" مشيراً الى أنه "قبل عام 2003 كان عدد المسيحيين في العراق يتراوح بين 750 الى 800 ألف نسمة وبعد عام 2003 أصبح عددهم قرابة 400 ألف نسمة قتل منهم ألف مدني وتعرض عدد منهم الى الخطف والمساومة المالية" وأكد رئيس أساقفة كركوك أن "الحكومة غير قادرة على توفير الحماية للبلاد بعد انسحاب القوات الأميركية" مبيناً أن "الأقليات ومنها المسيحيين متخوفون من المستقبل وأننا نراقب بانتظار وخوف وقلق المجهول ولا توجد رؤيا واضحة لمستقبل الأقليات في البلاد".
ينتمي أغلبية مسيحيي العراق الى الأمة الآشورية المتعددة الكنائس ولمذاهب مسيحية مختلفة وقد تعرضوا منذ الغزو الأميركي للعراق في آذار 2003 الى شتى أعمال العنف وبما انهم الحلقة الأضعف في الفسيفساء العراقية فقد تم تجاهلهم وتهميشهم من قبل السلطات التي تحكم العراق الآن سواء كانت المحلية او الغربية وسط تعتيم إعلامي وتجاهل سياسي.
وكالات
العثور على جثة الشاب المخطوف من الحمدانية في منطقة النمرود
نينوى / بلاد آشور - العراق
27-08-2010
أعلنت مصادر أمنية وأخرى طبية العثور على جثة شاب آشوري بعد ظهر الجمعة بعد أن تم اختطافه الجمعة الماضية من بلدة الحمدانية شرق مدينة الموصل وأكد المقدم محمد عمر الجبوري من شرطة الموصل "العثور على جثة الشاب الآشوري لؤي بهنام الملك (35 عاماً) مقتولاً بالرصاص بعد اختطافه الجمعة الماضية" مضيفاً أن "جثة الملك الذي وجد مقتولاً بالرصاص في الرأس وجدت في أرض قاحلة في منطقة النمرود جنوب الموصل واشار الجبوري الى ان "عائلة الضحية تفاوضت سرياً مع الخاطفين ودفعت لهم مبلغ 15 ألف دولار دون أن يبلغوا الشرطة على أمل ضمان عودة إبنهم الثلاثاء الماضي ولكن دون جدوى.
وكالات
حریق كبیر یشب في 04 قری زراعية ضمن الحدود الجغرافية لقضاء " العمادية"
العمادية - نوهدرا - آشور المحتلة / شمال العراق
24-08-2010
شب بعد ظهر اليوم الثلاثاء حريق كبير في عدد من القرى التابعة لقضاء "العمادية" الحق خسائر مادية كبيرة بالمزارعين وأصحاب المزارع وأفاد شهود عيان أن حريقاً كبيراً نشب في المنطقة منذ أربعة أيام في 04 قرى ضمن الحدود الجغرافية لقضاء "العمادية" والتهمت النيران بقايا قش في الآلاف الدونمات من الأراضي الزراعية وكذلك أشجار الكروم والفاكهة في عدد من مزارع وبساتين فلاحي المنطقة وأشار الشهود الى وقوع أضرارمادية كبيرة وأن فرق الإطفاء وبمساعدة الأهالي لم تستطع السيطرة على الحريق بشكل تام مؤكدين في الوقت نفسه عدم معرفة أسباب اندلاع الحريق .
مصادر
مسلحون مجهولون يختطفون مواطن آشوري وسط كركوك
كرخ سلوخ الآشورية - بلاد آشور - العراق
01-08-2010
أفاد مصدر أمني في كركوك بأن مجموعة مسلحة قامت باختطاف مواطن آشوري وسط كركوك وقال المصدر إن "مجموعة مسلحة تستقل سيارة حديثة مجهولة اللوحات قامت في وقت متقدم من مساء الجمعة بخطف المواطن يونان دانيال ممو ويعمل محاسباً في محل للصيرفة في منطقة شارع الجمهورية وسط مدينة كركوك"وأضاف المصدر الذي طلب عدم الكشف عن اسمه أن "القوات الأمنية طوقت المنطقة وباشرت بالتحقيق لمعرفة ملابسات الحادث" وعلم بأن المواطن المخطوف من سكنة حي المعلمين في منطقة رحيم أوا شمال شرقي المدينة.
وكالات
العثور على مصطبة حجرية تعود الى القرن الثالث الميلادي في عقرة
عقرة - آشور المحتلة - شمال العراق
20/07/2010
عثرت دائرة الآثار في قضاء عقرة التابع لمحافظة نوهدرا الآشورية (دهوك) على مصطبة حجرية أثرية يعود تاريخها الى القرن الثالث الميلادي وقال مدير دائرة الآثار في القضاء عمر حسين إن طول المصطبة يبلغ تقريباً متراً ونصف المتر وعرضها 15 سنتيمتراً ومنحوتة بعلامات الصليب من ثلاثة إتجاهات ومكان وضع الإنجيل مبين فيها وأشار حسين إلى أن الإكتشاف دليل على قدم منطقة عقرة وتم نقل المصطبة الى دائرة الآثار في القضاء وجدير بالذكر أن عقرة تضم 15 كنيسة أقدمها "كنيسة القديسة مريم العذراء" التي يعود تاريخها الى القرن الثاني الميلادي.
وكالات
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>
