MediaWiki master
MediaWiki\Parser\PPFrame Interface Reference

Inherited by MediaWiki\Parser\PPFrame_Hash.

Public Member Functions

 cachedExpand ( $key, $root, $flags=0)
 Expand a document tree node, caching the result on its parent with the given key.
 
 expand ( $root, $flags=0)
 Expand a document tree node.
 
 getArgument ( $name)
 Get an argument to this frame by name.
 
 getArguments ()
 Returns all arguments of this frame.
 
 getNamedArguments ()
 Returns all named arguments of this frame.
 
 getNumberedArguments ()
 Returns all numbered arguments of this frame.
 
 getTitle ()
 Get a title of frame.
 
 getTTL ()
 Get the TTL of the frame's output.
 
 implode ( $sep,... $params)
 Implode with no flags specified.
 
 implodeWithFlags ( $sep, $flags,... $params)
 Implode with flags for expand()
 
 isEmpty ()
 Returns true if there are no arguments in this frame.
 
 isTemplate ()
 Return true if the frame is a template frame.
 
 isVolatile ()
 Get the "volatile" flag.
 
 loopCheck ( $title)
 Returns true if the infinite loop check is OK, false if a loop is detected.
 
 newChild ( $args=false, $title=false, $indexOffset=0)
 Create a child frame.
 
 setTTL ( $ttl)
 Set the TTL of the output of this frame and all of its ancestors.
 
 setVolatile ( $flag=true)
 Set the "volatile" flag.
 
 virtualBracketedImplode ( $start, $sep, $end,... $params)
 Virtual implode with brackets.
 
 virtualImplode ( $sep,... $params)
 Makes an object that, when expand()ed, will be the same as one obtained with implode()
 

Public Attributes

const NO_ARGS = 1
 
const NO_IGNORE = 8
 
const NO_TAGS = 32
 
const NO_TEMPLATES = 2
 
const PROCESS_NOWIKI = 64
 
const RECOVER_COMMENTS = 16
 
const RECOVER_ORIG
 
const STRIP_COMMENTS = 4
 

Detailed Description

Definition at line 32 of file PPFrame.php.

Member Function Documentation

◆ cachedExpand()

MediaWiki\Parser\PPFrame::cachedExpand ( $key,
$root,
$flags = 0 )

Expand a document tree node, caching the result on its parent with the given key.

Parameters
string | int$key
string | PPNode$root
int$flags
Returns
string

Implemented in MediaWiki\Parser\PPFrame_Hash, and MediaWiki\Parser\PPTemplateFrame_Hash.

◆ expand()

MediaWiki\Parser\PPFrame::expand ( $root,
$flags = 0 )

◆ getArgument()

MediaWiki\Parser\PPFrame::getArgument ( $name)

Get an argument to this frame by name.

Parameters
int | string$name
Returns
string|false

Implemented in MediaWiki\Parser\PPCustomFrame_Hash, MediaWiki\Parser\PPFrame_Hash, and MediaWiki\Parser\PPTemplateFrame_Hash.

Referenced by MediaWiki\Parser\Parser\argSubstitution().

◆ getArguments()

MediaWiki\Parser\PPFrame::getArguments ( )

Returns all arguments of this frame.

Returns
array

Implemented in MediaWiki\Parser\PPCustomFrame_Hash, MediaWiki\Parser\PPFrame_Hash, and MediaWiki\Parser\PPTemplateFrame_Hash.

◆ getNamedArguments()

MediaWiki\Parser\PPFrame::getNamedArguments ( )

Returns all named arguments of this frame.

Returns
array

Implemented in MediaWiki\Parser\PPFrame_Hash, and MediaWiki\Parser\PPTemplateFrame_Hash.

◆ getNumberedArguments()

MediaWiki\Parser\PPFrame::getNumberedArguments ( )

Returns all numbered arguments of this frame.

Returns
array

Implemented in MediaWiki\Parser\PPFrame_Hash, and MediaWiki\Parser\PPTemplateFrame_Hash.

◆ getTitle()

MediaWiki\Parser\PPFrame::getTitle ( )

Get a title of frame.

Returns
Title

Implemented in MediaWiki\Parser\PPFrame_Hash.

◆ getTTL()

MediaWiki\Parser\PPFrame::getTTL ( )

Get the TTL of the frame's output.

This is the maximum amount of time, in seconds, that this frame's output should be cached for. A value of null indicates that no maximum has been specified.

Note that this TTL only applies to caching frames as parts of pages. It is not relevant to caching the entire rendered output of a page.

Returns
int|null

Implemented in MediaWiki\Parser\PPFrame_Hash.

◆ implode()

MediaWiki\Parser\PPFrame::implode ( $sep,
$params )

Implode with no flags specified.

Parameters
string$sep
string|PPNode...$params
Returns
string

Implemented in MediaWiki\Parser\PPFrame_Hash.

◆ implodeWithFlags()

MediaWiki\Parser\PPFrame::implodeWithFlags ( $sep,
$flags,
$params )

Implode with flags for expand()

Parameters
string$sep
int$flags
string|PPNode...$params
Returns
string

Implemented in MediaWiki\Parser\PPFrame_Hash.

◆ isEmpty()

MediaWiki\Parser\PPFrame::isEmpty ( )

Returns true if there are no arguments in this frame.

Returns
bool

Implemented in MediaWiki\Parser\PPCustomFrame_Hash, MediaWiki\Parser\PPFrame_Hash, and MediaWiki\Parser\PPTemplateFrame_Hash.

◆ isTemplate()

MediaWiki\Parser\PPFrame::isTemplate ( )

Return true if the frame is a template frame.

Returns
bool

Implemented in MediaWiki\Parser\PPFrame_Hash, and MediaWiki\Parser\PPTemplateFrame_Hash.

Referenced by MediaWiki\Parser\Parser\argSubstitution().

◆ isVolatile()

MediaWiki\Parser\PPFrame::isVolatile ( )

Get the "volatile" flag.

Callers should avoid caching the result of an expansion if it has the volatile flag set.

See also
self::setVolatile()
Returns
bool

Implemented in MediaWiki\Parser\PPFrame_Hash.

◆ loopCheck()

MediaWiki\Parser\PPFrame::loopCheck ( $title)

Returns true if the infinite loop check is OK, false if a loop is detected.

Parameters
Title$title
Returns
bool

Implemented in MediaWiki\Parser\PPFrame_Hash.

Referenced by MediaWiki\Parser\Parser\braceSubstitution().

◆ newChild()

MediaWiki\Parser\PPFrame::newChild ( $args = false,
$title = false,
$indexOffset = 0 )

Create a child frame.

Parameters
PPNode[] | false$args
Title | false$title
int$indexOffsetA number subtracted from the index attributes of the arguments
Returns
PPFrame

Implemented in MediaWiki\Parser\PPFrame_Hash.

Referenced by MediaWiki\Parser\Parser\braceSubstitution().

◆ setTTL()

MediaWiki\Parser\PPFrame::setTTL ( $ttl)

Set the TTL of the output of this frame and all of its ancestors.

Has no effect if the new TTL is greater than the one already set. Note that it is the caller's responsibility to change the cache expiry of the page as a whole, if such behavior is desired.

See also
self::getTTL()
Parameters
int$ttl

Implemented in MediaWiki\Parser\PPFrame_Hash, and MediaWiki\Parser\PPTemplateFrame_Hash.

◆ setVolatile()

MediaWiki\Parser\PPFrame::setVolatile ( $flag = true)

Set the "volatile" flag.

Note that this is somewhat of a "hack" in order to make extensions with side effects (such as Cite) work with the PHP parser. New extensions should be written in a way that they do not need this function, because other parsers (such as Parsoid) are not guaranteed to respect it, and it may be removed in the future.

Parameters
bool$flag

Implemented in MediaWiki\Parser\PPFrame_Hash, and MediaWiki\Parser\PPTemplateFrame_Hash.

◆ virtualBracketedImplode()

MediaWiki\Parser\PPFrame::virtualBracketedImplode ( $start,
$sep,
$end,
$params )

Virtual implode with brackets.

Parameters
string$start
string$sep
string$end
string|PPNode...$params
Returns
PPNode

Implemented in MediaWiki\Parser\PPFrame_Hash.

Referenced by MediaWiki\Parser\Parser\argSubstitution(), and MediaWiki\Parser\Parser\braceSubstitution().

◆ virtualImplode()

MediaWiki\Parser\PPFrame::virtualImplode ( $sep,
$params )

Makes an object that, when expand()ed, will be the same as one obtained with implode()

Parameters
string$sep
string|PPNode...$params
Returns
PPNode

Implemented in MediaWiki\Parser\PPFrame_Hash.

Member Data Documentation

◆ NO_ARGS

const MediaWiki\Parser\PPFrame::NO_ARGS = 1

◆ NO_IGNORE

const MediaWiki\Parser\PPFrame::NO_IGNORE = 8

Definition at line 36 of file PPFrame.php.

Referenced by MediaWiki\Parser\PPFrame_Hash\expand().

◆ NO_TAGS

const MediaWiki\Parser\PPFrame::NO_TAGS = 32

Definition at line 38 of file PPFrame.php.

Referenced by MediaWiki\Parser\PPFrame_Hash\expand().

◆ NO_TEMPLATES

const MediaWiki\Parser\PPFrame::NO_TEMPLATES = 2

◆ PROCESS_NOWIKI

const MediaWiki\Parser\PPFrame::PROCESS_NOWIKI = 64

Definition at line 39 of file PPFrame.php.

Referenced by MediaWiki\Parser\PPFrame_Hash\expand().

◆ RECOVER_COMMENTS

const MediaWiki\Parser\PPFrame::RECOVER_COMMENTS = 16

Definition at line 37 of file PPFrame.php.

Referenced by MediaWiki\Parser\PPFrame_Hash\expand().

◆ RECOVER_ORIG

const MediaWiki\Parser\PPFrame::RECOVER_ORIG
Initial value:
= self::NO_ARGS | self::NO_TEMPLATES | self::NO_IGNORE |
self::RECOVER_COMMENTS | self::NO_TAGS

Definition at line 41 of file PPFrame.php.

◆ STRIP_COMMENTS


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