Location: PHPKode > projects > Question2Answer > question2answer/qa-include/qa-app-q-list.php

	Question2Answer (c) Gideon Greenspan


	File: qa-include/qa-app-q-list.php
	Version: See define()s at top of qa-include/qa-base.php
	Description: Controller for most question listing pages, plus custom pages and plugin pages

	This program is free software; you can redistribute it and/or
	modify it under the terms of the GNU General Public License
	as published by the Free Software Foundation; either version 2
	of the License, or (at your option) any later version.
	This program is distributed in the hope that it will be useful,
	but WITHOUT ANY WARRANTY; without even the implied warranty of
	GNU General Public License for more details.

	More about this license: http://www.question2answer.org/license.php

	if (!defined('QA_VERSION')) { // don't allow this page to be requested directly from browser
		header('Location: ../');

	function qa_q_list_page_content($questions, $pagesize, $start, $count, $sometitle, $nonetitle,
		$navcategories, $categoryid, $categoryqcount, $categorypathprefix, $feedpathprefix, $suggest,
		$pagelinkparams=null, $categoryparams=null, $dummy=null)
	Returns the $qa_content structure for a question list page showing $questions retrieved from the
	database. If $pagesize is not null, it sets the max number of questions to display. If $count is
	not null, pagination is determined by $start and $count. The page title is $sometitle unless
	there are no questions shown, in which case it's $nonetitle. $navcategories should contain the
	categories retrived from the database using qa_db_category_nav_selectspec(...) for $categoryid,
	which is the current category shown. If $categorypathprefix is set, category navigation will be
	shown, with per-category question counts if $categoryqcount is true. The nav links will have the
	prefix $categorypathprefix and possible extra $categoryparams. If $feedpathprefix is set, the
	page has an RSS feed whose URL uses that prefix. If there are no links to other pages, $suggest
	is used to suggest what the user should do. The $pagelinkparams are passed through to
	qa_html_page_links(...) which creates links for page 2, 3, etc..
		if (qa_to_override(__FUNCTION__)) { $args=func_get_args(); return qa_call_override(__FUNCTION__, $args); }
		require_once QA_INCLUDE_DIR.'qa-app-format.php';
		require_once QA_INCLUDE_DIR.'qa-app-updates.php';
	//	Chop down to size, get user information for display

		if (isset($pagesize))
			$questions=array_slice($questions, 0, $pagesize);

	//	Prepare content for theme
		$qa_content=qa_content_prepare(true, array_keys(qa_category_path($navcategories, $categoryid)));
			'tags' => 'method="post" action="'.qa_self_html().'"',
			'hidden' => array(
				'code' => qa_get_form_security_code('vote'),
		if (count($questions)) {
			if (isset($categorypathprefix))
			foreach ($questions as $question)
				$qa_content['q_list']['qs'][]=qa_any_to_q_html_fields($question, $userid, qa_cookie_get(),
					$usershtml, null, qa_post_html_options($question, $defaults));

		} else
		if (isset($userid) && isset($categoryid)) {
			$categoryisfavorite=@$favoritemap['category'][$navcategories[$categoryid]['backpath']] ? true : false;
			$qa_content['favorite']=qa_favorite_form(QA_ENTITY_CATEGORY, $categoryid, $categoryisfavorite,
				qa_lang_sub($categoryisfavorite ? 'main/remove_x_favorites' : 'main/add_category_x_favorites', $navcategories[$categoryid]['title']));
		if (isset($count) && isset($pagesize))
			$qa_content['page_links']=qa_html_page_links(qa_request(), $start, $pagesize, $count, qa_opt('pages_prev_next'), $pagelinkparams);
		if (empty($qa_content['page_links']))
		if (qa_using_categories() && count($navcategories) && isset($categorypathprefix))
			$qa_content['navigation']['cat']=qa_category_navigation($navcategories, $categoryid, $categorypathprefix, $categoryqcount, $categoryparams);
		if (isset($feedpathprefix) && (qa_opt('feed_per_category') || !isset($categoryid)) )
				'url' => qa_path_html(qa_feed_request($feedpathprefix.(isset($categoryid) ? ('/'.qa_category_path_request($navcategories, $categoryid)) : ''))),
				'label' => strip_tags($sometitle),
		return $qa_content;
	function qa_qs_sub_navigation($sort, $categoryslugs)
	Return the sub navigation structure common to question listing pages

		if (isset($categoryslugs))
			foreach ($categoryslugs as $slug)

			'recent' => array(
				'label' => qa_lang('main/nav_most_recent'),
				'url' => qa_path_html($request),
			'hot' => array(
				'label' => qa_lang('main/nav_hot'),
				'url' => qa_path_html($request, array('sort' => 'hot')),
			'votes' => array(
				'label' => qa_lang('main/nav_most_votes'),
				'url' => qa_path_html($request, array('sort' => 'votes')),

			'answers' => array(
				'label' => qa_lang('main/nav_most_answers'),
				'url' => qa_path_html($request, array('sort' => 'answers')),

			'views' => array(
				'label' => qa_lang('main/nav_most_views'),
				'url' => qa_path_html($request, array('sort' => 'views')),
		if (isset($navigation[$sort]))
		if (!qa_opt('do_count_q_views'))
		return $navigation;
	function qa_unanswered_sub_navigation($by, $categoryslugs)
	Return the sub navigation structure common to unanswered pages

		if (isset($categoryslugs))
			foreach ($categoryslugs as $slug)
			'by-answers' => array(
				'label' => qa_lang('main/nav_no_answer'),
				'url' => qa_path_html($request),
			'by-selected' => array(
				'label' => qa_lang('main/nav_no_selected_answer'),
				'url' => qa_path_html($request, array('by' => 'selected')),
			'by-upvotes' => array(
				'label' => qa_lang('main/nav_no_upvoted_answer'),
				'url' => qa_path_html($request, array('by' => 'upvotes')),
		if (isset($navigation['by-'.$by]))
		if (!qa_opt('voting_on_as'))

		return $navigation;

	Omit PHP closing tag to help avoid accidental output
Return current item: Question2Answer