0
|
1 |
<?php
|
|
2 |
/***********************************************************************
|
|
3 |
|
|
4 |
Copyright (C) 2002-2005 Rickard Andersson (rickard@punbb.org)
|
|
5 |
|
|
6 |
This file is part of PunBB.
|
|
7 |
|
|
8 |
PunBB is free software; you can redistribute it and/or modify it
|
|
9 |
under the terms of the GNU General Public License as published
|
|
10 |
by the Free Software Foundation; either version 2 of the License,
|
|
11 |
or (at your option) any later version.
|
|
12 |
|
|
13 |
PunBB is distributed in the hope that it will be useful, but
|
|
14 |
WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
15 |
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
16 |
GNU General Public License for more details.
|
|
17 |
|
|
18 |
You should have received a copy of the GNU General Public License
|
|
19 |
along with this program; if not, write to the Free Software
|
|
20 |
Foundation, Inc., 59 Temple Place, Suite 330, Boston,
|
|
21 |
MA 02111-1307 USA
|
|
22 |
|
|
23 |
************************************************************************
|
|
24 |
|
|
25 |
|
|
26 |
INSTRUCTIONS
|
|
27 |
|
|
28 |
This script is used to include information about your board from
|
|
29 |
pages outside the forums and to syndicate news about recent
|
|
30 |
discussions via RSS. The script can display a list of recent
|
|
31 |
discussions (sorted by post time or last post time), a list of
|
|
32 |
active users or a collection of general board statistics. The
|
|
33 |
script can be called directly via an URL (for RSS), from a PHP
|
|
34 |
include command or through the use of Server Side Includes (SSI).
|
|
35 |
|
|
36 |
The scripts behaviour is controlled via variables supplied in the
|
|
37 |
URL to the script. The different variables are: action (what to
|
|
38 |
output), show (how many topics to display), fid (the ID or ID's of
|
|
39 |
the forum(s) to poll for topics), nfid (the ID or ID's of forums
|
|
40 |
that should be excluded) and type (output as HTML or RSS). The
|
|
41 |
only mandatory variable is action. Possible/default values are:
|
|
42 |
|
|
43 |
action: active (show most recently active topics) (HTML or RSS)
|
|
44 |
new (show newest topics) (HTML or RSS)
|
|
45 |
online (show users online) (HTML)
|
|
46 |
online_full (as above, but includes a full list) (HTML)
|
|
47 |
stats (show board statistics) (HTML)
|
|
48 |
|
|
49 |
show: Any integer value between 1 and 50. This variables is
|
|
50 |
ignored for RSS output. The default is 15.
|
|
51 |
|
|
52 |
fid: One or more forum ID's (comma-separated). If ignored,
|
|
53 |
topics from all guest-readable forums will be polled.
|
|
54 |
|
|
55 |
nfid: One or more forum ID's (comma-separated) that are to be
|
|
56 |
excluded. E.g. the ID of a a test forum.
|
|
57 |
|
|
58 |
type: RSS. Anything else means HTML output.
|
|
59 |
|
|
60 |
Here are some examples using PHP include().
|
|
61 |
|
|
62 |
Show the 15 most recently active topics from all forums:
|
|
63 |
include('http://host.com/forums/extern.php?action=active');
|
|
64 |
|
|
65 |
Show the 10 newest topics from forums with ID 5, 6 and 7:
|
|
66 |
include('http://host.com/forums/extern.php?action=new&show=10&fid=5,6,7');
|
|
67 |
|
|
68 |
Show users online:
|
|
69 |
include('http://host.com/forums/extern.php?action=online');
|
|
70 |
|
|
71 |
Show users online with full listing of users:
|
|
72 |
include('http://host.com/forums/extern.php?action=online_full');
|
|
73 |
|
|
74 |
Show board statistics:
|
|
75 |
include('http://host.com/forums/extern.php?action=stats');
|
|
76 |
|
|
77 |
Here are some examples using SSI.
|
|
78 |
|
|
79 |
Show the 5 newest topics from forums with ID 11 and 22:
|
|
80 |
<!--#include virtual="forums/extern.php?action=new&show=5&fid=11,22" -->
|
|
81 |
|
|
82 |
Show board statistics:
|
|
83 |
<!--#include virtual="forums/extern.php?action=stats" -->
|
|
84 |
|
|
85 |
And finally some examples using extern.php to output an RSS 0.91
|
|
86 |
feed.
|
|
87 |
|
|
88 |
Output the 15 most recently active topics:
|
|
89 |
http://host.com/extern.php?action=active&type=RSS
|
|
90 |
|
|
91 |
Output the 15 newest topics from forum with ID=2:
|
|
92 |
http://host.com/extern.php?action=active&type=RSS&fid=2
|
|
93 |
|
|
94 |
Below you will find some variables you can edit to tailor the
|
|
95 |
scripts behaviour to your needs.
|
|
96 |
|
|
97 |
|
|
98 |
/***********************************************************************/
|
|
99 |
|
|
100 |
// The maximum number of topics that will be displayed
|
|
101 |
$show_max_topics = 60;
|
|
102 |
|
|
103 |
// The length at which topic subjects will be truncated (for HTML output)
|
|
104 |
$max_subject_length = 30;
|
|
105 |
|
|
106 |
/***********************************************************************/
|
|
107 |
|
|
108 |
// DO NOT EDIT ANYTHING BELOW THIS LINE! (unless you know what you are doing)
|
|
109 |
|
|
110 |
|
|
111 |
define('PUN_ROOT', './');
|
|
112 |
@include PUN_ROOT.'config.php';
|
|
113 |
|
|
114 |
// If PUN isn't defined, config.php is missing or corrupt
|
|
115 |
if (!defined('PUN'))
|
|
116 |
exit('The file \'config.php\' doesn\'t exist or is corrupt. Please run install.php to install PunBB first.');
|
|
117 |
|
|
118 |
|
|
119 |
// Make sure PHP reports all errors except E_NOTICE
|
|
120 |
error_reporting(E_ALL ^ E_NOTICE);
|
|
121 |
|
|
122 |
// Turn off magic_quotes_runtime
|
|
123 |
set_magic_quotes_runtime(0);
|
|
124 |
|
|
125 |
|
|
126 |
// Load the functions script
|
|
127 |
require PUN_ROOT.'include/functions.php';
|
|
128 |
|
|
129 |
// Load DB abstraction layer and try to connect
|
|
130 |
require PUN_ROOT.'include/dblayer/common_db.php';
|
|
131 |
|
|
132 |
// Load cached config
|
|
133 |
@include PUN_ROOT.'cache/cache_config.php';
|
|
134 |
if (!defined('PUN_CONFIG_LOADED'))
|
|
135 |
{
|
|
136 |
require PUN_ROOT.'include/cache.php';
|
|
137 |
generate_config_cache();
|
|
138 |
require PUN_ROOT.'cache/cache_config.php';
|
|
139 |
}
|
|
140 |
|
|
141 |
// Make sure we (guests) have permission to read the forums
|
|
142 |
$result = $db->query('SELECT g_read_board FROM '.$db->prefix.'groups WHERE g_id=3') or error('Unable to fetch group info', __FILE__, __LINE__, $db->error());
|
|
143 |
if ($db->result($result) == '0')
|
|
144 |
exit('No permission');
|
|
145 |
|
|
146 |
|
|
147 |
// Attempt to load the common language file
|
|
148 |
@include PUN_ROOT.'lang/'.$pun_config['o_default_lang'].'/common.php';
|
|
149 |
if (!isset($lang_common))
|
|
150 |
exit('There is no valid language pack \''.$pun_config['o_default_lang'].'\' installed. Please reinstall a language of that name.');
|
|
151 |
|
|
152 |
// Check if we are to display a maintenance message
|
|
153 |
if ($pun_config['o_maintenance'] && !defined('PUN_TURN_OFF_MAINT'))
|
|
154 |
maintenance_message();
|
|
155 |
|
|
156 |
if (!isset($_GET['action']))
|
|
157 |
exit('No parameters supplied. See extern.php for instructions.');
|
|
158 |
|
|
159 |
|
|
160 |
//
|
|
161 |
// Converts the CDATA end sequence ]]> into ]]>
|
|
162 |
//
|
|
163 |
function escape_cdata($str)
|
|
164 |
{
|
|
165 |
return str_replace(']]>', ']]>', $str);
|
|
166 |
}
|
|
167 |
|
|
168 |
|
|
169 |
//
|
|
170 |
// Show recent discussions
|
|
171 |
//
|
|
172 |
if ($_GET['action'] == 'active' || $_GET['action'] == 'new')
|
|
173 |
{
|
|
174 |
$order_by = ($_GET['action'] == 'active') ? 't.last_post' : 't.posted';
|
|
175 |
$forum_sql = '';
|
|
176 |
|
|
177 |
// Was any specific forum ID's supplied?
|
|
178 |
if (isset($_GET['fid']) && $_GET['fid'] != '')
|
|
179 |
{
|
|
180 |
$fids = explode(',', trim($_GET['fid']));
|
|
181 |
$fids = array_map('intval', $fids);
|
|
182 |
|
|
183 |
if (!empty($fids))
|
|
184 |
$forum_sql = ' AND f.id IN('.implode(',', $fids).')';
|
|
185 |
}
|
|
186 |
|
|
187 |
// Any forum ID's to exclude?
|
|
188 |
if (isset($_GET['nfid']) && $_GET['nfid'] != '')
|
|
189 |
{
|
|
190 |
$nfids = explode(',', trim($_GET['nfid']));
|
|
191 |
$nfids = array_map('intval', $nfids);
|
|
192 |
|
|
193 |
if (!empty($nfids))
|
|
194 |
$forum_sql = ' AND f.id NOT IN('.implode(',', $nfids).')';
|
|
195 |
}
|
|
196 |
|
|
197 |
// Should we output this as RSS?
|
|
198 |
if (isset($_GET['type']) && strtoupper($_GET['type']) == 'RSS')
|
|
199 |
{
|
|
200 |
$rss_description = ($_GET['action'] == 'active') ? $lang_common['RSS Desc Active'] : $lang_common['RSS Desc New'];
|
|
201 |
$url_action = ($_GET['action'] == 'active') ? '&action=new' : '';
|
|
202 |
|
|
203 |
// Send XML/no cache headers
|
|
204 |
header('Content-Type: text/xml');
|
|
205 |
header('Expires: '.gmdate('D, d M Y H:i:s').' GMT');
|
|
206 |
header('Cache-Control: must-revalidate, post-check=0, pre-check=0');
|
|
207 |
header('Pragma: public');
|
|
208 |
|
|
209 |
// It's time for some syndication!
|
|
210 |
echo '<?xml version="1.0" encoding="'.$lang_common['lang_encoding'].'"?>'."\r\n";
|
|
211 |
echo '<!DOCTYPE rss PUBLIC "-//Netscape Communications//DTD RSS 0.91//EN" "http://my.netscape.com/publish/formats/rss-0.91.dtd">'."\r\n";
|
|
212 |
echo '<rss version="0.91">'."\r\n";
|
|
213 |
echo '<channel>'."\r\n";
|
|
214 |
echo "\t".'<title>'.pun_htmlspecialchars($pun_config['o_board_title']).'</title>'."\r\n";
|
|
215 |
echo "\t".'<link>'.$pun_config['o_base_url'].'/</link>'."\r\n";
|
|
216 |
echo "\t".'<description>'.pun_htmlspecialchars($rss_description.' '.$pun_config['o_board_title']).'</description>'."\r\n";
|
|
217 |
echo "\t".'<language>en-us</language>'."\r\n";
|
|
218 |
|
|
219 |
// Fetch 15 topics
|
|
220 |
$result = $db->query('SELECT t.id, t.poster, t.subject, t.posted, t.last_post, f.id AS fid, f.forum_name FROM '.$db->prefix.'topics AS t INNER JOIN '.$db->prefix.'forums AS f ON f.id=t.forum_id LEFT JOIN '.$db->prefix.'forum_perms AS fp ON (fp.forum_id=f.id AND fp.group_id=3) WHERE (fp.read_forum IS NULL OR fp.read_forum=1) AND t.moved_to IS NULL'.$forum_sql.' ORDER BY '.$order_by.' DESC LIMIT 15') or error('Unable to fetch topic list', __FILE__, __LINE__, $db->error());
|
|
221 |
|
|
222 |
while ($cur_topic = $db->fetch_assoc($result))
|
|
223 |
{
|
|
224 |
if ($pun_config['o_censoring'] == '1')
|
|
225 |
$cur_topic['subject'] = censor_words($cur_topic['subject']);
|
|
226 |
|
|
227 |
echo "\t".'<item>'."\r\n";
|
|
228 |
echo "\t\t".'<title>'.pun_htmlspecialchars($cur_topic['subject']).'</title>'."\r\n";
|
|
229 |
echo "\t\t".'<link>'.$pun_config['o_base_url'].'/viewtopic.php?id='.$cur_topic['id'].$url_action.'</link>'."\r\n";
|
|
230 |
echo "\t\t".'<description><![CDATA['.escape_cdata($lang_common['Forum'].': <a href="'.$pun_config['o_base_url'].'/viewforum.php?id='.$cur_topic['fid'].'">'.$cur_topic['forum_name'].'</a><br />'."\r\n".$lang_common['Author'].': '.$cur_topic['poster'].'<br />'."\r\n".$lang_common['Posted'].': '.date('r', $cur_topic['posted']).'<br />'."\r\n".$lang_common['Last post'].': '.date('r', $cur_topic['last_post'])).']]></description>'."\r\n";
|
|
231 |
echo "\t".'</item>'."\r\n";
|
|
232 |
}
|
|
233 |
|
|
234 |
echo '</channel>'."\r\n";
|
|
235 |
echo '</rss>';
|
|
236 |
}
|
|
237 |
|
|
238 |
|
|
239 |
// Output regular HTML
|
|
240 |
else
|
|
241 |
{
|
|
242 |
$show = isset($_GET['show']) ? intval($_GET['show']) : 15;
|
|
243 |
if ($show < 1 || $show > 50)
|
|
244 |
$show = 15;
|
|
245 |
|
|
246 |
// Fetch $show topics
|
|
247 |
$result = $db->query('SELECT t.id, t.subject FROM '.$db->prefix.'topics AS t INNER JOIN '.$db->prefix.'forums AS f ON f.id=t.forum_id LEFT JOIN '.$db->prefix.'forum_perms AS fp ON (fp.forum_id=f.id AND fp.group_id=3) WHERE (fp.read_forum IS NULL OR fp.read_forum=1) AND t.moved_to IS NULL'.$forum_sql.' ORDER BY '.$order_by.' DESC LIMIT '.$show) or error('Unable to fetch topic list', __FILE__, __LINE__, $db->error());
|
|
248 |
|
|
249 |
while ($cur_topic = $db->fetch_assoc($result))
|
|
250 |
{
|
|
251 |
if ($pun_config['o_censoring'] == '1')
|
|
252 |
$cur_topic['subject'] = censor_words($cur_topic['subject']);
|
|
253 |
|
|
254 |
if (pun_strlen($cur_topic['subject']) > $max_subject_length)
|
|
255 |
$subject_truncated = pun_htmlspecialchars(trim(substr($cur_topic['subject'], 0, ($max_subject_length-5)))).' …';
|
|
256 |
else
|
|
257 |
$subject_truncated = pun_htmlspecialchars($cur_topic['subject']);
|
|
258 |
|
|
259 |
echo '<li><a href="'.$pun_config['o_base_url'].'/viewtopic.php?id='.$cur_topic['id'].'&action=new" title="'.pun_htmlspecialchars($cur_topic['subject']).'">'.$subject_truncated.'</a></li>'."\n";
|
|
260 |
}
|
|
261 |
}
|
|
262 |
|
|
263 |
return;
|
|
264 |
}
|
|
265 |
|
|
266 |
|
|
267 |
//
|
|
268 |
// Show users online
|
|
269 |
//
|
|
270 |
else if ($_GET['action'] == 'online' || $_GET['action'] == 'online_full')
|
|
271 |
{
|
|
272 |
// Load the index.php language file
|
|
273 |
require PUN_ROOT.'lang/'.$pun_config['o_default_lang'].'/index.php';
|
|
274 |
|
|
275 |
// Fetch users online info and generate strings for output
|
|
276 |
$num_guests = $num_users = 0;
|
|
277 |
$users = array();
|
|
278 |
$result = $db->query('SELECT user_id, ident FROM '.$db->prefix.'online WHERE idle=0 ORDER BY ident', true) or error('Unable to fetch online list', __FILE__, __LINE__, $db->error());
|
|
279 |
|
|
280 |
while ($pun_user_online = $db->fetch_assoc($result))
|
|
281 |
{
|
|
282 |
if ($pun_user_online['user_id'] > 1)
|
|
283 |
{
|
|
284 |
$users[] = '<a href="'.$pun_config['o_base_url'].'/profile.php?id='.$pun_user_online['user_id'].'">'.pun_htmlspecialchars($pun_user_online['ident']).'</a>';
|
|
285 |
++$num_users;
|
|
286 |
}
|
|
287 |
else
|
|
288 |
++$num_guests;
|
|
289 |
}
|
|
290 |
|
|
291 |
echo $lang_index['Guests online'].': '.$num_guests.'<br />';
|
|
292 |
|
|
293 |
if ($_GET['action'] == 'online_full')
|
|
294 |
echo $lang_index['Users online'].': '.implode(', ', $users).'<br />';
|
|
295 |
else
|
|
296 |
echo $lang_index['Users online'].': '.$num_users.'<br />';
|
|
297 |
|
|
298 |
return;
|
|
299 |
}
|
|
300 |
|
|
301 |
|
|
302 |
//
|
|
303 |
// Show board statistics
|
|
304 |
//
|
|
305 |
else if ($_GET['action'] == 'stats')
|
|
306 |
{
|
|
307 |
// Load the index.php language file
|
|
308 |
require PUN_ROOT.'lang/'.$pun_config['o_default_lang'].'/index.php';
|
|
309 |
|
|
310 |
// Collect some statistics from the database
|
|
311 |
$result = $db->query('SELECT COUNT(id)-1 FROM '.$db->prefix.'users') or error('Unable to fetch total user count', __FILE__, __LINE__, $db->error());
|
|
312 |
$stats['total_users'] = $db->result($result);
|
|
313 |
|
|
314 |
$result = $db->query('SELECT id, username FROM '.$db->prefix.'users ORDER BY registered DESC LIMIT 1') or error('Unable to fetch newest registered user', __FILE__, __LINE__, $db->error());
|
|
315 |
$stats['last_user'] = $db->fetch_assoc($result);
|
|
316 |
|
|
317 |
$result = $db->query('SELECT SUM(num_topics), SUM(num_posts) FROM '.$db->prefix.'forums') or error('Unable to fetch topic/post count', __FILE__, __LINE__, $db->error());
|
|
318 |
list($stats['total_topics'], $stats['total_posts']) = $db->fetch_row($result);
|
|
319 |
|
|
320 |
echo $lang_index['No of users'].': '.$stats['total_users'].'<br />';
|
|
321 |
echo $lang_index['Newest user'].': <a href="'.$pun_config['o_base_url'].'/profile.php?id='.$stats['last_user']['id'].'">'.pun_htmlspecialchars($stats['last_user']['username']).'</a><br />';
|
|
322 |
echo $lang_index['No of topics'].': '.$stats['total_topics'].'<br />';
|
|
323 |
echo $lang_index['No of posts'].': '.$stats['total_posts'];
|
|
324 |
|
|
325 |
return;
|
|
326 |
}
|
|
327 |
|
|
328 |
|
|
329 |
else
|
|
330 |
exit('Bad request');
|