CategoryFinder Class Reference

The "CategoryFinder" class takes a list of articles, creates an internal representation of all their parent categories (as well as parents of parents etc.). More...

Collaboration diagram for CategoryFinder:

Public Member Functions
	getParents ()
	Get the parents. More...
	run ()
	Iterates through the parent tree starting with the seed values, then checks the articles if they match the conditions. More...
	seed ( $articleIds, $categories, $mode='AND')
	Initializes the instance. More...

Protected Attributes
int[]	$articles = []
	The original article IDs passed to the seed function. More...
IDatabase	$dbr
	Read-DB replica DB. More...
array	$deadend = []
	Array of DBKEY category names for categories that don't have a page. More...
string	$mode
	"AND" or "OR" More...
array	$name2id = []
array	$next = []
	Array of article/category IDs. More...
array	$parents = []
	Array of [ ID => [] ]. More...
array	$targets = []
	Array of DBKEY category names. More...

Private Member Functions
	check ( $id, &$conds, $path=[])
	This functions recurses through the parent representation, trying to match the conditions. More...
	scanNextLayer ()
	Scans a "parent layer" of the articles/categories in $this->next. More...

Detailed Description

The "CategoryFinder" class takes a list of articles, creates an internal representation of all their parent categories (as well as parents of parents etc.).

From this representation, it determines which of these articles are in one or all of a given subset of categories.

Example use :

# Determines whether the article with the page_id 12345 is in both
# "Category 1" and "Category 2" or their subcategories, respectively
 
$cf = new CategoryFinder;
$cf->seed(
    [ 12345 ],
    [ 'Category 1', 'Category 2' ],
    'AND'
);
$a = $cf->run();
print implode( ',' , $a );

Definition at line 46 of file CategoryFinder.php.

Member Function Documentation

check()

CategoryFinder::check (   $id, &  $conds,   $path = []  )

private

This functions recurses through the parent representation, trying to match the conditions.

Parameters

int	$id	The article/category to check
array	$conds	The array of categories to match
array	$path	Used to check for recursion loops

Returns

bool Does this match the conditions?

Definition at line 133 of file CategoryFinder.php.

References $path, as, captcha-old\count, and mode.

Referenced by run().

getParents()

CategoryFinder::getParents

(

)

Get the parents.

Only really useful if run() has been called already

Returns

array

Definition at line 122 of file CategoryFinder.php.

References $parents.

run()

CategoryFinder::run

(

)

Iterates through the parent tree starting with the seed values, then checks the articles if they match the conditions.

Returns

array Array of page_ids (those given to seed() that match the conditions)

Definition at line 99 of file CategoryFinder.php.

References $article, $ret, $targets, as, check(), captcha-old\count, DB_REPLICA, scanNextLayer(), and wfGetDB().

scanNextLayer()

CategoryFinder::scanNextLayer ( )

private

Scans a "parent layer" of the articles/categories in $this->next.

Definition at line 188 of file CategoryFinder.php.

References $name, $res, as, captcha-old\count, and NS_CATEGORY.

Referenced by run().

seed()

CategoryFinder::seed	(		$articleIds,
			$categories,
			$mode = 'AND'
	)

Initializes the instance.

Do this prior to calling run().

Parameters

array	$articleIds	Array of article IDs
array	$categories	FIXME
string	$mode	FIXME, default 'AND'.

Todo:

FIXME: $categories/$mode

Definition at line 78 of file CategoryFinder.php.

References $mode, as, Title\makeTitleSafe(), mode, and NS_CATEGORY.

Referenced by SpecialRecentChanges\filterByCategories().

Member Data Documentation

$articles

int [] CategoryFinder::$articles = []

protected

The original article IDs passed to the seed function.

Definition at line 48 of file CategoryFinder.php.

$dbr

IDatabase CategoryFinder::$dbr

protected

Read-DB replica DB.

Definition at line 69 of file CategoryFinder.php.

$deadend

array CategoryFinder::$deadend = []

protected

Array of DBKEY category names for categories that don't have a page.

Definition at line 51 of file CategoryFinder.php.

$mode

string CategoryFinder::$mode

protected

"AND" or "OR"

Definition at line 66 of file CategoryFinder.php.

Referenced by seed().

$name2id

array CategoryFinder::$name2id = []

protected

Definition at line 63 of file CategoryFinder.php.

$next

array CategoryFinder::$next = []

protected

Array of article/category IDs.

Definition at line 57 of file CategoryFinder.php.

$parents

array CategoryFinder::$parents = []

protected

Array of [ ID => [] ].

Definition at line 54 of file CategoryFinder.php.

Referenced by getParents().

$targets

array CategoryFinder::$targets = []

protected

Array of DBKEY category names.

Definition at line 60 of file CategoryFinder.php.

Referenced by run().

---

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

• includes/CategoryFinder.php