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 45 of file CategoryFinder.php.

Member Function Documentation

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 132 of file CategoryFinder.php.

References $path, and as.

Referenced by run().

CategoryFinder::getParents

(

)

Get the parents.

Only really useful if run() has been called already

Returns

array

Definition at line 121 of file CategoryFinder.php.

References $parents.

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 98 of file CategoryFinder.php.

References $article, $ret, $targets, as, check(), DB_REPLICA, scanNextLayer(), and wfGetDB().

CategoryFinder::scanNextLayer ( )

private

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

Definition at line 187 of file CategoryFinder.php.

References $name, $res, as, and NS_CATEGORY.

Referenced by run().

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 77 of file CategoryFinder.php.

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

Referenced by SpecialRecentChanges\filterByCategories().

Member Data Documentation

int [] CategoryFinder::$articles = []

protected

The original article IDs passed to the seed function.

Definition at line 47 of file CategoryFinder.php.

IDatabase CategoryFinder::$dbr

protected

Read-DB replica DB.

Definition at line 68 of file CategoryFinder.php.

array CategoryFinder::$deadend = []

protected

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

Definition at line 50 of file CategoryFinder.php.

string CategoryFinder::$mode

protected

"AND" or "OR"

Definition at line 65 of file CategoryFinder.php.

Referenced by seed().

array CategoryFinder::$name2id = []

protected

Definition at line 62 of file CategoryFinder.php.

array CategoryFinder::$next = []

protected

Array of article/category IDs.

Definition at line 56 of file CategoryFinder.php.

array CategoryFinder::$parents = []

protected

Array of [ ID => [] ].

Definition at line 53 of file CategoryFinder.php.

Referenced by getParents().

array CategoryFinder::$targets = []

protected

Array of DBKEY category names.

Definition at line 59 of file CategoryFinder.php.

Referenced by run().

---

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

• includes/CategoryFinder.php