MarkAHershberger has uploaded a new change for review.
https://gerrit.wikimedia.org/r/159658
Change subject: Don't check for Template:Extension_DPL during update
......................................................................
Don't check for Template:Extension_DPL during update
The check causes MediaWiki to execute some code that depends on some
updates having been run, which is no good.
bug: 60492
Change-Id: I4305eb1db19005aa09c6ea76086f402aba41bade
---
M DPLSetup.php
1 file changed, 874 insertions(+), 873 deletions(-)
git pull
ssh://gerrit.wikimedia.org:29418/mediawiki/extensions/DynamicPageList
refs/changes/58/159658/1
diff --git a/DPLSetup.php b/DPLSetup.php
index c0a4b40..8642da8 100644
--- a/DPLSetup.php
+++ b/DPLSetup.php
@@ -5,19 +5,19 @@
* This file handles the configuration setup for the DynamicPageList extension
of MediaWiki.
* This code is released under the GNU General Public License.
*
- *
- * Note: DynamicPageList is downward compatible with Extension:Intersection;
+ *
+ * Note: DynamicPageList is downward compatible with Extension:Intersection;
* There once was a version called "DynamicPageList2" which is obsolete
*
* Usage:
* require_once("extensions/DynamicPageList/DynamicPageList.php"); in
LocalSettings.php
- *
+ *
* @file
* @ingroup Extensions
* @link http://www.mediawiki.org/wiki/Extension:DynamicPageList_(third-party)
Documentation
- * @author n:en:User:IlyaHaykinson
- * @author n:en:User:Amgine
- * @author w:de:Benutzer:Unendlich
+ * @author n:en:User:IlyaHaykinson
+ * @author n:en:User:Amgine
+ * @author w:de:Benutzer:Unendlich
* @author m:User:Dangerman <[email protected]>
* @author m:User:Algorithmix <[email protected]>
* @license http://opensource.org/licenses/gpl-license.php GNU Public License
@@ -31,7 +31,7 @@
* allow ¦ as an alias for |
* escapelinks= introduced
* @version 0.9.4
- * allow "-" with categories =
+ * allow "-" with categories =
* disable UTF8 conversion for sortkey
* headingcount= added
* @version 0.9.5
@@ -173,7 +173,7 @@
* @version 1.3.6
* special page for DPL deleted
* allow individual collations for sorting, this makes case
insensitive sorting possible
- * hardwired collation change: for sorting the club suit
symbol's sort value is changed
+ * hardwired collation change: for sorting the club suit
symbol's sort value is changed
* so that the club suit will always appear AFTER the diamond suit
* bugfix: %PAGES% did not work in mode=category
* added a switch to include/exclude subpages
@@ -233,7 +233,7 @@
* support %DATE% and %USER% within phantom templates
* added randomseed
* @version 1.6.0
- * internal changes in the code; (no more globals etc ...)
+ * internal changes in the code; (no more globals etc ...)
* @version 1.6.1
* ordermethod= sortkey & categories decoupled, see line
2011
* hooks changed back to global functions due to problems
with older MW installations
@@ -256,7 +256,7 @@
* @version 1.6.7
* bugfix at goal=categories (due to change in 1.6.6)
* @version 1.6.8
- * allow & at category
+ * allow & at category
* @version 1.6.9
* added check against non-includable namespaces
* added includetrim' command
@@ -282,7 +282,7 @@
* usedby
* CATBULLETS variable
* @version 1.7.6
- * error correction: non existing array index 0 when
trying to includematch content in a non-existing chapter (near #3887)
+ * error correction: non existing array index 0 when
trying to includematch content in a non-existing chapter (near #3887)
* @version 1.7.7
* configuration switch allows to run DPL from protected
pages only (ExtDynamicPageList::$options['RunFromProtectedPagesOnly'])
* @version 1.7.8
@@ -327,7 +327,7 @@
* bugfix: title= & allrevisionssince caused SQL error
* added ordermethod = none
* changed %DPLTIME% to fractions of seconds
- * titlematch: We now translate a space to an escaped
underscore as the native underscore is a special char within SQL LIKE
+ * titlematch: We now translate a space to an escaped
underscore as the native underscore is a special char within SQL LIKE
* new commands: linkstoexternal and addexternallink
* changed default for userdateformat to show also seconds
DPL only; Intersection will show only the date for compatibility reasons)
* bugfix date/time problem 1977
@@ -340,7 +340,7 @@
* changed implementation of userdate transformation to
wgLang->userAdjust()
* include now understands parserFunctions when used with
{#xxx}
* include now understands tag functions when used with
{~xxx}
- * title< and title> added,
+ * title< and title> added,
* new URL arg: DPL_fromTitle, DPL_toTitle
* new built-in vars: %FIRSTTITLE%, %LASTTITLE%,
%FIRSTNAMESPACE%, %LASTNAMESPACE%, %SCROLLDIR% (only in header and footer)
* removed replacement of card suit symbols in SQL query
due to collation incompatibilities
@@ -409,7 +409,7 @@
* @version 2.0
* added %ARGS% to template surrogate call
* replaced "makeKnownLinkObjects" by "fullurl:" to get
rid of the need to change $rawHtml
- * eliminated rawHTML usage
+ * eliminated rawHTML usage
* eliminated calls to parser->clearState and parser->transformMsg,
now CITE and DPL work together
* as a consequence a patch to LinkHolderArray.php
is needed.
* added proprietory function to sort bidding sequences for the card
game of 'Bridge' according to suit rank
@@ -423,627 +423,627 @@
*
*/
-function ExtDynamicPageList__languageGetMagic( &$magicWords, $langCode )
{
- return ExtDynamicPageList::languageGetMagic( $magicWords, $langCode );
+function ExtDynamicPageList__languageGetMagic( &$magicWords, $langCode )
{
+ return ExtDynamicPageList::languageGetMagic( $magicWords, $langCode );
}
-function ExtDynamicPageList__endReset( &$parser, $text )
{
- return ExtDynamicPageList::endReset( $parser, $text );
+function ExtDynamicPageList__endReset( &$parser, $text )
{
+ return ExtDynamicPageList::endReset( $parser, $text );
}
-function ExtDynamicPageList__endEliminate( &$parser, $text )
{
- return ExtDynamicPageList::endEliminate( $parser, $text );
+function ExtDynamicPageList__endEliminate( &$parser, $text )
{
+ return ExtDynamicPageList::endEliminate( $parser, $text );
}
class ExtDynamicPageList {
- public static $DPLVersion = '?'; // current version is set
by DynamicPageList.php and DynamicPageListMigration.php
+ public static $DPLVersion = '?'; // current version is
set by DynamicPageList.php and DynamicPageListMigration.php
public static $useCacheAPI = true; //
decide whether we use another extension called CachePI which can help us
-
// to invalidate MediaWiki´s ParserCache if suitable
+ // to invalidate MediaWiki´s ParserCache if suitable
public static $modulesLoaded = false; // php
require_once control
-
- // Debug stuff
- // FATAL
- const FATAL_WRONGNS = 1; // $0: 'namespace'
or 'notnamespace'
- // $1: wrong
parameter given by user
- // $3: list of
possible titles of namespaces (except pseudo-namespaces: Media, Special)
-
- const FATAL_WRONGLINKSTO = 2; // $0: linksto'
(left as $0 just in case the parameter is renamed in the future)
- // $1: the wrong
parameter given by user
-
- const FATAL_TOOMANYCATS = 3; // $0: max number
of categories that can be included
+ // Debug stuff
- const FATAL_TOOFEWCATS = 4; // $0: min number
of categories that have to be included
+ // FATAL
+ const FATAL_WRONGNS = 1; // $0:
'namespace' or 'notnamespace'
+ // $1: wrong parameter given by user
+ // $3: list of possible titles of namespaces (except pseudo-namespaces:
Media, Special)
- const FATAL_NOSELECTION = 5;
+ const FATAL_WRONGLINKSTO = 2; // $0: linksto'
(left as $0 just in case the parameter is renamed in the future)
+ // $1: the wrong parameter given by user
- const FATAL_CATDATEBUTNOINCLUDEDCATS = 6;
+ const FATAL_TOOMANYCATS = 3; // $0: max
number of categories that can be included
- const FATAL_CATDATEBUTMORETHAN1CAT = 7;
+ const FATAL_TOOFEWCATS = 4; // $0: min
number of categories that have to be included
- const FATAL_MORETHAN1TYPEOFDATE = 8;
+ const FATAL_NOSELECTION = 5;
- const FATAL_WRONGORDERMETHOD = 9; // $0: param=val
that is possible only with $1 as last 'ordermethod' parameter
- // $1: last
'ordermethod' parameter required for $0
+ const FATAL_CATDATEBUTNOINCLUDEDCATS = 6;
- const FATAL_DOMINANTSECTIONRANGE = 10; // $0: the number
of arguments in includepage
+ const FATAL_CATDATEBUTMORETHAN1CAT = 7;
- const FATAL_NOCLVIEW = 11; // $0:
prefix_dpl_clview where 'prefix' is the prefix of your mediawiki table names
- // $1: SQL query
to create the prefix_dpl_clview on your mediawiki DB
+ const FATAL_MORETHAN1TYPEOFDATE = 8;
- const FATAL_OPENREFERENCES = 12;
-
- // ERROR
-
- // WARN
-
- const WARN_UNKNOWNPARAM = 13; // $0: unknown
parameter given by user
- // $1: list of DPL
available parameters separated by ', '
+ const FATAL_WRONGORDERMETHOD = 9; // $0:
param=val that is possible only with $1 as last 'ordermethod' parameter
+ // $1: last 'ordermethod' parameter required for $0
- const WARN_WRONGPARAM = 14; // $3: list of
valid param values separated by ' | '
+ const FATAL_DOMINANTSECTIONRANGE = 10; // $0: the
number of arguments in includepage
- const WARN_WRONGPARAM_INT = 15; // $0: param name
- // $1: wrong param
value given by user
- // $2: default
param value used instead by program
+ const FATAL_NOCLVIEW = 11; // $0:
prefix_dpl_clview where 'prefix' is the prefix of your mediawiki table names
+ // $1: SQL query to create the prefix_dpl_clview on your mediawiki DB
- const WARN_NORESULTS = 16;
+ const FATAL_OPENREFERENCES = 12;
- const WARN_CATOUTPUTBUTWRONGPARAMS = 17;
+ // ERROR
- const WARN_HEADINGBUTSIMPLEORDERMETHOD = 18; // $0:
'headingmode' value given by user
- // $1: value used
instead by program (which means no heading)
+ // WARN
- const WARN_DEBUGPARAMNOTFIRST = 19; // $0: 'log' value
+ const WARN_UNKNOWNPARAM = 13; // $0: unknown
parameter given by user
+ // $1: list of DPL available parameters separated by ', '
- const WARN_TRANSCLUSIONLOOP = 20; // $0: title of
page that creates an infinite transclusion loop
+ const WARN_WRONGPARAM = 14; // $3: list of
valid param values separated by ' | '
- // INFO
+ const WARN_WRONGPARAM_INT = 15; // $0: param
name
+ // $1: wrong param value given by user
+ // $2: default param value used instead by program
- // DEBUG
+ const WARN_NORESULTS = 16;
- const DEBUG_QUERY = 21; // $0: SQL query
executed to generate the dynamic page list
+ const WARN_CATOUTPUTBUTWRONGPARAMS = 17;
- // TRACE
-
// Output formatting
- // $1: number of
articles
-
- /**
- * Extension options
- */
- public static $maxCategoryCount = 4; // Maximum number of
categories allowed in the Query
- public static $minCategoryCount = 0; // Minimum number of
categories needed in the Query
- public static $maxResultCount = 500; // Maximum number of
results to allow
- public static $categoryStyleListCutoff = 6; // Max length to format
a list of articles chunked by letter as bullet list, if list bigger, columnar
format user (same as cutoff arg for CategoryPage::formatList())
- public static $allowUnlimitedCategories = true; // Allow unlimited
categories in the Query
- public static $allowUnlimitedResults = false; // Allow unlimited
results to be shown
- public static $allowedNamespaces = null; // to be initialized at
first use of DPL, array of all namespaces except Media and Special, because we
cannot use the DB for these to generate dynamic page lists.
-
// Cannot be customized. Use
ExtDynamicPageList::$options['namespace'] or
ExtDynamicPageList::$options['notnamespace'] for customization.
+ const WARN_HEADINGBUTSIMPLEORDERMETHOD = 18; // $0:
'headingmode' value given by user
+ // $1: value used instead by program (which means no heading)
+
+ const WARN_DEBUGPARAMNOTFIRST = 19; // $0: 'log'
value
+
+ const WARN_TRANSCLUSIONLOOP = 20; // $0: title of
page that creates an infinite transclusion loop
+
+ // INFO
+
+ // DEBUG
+
+ const DEBUG_QUERY = 21; // $0: SQL
query executed to generate the dynamic page list
+
+ // TRACE
+ // Output formatting
+ // $1: number of articles
+
+ /**
+ * Extension options
+ */
+ public static $maxCategoryCount = 4; // Maximum number of
categories allowed in the Query
+ public static $minCategoryCount = 0; // Minimum number of
categories needed in the Query
+ public static $maxResultCount = 500; // Maximum number of
results to allow
+ public static $categoryStyleListCutoff = 6; // Max length to
format a list of articles chunked by letter as bullet list, if list bigger,
columnar format user (same as cutoff arg for CategoryPage::formatList())
+ public static $allowUnlimitedCategories = true; // Allow unlimited
categories in the Query
+ public static $allowUnlimitedResults = false; // Allow unlimited
results to be shown
+ public static $allowedNamespaces = null; // to be initialized
at first use of DPL, array of all namespaces except Media and Special, because
we cannot use the DB for these to generate dynamic page lists.
+ // Cannot be customized. Use ExtDynamicPageList::$options['namespace']
or ExtDynamicPageList::$options['notnamespace'] for customization.
public static $behavingLikeIntersection = false; // Changes certain
default values to comply with Extension:Intersection
public static $functionalRichness = 0; // The amount
of functionality of DPL that is accesible for the user;
-
// .. to be set by DynamicPageList.php and
DynamicPageListMigration.php
- public static $respectParserCache = false; // false = make page
dynamic ; true = execute only when parser cache is refreshed
-
// .. to be changed in LocalSettings.php
-
+ // .. to be set by DynamicPageList.php and DynamicPageListMigration.php
+ public static $respectParserCache = false; // false =
make page dynamic ; true = execute only when parser cache is refreshed
+ // .. to be changed in LocalSettings.php
+
public static $fixedCategories = array(); // an array
which holds categories to which the page containing the DPL query
-
// shall be assigned althoug
reset_all|categories has been used
-
// see the fixcategory command
+ // shall be assigned althoug reset_all|categories has been used
+ // see the fixcategory command
- /**
- * Map parameters to possible values.
- * A 'default' key indicates the default value for the parameter.
- * A 'pattern' key indicates a pattern for regular expressions (that the
value must match).
- * For some options (e.g. 'namespace'), possible values are not yet
defined but will be if necessary (for debugging)
- */
- public static $options = array(
- 'addauthor' => array('default' => 'false', 'true', 'no',
'yes', '0', '1', 'off', 'on'),
- 'addcategories' => array('default' => 'false', 'true', 'no',
'yes', '0', '1', 'off', 'on'),
- 'addcontribution' => array('default' => 'false', 'true', 'no',
'yes', '0', '1', 'off', 'on'),
- 'addeditdate' => array('default' => 'false', 'true', 'no',
'yes', '0', '1', 'off', 'on'),
- 'addexternallink' => array('default' => 'false', 'true', 'no',
'yes', '0', '1', 'off', 'on'),
- 'addfirstcategorydate' => array('default' => 'false', 'true', 'no',
'yes', '0', '1', 'off', 'on'),
- 'addlasteditor' => array('default' => 'false', 'true', 'no',
'yes', '0', '1', 'off', 'on'),
- 'addpagecounter' => array('default' => 'false', 'true', 'no',
'yes', '0', '1', 'off', 'on'),
- 'addpagesize' => array('default' => 'false', 'true', 'no',
'yes', '0', '1', 'off', 'on'),
- 'addpagetoucheddate' => array('default' => 'false', 'true', 'no',
'yes', '0', '1', 'off', 'on'),
- 'adduser' => array('default' => 'false', 'true', 'no',
'yes', '0', '1', 'off', 'on'),
-
+ /**
+ * Map parameters to possible values.
+ * A 'default' key indicates the default value for the parameter.
+ * A 'pattern' key indicates a pattern for regular expressions (that
the value must match).
+ * For some options (e.g. 'namespace'), possible values are not yet
defined but will be if necessary (for debugging)
+ */
+ public static $options = array(
+ 'addauthor' => array('default' => 'false', 'true',
'no', 'yes', '0', '1', 'off', 'on'),
+ 'addcategories' => array('default' => 'false', 'true',
'no', 'yes', '0', '1', 'off', 'on'),
+ 'addcontribution' => array('default' => 'false', 'true',
'no', 'yes', '0', '1', 'off', 'on'),
+ 'addeditdate' => array('default' => 'false', 'true',
'no', 'yes', '0', '1', 'off', 'on'),
+ 'addexternallink' => array('default' => 'false', 'true',
'no', 'yes', '0', '1', 'off', 'on'),
+ 'addfirstcategorydate' => array('default' => 'false', 'true',
'no', 'yes', '0', '1', 'off', 'on'),
+ 'addlasteditor' => array('default' => 'false', 'true',
'no', 'yes', '0', '1', 'off', 'on'),
+ 'addpagecounter' => array('default' => 'false', 'true',
'no', 'yes', '0', '1', 'off', 'on'),
+ 'addpagesize' => array('default' => 'false', 'true',
'no', 'yes', '0', '1', 'off', 'on'),
+ 'addpagetoucheddate' => array('default' => 'false', 'true',
'no', 'yes', '0', '1', 'off', 'on'),
+ 'adduser' => array('default' => 'false', 'true',
'no', 'yes', '0', '1', 'off', 'on'),
+
// default of allowcachedresults depends on behaveasIntersetion
and on LocalSettings ...
- 'allowcachedresults' => array( 'true', 'false', 'no', 'yes',
'yes+warn', '0', '1', 'off', 'on'),
- /**
- * search for a page with the same title in another namespace (this is
normally the article to a talk page)
- */
- 'articlecategory' => null,
+ 'allowcachedresults' => array( 'true', 'false', 'no', 'yes',
'yes+warn', '0', '1', 'off', 'on'),
+ /**
+ * search for a page with the same title in another namespace
(this is normally the article to a talk page)
+ */
+ 'articlecategory' => null,
- /**
- * category= Cat11 | Cat12 | ...
- * category= Cat21 | Cat22 | ...
- * ...
- * [Special value] catX='' (empty string without quotes) means
pseudo-categoy of Uncategorized pages
- * Means pages have to be in category (Cat11 OR (inclusive) Cat2
OR...) AND (Cat21 OR Cat22 OR...) AND...
- * If '+' prefixes the list of categories (e.g. category=+ Cat1 | Cat
2 ...), only these categories can be used as headings in the DPL. See
'headingmode' param.
- * If '-' prefixes the list of categories (e.g. category=- Cat1 | Cat
2 ...), these categories will not appear as headings in the DPL. See
'headingmode' param.
- * Magic words allowed.
- * @todo define 'category' options (retrieve list of categories from
'categorylinks' table?)
- */
- 'category' => null,
- 'categorymatch' => null,
- 'categoryregexp' => null,
- /**
- * Min and Max of categories allowed for an article
- */
- 'categoriesminmax' => array('default' => '', 'pattern' =>
'/^\d*,?\d*$/'),
- /**
- * hiddencategories
- */
- 'hiddencategories' => array('default' => 'include', 'exclude',
'only'),
+ /**
+ * category= Cat11 | Cat12 | ...
+ * category= Cat21 | Cat22 | ...
+ * ...
+ * [Special value] catX='' (empty string without quotes) means
pseudo-categoy of Uncategorized pages
+ * Means pages have to be in category (Cat11 OR (inclusive)
Cat2 OR...) AND (Cat21 OR Cat22 OR...) AND...
+ * If '+' prefixes the list of categories (e.g. category=+ Cat1
| Cat 2 ...), only these categories can be used as headings in the DPL. See
'headingmode' param.
+ * If '-' prefixes the list of categories (e.g. category=- Cat1
| Cat 2 ...), these categories will not appear as headings in the DPL. See
'headingmode' param.
+ * Magic words allowed.
+ * @todo define 'category' options (retrieve list of categories
from 'categorylinks' table?)
+ */
+ 'category' => null,
+ 'categorymatch' => null,
+ 'categoryregexp' => null,
+ /**
+ * Min and Max of categories allowed for an article
+ */
+ 'categoriesminmax' => array('default' => '', 'pattern' =>
'/^\d*,?\d*$/'),
+ /**
+ * hiddencategories
+ */
+ 'hiddencategories' => array('default' => 'include',
'exclude', 'only'),
/**
* perform the command and do not query the database
*/
- 'execandexit' => array('default' => ''),
-
- /**
- * number of results which shall be skipped before display starts
- * default is 0
- */
- 'offset' => array('default' => '0', 'pattern' =>
'/^\d*$/'),
- /**
- * Max of results to display, selection is based on random.
- */
- 'count' => array('default' => '500', 'pattern' =>
'/^\d*$/'),
- /**
- * Seed to be used when calling random.
- */
- 'randomseed' => array('default' => '', 'pattern' =>
'/^\d*$/'),
- /**
- * Max number of results to display, selection is based on random.
- */
- 'randomcount' => array('default' => '', 'pattern' =>
'/^\d*$/'),
- /**
- * shall the result set be distinct (=default) or not?
- */
- 'distinct' => array('default' => 'true', 'strict',
'false', 'no', 'yes', '0', '1', 'off', 'on'),
+ 'execandexit' => array('default' => ''),
- 'dplcache' => array('default' => ''),
- 'dplcacheperiod' => array('default' => '86400', 'pattern' =>
'/^\d+$/'), // 86400 = # seconds for one day
+ /**
+ * number of results which shall be skipped before display
starts
+ * default is 0
+ */
+ 'offset' => array('default' => '0', 'pattern' =>
'/^\d*$/'),
+ /**
+ * Max of results to display, selection is based on random.
+ */
+ 'count' => array('default' => '500', 'pattern'
=> '/^\d*$/'),
+ /**
+ * Seed to be used when calling random.
+ */
+ 'randomseed' => array('default' => '', 'pattern' =>
'/^\d*$/'),
+ /**
+ * Max number of results to display, selection is based on
random.
+ */
+ 'randomcount' => array('default' => '', 'pattern' =>
'/^\d*$/'),
+ /**
+ * shall the result set be distinct (=default) or not?
+ */
+ 'distinct' => array('default' => 'true', 'strict',
'false', 'no', 'yes', '0', '1', 'off', 'on'),
- /**
- * number of columns for output, default is 1
- */
- 'columns' => array('default' => '', 'pattern' =>
'/^\d+$/'),
+ 'dplcache' => array('default' => ''),
+ 'dplcacheperiod' => array('default' => '86400', 'pattern'
=> '/^\d+$/'), // 86400 = # seconds for one day
- /**
- * debug=...
- * - 0: displays no debug message;
- * - 1: displays fatal errors only;
- * - 2: fatal errors + warnings only;
- * - 3: every debug message.
- * - 4: The SQL statement as an echo before execution.
- * - 5: <nowiki> tags around the ouput
+ /**
+ * number of columns for output, default is 1
+ */
+ 'columns' => array('default' => '', 'pattern' =>
'/^\d+$/'),
+
+ /**
+ * debug=...
+ * - 0: displays no debug message;
+ * - 1: displays fatal errors only;
+ * - 2: fatal errors + warnings only;
+ * - 3: every debug message.
+ * - 4: The SQL statement as an echo before execution.
+ * - 5: <nowiki> tags around the ouput
* - 6: don't execute SQL statement, only show it
- */
- 'debug' => array( 'default' => '2', '0', '1', '2', '3',
'4', '5', '6'),
+ */
+ 'debug' => array( 'default' => '2', '0', '1',
'2', '3', '4', '5', '6'),
- /**
- * eliminate=.. avoid creating unnecessary backreferences which point
to to DPL results.
- * it is expensive (in terms of
performance) but more precise than "reset"
- * categories: eliminate all category links which result from a DPL
call (by transcluded contents)
- * templates: the same with templates
- * images: the same with images
- * links: the same with internal and external links
- * all all of the above
- */
- 'eliminate' => array( 'default' => '', 'categories',
'templates', 'links', 'images', 'all', 'none'),
- /**
- * Mode at the heading level with ordermethod on multiple components,
e.g. category heading with ordermethod=category,...:
- * html headings (H2, H3, H4), definition list, no heading (none),
ordered, unordered.
- */
+ /**
+ * eliminate=.. avoid creating unnecessary backreferences which
point to to DPL results.
+ * it is expensive (in terms of
performance) but more precise than "reset"
+ * categories: eliminate all category links which result from a
DPL call (by transcluded contents)
+ * templates: the same with templates
+ * images: the same with images
+ * links: the same with internal and external links
+ * all all of the above
+ */
+ 'eliminate' => array( 'default' => '',
'categories', 'templates', 'links', 'images', 'all', 'none'),
+ /**
+ * Mode at the heading level with ordermethod on multiple
components, e.g. category heading with ordermethod=category,...:
+ * html headings (H2, H3, H4), definition list, no heading
(none), ordered, unordered.
+ */
- 'format' => null,
+ 'format' => null,
- 'goal' => array('default' => 'pages', 'pages',
'categories'),
+ 'goal' => array('default' => 'pages', 'pages',
'categories'),
- 'headingmode' => array( 'default' => 'none', 'H2', 'H3',
'H4', 'definition', 'none', 'ordered', 'unordered'),
- /**
- * we can display the number of articles within a heading group
- */
- 'headingcount' => array( 'default' => 'false', 'true', 'no',
'yes', '0', '1', 'off', 'on'),
- /**
- * Attributes for HTML list items (headings) at the heading level,
depending on 'headingmode' (e.g. 'li' for ordered/unordered)
- * Not yet applicable to 'headingmode=none | definition | H2 | H3 |
H4'.
- * @todo Make 'hitemattr' param applicable to 'none', 'definition',
'H2', 'H3', 'H4' headingmodes.
- * Example: hitemattr= class="topmenuli" style="color: red;"
- */
- 'hitemattr' => array('default' => ''),
- /**
- * Attributes for the HTML list element at the heading/top level,
depending on 'headingmode' (e.g. 'ol' for ordered, 'ul' for unordered, 'dl' for
definition)
- * Not yet applicable to 'headingmode=none'.
- * @todo Make 'hlistattr' param applicable to headingmode=none.
- * Example: hlistattr= class="topmenul" id="dmenu"
- */
- 'hlistattr' => array('default' => ''),
- /**
- * PAGE TRANSCLUSION: includepage=... or include=...
- * To include the whole page, use a wildcard:
- * includepage =*
- * To include sections labeled 'sec1' or 'sec2' or... from the page
(see the doc of the LabeledSectionTransclusion extension for more info):
- * includepage = sec1,sec2,..
- * To include from the first occurrence of the heading 'heading1'
(resp. 'heading2') until the next heading of the same or lower level. Note that
this comparison is case insensitive. (See
http://www.mediawiki.org/wiki/Extension:Labeled_Section_Transclusion#Transcluding_visual_headings.)
:
- * includepage = #heading1,#heading2,....
- * You can combine:
- * includepage= sec1,#heading1,...
- * To include nothing from the page (no transclusion), leave empty:
- * includepage =
- */
+ 'headingmode' => array( 'default' => 'none', 'H2',
'H3', 'H4', 'definition', 'none', 'ordered', 'unordered'),
+ /**
+ * we can display the number of articles within a heading group
+ */
+ 'headingcount' => array( 'default' => 'false', 'true',
'no', 'yes', '0', '1', 'off', 'on'),
+ /**
+ * Attributes for HTML list items (headings) at the heading
level, depending on 'headingmode' (e.g. 'li' for ordered/unordered)
+ * Not yet applicable to 'headingmode=none | definition | H2 |
H3 | H4'.
+ * @todo Make 'hitemattr' param applicable to 'none',
'definition', 'H2', 'H3', 'H4' headingmodes.
+ * Example: hitemattr= class="topmenuli" style="color: red;"
+ */
+ 'hitemattr' => array('default' => ''),
+ /**
+ * Attributes for the HTML list element at the heading/top
level, depending on 'headingmode' (e.g. 'ol' for ordered, 'ul' for unordered,
'dl' for definition)
+ * Not yet applicable to 'headingmode=none'.
+ * @todo Make 'hlistattr' param applicable to headingmode=none.
+ * Example: hlistattr= class="topmenul" id="dmenu"
+ */
+ 'hlistattr' => array('default' => ''),
+ /**
+ * PAGE TRANSCLUSION: includepage=... or include=...
+ * To include the whole page, use a wildcard:
+ * includepage =*
+ * To include sections labeled 'sec1' or 'sec2' or... from the
page (see the doc of the LabeledSectionTransclusion extension for more info):
+ * includepage = sec1,sec2,..
+ * To include from the first occurrence of the heading
'heading1' (resp. 'heading2') until the next heading of the same or lower
level. Note that this comparison is case insensitive. (See
http://www.mediawiki.org/wiki/Extension:Labeled_Section_Transclusion#Transcluding_visual_headings.)
:
+ * includepage = #heading1,#heading2,....
+ * You can combine:
+ * includepage= sec1,#heading1,...
+ * To include nothing from the page (no transclusion), leave
empty:
+ * includepage =
+ */
- 'includepage' => array('default' => ''),
- /**
- * make comparisons (linksto, linksfrom ) case insensitive
- */
- 'ignorecase' => array('default' => 'false', 'true', 'no',
'yes', '0', '1', 'off', 'on'),
- 'include' => null,
- /**
- * includesubpages default is TRUE
- */
- 'includesubpages' => array('default' => 'true', 'false', 'no',
'yes', '0', '1', 'off', 'on'),
- /**
- * includematch=..,.. allows to specify regular expressions which
must match the included contents
- */
- 'includematch' => array('default' => ''),
- 'includematchparsed' => array('default' => ''),
- /**
- * includenotmatch=..,.. allows to specify regular expressions
which must NOT match the included contents
- */
- 'includenotmatch' => array('default' => ''),
- 'includenotmatchparsed' => array('default' => ''),
- 'includetrim' => array('default' => 'false', 'true', 'no',
'yes', '0', '1', 'off', 'on'),
- /**
- * Inline text is some wiki text used to separate list items with
'mode=inline'.
- */
- 'inlinetext' => array('default' => ' - '),
- /**
- * Max # characters of included page to display.
- * Empty value (default) means no limit.
- * If we include setcions the limit will apply to each section.
- */
- 'includemaxlength' => array('default' => '', 'pattern' =>
'/^\d*$/'),
- /**
- * Attributes for HTML list items, depending on 'mode' ('li' for
ordered/unordered, 'span' for others).
- * Not applicable to 'mode=category'.
- * @todo Make 'itemattr' param applicable to 'mode=category'.
- * Example: itemattr= class="submenuli" style="color: red;"
- */
- 'itemattr' => array('default' => ''),
- /**
- * listseparators is an array of four tags (in wiki syntax) which
defines the output of DPL
- * if mode = 'userformat' was specified.
- * '\n' or '¶' in the input will be interpreted as a newline
character.
- * '%xxx%' in the input will be replaced by a corresponding
value (xxx= PAGE, NR, COUNT etc.)
- * t1 and t4 are the "outer envelope" for the whole result list,
- * t2,t3 form an inner envelope around the article name of each entry.
- * Examples: listseparators={|,,\n#[[%PAGE%]]
- * Note: use of html tags was abolished from version 2.0; the first
example must be written as:
- * : listseparators={|,\n|-\n|[[%PAGE%]],,\n|}
- */
- 'listseparators' => array('default' => ''),
- /**
- * sequence of four wiki tags (separated by ",") to be used together
with mode = 'userformat'
- * t1 and t4 define an outer frame for the article list
- * t2 and t3 build an inner frame for each article name
- * example: listattr=<ul>,<li>,</li>,</ul>
- */
- 'listattr' => array('default' => ''),
- /**
- * this parameter restricts the output to articles which can reached
via a link from the specified pages.
- * Examples: linksfrom=my article|your article
- */
- 'linksfrom' => array('default' => ''),
- /**
- * this parameter restricts the output to articles which cannot be
reached via a link from the specified pages.
- * Examples: notlinksfrom=my article|your article
- */
- 'notlinksfrom' => array('default' => ''),
- /**
- * this parameter restricts the output to articles which contain a
reference to one of the specified pages.
- * Examples: linksto=my article|your article ,
linksto=Template:my template , linksto = {{FULLPAGENAME}}
- */
- 'linksto' => array('default' => ''),
- /**
- * this parameter restricts the output to articles which do not
contain a reference to the specified page.
- */
- 'notlinksto' => array('default' => ''),
- /**
- * this parameter restricts the output to articles which contain an
external reference that conatins a certain pattern
- * Examples: linkstoexternal= www.xyz.com|www.xyz2.com
- */
- 'linkstoexternal' => array('default' => ''),
- /**
- * this parameter restricts the output to articles which use one of
the specified images.
- * Examples: imageused=Image:my image|Image:your image
- */
- 'imageused' => array('default' => ''),
- /**
+ 'includepage' => array('default' => ''),
+ /**
+ * make comparisons (linksto, linksfrom ) case insensitive
+ */
+ 'ignorecase' => array('default' => 'false',
'true', 'no', 'yes', '0', '1', 'off', 'on'),
+ 'include' => null,
+ /**
+ * includesubpages default is TRUE
+ */
+ 'includesubpages' => array('default' => 'true', 'false',
'no', 'yes', '0', '1', 'off', 'on'),
+ /**
+ * includematch=..,.. allows to specify regular expressions
which must match the included contents
+ */
+ 'includematch' => array('default' => ''),
+ 'includematchparsed' => array('default' => ''),
+ /**
+ * includenotmatch=..,.. allows to specify regular
expressions which must NOT match the included contents
+ */
+ 'includenotmatch' => array('default' => ''),
+ 'includenotmatchparsed' => array('default' => ''),
+ 'includetrim' => array('default' => 'false', 'true',
'no', 'yes', '0', '1', 'off', 'on'),
+ /**
+ * Inline text is some wiki text used to separate list items
with 'mode=inline'.
+ */
+ 'inlinetext' => array('default' => ' - '),
+ /**
+ * Max # characters of included page to display.
+ * Empty value (default) means no limit.
+ * If we include setcions the limit will apply to each section.
+ */
+ 'includemaxlength' => array('default' => '', 'pattern' =>
'/^\d*$/'),
+ /**
+ * Attributes for HTML list items, depending on 'mode' ('li'
for ordered/unordered, 'span' for others).
+ * Not applicable to 'mode=category'.
+ * @todo Make 'itemattr' param applicable to 'mode=category'.
+ * Example: itemattr= class="submenuli" style="color: red;"
+ */
+ 'itemattr' => array('default' => ''),
+ /**
+ * listseparators is an array of four tags (in wiki syntax)
which defines the output of DPL
+ * if mode = 'userformat' was specified.
+ * '\n' or '¶' in the input will be interpreted as a newline
character.
+ * '%xxx%' in the input will be replaced by a
corresponding value (xxx= PAGE, NR, COUNT etc.)
+ * t1 and t4 are the "outer envelope" for the whole result list,
+ * t2,t3 form an inner envelope around the article name of each
entry.
+ * Examples: listseparators={|,,\n#[[%PAGE%]]
+ * Note: use of html tags was abolished from version 2.0; the
first example must be written as:
+ * : listseparators={|,\n|-\n|[[%PAGE%]],,\n|}
+ */
+ 'listseparators' => array('default' => ''),
+ /**
+ * sequence of four wiki tags (separated by ",") to be used
together with mode = 'userformat'
+ * t1 and t4 define an outer frame for the article
list
+ * t2 and t3 build an inner frame for each article
name
+ * example: listattr=<ul>,<li>,</li>,</ul>
+ */
+ 'listattr' => array('default' => ''),
+ /**
+ * this parameter restricts the output to articles which can
reached via a link from the specified pages.
+ * Examples: linksfrom=my article|your article
+ */
+ 'linksfrom' => array('default' => ''),
+ /**
+ * this parameter restricts the output to articles which cannot
be reached via a link from the specified pages.
+ * Examples: notlinksfrom=my article|your article
+ */
+ 'notlinksfrom' => array('default' => ''),
+ /**
+ * this parameter restricts the output to articles which
contain a reference to one of the specified pages.
+ * Examples: linksto=my article|your article ,
linksto=Template:my template , linksto = {{FULLPAGENAME}}
+ */
+ 'linksto' => array('default' => ''),
+ /**
+ * this parameter restricts the output to articles which do not
contain a reference to the specified page.
+ */
+ 'notlinksto' => array('default' => ''),
+ /**
+ * this parameter restricts the output to articles which
contain an external reference that conatins a certain pattern
+ * Examples: linkstoexternal= www.xyz.com|www.xyz2.com
+ */
+ 'linkstoexternal' => array('default' => ''),
+ /**
+ * this parameter restricts the output to articles which use
one of the specified images.
+ * Examples: imageused=Image:my image|Image:your image
+ */
+ 'imageused' => array('default' => ''),
+ /**
* this parameter restricts the output to images which are used
(contained) by one of the specified pages.
* Examples: imagecontainer=my article|your article
*/
'imagecontainer' => array('default' => ''),
- /**
- * this parameter restricts the output to articles which use the
specified template.
- * Examples: uses=Template:my template
- */
- 'uses' => array('default' => ''),
- /**
- * this parameter restricts the output to articles which do not use
the specified template.
- * Examples: notuses=Template:my template
- */
- 'notuses' => array('default' => ''),
- /**
- * this parameter restricts the output to the template used by the
specified page.
- */
- 'usedby' => array('default' => ''),
- /**
- * allows to specify a username who must be the first editor of the
pages we select
- */
- 'createdby' => null,
- /**
- * allows to specify a username who must not be the first editor of
the pages we select
- */
- 'notcreatedby' => null,
- /**
- * allows to specify a username who must be among the editors of the
pages we select
- */
- 'modifiedby' => null,
- /**
- * allows to specify a username who must not be among the editors of
the pages we select
- */
- 'notmodifiedby' => null,
- /**
- * allows to specify a username who must be the last editor of the
pages we select
- */
- 'lastmodifiedby' => null,
- /**
- * allows to specify a username who must not be the last editor of the
pages we select
- */
- 'notlastmodifiedby' => null,
- /**
- * Mode for list of pages (possibly within a heading, see
'headingmode' param).
- * 'none' mode is implemented as a specific submode of 'inline' with
<br /> as inline text
- * 'userformat' does not produce any html tags unless 'listseparators'
are specified
- */
- 'mode' => null, // depends on behaveAs...
mode
- /**
- * by default links to articles of type image or category are escaped
(i.e. they appear as a link and do not
- * actually assign the category or show the image; this can be changed.
- * 'true' default
- * 'false' images are shown, categories are assigned to the current
document
- */
- 'escapelinks' => array('default' => 'true','false', 'no',
'yes', '0', '1', 'off', 'on'),
- /**
- * by default the oage containingthe query will not be part of the
result set.
- * This can be changed via 'skipthispage=no'. This should be used with
care as it may lead to
- * problems which are hard to track down, esp. in combination with
contents transclusion.
- */
- 'skipthispage' => array('default' => 'true','false', 'no',
'yes', '0', '1', 'off', 'on'),
- /**
- * namespace= Ns1 | Ns2 | ...
- * [Special value] NsX='' (empty string without quotes) means Main
namespace
- * Means pages have to be in namespace Ns1 OR Ns2 OR...
- * Magic words allowed.
- */
- 'namespace' => null,
- /**
- * notcategory= Cat1
- * notcategory = Cat2
- * ...
- * Means pages can be NEITHER in category Cat1 NOR in Cat2 NOR...
- * @todo define 'notcategory' options (retrieve list of categories
from 'categorylinks' table?)
- */
- 'notcategory' => null,
- 'notcategorymatch' => null,
- 'notcategoryregexp' => null,
- /**
- * notnamespace= Ns1
- * notnamespace= Ns2
- * ...
- * [Special value] NsX='' (empty string without quotes) means Main
namespace
- * Means pages have to be NEITHER in namespace Ns1 NOR Ns2 NOR...
- * Magic words allowed.
- */
- 'notnamespace' => null,
- /**
- * title is the exact name of a page; this is useful if you want to
use DPL
- * just for contents inclusion; mode=userformat is automatically
implied with title=
- */
- 'title' => null,
- /**
- * titlematch is a (SQL-LIKE-expression) pattern
- * which restricts the result to pages matching that pattern
- */
- 'title<' => null,
- 'title>' => null,
- 'scroll' => array('default' => 'false', 'true', 'no',
'yes', '0', '1', 'off', 'on'),
- 'titlematch' => null,
- 'titleregexp' => null,
- 'userdateformat' => null, // depends on behaveAs... mode
- 'updaterules' => array('default' => ''),
- 'deleterules' => array('default' => ''),
+ /**
+ * this parameter restricts the output to articles which use
the specified template.
+ * Examples: uses=Template:my template
+ */
+ 'uses' => array('default' => ''),
+ /**
+ * this parameter restricts the output to articles which do not
use the specified template.
+ * Examples: notuses=Template:my template
+ */
+ 'notuses' => array('default' => ''),
+ /**
+ * this parameter restricts the output to the template used by
the specified page.
+ */
+ 'usedby' => array('default' => ''),
+ /**
+ * allows to specify a username who must be the first editor of
the pages we select
+ */
+ 'createdby' => null,
+ /**
+ * allows to specify a username who must not be the first
editor of the pages we select
+ */
+ 'notcreatedby' => null,
+ /**
+ * allows to specify a username who must be among the editors
of the pages we select
+ */
+ 'modifiedby' => null,
+ /**
+ * allows to specify a username who must not be among the
editors of the pages we select
+ */
+ 'notmodifiedby' => null,
+ /**
+ * allows to specify a username who must be the last editor of
the pages we select
+ */
+ 'lastmodifiedby' => null,
+ /**
+ * allows to specify a username who must not be the last editor
of the pages we select
+ */
+ 'notlastmodifiedby' => null,
+ /**
+ * Mode for list of pages (possibly within a heading, see
'headingmode' param).
+ * 'none' mode is implemented as a specific submode of 'inline'
with <br /> as inline text
+ * 'userformat' does not produce any html tags unless
'listseparators' are specified
+ */
+ 'mode' => null, // depends on
behaveAs... mode
+ /**
+ * by default links to articles of type image or category are
escaped (i.e. they appear as a link and do not
+ * actually assign the category or show the image; this can be
changed.
+ * 'true' default
+ * 'false' images are shown, categories are assigned to the
current document
+ */
+ 'escapelinks' => array('default' => 'true','false',
'no', 'yes', '0', '1', 'off', 'on'),
+ /**
+ * by default the oage containingthe query will not be part of
the result set.
+ * This can be changed via 'skipthispage=no'. This should be
used with care as it may lead to
+ * problems which are hard to track down, esp. in combination
with contents transclusion.
+ */
+ 'skipthispage' => array('default' => 'true','false',
'no', 'yes', '0', '1', 'off', 'on'),
+ /**
+ * namespace= Ns1 | Ns2 | ...
+ * [Special value] NsX='' (empty string without quotes) means
Main namespace
+ * Means pages have to be in namespace Ns1 OR Ns2 OR...
+ * Magic words allowed.
+ */
+ 'namespace' => null,
+ /**
+ * notcategory= Cat1
+ * notcategory = Cat2
+ * ...
+ * Means pages can be NEITHER in category Cat1 NOR in Cat2
NOR...
+ * @todo define 'notcategory' options (retrieve list of
categories from 'categorylinks' table?)
+ */
+ 'notcategory' => null,
+ 'notcategorymatch' => null,
+ 'notcategoryregexp' => null,
+ /**
+ * notnamespace= Ns1
+ * notnamespace= Ns2
+ * ...
+ * [Special value] NsX='' (empty string without quotes) means
Main namespace
+ * Means pages have to be NEITHER in namespace Ns1 NOR Ns2
NOR...
+ * Magic words allowed.
+ */
+ 'notnamespace' => null,
+ /**
+ * title is the exact name of a page; this is useful if you
want to use DPL
+ * just for contents inclusion; mode=userformat is
automatically implied with title=
+ */
+ 'title' => null,
+ /**
+ * titlematch is a (SQL-LIKE-expression) pattern
+ * which restricts the result to pages matching that pattern
+ */
+ 'title<' => null,
+ 'title>' => null,
+ 'scroll' => array('default' => 'false', 'true',
'no', 'yes', '0', '1', 'off', 'on'),
+ 'titlematch' => null,
+ 'titleregexp' => null,
+ 'userdateformat' => null, // depends on behaveAs...
mode
+ 'updaterules' => array('default' => ''),
+ 'deleterules' => array('default' => ''),
- /**
- * nottitlematch is a (SQL-LIKE-expression) pattern
- * which excludes pages matching that pattern from the result
- */
- 'nottitlematch' => null,
- 'nottitleregexp' => null,
- 'order' => null, // depends on
behaveAs... mode
- /**
- * we can specify something like "latin1_swedish_ci" for case
insensitive sorting
- */
- 'ordercollation' => array('default' => ''),
- /**
- * 'ordermethod=param1,param2' means ordered by param1 first, then by
param2.
- * @todo: add 'ordermethod=category,categoryadd' (for each category
CAT, pages ordered by date when page was added to CAT).
- */
- 'ordermethod' => null, // depends on behaveAs... mode
- /**
- * minoredits =... (compatible with ordermethod=...,firstedit |
lastedit only)
- * - exclude: ignore minor edits when sorting the list (rev_minor_edit
= 0 only)
- * - include: include minor edits
- */
- 'minoredits' => array('default' => 'include', 'exclude',
'include'),
- /**
- * lastrevisionbefore = select the latest revision which was existent
before the specified point in time
- */
- 'lastrevisionbefore' => array('default' => '', 'pattern' =>
'#^[-./:0-9]+$#'),
- /**
- * allrevisionsbefore = select the revisions which were created before
the specified point in time
- */
- 'allrevisionsbefore' => array('default' => '', 'pattern' =>
'#^[-./:0-9]+$#'),
- /**
- * firstrevisionsince = select the first revision which was created
after the specified point in time
- */
- 'firstrevisionsince' => array('default' => '', 'pattern' =>
'#^[-./:0-9]+$#'),
- /**
- * allrevisionssince = select the latest revisions which were created
after the specified point in time
- */
- 'allrevisionssince' => array('default' => '', 'pattern' =>
'#^[-./:0-9]+$#'),
- /**
- * Minimum/Maximum number of revisions required
- */
- 'minrevisions' => array('default' => '', 'pattern' =>
'/^\d*$/'),
- 'maxrevisions' => array('default' => '', 'pattern' =>
'/^\d*$/'),
- /**
- * noresultsheader / footer is some wiki text which will be output
(instead of a warning message)
- * if the result set is empty; setting 'noresultsheader' to something
like ' ' will suppress
- * the warning about empty result set.
- */
- 'suppresserrors' => array('default' => 'false', 'true', 'no',
'yes', '0', '1', 'off', 'on'),
- 'noresultsheader' => array('default' => ''),
- 'noresultsfooter' => array('default' => ''),
- /**
- * oneresultsheader / footer is some wiki text which will be output
- * if the result set contains exactly one entry.
- */
- 'oneresultheader' => array('default' => ''),
- 'oneresultfooter' => array('default' => ''),
- /**
- * openreferences =...
- * - no: excludes pages which do not exist (=default)
- * - yes: includes pages which do not exist -- this conflicts with
some other options
- * - only: show only non existing pages [ not implemented so far ]
- */
- 'openreferences' => array('default' => 'false', 'true', 'no',
'yes', '0', '1', 'off', 'on'),
- /**
- * redirects =...
- * - exclude: excludes redirect pages from lists (page_is_redirect = 0
only)
- * - include: allows redirect pages to appear in lists
- * - only: lists only redirect pages in lists (page_is_redirect = 1
only)
- */
- 'redirects' => array('default' => 'exclude', 'exclude',
'include', 'only'),
- /**
- * stablepages =...
- * - exclude: excludes stable pages from lists
- * - include: allows stable pages to appear in lists
- * - only: lists only stable pages in lists
- */
- 'stablepages' => array('default' => 'include', 'exclude',
'include', 'only'),
- /**
- * qualitypages =...
- * - exclude: excludes quality pages from lists
- * - include: allows quality pages to appear in lists
- * - only: lists only quality pages in lists
- */
- 'qualitypages' => array('default' => 'include', 'exclude',
'include', 'only'),
- /**
- * resultsheader / footer is some wiki text which will be output
before / after the result list
- * (if there is at least one result); if 'oneresultheader / footer' is
specified it will only be
- * used if there are at least TWO results
- */
- 'resultsheader' => array('default' => ''),
- 'resultsfooter' => array('default' => ''),
- /**
- * reset=..
- * categories: remove all category links which have been defined
before the dpl call,
- * typically resulting from template calls or
transcluded contents
- * templates: the same with templates
- * images: the same with images
- * links: the same with internal and external links, throws
away ALL links, not only DPL generated links!
- * all all of the above
- */
- 'reset' => array( 'default' => '', 'categories',
'templates', 'links', 'images', 'all', 'none'),
- /**
- * fixcategory=.. prevents a category from being reset
- */
- 'fixcategory' => array( 'default' => ''),
- /**
- * number of rows for output, default is 1
- * note: a "row" is a group of lines for which the heading tags
defined in listseparators/format will be repeated
- */
- 'rows' => array('default' => '', 'pattern' =>
'/^\d+$/'),
- /**
- * number of elements in a rows for output, default is "all"
- * note: a "row" is a group of lines for which the heading tags
defined in listeseparators will be repeated
- */
- 'rowsize' => array('default' => '', 'pattern' =>
'/^\d+$/'),
- /**
- * the html tags used for columns and rows
- */
- 'rowcolformat' => array('default' => ''),
- /**
- * secseparators is a sequence of pairs of tags used to separate
sections (see "includepage=name1, name2, ..")
- * each pair corresponds to one entry in the includepage command
- * if only one tag is given it will be used for all sections as a
start tag (end tag will be empty then)
- */
- 'secseparators' => array('default' => ''),
- /**
- * multisecseparators is a list of tags (which correspond to the items
in includepage)
- * and which are put between identical sections included from the same
file
- */
- 'multisecseparators' => array('default' => ''),
- /**
- * dominantSection is the number (starting from 1) of an includepage
argument which shall be used
- * as a dominant value set for the creation of additional output rows
(one per value of the
- * dominant column
- */
- 'dominantsection' => array('default' => '0', 'pattern' =>
'/^\d*$/'),
- /**
- * showcurid creates a stable link to the current revision of a page
- */
- 'showcurid' => array('default' => 'false', 'true', 'no',
'yes', '0', '1', 'off', 'on'),
- /**
- * shownamespace decides whether to show the namespace prefix or not
- */
- 'shownamespace' => array('default' => 'true', 'false', 'no',
'yes', '0', '1', 'off', 'on'),
- /**
- * replaceintitle applies a regex replacement to %TITLE%
- */
- 'replaceintitle' => array('default' => ''),
- /**
- * table is a short hand for combined values of listseparators,
colseparators and mulicolseparators
- */
- 'table' => array('default' => ''),
- /**
- * tablerow allows to define individual formats for table columns
- */
- 'tablerow' => array('default' => ''),
- /**
- * The number (starting with 1) of the column to be used for sorting
- */
- 'tablesortcol' => array('default' => '0', 'pattern' =>
'/^-?\d*$/'),
- /**
- * Max # characters of page title to display.
- * Empty value (default) means no limit.
- * Not applicable to mode=category.
- */
- 'titlemaxlength' => array('default' => '', 'pattern' =>
'/^\d*$/')
- );
+ /**
+ * nottitlematch is a (SQL-LIKE-expression) pattern
+ * which excludes pages matching that pattern from the result
+ */
+ 'nottitlematch' => null,
+ 'nottitleregexp' => null,
+ 'order' => null, // depends on
behaveAs... mode
+ /**
+ * we can specify something like "latin1_swedish_ci" for case
insensitive sorting
+ */
+ 'ordercollation' => array('default' => ''),
+ /**
+ * 'ordermethod=param1,param2' means ordered by param1 first,
then by param2.
+ * @todo: add 'ordermethod=category,categoryadd' (for each
category CAT, pages ordered by date when page was added to CAT).
+ */
+ 'ordermethod' => null, // depends on behaveAs... mode
+ /**
+ * minoredits =... (compatible with ordermethod=...,firstedit |
lastedit only)
+ * - exclude: ignore minor edits when sorting the list
(rev_minor_edit = 0 only)
+ * - include: include minor edits
+ */
+ 'minoredits' => array('default' => 'include',
'exclude', 'include'),
+ /**
+ * lastrevisionbefore = select the latest revision which was
existent before the specified point in time
+ */
+ 'lastrevisionbefore' => array('default' => '', 'pattern' =>
'#^[-./:0-9]+$#'),
+ /**
+ * allrevisionsbefore = select the revisions which were created
before the specified point in time
+ */
+ 'allrevisionsbefore' => array('default' => '', 'pattern' =>
'#^[-./:0-9]+$#'),
+ /**
+ * firstrevisionsince = select the first revision which was
created after the specified point in time
+ */
+ 'firstrevisionsince' => array('default' => '', 'pattern' =>
'#^[-./:0-9]+$#'),
+ /**
+ * allrevisionssince = select the latest revisions which were
created after the specified point in time
+ */
+ 'allrevisionssince' => array('default' => '', 'pattern' =>
'#^[-./:0-9]+$#'),
+ /**
+ * Minimum/Maximum number of revisions required
+ */
+ 'minrevisions' => array('default' => '', 'pattern' =>
'/^\d*$/'),
+ 'maxrevisions' => array('default' => '', 'pattern' =>
'/^\d*$/'),
+ /**
+ * noresultsheader / footer is some wiki text which will be
output (instead of a warning message)
+ * if the result set is empty; setting 'noresultsheader' to
something like ' ' will suppress
+ * the warning about empty result set.
+ */
+ 'suppresserrors' => array('default' => 'false', 'true',
'no', 'yes', '0', '1', 'off', 'on'),
+ 'noresultsheader' => array('default' => ''),
+ 'noresultsfooter' => array('default' => ''),
+ /**
+ * oneresultsheader / footer is some wiki text which will be
output
+ * if the result set contains exactly one entry.
+ */
+ 'oneresultheader' => array('default' => ''),
+ 'oneresultfooter' => array('default' => ''),
+ /**
+ * openreferences =...
+ * - no: excludes pages which do not exist (=default)
+ * - yes: includes pages which do not exist -- this conflicts
with some other options
+ * - only: show only non existing pages [ not implemented so
far ]
+ */
+ 'openreferences' => array('default' => 'false', 'true',
'no', 'yes', '0', '1', 'off', 'on'),
+ /**
+ * redirects =...
+ * - exclude: excludes redirect pages from lists
(page_is_redirect = 0 only)
+ * - include: allows redirect pages to appear in lists
+ * - only: lists only redirect pages in lists (page_is_redirect
= 1 only)
+ */
+ 'redirects' => array('default' => 'exclude',
'exclude', 'include', 'only'),
+ /**
+ * stablepages =...
+ * - exclude: excludes stable pages from lists
+ * - include: allows stable pages to appear in lists
+ * - only: lists only stable pages in lists
+ */
+ 'stablepages' => array('default' => 'include',
'exclude', 'include', 'only'),
+ /**
+ * qualitypages =...
+ * - exclude: excludes quality pages from lists
+ * - include: allows quality pages to appear in lists
+ * - only: lists only quality pages in lists
+ */
+ 'qualitypages' => array('default' => 'include',
'exclude', 'include', 'only'),
+ /**
+ * resultsheader / footer is some wiki text which will be
output before / after the result list
+ * (if there is at least one result); if 'oneresultheader /
footer' is specified it will only be
+ * used if there are at least TWO results
+ */
+ 'resultsheader' => array('default' => ''),
+ 'resultsfooter' => array('default' => ''),
+ /**
+ * reset=..
+ * categories: remove all category links which have been
defined before the dpl call,
+ * typically resulting from template
calls or transcluded contents
+ * templates: the same with templates
+ * images: the same with images
+ * links: the same with internal and external links,
throws away ALL links, not only DPL generated links!
+ * all all of the above
+ */
+ 'reset' => array( 'default' => '', 'categories',
'templates', 'links', 'images', 'all', 'none'),
+ /**
+ * fixcategory=.. prevents a category from being reset
+ */
+ 'fixcategory' => array( 'default' => ''),
+ /**
+ * number of rows for output, default is 1
+ * note: a "row" is a group of lines for which the heading tags
defined in listseparators/format will be repeated
+ */
+ 'rows' => array('default' => '', 'pattern' =>
'/^\d+$/'),
+ /**
+ * number of elements in a rows for output, default is "all"
+ * note: a "row" is a group of lines for which the heading tags
defined in listeseparators will be repeated
+ */
+ 'rowsize' => array('default' => '', 'pattern' =>
'/^\d+$/'),
+ /**
+ * the html tags used for columns and rows
+ */
+ 'rowcolformat' => array('default' => ''),
+ /**
+ * secseparators is a sequence of pairs of tags used to
separate sections (see "includepage=name1, name2, ..")
+ * each pair corresponds to one entry in the includepage command
+ * if only one tag is given it will be used for all sections as
a start tag (end tag will be empty then)
+ */
+ 'secseparators' => array('default' => ''),
+ /**
+ * multisecseparators is a list of tags (which correspond to
the items in includepage)
+ * and which are put between identical sections included from
the same file
+ */
+ 'multisecseparators' => array('default' => ''),
+ /**
+ * dominantSection is the number (starting from 1) of an
includepage argument which shall be used
+ * as a dominant value set for the creation of additional
output rows (one per value of the
+ * dominant column
+ */
+ 'dominantsection' => array('default' => '0', 'pattern' =>
'/^\d*$/'),
+ /**
+ * showcurid creates a stable link to the current revision of a
page
+ */
+ 'showcurid' => array('default' => 'false',
'true', 'no', 'yes', '0', '1', 'off', 'on'),
+ /**
+ * shownamespace decides whether to show the namespace prefix
or not
+ */
+ 'shownamespace' => array('default' => 'true', 'false',
'no', 'yes', '0', '1', 'off', 'on'),
+ /**
+ * replaceintitle applies a regex replacement to %TITLE%
+ */
+ 'replaceintitle' => array('default' => ''),
+ /**
+ * table is a short hand for combined values of listseparators,
colseparators and mulicolseparators
+ */
+ 'table' => array('default' => ''),
+ /**
+ * tablerow allows to define individual formats for table
columns
+ */
+ 'tablerow' => array('default' => ''),
+ /**
+ * The number (starting with 1) of the column to be used for
sorting
+ */
+ 'tablesortcol' => array('default' => '0', 'pattern' =>
'/^-?\d*$/'),
+ /**
+ * Max # characters of page title to display.
+ * Empty value (default) means no limit.
+ * Not applicable to mode=category.
+ */
+ 'titlemaxlength' => array('default' => '', 'pattern' =>
'/^\d*$/')
+ );
- // Note: If you add a line like the following to your LocalSetings.php,
DPL will only run from protected pages
+ // Note: If you add a line like the following to your LocalSetings.php,
DPL will only run from protected pages
// ExtDynamicPageList::$options['RunFromProtectedPagesOnly'] =
"<small><i>Extension DPL (warning): current configuration allows execution from
protected pages only.</i></small>";
public static $validParametersForRichnessLevel = array(
- 0 => '
+ 0 => '
addfirstcategorydate
category
count
@@ -1060,7 +1060,7 @@
stablepages
suppresserrors
',
- 1 => '
+ 1 => '
allowcachedresults
execandexit
columns
@@ -1078,7 +1078,7 @@
noresultsfooter
noresultsheader
randomcount
- randomseed
+ randomseed
replaceintitle
resultsfooter
resultsheader
@@ -1092,7 +1092,7 @@
titlemaxlength
userdateformat
',
- 2 => '
+ 2 => '
addauthor
addcategories
addcontribution
@@ -1151,7 +1151,7 @@
usedby
uses
',
- 3 => '
+ 3 => '
allrevisionsbefore
allrevisionssince
articlecategory
@@ -1168,230 +1168,231 @@
openreferences
titleregexp
',
- 4 => '
+ 4 => '
deleterules
goal
updaterules
',
- );
-
+ );
- public static $debugMinLevels = array();
- public static $createdLinks; // the links created by DPL are collected
here;
- // they can be removed during the final ouput
- // phase of the MediaWiki parser
- private static function behaveLikeIntersection($mode) {
+ public static $debugMinLevels = array();
+ public static $createdLinks; // the links created by DPL are collected
here;
+ // they can be removed during the final ouput
+ // phase of the MediaWiki parser
+
+ private static function behaveLikeIntersection($mode) {
self::$behavingLikeIntersection = $mode;
}
- public static function setFunctionalRichness($level) {
+ public static function setFunctionalRichness($level) {
self::$functionalRichness = $level;
}
- public static function setupDPL() {
+ public static function setupDPL() {
global $wgParser;
// DPL offers the same functionality as Intersection; so we
register the <DynamicPageList> tag
// in case LabeledSection Extension is not installed we need to
remove section markers
- $wgParser->setHook( 'section', array( __CLASS__,
'removeSectionMarkers' ) );
- $wgParser->setHook( 'DPL', array( __CLASS__, 'dplTag'
) );
+ $wgParser->setHook( 'section', array( __CLASS__,
'removeSectionMarkers' ) );
+ $wgParser->setHook( 'DPL', array( __CLASS__,
'dplTag' ) );
$wgParser->setHook( 'DynamicPageList', array( __CLASS__,
'intersectionTag' ) );
-
- $wgParser->setFunctionHook( 'dpl', array( __CLASS__,
'dplParserFunction' ) );
- $wgParser->setFunctionHook( 'dplnum', array( __CLASS__,
'dplNumParserFunction' ) );
- $wgParser->setFunctionHook( 'dplvar', array( __CLASS__,
'dplVarParserFunction' ) );
- $wgParser->setFunctionHook( 'dplreplace', array( __CLASS__,
'dplReplaceParserFunction' ) );
- $wgParser->setFunctionHook( 'dplchapter', array( __CLASS__,
'dplChapterParserFunction' ) );
- $wgParser->setFunctionHook( 'dplmatrix', array( __CLASS__,
'dplMatrixParserFunction' ) );
+
+ $wgParser->setFunctionHook( 'dpl', array( __CLASS__,
'dplParserFunction' ) );
+ $wgParser->setFunctionHook( 'dplnum', array( __CLASS__,
'dplNumParserFunction' ) );
+ $wgParser->setFunctionHook( 'dplvar', array( __CLASS__,
'dplVarParserFunction' ) );
+ $wgParser->setFunctionHook( 'dplreplace', array( __CLASS__,
'dplReplaceParserFunction' ) );
+ $wgParser->setFunctionHook( 'dplchapter', array( __CLASS__,
'dplChapterParserFunction' ) );
+ $wgParser->setFunctionHook( 'dplmatrix', array( __CLASS__,
'dplMatrixParserFunction' ) );
self::commonSetup();
- }
-
- public static function setupMigration() {
+ }
+
+ public static function setupMigration() {
// DPL offers the same functionality as Intersection under the
tag name <Intersection>
- global $wgParser;
+ global $wgParser;
$wgParser->setHook( 'Intersection', array( __CLASS__,
'intersectionTag' ) );
-
+
self::commonSetup();
- }
+ }
private static function commonSetup() {
-
- if (!isset(self::$createdLinks)) {
- self::$createdLinks=array(
- 'resetLinks'=> false, 'resetTemplates' => false,
- 'resetCategories' => false, 'resetImages' => false,
'resetdone' => false , 'elimdone' => false );
- }
- // make sure page "Template:Extension DPL" exists
- $title = Title::newFromText('Template:Extension DPL');
- global $wgUser;
- if (!$title->exists() && $wgUser->isAllowed('edit')) {
- $article = new Article($title);
- $article->doEdit( "<noinclude>This page was
automatically created. It serves as an anchor page for ".
- "all
'''[[Special:WhatLinksHere/Template:Extension_DPL|invocations]]''' ".
- "of
[http://mediawiki.org/wiki/Extension:DynamicPageList Extension:DynamicPageList
(DPL)].</noinclude>",
- $title, EDIT_NEW |
EDIT_FORCE_BOT );
- die(header('Location:
'.Title::newFromText('Template:Extension DPL')->getFullURL()));
+ if (!isset(self::$createdLinks)) {
+ self::$createdLinks=array(
+ 'resetLinks'=> false, 'resetTemplates' => false,
+ 'resetCategories' => false, 'resetImages' =>
false, 'resetdone' => false , 'elimdone' => false );
}
- require_once( 'DPLVariables.php' );
+ if ( !defined( "MW_UPDATER" ) ) {
+ // make sure page "Template:Extension DPL" exists
+ $title = Title::newFromText('Template:Extension DPL');
+ global $wgUser;
+ if (!$title->exists() && $wgUser->isAllowed('edit')) {
+ $article = new Article($title);
+ $article->doEdit( "<noinclude>This page was
automatically created. It serves as an anchor page for ".
+ "all
'''[[Special:WhatLinksHere/Template:Extension_DPL|invocations]]''' ".
+ "of
[http://mediawiki.org/wiki/Extension:DynamicPageList Extension:DynamicPageList
(DPL)].</noinclude>",
+ $title, EDIT_NEW | EDIT_FORCE_BOT );
+ die(header('Location:
'.Title::newFromText('Template:Extension DPL')->getFullURL()));
+ }
+ }
+ require_once( 'DPLVariables.php' );
}
private static function loadMessages() {
- /**
- * Define codes and map debug message to min debug level above which
message can be displayed
- */
- $debugCodes = array(
- // FATAL
- 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
- // WARN
- 2, 2, 2, 2, 2, 2, 2, 2,
- // DEBUG
- 3
- );
+ /**
+ * Define codes and map debug message to min debug level above
which message can be displayed
+ */
+ $debugCodes = array(
+ // FATAL
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ // WARN
+ 2, 2, 2, 2, 2, 2, 2, 2,
+ // DEBUG
+ 3
+ );
- foreach ($debugCodes as $i => $minlevel )
- {
- self::$debugMinLevels[$i] = $minlevel;
- }
+ foreach ($debugCodes as $i => $minlevel )
+ {
+ self::$debugMinLevels[$i] = $minlevel;
+ }
}
private static function loadModules() {
-
+
if (self::$modulesLoaded == true) return;
-
+
self::loadMessages();
- require_once( 'DynamicPageListInclude.php' );
- require_once( 'DPL.php' );
- require_once( 'DPLMain.php' );
- require_once( 'DPLArticle.php' );
- require_once( 'DPLListMode.php' );
- require_once( 'DPLVariables.php' );
- require_once( 'DPLLogger.php' );
+ require_once( 'DynamicPageListInclude.php' );
+ require_once( 'DPL.php' );
+ require_once( 'DPLMain.php' );
+ require_once( 'DPLArticle.php' );
+ require_once( 'DPLListMode.php' );
+ require_once( 'DPLVariables.php' );
+ require_once( 'DPLLogger.php' );
self::$modulesLoaded = true;
}
-
- public static function languageGetMagic( &$magicWords, $langCode ) {
- # Add the magic word
- # The first array element is case sensitivity, in this case it is not
case sensitive
- # All remaining elements are synonyms for our parser function
- $magicWords['dpl'] = array( 0, 'dpl' );
- $magicWords['dplnum'] = array( 0, 'dplnum' );
- $magicWords['dplvar'] = array( 0, 'dplvar' );
- $magicWords['dplreplace'] = array( 0, 'dplreplace' );
- $magicWords['dplchapter'] = array( 0, 'dplchapter' );
- $magicWords['dplmatrix'] = array( 0, 'dplmatrix' );
- $magicWords['DynamicPageList'] = array( 0, 'DynamicPageList' );
- # unless we return true, other parser functions extensions won't get
loaded.
- return true;
- }
-
//-------------------------------------------------------------------------------------
ENTRY parser TAG intersection
- public static function intersectionTag( $input, $params, $parser ) {
+ public static function languageGetMagic( &$magicWords, $langCode ) {
+ # Add the magic word
+ # The first array element is case sensitivity, in this case it
is not case sensitive
+ # All remaining elements are synonyms for our parser function
+ $magicWords['dpl'] = array( 0, 'dpl' );
+ $magicWords['dplnum'] = array( 0, 'dplnum' );
+ $magicWords['dplvar'] = array( 0, 'dplvar' );
+ $magicWords['dplreplace'] = array( 0, 'dplreplace' );
+ $magicWords['dplchapter'] = array( 0, 'dplchapter' );
+ $magicWords['dplmatrix'] = array( 0, 'dplmatrix' );
+ $magicWords['DynamicPageList'] = array( 0, 'DynamicPageList' );
+ # unless we return true, other parser functions extensions
won't get loaded.
+ return true;
+ }
+
+
//-------------------------------------------------------------------------------------
ENTRY parser TAG intersection
+ public static function intersectionTag( $input, $params, $parser ) {
self::behaveLikeIntersection(true);
return self::executeTag($input, $params, $parser);
}
-
//-------------------------------------------------------------------------------------
ENTRY parser TAG dpl
- public static function dplTag( $input, $params, $parser ) {
+
//-------------------------------------------------------------------------------------
ENTRY parser TAG dpl
+ public static function dplTag( $input, $params, $parser ) {
self::behaveLikeIntersection(false);
return self::executeTag($input, $params, $parser);
}
-
//-------------------------------------------------------------------------------------
ENTRY parser TAG
- // The callback function wrapper for converting the input text to HTML
output
- private static function executeTag( $input, $params, $parser ) {
+
//-------------------------------------------------------------------------------------
ENTRY parser TAG
+ // The callback function wrapper for converting the input text to HTML
output
+ private static function executeTag( $input, $params, $parser ) {
// late loading of php modules, only if needed
self::loadModules();
- // entry point for user tag <dpl> or <DynamicPageList>
- // create list and do a recursive parse of the output
-
- // $dump1 = self::dumpParsedRefs($parser,"before DPL tag");
- $text = DPLMain::dynamicPageList($input, $params, $parser, $reset,
'tag');
- // $dump2 = self::dumpParsedRefs($parser,"after DPL tag");
- if ($reset[1]) { // we can remove the templates by save/restore
- $saveTemplates = $parser->mOutput->mTemplates;
- }
- if ($reset[2]) { // we can remove the categories by save/restore
- $saveCategories = $parser->mOutput->mCategories;
- }
- if ($reset[3]) { // we can remove the images by save/restore
- $saveImages = $parser->mOutput->mImages;
- }
- $parsedDPL = $parser->recursiveTagParse($text);
- if ($reset[1]) { // TEMPLATES
- $parser->mOutput->mTemplates =$saveTemplates;
- }
- if ($reset[2]) { // CATEGORIES
- $parser->mOutput->mCategories =$saveCategories;
- }
- if ($reset[3]) { // IMAGES
- $parser->mOutput->mImages =$saveImages;
- }
- // $dump3 = self::dumpParsedRefs($parser,"after tag parse");
- // return $dump1.$parsedDPL.$dump2.$dump3;
- return $parsedDPL;
- }
+ // entry point for user tag <dpl> or <DynamicPageList>
+ // create list and do a recursive parse of the output
+
+ // $dump1 = self::dumpParsedRefs($parser,"before DPL tag");
+ $text = DPLMain::dynamicPageList($input, $params, $parser,
$reset, 'tag');
+ // $dump2 = self::dumpParsedRefs($parser,"after DPL tag");
+ if ($reset[1]) { // we can remove the templates by
save/restore
+ $saveTemplates = $parser->mOutput->mTemplates;
+ }
+ if ($reset[2]) { // we can remove the categories by
save/restore
+ $saveCategories = $parser->mOutput->mCategories;
+ }
+ if ($reset[3]) { // we can remove the images by
save/restore
+ $saveImages = $parser->mOutput->mImages;
+ }
+ $parsedDPL = $parser->recursiveTagParse($text);
+ if ($reset[1]) { // TEMPLATES
+ $parser->mOutput->mTemplates =$saveTemplates;
+ }
+ if ($reset[2]) { // CATEGORIES
+ $parser->mOutput->mCategories =$saveCategories;
+ }
+ if ($reset[3]) { // IMAGES
+ $parser->mOutput->mImages =$saveImages;
+ }
+ // $dump3 = self::dumpParsedRefs($parser,"after tag parse");
+ // return $dump1.$parsedDPL.$dump2.$dump3;
+ return $parsedDPL;
+ }
-
//-------------------------------------------------------------------------------------
ENTRY parser FUNCTION #dpl
- public static function dplParserFunction(&$parser) {
+
//-------------------------------------------------------------------------------------
ENTRY parser FUNCTION #dpl
+ public static function dplParserFunction(&$parser) {
// late loading of php modules, only if needed
self::loadModules();
self::behaveLikeIntersection(false);
-
- // callback for the parser function {{#dpl: or {{DynamicPageList::
- $params = array();
- $input="";
-
- $numargs = func_num_args();
- if ($numargs < 2) {
- $input = "#dpl: no arguments specified";
- return str_replace('§','<','§pre>§nowiki>'.$input.'§/nowiki>§/pre>');
- }
-
- // fetch all user-provided arguments (skipping $parser)
- $arg_list = func_get_args();
- for ($i = 1; $i < $numargs; $i++) {
- $p1 = $arg_list[$i];
- $input .= str_replace("\n","",$p1) ."\n";
- }
- // for debugging you may want to uncomment the following statement
- // return
str_replace('§','<','§pre>§nowiki>'.$input.'§/nowiki>§/pre>');
-
-
- // $dump1 = self::dumpParsedRefs($parser,"before DPL func");
- // $text = DPLMain::dynamicPageList($input, $params, $parser,
$reset, 'func');
- // $dump2 = self::dumpParsedRefs($parser,"after DPL func");
- // return $dump1.$text.$dump2;
-
- $dplresult = DPLMain::dynamicPageList($input, $params, $parser,
$reset, 'func');
- return array( // parser needs to be coaxed to do further recursive
processing
- $parser->getPreprocessor()->preprocessToObj($dplresult,
Parser::PTD_FOR_INCLUSION ),
- 'isLocalObj' => true,
- 'title' => $parser->getTitle()
- );
- }
+ // callback for the parser function {{#dpl: or
{{DynamicPageList::
+ $params = array();
+ $input="";
- public static function dplNumParserFunction(&$parser, $text='') {
- $num = str_replace(' ',' ',$text);
- $num = str_replace(' ',' ',$text);
+ $numargs = func_num_args();
+ if ($numargs < 2) {
+ $input = "#dpl: no arguments specified";
+ return
str_replace('§','<','§pre>§nowiki>'.$input.'§/nowiki>§/pre>');
+ }
+
+ // fetch all user-provided arguments (skipping $parser)
+ $arg_list = func_get_args();
+ for ($i = 1; $i < $numargs; $i++) {
+ $p1 = $arg_list[$i];
+ $input .= str_replace("\n","",$p1) ."\n";
+ }
+ // for debugging you may want to uncomment the following
statement
+ // return
str_replace('§','<','§pre>§nowiki>'.$input.'§/nowiki>§/pre>');
+
+
+ // $dump1 = self::dumpParsedRefs($parser,"before DPL func");
+ // $text = DPLMain::dynamicPageList($input, $params,
$parser, $reset, 'func');
+ // $dump2 = self::dumpParsedRefs($parser,"after DPL func");
+ // return $dump1.$text.$dump2;
+
+ $dplresult = DPLMain::dynamicPageList($input, $params, $parser,
$reset, 'func');
+ return array( // parser needs to be coaxed to do further
recursive processing
+ $parser->getPreprocessor()->preprocessToObj($dplresult,
Parser::PTD_FOR_INCLUSION ),
+ 'isLocalObj' => true,
+ 'title' => $parser->getTitle()
+ );
+
+ }
+
+ public static function dplNumParserFunction(&$parser, $text='') {
+ $num = str_replace(' ',' ',$text);
+ $num = str_replace(' ',' ',$text);
$num =
preg_replace('/([0-9])([.])([0-9][0-9]?[^0-9,])/','\1,\3',$num);
$num = preg_replace('/([0-9.]+),([0-9][0-9][0-9])\s*Mrd/','\1\2
000000 ',$num);
$num = preg_replace('/([0-9.]+),([0-9][0-9])\s*Mrd/','\1\2
0000000 ',$num);
@@ -1405,187 +1406,187 @@
$num = preg_replace('/^[^0-9]+/','',$num);
$num = preg_replace('/[^0-9].*/','',$num);
return $num;
- }
+ }
- public static function dplVarParserFunction(&$parser, $cmd) {
+ public static function dplVarParserFunction(&$parser, $cmd) {
$args = func_get_args();
- if ($cmd=='set') return DPLVariables::setVar($args);
- else if ($cmd=='default') return DPLVariables::setVarDefault($args);
+ if ($cmd=='set') return DPLVariables::setVar($args);
+ else if ($cmd=='default') return
DPLVariables::setVarDefault($args);
return DPLVariables::getVar($cmd);
- }
+ }
- private static function isRegexp ($needle) {
- if (strlen($needle)<3) return false;
- if (ctype_alnum($needle[0])) return false;
- $nettoNeedle = preg_replace('/[ismu]*$/','',$needle);
- if (strlen($nettoNeedle)<2) return false;
- if ($needle[0] == $nettoNeedle[strlen($nettoNeedle)-1]) return true;
- return false;
- }
+ private static function isRegexp ($needle) {
+ if (strlen($needle)<3) return false;
+ if (ctype_alnum($needle[0])) return false;
+ $nettoNeedle = preg_replace('/[ismu]*$/','',$needle);
+ if (strlen($nettoNeedle)<2) return false;
+ if ($needle[0] == $nettoNeedle[strlen($nettoNeedle)-1]) return
true;
+ return false;
+ }
- public static function dplReplaceParserFunction(&$parser, $text, $pat,
$repl='') {
+ public static function dplReplaceParserFunction(&$parser, $text, $pat,
$repl='') {
if ($text=='' || $pat=='') return '';
- # convert \n to a real newline character
- $repl = str_replace('\n',"\n",$repl);
-
- # replace
- if (!self::isRegexp($pat) ) $pat='`'.str_replace('`','\`',$pat).'`';
-
- return preg_replace ( $pat, $repl, $text );
- }
+ # convert \n to a real newline character
+ $repl = str_replace('\n',"\n",$repl);
- public static function dplChapterParserFunction(&$parser, $text='',
$heading=' ', $maxLength = -1, $page = '?page?', $link = 'default', $trim=false
) {
- $output = DPLInclude::extractHeadingFromText($parser, $page,
'?title?', $text, $heading, '', $sectionHeading, true, $maxLength, $link,
$trim);
- return $output[0];
- }
+ # replace
+ if (!self::isRegexp($pat) )
$pat='`'.str_replace('`','\`',$pat).'`';
- public static function dplMatrixParserFunction(&$parser, $name, $yes, $no,
$flip, $matrix ) {
- $lines = explode("\n",$matrix);
- $m = array();
- $sources = array();
- $targets = array();
- $from = '';
- $to = '';
- if ($flip=='' | $flip=='normal') $flip=false;
- else
$flip=true;
- if ($name=='') $name=' ';
- if ($yes=='') $yes= ' x ';
- if ($no=='') $no = ' ';
- if ($no[0]=='-') $no = " $no ";
- foreach ($lines as $line) {
- if (strlen($line)<=0) continue;
- if ($line[0]!=' ') {
- $from = preg_split(' *\~\~ *',trim($line),2);
- if (!array_key_exists($from[0],$sources)) {
- if (count($from)<2 || $from[1]=='')
$sources[$from[0]] = $from[0];
- else
$sources[$from[0]] = $from[1];
- $m[$from[0]] = array();
- }
- }
- else if (trim($line) != '') {
- $to = preg_split(' *\~\~ *',trim($line),2);
- if (count($to)<2 || $to[1]=='') $targets[$to[0]] =
$to[0];
- else
$targets[$to[0]] = $to[1];
- $m[$from[0]][$to[0]] = true;
- }
- }
- ksort($targets);
+ return preg_replace ( $pat, $repl, $text );
+ }
- $header = "\n";
-
- if ($flip) {
- foreach ($sources as $from => $fromName) {
- $header .= "![[$from|".$fromName."]]\n";
- }
- foreach ($targets as $to => $toName) {
- $targets[$to] = "[[$to|$toName]]";
- foreach ($sources as $from => $fromName) {
- if (array_key_exists($to,$m[$from])) {
- $targets[$to] .= "\n|$yes";
- }
- else {
- $targets[$to] .= "\n|$no";
- }
- }
- $targets[$to].= "\n|--\n";
- }
- return
"{|class=dplmatrix\n|$name"."\n".$header."|--\n!".join("\n!",$targets)."\n|}";
- }
- else {
- foreach ($targets as $to => $toName) {
- $header .= "![[$to|".$toName."]]\n";
- }
- foreach ($sources as $from => $fromName) {
- $sources[$from] = "[[$from|$fromName]]";
- foreach ($targets as $to => $toName) {
- if (array_key_exists($to,$m[$from])) {
- $sources[$from] .= "\n|$yes";
- }
- else {
- $sources[$from] .= "\n|$no";
- }
- }
- $sources[$from].= "\n|--\n";
- }
- return
"{|class=dplmatrix\n|$name"."\n".$header."|--\n!".join("\n!",$sources)."\n|}";
- }
- }
+ public static function dplChapterParserFunction(&$parser, $text='',
$heading=' ', $maxLength = -1, $page = '?page?', $link = 'default', $trim=false
) {
+ $output = DPLInclude::extractHeadingFromText($parser, $page,
'?title?', $text, $heading, '', $sectionHeading, true, $maxLength, $link,
$trim);
+ return $output[0];
+ }
- private static function dumpParsedRefs($parser,$label) {
- //if (!preg_match("/Query Q/",$parser->mTitle->getText())) return '';
+ public static function dplMatrixParserFunction(&$parser, $name, $yes,
$no, $flip, $matrix ) {
+ $lines = explode("\n",$matrix);
+ $m = array();
+ $sources = array();
+ $targets = array();
+ $from = '';
+ $to = '';
+ if ($flip=='' | $flip=='normal') $flip=false;
+ else
$flip=true;
+ if ($name=='') $name=' ';
+ if ($yes=='') $yes= ' x ';
+ if ($no=='') $no = ' ';
+ if ($no[0]=='-') $no = " $no ";
+ foreach ($lines as $line) {
+ if (strlen($line)<=0) continue;
+ if ($line[0]!=' ') {
+ $from = preg_split(' *\~\~ *',trim($line),2);
+ if (!array_key_exists($from[0],$sources)) {
+ if (count($from)<2 || $from[1]=='')
$sources[$from[0]] = $from[0];
+ else
$sources[$from[0]] = $from[1];
+ $m[$from[0]] = array();
+ }
+ }
+ else if (trim($line) != '') {
+ $to = preg_split(' *\~\~ *',trim($line),2);
+ if (count($to)<2 || $to[1]=='')
$targets[$to[0]] = $to[0];
+ else
$targets[$to[0]] = $to[1];
+ $m[$from[0]][$to[0]] = true;
+ }
+ }
+ ksort($targets);
+
+ $header = "\n";
+
+ if ($flip) {
+ foreach ($sources as $from => $fromName) {
+ $header .= "![[$from|".$fromName."]]\n";
+ }
+ foreach ($targets as $to => $toName) {
+ $targets[$to] = "[[$to|$toName]]";
+ foreach ($sources as $from => $fromName) {
+ if (array_key_exists($to,$m[$from])) {
+ $targets[$to] .= "\n|$yes";
+ }
+ else {
+ $targets[$to] .= "\n|$no";
+ }
+ }
+ $targets[$to].= "\n|--\n";
+ }
+ return
"{|class=dplmatrix\n|$name"."\n".$header."|--\n!".join("\n!",$targets)."\n|}";
+ }
+ else {
+ foreach ($targets as $to => $toName) {
+ $header .= "![[$to|".$toName."]]\n";
+ }
+ foreach ($sources as $from => $fromName) {
+ $sources[$from] = "[[$from|$fromName]]";
+ foreach ($targets as $to => $toName) {
+ if (array_key_exists($to,$m[$from])) {
+ $sources[$from] .= "\n|$yes";
+ }
+ else {
+ $sources[$from] .= "\n|$no";
+ }
+ }
+ $sources[$from].= "\n|--\n";
+ }
+ return
"{|class=dplmatrix\n|$name"."\n".$header."|--\n!".join("\n!",$sources)."\n|}";
+ }
+ }
+
+ private static function dumpParsedRefs($parser,$label) {
+ //if (!preg_match("/Query Q/",$parser->mTitle->getText()))
return '';
echo '<pre>parser mLinks: ';
ob_start(); var_dump($parser->mOutput->mLinks);
$a=ob_get_contents(); ob_end_clean(); echo htmlspecialchars($a,ENT_QUOTES);
echo '</pre>';
echo '<pre>parser mTemplates: ';
ob_start(); var_dump($parser->mOutput->mTemplates);
$a=ob_get_contents(); ob_end_clean(); echo htmlspecialchars($a,ENT_QUOTES);
echo '</pre>';
- }
+ }
- //remove section markers in case the LabeledSectionTransclusion extension
is not installed.
- public static function removeSectionMarkers( $in, $assocArgs=array(),
$parser=null ) {
- return '';
- }
+ //remove section markers in case the LabeledSectionTransclusion
extension is not installed.
+ public static function removeSectionMarkers( $in, $assocArgs=array(),
$parser=null ) {
+ return '';
+ }
- public static function fixCategory($cat) {
+ public static function fixCategory($cat) {
if ($cat!='') self::$fixedCategories[$cat]=1;
- }
+ }
-// reset everything; some categories may have been fixed, however via
fixcategory=
- public static function endReset( &$parser, $text ) {
- if (!self::$createdLinks['resetdone']) {
- self::$createdLinks['resetdone'] = true;
+ // reset everything; some categories may have been fixed, however via
fixcategory=
+ public static function endReset( &$parser, $text ) {
+ if (!self::$createdLinks['resetdone']) {
+ self::$createdLinks['resetdone'] = true;
foreach ($parser->mOutput->mCategories as $key => $val)
{
if
(array_key_exists($key,self::$fixedCategories)) self::$fixedCategories[$key] =
$val;
}
- // $text .= self::dumpParsedRefs($parser,"before final reset");
- if (self::$createdLinks['resetLinks'])
$parser->mOutput->mLinks = array();
- if (self::$createdLinks['resetCategories'])
$parser->mOutput->mCategories = self::$fixedCategories;
+ // $text .= self::dumpParsedRefs($parser,"before final
reset");
+ if (self::$createdLinks['resetLinks'])
$parser->mOutput->mLinks = array();
+ if (self::$createdLinks['resetCategories'])
$parser->mOutput->mCategories = self::$fixedCategories;
if (self::$createdLinks['resetTemplates'])
$parser->mOutput->mTemplates = array();
- if (self::$createdLinks['resetImages'])
$parser->mOutput->mImages = array();
- // $text .= self::dumpParsedRefs($parser,"after final reset");
+ if (self::$createdLinks['resetImages'])
$parser->mOutput->mImages = array();
+ // $text .= self::dumpParsedRefs($parser,"after final
reset");
self::$fixedCategories=array();
- }
- return true;
- }
+ }
+ return true;
+ }
- public static function endEliminate( &$parser, &$text ) {
+ public static function endEliminate( &$parser, &$text ) {
- // called during the final output phase; removes links created by DPL
- if (isset(self::$createdLinks)) {
+ // called during the final output phase; removes links created
by DPL
+ if (isset(self::$createdLinks)) {
// self::dumpParsedRefs($parser,"before final
eliminate");
- if (array_key_exists(0,self::$createdLinks)) {
- foreach ($parser->mOutput->getLinks() as $nsp => $link) {
+ if (array_key_exists(0,self::$createdLinks)) {
+ foreach ($parser->mOutput->getLinks() as $nsp
=> $link) {
if
(!array_key_exists($nsp,self::$createdLinks[0])) continue;
// echo ("<pre> elim: created Links
[$nsp] = ". count(ExtDynamicPageList::$createdLinks[0][$nsp])."</pre>\n");
// echo ("<pre> elim: parser Links
[$nsp] = ". count($parser->mOutput->mLinks[$nsp]) ."</pre>\n");
$parser->mOutput->mLinks[$nsp] =
array_diff_assoc($parser->mOutput->mLinks[$nsp],self::$createdLinks[0][$nsp]);
// echo ("<pre> elim: parser Links
[$nsp] nachher = ". count($parser->mOutput->mLinks[$nsp]) ."</pre>\n");
if
(count($parser->mOutput->mLinks[$nsp])==0) unset
($parser->mOutput->mLinks[$nsp]);
- }
- }
- if (isset(self::$createdLinks) &&
array_key_exists(1,self::$createdLinks)) {
- foreach ($parser->mOutput->mTemplates as $nsp => $tpl) {
+ }
+ }
+ if (isset(self::$createdLinks) &&
array_key_exists(1,self::$createdLinks)) {
+ foreach ($parser->mOutput->mTemplates as $nsp
=> $tpl) {
if
(!array_key_exists($nsp,self::$createdLinks[1])) continue;
// echo ("<pre> elim: created Tpls
[$nsp] = ". count(ExtDynamicPageList::$createdLinks[1][$nsp])."</pre>\n");
// echo ("<pre> elim: parser Tpls
[$nsp] = ". count($parser->mOutput->mTemplates[$nsp]) ."</pre>\n");
$parser->mOutput->mTemplates[$nsp] =
array_diff_assoc($parser->mOutput->mTemplates[$nsp],self::$createdLinks[1][$nsp]);
// echo ("<pre> elim: parser Tpls
[$nsp] nachher = ". count($parser->mOutput->mTemplates[$nsp]) ."</pre>\n");
if
(count($parser->mOutput->mTemplates[$nsp])==0) unset
($parser->mOutput->mTemplates[$nsp]);
- }
- }
- if (isset(self::$createdLinks) &&
array_key_exists(2,self::$createdLinks)) {
+ }
+ }
+ if (isset(self::$createdLinks) &&
array_key_exists(2,self::$createdLinks)) {
$parser->mOutput->mCategories =
array_diff_assoc($parser->mOutput->mCategories,self::$createdLinks[2]);
- }
- if (isset(self::$createdLinks) &&
array_key_exists(3,self::$createdLinks)) {
+ }
+ if (isset(self::$createdLinks) &&
array_key_exists(3,self::$createdLinks)) {
$parser->mOutput->mImages =
array_diff_assoc($parser->mOutput->mImages,self::$createdLinks[3]);
- }
- // $text .= self::dumpParsedRefs($parser,"after final
eliminate".$parser->mTitle->getText());
- }
+ }
+ // $text .= self::dumpParsedRefs($parser,"after final
eliminate".$parser->mTitle->getText());
+ }
- //self::$createdLinks=array(
- // 'resetLinks'=> false, 'resetTemplates' => false,
- // 'resetCategories' => false, 'resetImages' => false,
'resetdone' => false );
- return true;
- }
+ //self::$createdLinks=array(
+ // 'resetLinks'=> false, 'resetTemplates' => false,
+ // 'resetCategories' => false, 'resetImages' => false,
'resetdone' => false );
+ return true;
+ }
}
--
To view, visit https://gerrit.wikimedia.org/r/159658
To unsubscribe, visit https://gerrit.wikimedia.org/r/settings
Gerrit-MessageType: newchange
Gerrit-Change-Id: I4305eb1db19005aa09c6ea76086f402aba41bade
Gerrit-PatchSet: 1
Gerrit-Project: mediawiki/extensions/DynamicPageList
Gerrit-Branch: master
Gerrit-Owner: MarkAHershberger <[email protected]>
Gerrit-Reviewer: jenkins-bot <>
_______________________________________________
MediaWiki-commits mailing list
[email protected]
https://lists.wikimedia.org/mailman/listinfo/mediawiki-commits
