Image gallery. More...

Inheritance diagram for ImageGalleryBase:

Collaboration diagram for ImageGalleryBase:

Public Member Functions
	__construct ($mode= 'traditional')
	Create a new image gallery object.
	add ($title, $html= '', $alt= '', $link= '', $handlerOpts=array())
	Add an image to the gallery.
	count ()
	getContextTitle ()
	Get the contextual title, if applicable.
	insert ($title, $html= '', $alt= '', $link= '', $handlerOpts=array())
	Add an image at the beginning of the gallery.
	isEmpty ()
	isEmpty() returns true if the gallery contains no images
	setAdditionalOptions ($options)
	Allow setting additional options.
	setAttributes ($attribs)
	Set arbitrary attributes to go on the HTML gallery output element.
	setCaption ($caption)
	Set the caption (as plain text)
	setCaptionHtml ($caption)
	Set the caption (as HTML)
	setContextTitle ($title)
	Set the contextual title.
	setHeights ($num)
	Set how high each image will be, in pixels.
	setHideBadImages ($flag=true)
	Set bad image flag.
	setParser ($parser)
	Register a parser object.
	setPerRow ($num)
	Set how many images will be displayed per row.
	setShowBytes ($f)
	Enable/Disable showing of the file size of an image in the gallery.
	setShowFilename ($f)
	Enable/Disable showing of the filename of an image in the gallery.
	setWidths ($num)
	Set how wide each image will be, in pixels.
	toHTML ()
	Display an html representation of the gallery.
	useSkin ($skin)
	Instruct the class to use a specific skin for rendering.
Static Public Member Functions
static	factory ($mode=false)
	Get a new image gallery.
Public Attributes
bool string	$mCaption = false
	Gallery caption.
bool	$mHideBadImages
	Hide blacklisted images?
array	$mImages
	Gallery images *.
string	$mMode
	Gallery mode.
Parser	$mParser
	Registered parser object for output callbacks.
bool	$mShowBytes
	Whether to show the filesize in bytes in categories *.
bool	$mShowFilename
	Whether to show the filename.
Protected Member Functions
	getRenderLang ()
	Determines the correct language to be used for this image gallery.
Protected Attributes
Title	$contextTitle = false
	Contextual title, used when images are being screened against the bad image list.
array	$mAttribs = array()
	*
Static Private Member Functions
static	loadModes ()
Static Private Attributes
static	$modeMapping = false

Detailed Description

Image gallery.

Add images to the gallery using add(), then render that list to HTML using toHTML().

Definition at line 30 of file ImageGalleryBase.php.

Constructor & Destructor Documentation

ImageGalleryBase::__construct ( $ mode = 'traditional' )

Create a new image gallery object.

You should not call this directly, but instead use ImageGalleryBase::factory().

Reimplemented in ImageGallery, and PackedImageGallery.

Definition at line 102 of file ImageGalleryBase.php.

Member Function Documentation

ImageGalleryBase::add	(	$	title,
		$	html = `''`,
		$	alt = `''`,
		$	link = `''`,
		$	handlerOpts = `array()`
	)

Add an image to the gallery.

Parameters:

Title	$title	Title object of the image that is added to the gallery
string	$html	Additional HTML text to be shown. The name and size of the image are always shown.
string	$alt	Alt text for the image
string	$link	Override image link (optional)
array	$handlerOpts	Array of options for image handler (aka page number)

Definition at line 220 of file ImageGalleryBase.php.

ImageGalleryBase::count ( )

Returns:: int Number of images in the gallery

Definition at line 298 of file ImageGalleryBase.php.

Referenced by setContextTitle().

static ImageGalleryBase::factory ( $ mode = false ) [static]

Get a new image gallery.

This is the method other callers should use to get a gallery.

Parameters:

string | bool $mode Mode to use. False to use the default.

Exceptions:

MWException

Definition at line 66 of file ImageGalleryBase.php.

References $wgContLang, global, and loadModes().

Referenced by NewFilesPager\getStartBody(), and ImageQueryPage\outputResults().

ImageGalleryBase::getContextTitle ( )

Get the contextual title, if applicable.

Returns:: Title|bool Title or false

Definition at line 316 of file ImageGalleryBase.php.

References $title.

Referenced by TraditionalImageGallery\toHTML().

ImageGalleryBase::getRenderLang ( ) [protected]

Determines the correct language to be used for this image gallery.

Returns:: Language

Definition at line 326 of file ImageGalleryBase.php.

Referenced by TraditionalImageGallery\toHTML().

ImageGalleryBase::insert	(	$	title,
		$	html = `''`,
		$	alt = `''`,
		$	link = `''`,
		$	handlerOpts = `array()`
	)

Add an image at the beginning of the gallery.

Parameters:

Title	$title	Title object of the image that is added to the gallery
string	$html	Additional HTML text to be shown. The name and size of the image are always shown.
string	$alt	Alt text for the image
string	$link	Override image link (optional)
array	$handlerOpts	Array of options for image handler (aka page number)

Definition at line 239 of file ImageGalleryBase.php.

ImageGalleryBase::isEmpty ( )

isEmpty() returns true if the gallery contains no images

Returns:: bool

Definition at line 251 of file ImageGalleryBase.php.

static ImageGalleryBase::loadModes ( ) [static, private]

Definition at line 82 of file ImageGalleryBase.php.

Referenced by factory().

ImageGalleryBase::setAdditionalOptions ( $ options )

Allow setting additional options.

This is meant to allow extensions to add additional parameters to <gallery> parser tag.

Parameters:

array $options Attributes of gallery tag.

Definition at line 196 of file ImageGalleryBase.php.

ImageGalleryBase::setAttributes ( $ attribs )

Set arbitrary attributes to go on the HTML gallery output element.

Should be suitable for a

.

Note -- if taking from user input, you should probably run through Sanitizer::validateAttributes() first.

Parameters:

array $attribs Array of HTML attribute pairs

Definition at line 284 of file ImageGalleryBase.php.

ImageGalleryBase::setCaption ( $ caption )

Set the caption (as plain text)

Parameters:

string $caption Caption

Definition at line 142 of file ImageGalleryBase.php.

ImageGalleryBase::setCaptionHtml ( $ caption )

Set the caption (as HTML)

Parameters:

string $caption Caption

Definition at line 151 of file ImageGalleryBase.php.

ImageGalleryBase::setContextTitle ( $ title )

Set the contextual title.

Parameters:

Title $title Contextual title

Definition at line 307 of file ImageGalleryBase.php.

References count().

ImageGalleryBase::setHeights ( $ num )

Set how high each image will be, in pixels.

Parameters:

int $num Integer > 0; invalid numbers will be ignored

Definition at line 183 of file ImageGalleryBase.php.

ImageGalleryBase::setHideBadImages ( $ flag = true )

Set bad image flag.

Definition at line 133 of file ImageGalleryBase.php.

ImageGalleryBase::setParser ( $ parser )

Register a parser object.

If you do not set this and the output of this gallery ends up in parser cache, the javascript will break!

Note:: This also triggers using the page's target language instead of the user language.

Parameters:

$parser Parser

Definition at line 126 of file ImageGalleryBase.php.

ImageGalleryBase::setPerRow ( $ num )

Set how many images will be displayed per row.

Parameters:

int $num Integer >= 0; If perrow=0 the gallery layout will adapt to screensize invalid numbers will be rejected

Reimplemented in PackedImageGallery.

Definition at line 161 of file ImageGalleryBase.php.

ImageGalleryBase::setShowBytes ( $ f )

Enable/Disable showing of the file size of an image in the gallery.

Enabled by default.

Parameters:

bool $f Set to false to disable.

Definition at line 261 of file ImageGalleryBase.php.

ImageGalleryBase::setShowFilename ( $ f )

Enable/Disable showing of the filename of an image in the gallery.

Enabled by default.

Parameters:

bool $f Set to false to disable.

Definition at line 271 of file ImageGalleryBase.php.

ImageGalleryBase::setWidths ( $ num )

Set how wide each image will be, in pixels.

Parameters:

int $num Integer > 0; invalid numbers will be ignored

Definition at line 172 of file ImageGalleryBase.php.

ImageGalleryBase::toHTML ( ) [abstract]

Display an html representation of the gallery.

Returns:: string The html

Reimplemented in TraditionalImageGallery.

ImageGalleryBase::useSkin ( $ skin )

Instruct the class to use a specific skin for rendering.

Parameters:

Skin $skin

Deprecated:: since 1.18 Not used anymore

Definition at line 205 of file ImageGalleryBase.php.

Member Data Documentation

Title ImageGalleryBase::$contextTitle = false [protected]

Contextual title, used when images are being screened against the bad image list.

Definition at line 52 of file ImageGalleryBase.php.

array ImageGalleryBase::$mAttribs = array() [protected]

*

Definition at line 54 of file ImageGalleryBase.php.

bool string ImageGalleryBase::$mCaption = false

Gallery caption.

Default: false *

Definition at line 39 of file ImageGalleryBase.php.

bool ImageGalleryBase::$mHideBadImages

Hide blacklisted images?

Definition at line 43 of file ImageGalleryBase.php.

array ImageGalleryBase::$mImages

Gallery images *.

Definition at line 31 of file ImageGalleryBase.php.

string ImageGalleryBase::$mMode

Gallery mode.

Default: traditional *

Definition at line 37 of file ImageGalleryBase.php.

ImageGalleryBase::$modeMapping = false [static, private]

Definition at line 57 of file ImageGalleryBase.php.

Parser ImageGalleryBase::$mParser

Registered parser object for output callbacks.

Definition at line 47 of file ImageGalleryBase.php.

bool ImageGalleryBase::$mShowBytes

Whether to show the filesize in bytes in categories *.

Definition at line 33 of file ImageGalleryBase.php.

bool ImageGalleryBase::$mShowFilename

Whether to show the filename.

Default: true *

Definition at line 35 of file ImageGalleryBase.php.

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

includes/gallery/ImageGalleryBase.php

Public Member Functions

Static Public Member Functions

Public Attributes

Protected Member Functions

Protected Attributes

Static Private Member Functions

Static Private Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation