in case we do: include(bootstrap) ... include(common)
[phpbb.git] / phpBB / mcp.php
blobdb77fee8c82bd6c716be3ea7fe4ce47759ddcbee
1 <?php
2 /**
4 * @package mcp
5 * @version $Id$
6 * @copyright (c) 2005 phpBB Group
7 * @license http://opensource.org/licenses/gpl-license.php GNU Public License
9 */
11 /**
12 * @ignore
14 define('IN_PHPBB', true);
15 if (!defined('PHPBB_ROOT_PATH')) define('PHPBB_ROOT_PATH', './');
16 if (!defined('PHP_EXT')) define('PHP_EXT', substr(strrchr(__FILE__, '.'), 1));
17 include(PHPBB_ROOT_PATH . 'common.' . PHP_EXT);
18 include(PHPBB_ROOT_PATH . 'includes/functions_admin.' . PHP_EXT);
19 require(PHPBB_ROOT_PATH . 'includes/functions_module.' . PHP_EXT);
21 // Start session management
22 $user->session_begin();
23 $auth->acl($user->data);
24 $user->setup('mcp');
26 $module = new p_master();
28 // Setting a variable to let the style designer know where he is...
29 $template->assign_var('S_IN_MCP', true);
31 // Basic parameter data
32 $id = request_var('i', '');
34 $mode = request_var('mode', array(''));
35 if (!empty($mode))
37 $mode = key($mode);
39 else
41 $mode = request_var('mode', '');
44 // Only Moderators can go beyond this point
45 if (!$user->data['is_registered'])
47 if ($user->data['is_bot'])
49 redirect(append_sid(PHPBB_ROOT_PATH . 'index.' . PHP_EXT));
52 login_box('', $user->lang['LOGIN_EXPLAIN_MCP']);
55 $quickmod = phpbb_request::is_set('quickmod');
56 $action = request_var('action', '');
57 $action_ary = request_var('action', array('' => 0));
58 $forum_action = request_var('forum_action', '');
60 if (sizeof($action_ary))
62 $action = key($action_ary);
64 else if (!empty($forum_action) && phpbb_request::variable('sort', false, false, phpbb_request::POST))
66 $action = $forum_action;
68 unset($action_ary);
70 if ($mode == 'topic_logs')
72 $id = 'logs';
73 $quickmod = false;
76 $post_id = request_var('p', 0);
77 $topic_id = request_var('t', 0);
78 $forum_id = request_var('f', 0);
79 $user_id = request_var('u', 0);
80 $username = utf8_normalize_nfc(request_var('username', '', true));
82 if ($post_id)
84 // We determine the topic and forum id here, to make sure the moderator really has moderative rights on this post
85 $sql = 'SELECT topic_id, forum_id
86 FROM ' . POSTS_TABLE . "
87 WHERE post_id = $post_id";
88 $result = $db->sql_query($sql);
89 $row = $db->sql_fetchrow($result);
90 $db->sql_freeresult($result);
92 $topic_id = (int) $row['topic_id'];
93 $forum_id = (int) ($row['forum_id']) ? $row['forum_id'] : $forum_id;
95 else if ($topic_id)
97 $sql = 'SELECT forum_id
98 FROM ' . TOPICS_TABLE . "
99 WHERE topic_id = $topic_id";
100 $result = $db->sql_query($sql);
101 $row = $db->sql_fetchrow($result);
102 $db->sql_freeresult($result);
104 $forum_id = (int) $row['forum_id'];
107 // If the user doesn't have any moderator powers (globally or locally) he can't access the mcp
108 if (!$auth->acl_getf_global('m_'))
110 // Except he is using one of the quickmod tools for users
111 $user_quickmod_actions = array(
112 'lock' => 'f_user_lock',
113 'make_sticky' => 'f_sticky',
114 'make_announce' => 'f_announce',
115 'make_global' => 'f_announce',
116 'make_normal' => array('f_announce', 'f_sticky')
119 $allow_user = false;
120 if ($quickmod && isset($user_quickmod_actions[$action]) && $user->data['is_registered'] && $auth->acl_gets($user_quickmod_actions[$action], $forum_id))
122 $topic_info = get_topic_data(array($topic_id));
123 if ($topic_info[$topic_id]['topic_poster'] == $user->data['user_id'])
125 $allow_user = true;
129 if (!$allow_user)
131 trigger_error('NOT_AUTHORISED');
135 // if the user cannot read the forum he tries to access then we won't allow mcp access either
136 if ($forum_id && !$auth->acl_get('f_read', $forum_id))
138 trigger_error('NOT_AUTHORISED');
141 if ($forum_id)
143 $module->acl_forum_id = $forum_id;
146 // Instantiate module system and generate list of available modules
147 $module->list_modules('mcp');
149 if ($quickmod)
151 $mode = 'quickmod';
153 switch ($action)
155 case 'lock':
156 case 'unlock':
157 case 'lock_post':
158 case 'unlock_post':
159 case 'make_sticky':
160 case 'make_announce':
161 case 'make_global':
162 case 'make_normal':
163 case 'fork':
164 case 'move':
165 case 'delete_post':
166 case 'delete_topic':
167 $module->load('mcp', 'main', 'quickmod');
168 return;
169 break;
171 case 'topic_logs':
172 $module->set_active('logs', 'topic_logs');
173 break;
175 case 'merge_topic':
176 $module->set_active('main', 'forum_view');
177 break;
179 case 'split':
180 case 'merge':
181 $module->set_active('main', 'topic_view');
182 break;
184 default:
185 trigger_error("$action not allowed as quickmod", E_USER_ERROR);
186 break;
189 else
191 // Select the active module
192 $module->set_active($id, $mode);
195 // Hide some of the options if we don't have the relevant information to use them
196 if (!$post_id)
198 $module->set_display('main', 'post_details', false);
199 $module->set_display('warn', 'warn_post', false);
202 if ($mode == '' || $mode == 'unapproved_topics' || $mode == 'unapproved_posts')
204 $module->set_display('queue', 'approve_details', false);
207 if ($mode == '' || $mode == 'reports' || $mode == 'reports_closed')
209 $module->set_display('reports', 'report_details', false);
212 if (!$topic_id)
214 $module->set_display('main', 'topic_view', false);
215 $module->set_display('logs', 'topic_logs', false);
218 if (!$forum_id)
220 $module->set_display('main', 'forum_view', false);
221 $module->set_display('logs', 'forum_logs', false);
224 if (!$user_id && $username == '')
226 $module->set_display('notes', 'user_notes', false);
227 $module->set_display('warn', 'warn_user', false);
230 // Load and execute the relevant module
231 $module->load_active();
233 // Assign data to the template engine for the list of modules
234 $module->assign_tpl_vars(append_sid(PHPBB_ROOT_PATH . 'mcp.' . PHP_EXT));
236 // Generate urls for letting the moderation control panel being accessed in different modes
237 $template->assign_vars(array(
238 'U_MCP' => append_sid('mcp', 'i=main'),
239 'U_MCP_FORUM' => ($forum_id) ? append_sid('mcp', "i=main&amp;mode=forum_view&amp;f=$forum_id") : '',
240 'U_MCP_TOPIC' => ($forum_id && $topic_id) ? append_sid('mcp', "i=main&amp;mode=topic_view&amp;t=$topic_id") : '',
241 'U_MCP_POST' => ($forum_id && $topic_id && $post_id) ? append_sid('mcp', "i=main&amp;mode=post_details&amp;t=$topic_id&amp;p=$post_id") : '',
244 // Generate the page, do not display/query online list
245 $module->display($module->get_page_title(), false);
248 * Functions used to generate additional URL paramters
250 function _module__url($mode, &$module_row)
252 return extra_url();
255 function _module_notes_url($mode, &$module_row)
257 if ($mode == 'front')
259 return '';
262 global $user_id;
263 return ($user_id) ? "&amp;u=$user_id" : '';
266 function _module_warn_url($mode, &$module_row)
268 if ($mode == 'front' || $mode == 'list')
270 global $forum_id;
272 return ($forum_id) ? "&amp;f=$forum_id" : '';
275 if ($mode == 'warn_post')
277 global $forum_id, $post_id;
279 $url_extra = ($forum_id) ? "&amp;f=$forum_id" : '';
280 $url_extra .= ($post_id) ? "&amp;p=$post_id" : '';
282 return $url_extra;
284 else
286 global $user_id;
288 return ($user_id) ? "&amp;u=$user_id" : '';
292 function _module_main_url($mode, &$module_row)
294 return extra_url();
297 function _module_logs_url($mode, &$module_row)
299 return extra_url();
302 function _module_ban_url($mode, &$module_row)
304 return extra_url();
307 function _module_queue_url($mode, &$module_row)
309 return extra_url();
312 function _module_reports_url($mode, &$module_row)
314 return extra_url();
317 function extra_url()
319 global $forum_id, $topic_id, $post_id, $user_id;
321 $url_extra = '';
322 $url_extra .= ($forum_id) ? "&amp;f=$forum_id" : '';
323 $url_extra .= ($topic_id) ? "&amp;t=$topic_id" : '';
324 $url_extra .= ($post_id) ? "&amp;p=$post_id" : '';
325 $url_extra .= ($user_id) ? "&amp;u=$user_id" : '';
327 return $url_extra;
331 * Get simple topic data
333 function get_topic_data($topic_ids, $acl_list = false, $read_tracking = false)
335 global $auth, $db, $user;
336 static $rowset = array();
338 $topics = array();
340 if (!sizeof($topic_ids))
342 return array();
345 // cache might not contain read tracking info, so we can't use it if read
346 // tracking information is requested
347 if (!$read_tracking)
349 $cache_topic_ids = array_intersect($topic_ids, array_keys($rowset));
350 $topic_ids = array_diff($topic_ids, array_keys($rowset));
352 else
354 $cache_topic_ids = array();
357 if (sizeof($topic_ids))
359 $sql_array = array(
360 'SELECT' => 't.*, f.*',
362 'FROM' => array(
363 TOPICS_TABLE => 't',
366 'LEFT_JOIN' => array(
367 array(
368 'FROM' => array(FORUMS_TABLE => 'f'),
369 'ON' => 'f.forum_id = t.forum_id'
373 'WHERE' => $db->sql_in_set('t.topic_id', $topic_ids)
376 if ($read_tracking && phpbb::$config['load_db_lastread'])
378 $sql_array['SELECT'] .= ', tt.mark_time, ft.mark_time as forum_mark_time';
380 $sql_array['LEFT_JOIN'][] = array(
381 'FROM' => array(TOPICS_TRACK_TABLE => 'tt'),
382 'ON' => 'tt.user_id = ' . $user->data['user_id'] . ' AND t.topic_id = tt.topic_id'
385 $sql_array['LEFT_JOIN'][] = array(
386 'FROM' => array(FORUMS_TRACK_TABLE => 'ft'),
387 'ON' => 'ft.user_id = ' . $user->data['user_id'] . ' AND t.forum_id = ft.forum_id'
391 $sql = $db->sql_build_query('SELECT', $sql_array);
392 $result = $db->sql_query($sql);
394 while ($row = $db->sql_fetchrow($result))
396 if (!$row['forum_id'])
398 // Global Announcement?
399 $row['forum_id'] = request_var('f', 0);
402 $rowset[$row['topic_id']] = $row;
404 if ($acl_list && !$auth->acl_gets($acl_list, $row['forum_id']))
406 continue;
409 $topics[$row['topic_id']] = $row;
411 $db->sql_freeresult($result);
414 foreach ($cache_topic_ids as $id)
416 if (!$acl_list || $auth->acl_gets($acl_list, $rowset[$id]['forum_id']))
418 $topics[$id] = $rowset[$id];
422 return $topics;
426 * Get simple post data
428 function get_post_data($post_ids, $acl_list = false, $read_tracking = false)
430 global $db, $auth, $user;
432 $rowset = array();
434 if (!sizeof($post_ids))
436 return array();
439 $sql_array = array(
440 'SELECT' => 'p.*, u.*, t.*, f.*',
442 'FROM' => array(
443 USERS_TABLE => 'u',
444 POSTS_TABLE => 'p',
445 TOPICS_TABLE => 't',
448 'LEFT_JOIN' => array(
449 array(
450 'FROM' => array(FORUMS_TABLE => 'f'),
451 'ON' => 'f.forum_id = t.forum_id'
455 'WHERE' => $db->sql_in_set('p.post_id', $post_ids) . '
456 AND u.user_id = p.poster_id
457 AND t.topic_id = p.topic_id',
460 if ($read_tracking && phpbb::$config['load_db_lastread'])
462 $sql_array['SELECT'] .= ', tt.mark_time, ft.mark_time as forum_mark_time';
464 $sql_array['LEFT_JOIN'][] = array(
465 'FROM' => array(TOPICS_TRACK_TABLE => 'tt'),
466 'ON' => 'tt.user_id = ' . $user->data['user_id'] . ' AND t.topic_id = tt.topic_id'
469 $sql_array['LEFT_JOIN'][] = array(
470 'FROM' => array(FORUMS_TRACK_TABLE => 'ft'),
471 'ON' => 'ft.user_id = ' . $user->data['user_id'] . ' AND t.forum_id = ft.forum_id'
475 $sql = $db->sql_build_query('SELECT', $sql_array);
476 $result = $db->sql_query($sql);
477 unset($sql_array);
479 while ($row = $db->sql_fetchrow($result))
481 if (!$row['forum_id'])
483 // Global Announcement?
484 $row['forum_id'] = request_var('f', 0);
487 if ($acl_list && !$auth->acl_gets($acl_list, $row['forum_id']))
489 continue;
492 if (!$row['post_approved'] && !$auth->acl_get('m_approve', $row['forum_id']))
494 // Moderators without the permission to approve post should at least not see them. ;)
495 continue;
498 $rowset[$row['post_id']] = $row;
500 $db->sql_freeresult($result);
502 return $rowset;
506 * Get simple forum data
508 function get_forum_data($forum_id, $acl_list = 'f_list', $read_tracking = false)
510 global $auth, $db, $user;
512 $rowset = array();
514 if (!is_array($forum_id))
516 $forum_id = array($forum_id);
519 if (!sizeof($forum_id))
521 return array();
524 if ($read_tracking && phpbb::$config['load_db_lastread'])
526 $read_tracking_join = ' LEFT JOIN ' . FORUMS_TRACK_TABLE . ' ft ON (ft.user_id = ' . $user->data['user_id'] . '
527 AND ft.forum_id = f.forum_id)';
528 $read_tracking_select = ', ft.mark_time';
530 else
532 $read_tracking_join = $read_tracking_select = '';
535 $sql = "SELECT f.* $read_tracking_select
536 FROM " . FORUMS_TABLE . " f$read_tracking_join
537 WHERE " . $db->sql_in_set('f.forum_id', $forum_id);
538 $result = $db->sql_query($sql);
540 while ($row = $db->sql_fetchrow($result))
542 if ($acl_list && !$auth->acl_gets($acl_list, $row['forum_id']))
544 continue;
547 if ($auth->acl_get('m_approve', $row['forum_id']))
549 $row['forum_topics'] = $row['forum_topics_real'];
552 $rowset[$row['forum_id']] = $row;
554 $db->sql_freeresult($result);
556 return $rowset;
560 * sorting in mcp
562 * @param string $where_sql should either be WHERE (default if ommited) or end with AND or OR
564 function mcp_sorting($mode, &$sort_days, &$sort_key, &$sort_dir, &$sort_by_sql, &$sort_order_sql, &$total, $forum_id = 0, $topic_id = 0, $where_sql = 'WHERE')
566 global $db, $user, $auth, $template;
568 $sort_days = request_var('st', 0);
569 $min_time = ($sort_days) ? time() - ($sort_days * 86400) : 0;
571 switch ($mode)
573 case 'viewforum':
574 $type = 'topics';
575 $default_key = 't';
576 $default_dir = 'd';
578 $sql = 'SELECT COUNT(topic_id) AS total
579 FROM ' . TOPICS_TABLE . "
580 $where_sql forum_id = $forum_id
581 AND topic_type NOT IN (" . POST_ANNOUNCE . ', ' . POST_GLOBAL . ")
582 AND topic_last_post_time >= $min_time";
584 if (!$auth->acl_get('m_approve', $forum_id))
586 $sql .= 'AND topic_approved = 1';
588 break;
590 case 'viewtopic':
591 $type = 'posts';
592 $default_key = 't';
593 $default_dir = 'a';
595 $sql = 'SELECT COUNT(post_id) AS total
596 FROM ' . POSTS_TABLE . "
597 $where_sql topic_id = $topic_id
598 AND post_time >= $min_time";
600 if (!$auth->acl_get('m_approve', $forum_id))
602 $sql .= 'AND post_approved = 1';
604 break;
606 case 'unapproved_posts':
607 $type = 'posts';
608 $default_key = 't';
609 $default_dir = 'd';
610 $where_sql .= ($topic_id) ? ' topic_id = ' . $topic_id . ' AND' : '';
612 $sql = 'SELECT COUNT(post_id) AS total
613 FROM ' . POSTS_TABLE . "
614 $where_sql " . $db->sql_in_set('forum_id', ($forum_id) ? array($forum_id) : array_intersect(get_forum_list('f_read'), get_forum_list('m_approve'))) . '
615 AND post_approved = 0';
617 if ($min_time)
619 $sql .= ' AND post_time >= ' . $min_time;
621 break;
623 case 'unapproved_topics':
624 $type = 'topics';
625 $default_key = 't';
626 $default_dir = 'd';
628 $sql = 'SELECT COUNT(topic_id) AS total
629 FROM ' . TOPICS_TABLE . "
630 $where_sql " . $db->sql_in_set('forum_id', ($forum_id) ? array($forum_id) : array_intersect(get_forum_list('f_read'), get_forum_list('m_approve'))) . '
631 AND topic_approved = 0';
633 if ($min_time)
635 $sql .= ' AND topic_time >= ' . $min_time;
637 break;
639 case 'reports':
640 case 'reports_closed':
641 $type = 'reports';
642 $default_key = 't';
643 $default_dir = 'd';
644 $limit_time_sql = ($min_time) ? "AND r.report_time >= $min_time" : '';
646 if ($topic_id)
648 $where_sql .= ' p.topic_id = ' . $topic_id;
650 else if ($forum_id)
652 $where_sql .= ' p.forum_id = ' . $forum_id;
654 else
656 $where_sql .= ' ' . $db->sql_in_set('p.forum_id', get_forum_list(array('!f_read', '!m_report')), true, true);
659 if ($mode == 'reports')
661 $where_sql .= ' AND r.report_closed = 0';
663 else
665 $where_sql .= ' AND r.report_closed = 1';
668 $sql = 'SELECT COUNT(r.report_id) AS total
669 FROM ' . REPORTS_TABLE . ' r, ' . POSTS_TABLE . " p
670 $where_sql
671 AND p.post_id = r.post_id
672 $limit_time_sql";
673 break;
675 case 'viewlogs':
676 $type = 'logs';
677 $default_key = 't';
678 $default_dir = 'd';
680 $sql = 'SELECT COUNT(log_id) AS total
681 FROM ' . LOG_TABLE . "
682 $where_sql " . $db->sql_in_set('forum_id', ($forum_id) ? array($forum_id) : array_intersect(get_forum_list('f_read'), get_forum_list('m_'))) . '
683 AND log_time >= ' . $min_time . '
684 AND log_type = ' . LOG_MOD;
685 break;
688 $sort_key = request_var('sk', $default_key);
689 $sort_dir = request_var('sd', $default_dir);
690 $sort_dir_text = array('a' => $user->lang['ASCENDING'], 'd' => $user->lang['DESCENDING']);
692 switch ($type)
694 case 'topics':
695 $limit_days = array(0 => $user->lang['ALL_TOPICS'], 1 => $user->lang['1_DAY'], 7 => $user->lang['7_DAYS'], 14 => $user->lang['2_WEEKS'], 30 => $user->lang['1_MONTH'], 90 => $user->lang['3_MONTHS'], 180 => $user->lang['6_MONTHS'], 365 => $user->lang['1_YEAR']);
696 $sort_by_text = array('a' => $user->lang['AUTHOR'], 't' => $user->lang['POST_TIME'], 'tt' => $user->lang['TOPIC_TIME'], 'r' => $user->lang['REPLIES'], 's' => $user->lang['SUBJECT'], 'v' => $user->lang['VIEWS']);
698 $sort_by_sql = array('a' => 't.topic_first_poster_name', 't' => 't.topic_last_post_time', 'tt' => 't.topic_time', 'r' => (($auth->acl_get('m_approve', $forum_id)) ? 't.topic_replies_real' : 't.topic_replies'), 's' => 't.topic_title', 'v' => 't.topic_views');
699 $limit_time_sql = ($min_time) ? "AND t.topic_last_post_time >= $min_time" : '';
700 break;
702 case 'posts':
703 $limit_days = array(0 => $user->lang['ALL_POSTS'], 1 => $user->lang['1_DAY'], 7 => $user->lang['7_DAYS'], 14 => $user->lang['2_WEEKS'], 30 => $user->lang['1_MONTH'], 90 => $user->lang['3_MONTHS'], 180 => $user->lang['6_MONTHS'], 365 => $user->lang['1_YEAR']);
704 $sort_by_text = array('a' => $user->lang['AUTHOR'], 't' => $user->lang['POST_TIME'], 's' => $user->lang['SUBJECT']);
705 $sort_by_sql = array('a' => 'u.username_clean', 't' => 'p.post_time', 's' => 'p.post_subject');
706 $limit_time_sql = ($min_time) ? "AND p.post_time >= $min_time" : '';
707 break;
709 case 'reports':
710 $limit_days = array(0 => $user->lang['ALL_REPORTS'], 1 => $user->lang['1_DAY'], 7 => $user->lang['7_DAYS'], 14 => $user->lang['2_WEEKS'], 30 => $user->lang['1_MONTH'], 90 => $user->lang['3_MONTHS'], 180 => $user->lang['6_MONTHS'], 365 => $user->lang['1_YEAR']);
711 $sort_by_text = array('a' => $user->lang['AUTHOR'], 'r' => $user->lang['REPORTER'], 'p' => $user->lang['POST_TIME'], 't' => $user->lang['REPORT_TIME'], 's' => $user->lang['SUBJECT']);
712 $sort_by_sql = array('a' => 'u.username_clean', 'r' => 'ru.username', 'p' => 'p.post_time', 't' => 'r.report_time', 's' => 'p.post_subject');
713 break;
715 case 'logs':
716 $limit_days = array(0 => $user->lang['ALL_ENTRIES'], 1 => $user->lang['1_DAY'], 7 => $user->lang['7_DAYS'], 14 => $user->lang['2_WEEKS'], 30 => $user->lang['1_MONTH'], 90 => $user->lang['3_MONTHS'], 180 => $user->lang['6_MONTHS'], 365 => $user->lang['1_YEAR']);
717 $sort_by_text = array('u' => $user->lang['SORT_USERNAME'], 't' => $user->lang['SORT_DATE'], 'i' => $user->lang['SORT_IP'], 'o' => $user->lang['SORT_ACTION']);
719 $sort_by_sql = array('u' => 'u.username_clean', 't' => 'l.log_time', 'i' => 'l.log_ip', 'o' => 'l.log_operation');
720 $limit_time_sql = ($min_time) ? "AND l.log_time >= $min_time" : '';
721 break;
724 if (!isset($sort_by_sql[$sort_key]))
726 $sort_key = $default_key;
729 $sort_order_sql = $sort_by_sql[$sort_key] . ' ' . (($sort_dir == 'd') ? 'DESC' : 'ASC');
731 $s_limit_days = $s_sort_key = $s_sort_dir = $sort_url = '';
732 gen_sort_selects($limit_days, $sort_by_text, $sort_days, $sort_key, $sort_dir, $s_limit_days, $s_sort_key, $s_sort_dir, $sort_url);
734 $template->assign_vars(array(
735 'S_SELECT_SORT_DIR' => $s_sort_dir,
736 'S_SELECT_SORT_KEY' => $s_sort_key,
737 'S_SELECT_SORT_DAYS' => $s_limit_days)
740 if (($sort_days && $mode != 'viewlogs') || in_array($mode, array('reports', 'unapproved_topics', 'unapproved_posts')) || $where_sql != 'WHERE')
742 $result = $db->sql_query($sql);
743 $total = (int) $db->sql_fetchfield('total');
744 $db->sql_freeresult($result);
746 else
748 $total = -1;
753 * Validate ids
755 * @param array &$ids The relevant ids to check
756 * @param string $table The table to find the ids in
757 * @param string $sql_id The ids relevant column name
758 * @param array $acl_list A list of permissions the user need to have
759 * @param mixed $singe_forum Limit to one forum id (int) or the first forum found (true)
761 * @return mixed False if no ids were able to be retrieved, true if at least one id left.
762 * Additionally, this value can be the forum_id assigned if $single_forum was set.
763 * Therefore checking the result for with !== false is the best method.
765 function check_ids(&$ids, $table, $sql_id, $acl_list = false, $single_forum = false)
767 global $db, $auth;
769 if (!is_array($ids) || empty($ids))
771 return false;
774 $sql = "SELECT $sql_id, forum_id FROM $table
775 WHERE " . $db->sql_in_set($sql_id, $ids);
776 $result = $db->sql_query($sql);
778 $ids = array();
779 $forum_id = false;
781 while ($row = $db->sql_fetchrow($result))
783 if ($acl_list && $row['forum_id'] && !$auth->acl_gets($acl_list, $row['forum_id']))
785 continue;
788 if ($acl_list && !$row['forum_id'] && !$auth->acl_getf_global($acl_list))
790 continue;
793 // Limit forum? If not, just assign the id.
794 if ($single_forum === false)
796 $ids[] = $row[$sql_id];
797 continue;
800 // Limit forum to a specific forum id?
801 // This can get really tricky, because we do not want to create a failure on global topics. :)
802 if ($row['forum_id'])
804 if ($single_forum !== true && $row['forum_id'] == (int) $single_forum)
806 $forum_id = (int) $single_forum;
808 else if ($forum_id === false)
810 $forum_id = $row['forum_id'];
813 if ($row['forum_id'] == $forum_id)
815 $ids[] = $row[$sql_id];
818 else
820 // Always add a global topic
821 $ids[] = $row[$sql_id];
824 $db->sql_freeresult($result);
826 if (!sizeof($ids))
828 return false;
831 // If forum id is false and ids populated we may have only global announcements selected (returning 0 because of (int) $forum_id)
833 return ($single_forum === false) ? true : (int) $forum_id;