Gecko [ paroquia-rio-de-mouro.pt ]

Name	Size	Permission	Date
i18n	[ DIR ]	drwxr-xr-x	2016-11-28 20:20
ApiAMCreateAccount.php	4.17 KB	-rw-r--r--	2016-11-28 20:20
ApiAuthManagerHelper.php	12.14 KB	-rw-r--r--	2016-11-28 20:20
ApiBase.php	84.45 KB	-rw-r--r--	2016-11-28 20:20
ApiBlock.php	5.16 KB	-rw-r--r--	2016-11-28 20:20
ApiCSPReport.php	6.34 KB	-rw-r--r--	2016-11-28 20:20
ApiChangeAuthenticationData.php	2.95 KB	-rw-r--r--	2016-11-28 20:20
ApiCheckToken.php	2.24 KB	-rw-r--r--	2016-11-28 20:20
ApiClearHasMsg.php	1.62 KB	-rw-r--r--	2016-11-28 20:20
ApiClientLogin.php	4.39 KB	-rw-r--r--	2016-11-28 20:20
ApiComparePages.php	3.51 KB	-rw-r--r--	2016-11-28 20:20
ApiContinuationManager.php	8.03 KB	-rw-r--r--	2016-11-28 20:20
ApiDelete.php	6.38 KB	-rw-r--r--	2016-11-28 20:20
ApiDisabled.php	1.42 KB	-rw-r--r--	2016-11-28 20:20
ApiEditPage.php	18.94 KB	-rw-r--r--	2016-11-28 20:20
ApiEmailUser.php	2.79 KB	-rw-r--r--	2016-11-28 20:20
ApiErrorFormatter.php	9.31 KB	-rw-r--r--	2016-11-28 20:20
ApiExpandTemplates.php	7.05 KB	-rw-r--r--	2016-11-28 20:20
ApiFeedContributions.php	6.51 KB	-rw-r--r--	2016-11-28 20:20
ApiFeedRecentChanges.php	5.32 KB	-rw-r--r--	2016-11-28 20:20
ApiFeedWatchlist.php	8.96 KB	-rw-r--r--	2016-11-28 20:20
ApiFileRevert.php	3.86 KB	-rw-r--r--	2016-11-28 20:20
ApiFormatBase.php	8.3 KB	-rw-r--r--	2016-11-28 20:20
ApiFormatDbg.php	1.77 KB	-rw-r--r--	2010-12-22 21:52
ApiFormatDump.php	1.79 KB	-rw-r--r--	2011-01-10 23:36
ApiFormatFeedWrapper.php	3.51 KB	-rw-r--r--	2016-11-28 20:20
ApiFormatJson.php	3.86 KB	-rw-r--r--	2016-11-28 20:20
ApiFormatNone.php	1.07 KB	-rw-r--r--	2016-11-28 20:20
ApiFormatPhp.php	2.47 KB	-rw-r--r--	2016-11-28 20:20
ApiFormatRaw.php	3.02 KB	-rw-r--r--	2016-11-28 20:20
ApiFormatTxt.php	1.75 KB	-rw-r--r--	2010-12-22 21:52
ApiFormatWddx.php	4.07 KB	-rw-r--r--	2010-12-22 21:52
ApiFormatXml.php	8.96 KB	-rw-r--r--	2016-11-28 20:20
ApiFormatYaml.php	1.37 KB	-rw-r--r--	2011-04-18 13:42
ApiHelp.php	26.17 KB	-rw-r--r--	2016-11-28 20:20
ApiHelpParamValueMessage.php	1.95 KB	-rw-r--r--	2016-11-28 20:20
ApiImageRotate.php	5.19 KB	-rw-r--r--	2016-11-28 20:20
ApiImport.php	4.95 KB	-rw-r--r--	2016-11-28 20:20
ApiLinkAccount.php	3.83 KB	-rw-r--r--	2016-11-28 20:20
ApiLogin.php	9.22 KB	-rw-r--r--	2016-11-28 20:20
ApiLogout.php	2.04 KB	-rw-r--r--	2016-11-28 20:20
ApiMain.php	55.81 KB	-rw-r--r--	2016-11-28 20:20
ApiManageTags.php	3.24 KB	-rw-r--r--	2016-11-28 20:20
ApiMergeHistory.php	3.75 KB	-rw-r--r--	2016-11-28 20:20
ApiMessage.php	5.64 KB	-rw-r--r--	2016-11-28 20:20
ApiModuleManager.php	8.31 KB	-rw-r--r--	2016-11-28 20:20
ApiMove.php	7.22 KB	-rw-r--r--	2016-11-28 20:20
ApiOpenSearch.php	11.74 KB	-rw-r--r--	2016-11-28 20:20
ApiOptions.php	5.25 KB	-rw-r--r--	2016-11-28 20:20
ApiPageSet.php	44.37 KB	-rw-r--r--	2016-11-28 20:20
ApiParamInfo.php	14.88 KB	-rw-r--r--	2016-11-28 20:20
ApiParse.php	26.07 KB	-rw-r--r--	2016-11-28 20:20
ApiPatrol.php	2.99 KB	-rw-r--r--	2016-11-28 20:20
ApiProtect.php	5.54 KB	-rw-r--r--	2016-11-28 20:20
ApiPurge.php	5.83 KB	-rw-r--r--	2016-11-28 20:20
ApiQuery.php	17.13 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryAllCategories.php	5.79 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryAllDeletedRevisions.php	14.65 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryAllImages.php	11.64 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryAllLinks.php	8.69 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryAllMessages.php	7.26 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryAllPages.php	9.65 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryAllRevisions.php	8.78 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryAllUsers.php	11.5 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryAllimages.php	8.42 KB	-rw-r--r--	2011-11-28 16:52
ApiQueryAllmessages.php	7.59 KB	-rw-r--r--	2011-11-28 16:52
ApiQueryAllpages.php	10.24 KB	-rw-r--r--	2011-11-28 16:52
ApiQueryAuthManagerInfo.php	4.11 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryBacklinks.php	17.24 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryBacklinksprop.php	12.31 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryBase.php	17.33 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryBlocks.php	10.29 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryCategories.php	6.53 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryCategoryInfo.php	3.29 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryCategoryMembers.php	11.99 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryContributors.php	7.5 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryDeletedRevisions.php	9.64 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryDeletedrevs.php	16.42 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryDisabled.php	1.4 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryDuplicateFiles.php	5.38 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryExtLinksUsage.php	5.94 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryExternalLinks.php	3.79 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryFileRepoInfo.php	3.2 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryFilearchive.php	9.18 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryGeneratorBase.php	3.27 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryIWBacklinks.php	5.62 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryIWLinks.php	5.12 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryImageInfo.php	25.98 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryImages.php	4.88 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryInfo.php	27.38 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryLangBacklinks.php	5.55 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryLangLinks.php	5.44 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryLinks.php	6.63 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryLogEvents.php	14.02 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryMyStashedFiles.php	4.04 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryPagePropNames.php	2.96 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryPageProps.php	3.13 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryPagesWithProp.php	4.84 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryPrefixSearch.php	3.63 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryProtectedTitles.php	6.83 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryQueryPage.php	4.6 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryRandom.php	6.56 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryRecentChanges.php	21.5 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryRevisions.php	14.46 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryRevisionsBase.php	15.64 KB	-rw-r--r--	2016-11-28 20:20
ApiQuerySearch.php	10.87 KB	-rw-r--r--	2016-11-28 20:20
ApiQuerySiteinfo.php	26.94 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryStashImageInfo.php	4.25 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryTags.php	4.93 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryTokens.php	4 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryUserContributions.php	17.06 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryUserInfo.php	9.93 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryUsers.php	10.21 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryWatchlist.php	15.41 KB	-rw-r--r--	2016-11-28 20:20
ApiQueryWatchlistRaw.php	5.74 KB	-rw-r--r--	2016-11-28 20:20
ApiRemoveAuthenticationData.php	3.29 KB	-rw-r--r--	2016-11-28 20:20
ApiResetPassword.php	3.89 KB	-rw-r--r--	2016-11-28 20:20
ApiResult.php	36.21 KB	-rw-r--r--	2016-11-28 20:20
ApiRevisionDelete.php	6.42 KB	-rw-r--r--	2016-11-28 20:20
ApiRollback.php	6.02 KB	-rw-r--r--	2016-11-28 20:20
ApiRsd.php	4.71 KB	-rw-r--r--	2016-11-28 20:20
ApiSerializable.php	1.55 KB	-rw-r--r--	2016-11-28 20:20
ApiSetNotificationTimestamp.php	7.01 KB	-rw-r--r--	2016-11-28 20:20
ApiStashEdit.php	15.04 KB	-rw-r--r--	2016-11-28 20:20
ApiTag.php	4.6 KB	-rw-r--r--	2016-11-28 20:20
ApiTokens.php	3.11 KB	-rw-r--r--	2016-11-28 20:20
ApiUnblock.php	3.52 KB	-rw-r--r--	2016-11-28 20:20
ApiUndelete.php	3.9 KB	-rw-r--r--	2016-11-28 20:20
ApiUpload.php	30.6 KB	-rw-r--r--	2016-11-28 20:20
ApiUserrights.php	3.92 KB	-rw-r--r--	2016-11-28 20:20
ApiWatch.php	5.3 KB	-rw-r--r--	2016-11-28 20:20
SearchApi.php	6.16 KB	-rw-r--r--	2016-11-28 20:20

Rename

<?php
/**
 * Query the list of contributors to a page
 *
 * Created on Nov 14, 2013
 *
 * Copyright © 2013 Brad Jorsch
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License along
 * with this program; if not, write to the Free Software Foundation, Inc.,
 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 * http://www.gnu.org/copyleft/gpl.html
 *
 * @file
 * @since 1.23
 */

/**
 * A query module to show contributors to a page
 *
 * @ingroup API
 * @since 1.23
 */
class ApiQueryContributors extends ApiQueryBase {
	/** We don't want to process too many pages at once (it hits cold
	 * database pages too heavily), so only do the first MAX_PAGES input pages
	 * in each API call (leaving the rest for continuation).
	 */
	const MAX_PAGES = 100;

public function __construct( ApiQuery $query, $moduleName ) {
		// "pc" is short for "page contributors", "co" was already taken by the
		// GeoData extension's prop=coordinates.
		parent::__construct( $query, $moduleName, 'pc' );
	}

public function execute() {
		$db = $this->getDB();
		$params = $this->extractRequestParams();
		$this->requireMaxOneParameter( $params, 'group', 'excludegroup', 'rights', 'excluderights' );

// Only operate on existing pages
		$pages = array_keys( $this->getPageSet()->getGoodTitles() );

// Filter out already-processed pages
		if ( $params['continue'] !== null ) {
			$cont = explode( '|', $params['continue'] );
			$this->dieContinueUsageIf( count( $cont ) != 2 );
			$cont_page = (int)$cont[0];
			$pages = array_filter( $pages, function ( $v ) use ( $cont_page ) {
				return $v >= $cont_page;
			} );
		}
		if ( !count( $pages ) ) {
			// Nothing to do
			return;
		}

// Apply MAX_PAGES, leaving any over the limit for a continue.
		sort( $pages );
		$continuePages = null;
		if ( count( $pages ) > self::MAX_PAGES ) {
			$continuePages = $pages[self::MAX_PAGES] . '|0';
			$pages = array_slice( $pages, 0, self::MAX_PAGES );
		}

$result = $this->getResult();

// First, count anons
		$this->addTables( 'revision' );
		$this->addFields( [
			'page' => 'rev_page',
			'anons' => 'COUNT(DISTINCT rev_user_text)',
		] );
		$this->addWhereFld( 'rev_page', $pages );
		$this->addWhere( 'rev_user = 0' );
		$this->addWhere( $db->bitAnd( 'rev_deleted', Revision::DELETED_USER ) . ' = 0' );
		$this->addOption( 'GROUP BY', 'rev_page' );
		$res = $this->select( __METHOD__ );
		foreach ( $res as $row ) {
			$fit = $result->addValue( [ 'query', 'pages', $row->page ],
				'anoncontributors', (int)$row->anons
			);
			if ( !$fit ) {
				// This not fitting isn't reasonable, so it probably means that
				// some other module used up all the space. Just set a dummy
				// continue and hope it works next time.
				$this->setContinueEnumParameter( 'continue',
					$params['continue'] !== null ? $params['continue'] : '0|0'
				);

return;
			}
		}

// Next, add logged-in users
		$this->resetQueryParams();
		$this->addTables( 'revision' );
		$this->addFields( [
			'page' => 'rev_page',
			'user' => 'rev_user',
			'username' => 'MAX(rev_user_text)', // Non-MySQL databases don't like partial group-by
		] );
		$this->addWhereFld( 'rev_page', $pages );
		$this->addWhere( 'rev_user != 0' );
		$this->addWhere( $db->bitAnd( 'rev_deleted', Revision::DELETED_USER ) . ' = 0' );
		$this->addOption( 'GROUP BY', 'rev_page, rev_user' );
		$this->addOption( 'LIMIT', $params['limit'] + 1 );

// Force a sort order to ensure that properties are grouped by page
		// But only if pp_page is not constant in the WHERE clause.
		if ( count( $pages ) > 1 ) {
			$this->addOption( 'ORDER BY', 'rev_page, rev_user' );
		} else {
			$this->addOption( 'ORDER BY', 'rev_user' );
		}

$limitGroups = [];
		if ( $params['group'] ) {
			$excludeGroups = false;
			$limitGroups = $params['group'];
		} elseif ( $params['excludegroup'] ) {
			$excludeGroups = true;
			$limitGroups = $params['excludegroup'];
		} elseif ( $params['rights'] ) {
			$excludeGroups = false;
			foreach ( $params['rights'] as $r ) {
				$limitGroups = array_merge( $limitGroups, User::getGroupsWithPermission( $r ) );
			}

// If no group has the rights requested, no need to query
			if ( !$limitGroups ) {
				if ( $continuePages !== null ) {
					// But we still need to continue for the next page's worth
					// of anoncontributors
					$this->setContinueEnumParameter( 'continue', $continuePages );
				}

return;
			}
		} elseif ( $params['excluderights'] ) {
			$excludeGroups = true;
			foreach ( $params['excluderights'] as $r ) {
				$limitGroups = array_merge( $limitGroups, User::getGroupsWithPermission( $r ) );
			}
		}

if ( $limitGroups ) {
			$limitGroups = array_unique( $limitGroups );
			$this->addTables( 'user_groups' );
			$this->addJoinConds( [ 'user_groups' => [
				$excludeGroups ? 'LEFT OUTER JOIN' : 'INNER JOIN',
				[ 'ug_user=rev_user', 'ug_group' => $limitGroups ]
			] ] );
			$this->addWhereIf( 'ug_user IS NULL', $excludeGroups );
		}

if ( $params['continue'] !== null ) {
			$cont = explode( '|', $params['continue'] );
			$this->dieContinueUsageIf( count( $cont ) != 2 );
			$cont_page = (int)$cont[0];
			$cont_user = (int)$cont[1];
			$this->addWhere(
				"rev_page > $cont_page OR " .
				"(rev_page = $cont_page AND " .
				"rev_user >= $cont_user)"
			);
		}

$res = $this->select( __METHOD__ );
		$count = 0;
		foreach ( $res as $row ) {
			if ( ++$count > $params['limit'] ) {
				// We've reached the one extra which shows that
				// there are additional pages to be had. Stop here...
				$this->setContinueEnumParameter( 'continue', $row->page . '|' . $row->user );

return;
			}

$fit = $this->addPageSubItem( $row->page,
				[ 'userid' => (int)$row->user, 'name' => $row->username ],
				'user'
			);
			if ( !$fit ) {
				$this->setContinueEnumParameter( 'continue', $row->page . '|' . $row->user );

return;
			}
		}

if ( $continuePages !== null ) {
			$this->setContinueEnumParameter( 'continue', $continuePages );
		}
	}

public function getCacheMode( $params ) {
		return 'public';
	}

public function getAllowedParams() {
		$userGroups = User::getAllGroups();
		$userRights = User::getAllRights();

return [
			'group' => [
				ApiBase::PARAM_TYPE => $userGroups,
				ApiBase::PARAM_ISMULTI => true,
			],
			'excludegroup' => [
				ApiBase::PARAM_TYPE => $userGroups,
				ApiBase::PARAM_ISMULTI => true,
			],
			'rights' => [
				ApiBase::PARAM_TYPE => $userRights,
				ApiBase::PARAM_ISMULTI => true,
			],
			'excluderights' => [
				ApiBase::PARAM_TYPE => $userRights,
				ApiBase::PARAM_ISMULTI => true,
			],
			'limit' => [
				ApiBase::PARAM_DFLT => 10,
				ApiBase::PARAM_TYPE => 'limit',
				ApiBase::PARAM_MIN => 1,
				ApiBase::PARAM_MAX => ApiBase::LIMIT_BIG1,
				ApiBase::PARAM_MAX2 => ApiBase::LIMIT_BIG2
			],
			'continue' => [
				ApiBase::PARAM_HELP_MSG => 'api-help-param-continue',
			],
		];
	}

protected function getExamplesMessages() {
		return [
			'action=query&prop=contributors&titles=Main_Page'
				=> 'apihelp-query+contributors-example-simple',
		];
	}

public function getHelpUrls() {
		return 'https://www.mediawiki.org/wiki/API:Contributors';
	}
}