XML file reader for the page data importer. More...

Public Member Functions
	__construct ($source)
	Creates an ImportXMLReader drawing from the source provided.
	debugRevisionHandler (&$revision)
	Alternate per-revision callback, for debugging.
	doImport ()
	Primary entry point.
	finishImportPage ($title, $origTitle, $revCount, $sRevCount, $pageInfo)
	Mostly for hook use.
	importLogItem ($rev)
	Default per-revision callback, performs the import.
	importRevision ($revision)
	Default per-revision callback, performs the import.
	importUpload ($revision)
	Dummy for now...
	pageCallback ($title)
	Notify the callback function when a new "<page>" is reached.
	setDebug ($debug)
	Set debug mode...
	setImageBasePath ($dir)
	setImportUploads ($import)
	setLogItemCallback ($callback)
	Sets the action to perform as each log item reached.
	setNoticeCallback ($callback)
	Set a callback that displays notice messages.
	setNoUpdates ($noupdates)
	Set 'no updates' mode.
	setPageCallback ($callback)
	Sets the action to perform as each new page in the stream is reached.
	setPageOutCallback ($callback)
	Sets the action to perform as each page in the stream is completed.
	setRevisionCallback ($callback)
	Sets the action to perform as each page revision is reached.
	setSiteInfoCallback ($callback)
	Sets the action to perform when site info is encountered.
	setTargetNamespace ($namespace)
	Set a target namespace to override the defaults.
	setTargetRootPage ($rootpage)
	Set a target root page under which all pages are imported.
	setUploadCallback ($callback)
	Sets the action to perform as each file upload version is reached.
Public Attributes
	$mDebug
	$mImageBasePath
	$mPageCallback
	$mPageOutCallback
	$mRevisionCallback
	$mTargetNamespace
	$mTargetRootPage
	$mUploadCallback
Private Member Functions
	debug ($data)
	dumpElement ()
	Left in for debugging.
	dumpTemp ($contents)
	handleContributor ()
	handleLogItem ()
	handlePage ()
	handleRevision (&$pageInfo)
	handleSiteInfo ()
	handleUpload (&$pageInfo)
	logItemCallback ($revision)
	Notify the callback function of a new log item.
	nodeContents ()
	Shouldn't something like this be built-in to XMLReader? Fetches text contents of the current element, assuming no sub-elements or such scary things.
	notice ($msg)
	pageOutCallback ($title, $origTitle, $revCount, $sucCount, $pageInfo)
	Notify the callback function when a "</page>" is closed.
	processLogItem ($logInfo)
	processRevision ($pageInfo, $revisionInfo)
	processTitle ($text)
	processUpload ($pageInfo, $uploadInfo)
	revisionCallback ($revision)
	Notify the callback function of a revision.
	throwXmlError ($err)
	warn ($data)
Private Attributes
	$mImportUploads
	$mLogItemCallback
	$mNoticeCallback
	$mNoUpdates = false
	$mSiteInfoCallback
	$reader = null

Detailed Description

XML file reader for the page data importer.

implements Special:Import

Definition at line 33 of file Import.php.

Constructor & Destructor Documentation

WikiImporter::__construct ( $ source )

Creates an ImportXMLReader drawing from the source provided.

Parameters:

$source

Definition at line 45 of file Import.php.

References $source, array(), UploadSourceAdapter\registerSource(), setLogItemCallback(), setPageOutCallback(), setRevisionCallback(), and setUploadCallback().

Member Function Documentation

WikiImporter::debug ( $ data ) [private]

Definition at line 68 of file Import.php.

References wfDebug().

Referenced by debugRevisionHandler(), doImport(), handleLogItem(), handlePage(), handleRevision(), handleUpload(), and throwXmlError().

WikiImporter::debugRevisionHandler ( &$ revision )

Alternate per-revision callback, for debugging.

Parameters:

$revision WikiRevision

Definition at line 305 of file Import.php.

References debug().

WikiImporter::doImport ( )

Primary entry point.

Exceptions:

MWException

Returns:: bool

Definition at line 443 of file Import.php.

References array(), debug(), handleLogItem(), handlePage(), handleSiteInfo(), warn(), and wfRunHooks().

WikiImporter::dumpElement ( ) [private]

Left in for debugging.

Definition at line 401 of file Import.php.

References $name, array(), as, and print.

WikiImporter::dumpTemp ( $ contents ) [private]

Parameters:

$contents

Returns:: string

Definition at line 768 of file Import.php.

References wfTempDir().

Referenced by handleUpload().

WikiImporter::finishImportPage	(	$	title,
		$	origTitle,
		$	revCount,
		$	sRevCount,
		$	pageInfo
	)

Mostly for hook use.

Parameters:

$title
$origTitle
$revCount
$sRevCount
$pageInfo

Returns:

Definition at line 296 of file Import.php.

References wfRunHooks().

WikiImporter::handleContributor ( ) [private]

Returns:: array

Definition at line 816 of file Import.php.

References array(), and nodeContents().

Referenced by handleLogItem(), handleRevision(), and handleUpload().

WikiImporter::handleLogItem ( ) [private]

Definition at line 509 of file Import.php.

References array(), debug(), handleContributor(), nodeContents(), processLogItem(), warn(), and wfRunHooks().

Referenced by doImport().

WikiImporter::handlePage ( ) [private]

Definition at line 570 of file Import.php.

References $title, array(), debug(), handleRevision(), handleUpload(), list, nodeContents(), pageCallback(), pageOutCallback(), processTitle(), warn(), and wfRunHooks().

Referenced by doImport().

WikiImporter::handleRevision ( &$ pageInfo ) [private]

Parameters:

$pageInfo array

Definition at line 627 of file Import.php.

References array(), debug(), handleContributor(), nodeContents(), processRevision(), warn(), and wfRunHooks().

Referenced by handlePage().

WikiImporter::handleSiteInfo ( ) [private]

Returns:: bool

Exceptions:

MWException

Definition at line 499 of file Import.php.

Referenced by doImport().

WikiImporter::handleUpload ( &$ pageInfo ) [private]

Parameters:

$pageInfo

Returns:: mixed

Definition at line 713 of file Import.php.

References $path, array(), debug(), dumpTemp(), handleContributor(), nodeContents(), processUpload(), warn(), and wfRunHooks().

Referenced by handlePage().

WikiImporter::importLogItem ( $ rev )

Default per-revision callback, performs the import.

Parameters:

$rev	WikiRevision

Returns:: bool

Definition at line 272 of file Import.php.

References $rev, array(), and wfGetDB().

WikiImporter::importRevision ( $ revision )

Default per-revision callback, performs the import.

Parameters:

$revision WikiRevision

Returns:: bool

Definition at line 254 of file Import.php.

References array(), notice(), and wfGetDB().

WikiImporter::importUpload ( $ revision )

Dummy for now...

Parameters:

$revision

Returns:: bool

Definition at line 282 of file Import.php.

References array(), and wfGetDB().

WikiImporter::logItemCallback ( $ revision ) [private]

Notify the callback function of a new log item.

Parameters:

$revision WikiRevision object

Returns:: bool|mixed

Definition at line 362 of file Import.php.

References array().

Referenced by processLogItem().

WikiImporter::nodeContents ( ) [private]

Shouldn't something like this be built-in to XMLReader? Fetches text contents of the current element, assuming no sub-elements or such scary things.

Returns:: string

Access:: private

Definition at line 378 of file Import.php.

Referenced by handleContributor(), handleLogItem(), handlePage(), handleRevision(), and handleUpload().

WikiImporter::notice ( $ msg ) [private]

Definition at line 78 of file Import.php.

References $params, and wfMessage().

Referenced by importRevision(), and processTitle().

WikiImporter::pageCallback ( $ title )

Notify the callback function when a new "<page>" is reached.

Parameters:

$title Title

Definition at line 322 of file Import.php.

References $title.

Referenced by handlePage().

WikiImporter::pageOutCallback	(	$	title,
		$	origTitle,
		$	revCount,
		$	sucCount,
		$	pageInfo
	)		`[private]`

Notify the callback function when a "</page>" is closed.

Parameters:

	$title	Title
	$origTitle	Title
	$revCount	Integer
int	$sucCount	number of revisions for which callback returned true
array	$pageInfo	associative array of page information

Definition at line 336 of file Import.php.

Referenced by handlePage().

WikiImporter::processLogItem ( $ logInfo ) [private]

Parameters:

$logInfo

Returns:: bool|mixed

Definition at line 545 of file Import.php.

References logItemCallback(), Title\newFromText(), and WikiRevision\setID().

Referenced by handleLogItem().

WikiImporter::processRevision	(	$	pageInfo,
		$	revisionInfo
	)		`[private]`

Parameters:

$pageInfo
$revisionInfo

Returns:: bool|mixed

Definition at line 668 of file Import.php.

References revisionCallback(), WikiRevision\setID(), and wfTimestampNow().

Referenced by handleRevision().

WikiImporter::processTitle ( $ text ) [private]

Parameters:

$text string

Returns:: Array or false

Definition at line 840 of file Import.php.

References $title, $wgCommandLineMode, array(), global, Title\makeTitleSafe(), Title\newFromText(), and notice().

Referenced by handlePage().

WikiImporter::processUpload	(	$	pageInfo,
		$	uploadInfo
	)		`[private]`

Parameters:

$pageInfo
$uploadInfo

Returns:: mixed

Definition at line 779 of file Import.php.

References empty, and WikiRevision\setTitle().

Referenced by handleUpload().

WikiImporter::revisionCallback ( $ revision ) [private]

Notify the callback function of a revision.

Parameters:

$revision WikiRevision object

Returns:: bool|mixed

Definition at line 348 of file Import.php.

References array().

Referenced by processRevision().

WikiImporter::setDebug ( $ debug )

Set debug mode...

Parameters:

$debug bool

Definition at line 93 of file Import.php.

References $debug.

WikiImporter::setImageBasePath ( $ dir )

Parameters:

$dir

Definition at line 238 of file Import.php.

References $dir.

WikiImporter::setImportUploads ( $ import )

Parameters:

$import

Definition at line 245 of file Import.php.

WikiImporter::setLogItemCallback ( $ callback )

Sets the action to perform as each log item reached.

Parameters:

$callback callback

Returns:: callback

Definition at line 168 of file Import.php.

Referenced by __construct().

WikiImporter::setNoticeCallback ( $ callback )

Set a callback that displays notice messages.

Parameters:

$callback callback

Returns:: callback

Definition at line 111 of file Import.php.

References wfSetVar().

WikiImporter::setNoUpdates ( $ noupdates )

Set 'no updates' mode.

In this mode, the link tables will not be updated by the importer

Parameters:

$noupdates bool

Definition at line 101 of file Import.php.

WikiImporter::setPageCallback ( $ callback )

Sets the action to perform as each new page in the stream is reached.

Parameters:

$callback callback

Returns:: callback

Definition at line 120 of file Import.php.

WikiImporter::setPageOutCallback ( $ callback )

Sets the action to perform as each page in the stream is completed.

Callback accepts the page title (as a Title object), a second object with the original title form (in case it's been overridden into a local namespace), and a count of revisions.

Parameters:

$callback callback

Returns:: callback

Definition at line 135 of file Import.php.

Referenced by __construct().

WikiImporter::setRevisionCallback ( $ callback )

Sets the action to perform as each page revision is reached.

Parameters:

$callback callback

Returns:: callback

Definition at line 146 of file Import.php.

Referenced by __construct().

WikiImporter::setSiteInfoCallback ( $ callback )

Sets the action to perform when site info is encountered.

Parameters:

$callback callback

Returns:: callback

Definition at line 179 of file Import.php.

WikiImporter::setTargetNamespace ( $ namespace )

Set a target namespace to override the defaults.

Parameters:

$namespace

Returns:: bool

Definition at line 190 of file Import.php.

Referenced by setTargetRootPage().

WikiImporter::setTargetRootPage ( $ rootpage )

Set a target root page under which all pages are imported.

Parameters:

$rootpage

Returns:: status object

Definition at line 207 of file Import.php.

References $title, $wgContLang, global, MWNamespace\hasSubpages(), Title\newFromText(), Status\newGood(), setTargetNamespace(), and wfMessage().

WikiImporter::setUploadCallback ( $ callback )

Sets the action to perform as each file upload version is reached.

Parameters:

$callback callback

Returns:: callback

Definition at line 157 of file Import.php.

Referenced by __construct().

WikiImporter::throwXmlError ( $ err ) [private]

Definition at line 63 of file Import.php.

References debug(), and wfDebug().

WikiImporter::warn ( $ data ) [private]

Definition at line 74 of file Import.php.

References wfDebug().

Referenced by doImport(), handleLogItem(), handlePage(), handleRevision(), and handleUpload().

Member Data Documentation

WikiImporter::$mDebug

Definition at line 37 of file Import.php.

WikiImporter::$mImageBasePath

Definition at line 38 of file Import.php.

WikiImporter::$mImportUploads [private]

Definition at line 38 of file Import.php.

WikiImporter::$mLogItemCallback [private]

Definition at line 35 of file Import.php.

WikiImporter::$mNoticeCallback [private]

Definition at line 37 of file Import.php.

WikiImporter::$mNoUpdates = false [private]

Definition at line 39 of file Import.php.

WikiImporter::$mPageCallback

Definition at line 35 of file Import.php.

WikiImporter::$mPageOutCallback

Definition at line 36 of file Import.php.

WikiImporter::$mRevisionCallback

Definition at line 35 of file Import.php.

WikiImporter::$mSiteInfoCallback [private]

Definition at line 36 of file Import.php.

WikiImporter::$mTargetNamespace

Definition at line 36 of file Import.php.

WikiImporter::$mTargetRootPage

Definition at line 36 of file Import.php.

WikiImporter::$mUploadCallback

Definition at line 35 of file Import.php.

WikiImporter::$reader = null [private]

Definition at line 34 of file Import.php.

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

includes/Import.php

Public Member Functions

Public Attributes

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation