MediaWiki  1.30.0
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$idThe article/category to check
array$condsThe array of categories to match
array$pathUsed 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$articleIdsArray of article IDs
array$categoriesFIXME
string$modeFIXME, 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:
CategoryFinder\seed
seed( $articleIds, $categories, $mode='AND')
Initializes the instance.
Definition: CategoryFinder.php:78
CategoryFinder
The "CategoryFinder" class takes a list of articles, creates an internal representation of all their ...
Definition: CategoryFinder.php:46