Inheritance diagram for CategoryViewer:

Collaboration diagram for CategoryViewer:

Public Member Functions
	__construct ($title, IContextSource $context, $from= '', $until= '', $query=array())
	Constructor.
	addImage (Title $title, $sortkey, $pageLength, $isRedirect=false)
	Add a page in the image namespace.
	addPage ($title, $sortkey, $pageLength, $isRedirect=false)
	Add a miscellaneous page.
	addSubcategory (Title $title, $sortkey, $pageLength)
	Add a subcategory to the internal lists, using a title object.
	addSubcategoryObject (Category $cat, $sortkey, $pageLength)
	Add a subcategory to the internal lists, using a Category object.
	clearCategoryState ()
	doCategoryQuery ()
	finaliseCategoryState ()
	formatList ($articles, $articles_start_char, $cutoff=6)
	Format a list of articles chunked by letter, either as a bullet list or a columnar format, depending on the length.
	getCategoryBottom ()
	getCategoryTop ()
	getHTML ()
	Format the category data list.
	getImageSection ()
	getPagesSection ()
	getSubcategorySection ()
	getSubcategorySortChar ($title, $sortkey)
	Get the character to be used for sorting subcategories.
Static Public Member Functions
static	columnList ($articles, $articles_start_char)
	Format a list of articles chunked by letter in a three-column list, ordered vertically.
Public Attributes
	$articles
	$articles_start_char
	$children
	$children_start_char
Collation	$collation
Array	$flip
	$from
ImageGallery	$gallery
	$imgsNoGallery
	$imgsNoGallery_start_char
	$imgsNoGalley
	$limit
Array	$nextPage
	$showGallery
Title	$title
	$until
Private Member Functions
	addFragmentToTitle ($title, $section)
	Takes a title, and adds the fragment identifier that corresponds to the correct segment of the category.
	getCountMessage ($rescnt, $dbcnt, $type)
	What to do if the category table conflicts with the number of results returned? This function says what.
	getSectionPagingLinks ($type)
	Get the paging links for a section (subcats/pages/files), to go at the top and bottom of the output.
	pagingLinks ($first, $last, $type= '')
	Create paging links, as a helper method to getSectionPagingLinks().
Static Private Member Functions
static	shortList ($articles, $articles_start_char)
	Format a list of articles chunked by letter in a bullet list.
Private Attributes
Category	$cat
	Category object for this page.
array	$query
	The original query array, to be used in generating paging links.

Detailed Description

Definition at line 23 of file CategoryViewer.php.

Constructor & Destructor Documentation

CategoryViewer::__construct	(	$	title,
		IContextSource $	context,
		$	from = `''`,
		$	until = `''`,
		$	query = `array()`
	)

Constructor.

Since:: 1.19 $context is a second, required parameter

Parameters:

$title	Title
$context	IContextSource
$from	String
$until	String
$query	Array

Definition at line 71 of file CategoryViewer.php.

Member Function Documentation

CategoryViewer::addFragmentToTitle	(	$	title,
		$	section
	)		`[private]`

Takes a title, and adds the fragment identifier that corresponds to the correct segment of the category.

Parameters:

Title	$title,:	The title (usually $this->title)
String	$section,:	Which section

Returns:: Title

Definition at line 611 of file CategoryViewer.php.

CategoryViewer::addImage	(	Title $	title,
		$	sortkey,
		$	pageLength,
		$	isRedirect = `false`
	)

Add a page in the image namespace.

Parameters:

$title	Title
$sortkey
$pageLength
$isRedirect	bool

Definition at line 208 of file CategoryViewer.php.

CategoryViewer::addPage	(	$	title,
		$	sortkey,
		$	pageLength,
		$	isRedirect = `false`
	)

Add a miscellaneous page.

Parameters:

$title
$sortkey
$pageLength
$isRedirect	bool

Definition at line 238 of file CategoryViewer.php.

CategoryViewer::addSubcategory	(	Title $	title,
		$	sortkey,
		$	pageLength
	)

Add a subcategory to the internal lists, using a title object.

Deprecated:: since 1.17 kept for compatibility, please use addSubcategoryObject instead

Definition at line 171 of file CategoryViewer.php.

CategoryViewer::addSubcategoryObject	(	Category $	cat,
		$	sortkey,
		$	pageLength
	)

Add a subcategory to the internal lists, using a Category object.

Parameters:

$cat	Category
$sortkey
$pageLength

Definition at line 150 of file CategoryViewer.php.

References $title, Title\getText(), Category\getTitle(), Title\isRedirect(), and Linker\link().

CategoryViewer::clearCategoryState ( )

Definition at line 130 of file CategoryViewer.php.

static CategoryViewer::columnList	(	$	articles,
		$	articles_start_char
	)		`[static]`

Format a list of articles chunked by letter in a three-column list, ordered vertically.

TODO: Take the headers into account when creating columns, so they're more visually equal.

More distant TODO: Scrap this and use CSS columns, whenever IE finally supports those.

Parameters:

$articles	Array
$articles_start_char	Array

Returns:: String

Access:: private

Definition at line 495 of file CategoryViewer.php.

CategoryViewer::doCategoryQuery ( )

Definition at line 268 of file CategoryViewer.php.

CategoryViewer::finaliseCategoryState ( )

Definition at line 253 of file CategoryViewer.php.

CategoryViewer::formatList	(	$	articles,
		$	articles_start_char,
		$	cutoff = `6`
	)

Format a list of articles chunked by letter, either as a bullet list or a columnar format, depending on the length.

Parameters:

$articles	Array
$articles_start_char	Array
$cutoff	Int

Returns:: String

Access:: private

Definition at line 463 of file CategoryViewer.php.

CategoryViewer::getCategoryBottom ( )

Returns:: string

Definition at line 449 of file CategoryViewer.php.

CategoryViewer::getCategoryTop ( )

Returns:: string

Definition at line 345 of file CategoryViewer.php.

CategoryViewer::getCountMessage	(	$	rescnt,
		$	dbcnt,
		$	type
	)		`[private]`

What to do if the category table conflicts with the number of results returned? This function says what.

Each type is considered independently of the other types.

Note for grepping: uses the messages category-article-count, category-article-count-limited, category-subcat-count, category-subcat-count-limited, category-file-count, category-file-count-limited.

Parameters:

$rescnt	Int: The number of items returned by our database query.
$dbcnt	Int: The number of items according to the category table.
$type	String: 'subcat', 'article', or 'file'

Returns:: String: A message giving the number of items, to output to HTML.

Definition at line 645 of file CategoryViewer.php.

CategoryViewer::getHTML ( )

Format the category data list.

Returns:: string HTML output

Definition at line 89 of file CategoryViewer.php.

CategoryViewer::getImageSection ( )

Returns:: string

Definition at line 407 of file CategoryViewer.php.

CategoryViewer::getPagesSection ( )

Returns:: string

Definition at line 378 of file CategoryViewer.php.

CategoryViewer::getSectionPagingLinks ( $ type ) [private]

Get the paging links for a section (subcats/pages/files), to go at the top and bottom of the output.

Parameters:

$type String: 'page', 'subcat', or 'file'

Returns:: String: HTML output, possibly empty if there are no other pages

Definition at line 436 of file CategoryViewer.php.

CategoryViewer::getSubcategorySection ( )

Returns:: string

Definition at line 355 of file CategoryViewer.php.

CategoryViewer::getSubcategorySortChar	(	$	title,
		$	sortkey
	)

Get the character to be used for sorting subcategories.

If there's a link from Category:A to Category:B, the sortkey of the resulting entry in the categorylinks table is Category:A, not A, which it SHOULD be. Workaround: If sortkey == "Category:".$title, than use $title for sorting, else use sortkey...

Parameters:

Title	$title
string	$sortkey	The human-readable sortkey (before transforming to icu or whatever).

Returns:: string

Definition at line 187 of file CategoryViewer.php.

CategoryViewer::pagingLinks	(	$	first,
		$	last,
		$	type = `''`
	)		`[private]`

Create paging links, as a helper method to getSectionPagingLinks().

Parameters:

$first	String The 'until' parameter for the generated URL
$last	String The 'from' parameter for the genererated URL
$type	String A prefix for parameters, 'page' or 'subcat' or 'file'

Returns:: String HTML

Definition at line 571 of file CategoryViewer.php.

static CategoryViewer::shortList	(	$	articles,
		$	articles_start_char
	)		`[static, private]`

Format a list of articles chunked by letter in a bullet list.

Parameters:

$articles	Array
$articles_start_char	Array

Returns:: String

Definition at line 548 of file CategoryViewer.php.

Member Data Documentation

CategoryViewer::$articles

Definition at line 24 of file CategoryViewer.php.

CategoryViewer::$articles_start_char

Definition at line 24 of file CategoryViewer.php.

Category CategoryViewer::$cat [private]

Category object for this page.

Definition at line 54 of file CategoryViewer.php.

CategoryViewer::$children

Definition at line 24 of file CategoryViewer.php.

CategoryViewer::$children_start_char

Definition at line 24 of file CategoryViewer.php.

Collation CategoryViewer::$collation

Definition at line 45 of file CategoryViewer.php.

Array CategoryViewer::$flip

Definition at line 37 of file CategoryViewer.php.

CategoryViewer::$from

Definition at line 24 of file CategoryViewer.php.

ImageGallery CategoryViewer::$gallery

Definition at line 49 of file CategoryViewer.php.

CategoryViewer::$imgsNoGallery

Definition at line 24 of file CategoryViewer.php.

CategoryViewer::$imgsNoGallery_start_char

Definition at line 24 of file CategoryViewer.php.

CategoryViewer::$imgsNoGalley

Definition at line 24 of file CategoryViewer.php.

CategoryViewer::$limit

Definition at line 24 of file CategoryViewer.php.

Array CategoryViewer::$nextPage

Definition at line 33 of file CategoryViewer.php.

array CategoryViewer::$query [private]

The original query array, to be used in generating paging links.

Definition at line 59 of file CategoryViewer.php.

CategoryViewer::$showGallery

Definition at line 24 of file CategoryViewer.php.

Title CategoryViewer::$title

Definition at line 41 of file CategoryViewer.php.

Referenced by addSubcategoryObject().

CategoryViewer::$until

Definition at line 24 of file CategoryViewer.php.

The documentation for this class was generated from the following file:

includes/CategoryViewer.php

Public Member Functions

Static Public Member Functions

Public Attributes

Private Member Functions

Static Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation