| Server IP : 167.235.224.122 / Your IP : 216.73.216.110 Web Server : Apache/2.4.58 (Ubuntu) System : Linux newplayground 6.8.0-136-generic #136-Ubuntu SMP PREEMPT_DYNAMIC Wed Jul 1 21:33:11 UTC 2026 aarch64 User : deploy ( 1000) PHP Version : 8.4.23 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : OFF | Sudo : ON | Pkexec : OFF Directory : /var/www/html/wiki/extensions/Babel/includes/ |
Upload File : |
<?php
/**
* Code for automatic creation of categories.
*
* @file
* @author Robert Leverington
* @author Robin Pepermans
* @author Niklas Laxström
* @author Brian Wolff
* @author Purodha Blissenbach
* @author Sam Reed
* @author Siebrand Mazeland
* @author Winston Sung
* @license GPL-2.0-or-later
*/
declare( strict_types = 1 );
namespace MediaWiki\Babel;
use MediaWiki\CommentStore\CommentStoreComment;
use MediaWiki\Content\ContentHandler;
use MediaWiki\Deferred\DeferredUpdates;
use MediaWiki\MainConfigNames;
use MediaWiki\MediaWikiServices;
use MediaWiki\Revision\SlotRecord;
use MediaWiki\Title\Title;
use MediaWiki\User\User;
use RecentChange;
/**
* Class for automatic creation of Babel category pages.
*/
class BabelAutoCreate {
public const MSG_USERNAME = 'babel-autocreate-user';
/**
* Create category.
*
* @param string $category Name of category to create.
* @param string $text Text to use when creating the category.
*/
public static function create( string $category, string $text ): void {
$category = strip_tags( $category );
$title = Title::makeTitleSafe( NS_CATEGORY, $category );
# T170654: We need to check whether non-existing category page in one language variant actually
# exists in another language variant when a language supports multiple language variants.
MediaWikiServices::getInstance()->getLanguageConverterFactory()->getLanguageConverter()
->findVariantLink( $category, $title, true );
DeferredUpdates::addCallableUpdate( function () use ( $title, $text ) {
$mwServices = MediaWikiServices::getInstance();
// Extra exists check here in case the category was created while this code was running
if ( $title === null || $title->exists() ) {
return;
}
$user = self::user();
# Do not add a message if the username is invalid or if the account that adds it, is blocked
if ( !$user || $user->getBlock() ) {
return;
}
if ( !$mwServices->getPermissionManager()
->quickUserCan( 'create', $user, $title )
) {
# The Babel AutoCreate account is not allowed to create the page
return;
}
$pageUpdater = $mwServices
->getWikiPageFactory()
->newFromTitle( $title )
->newPageUpdater( $user )
->setContent( SlotRecord::MAIN, ContentHandler::makeContent( $text, $title ) )
->setFlags( EDIT_FORCE_BOT );
$config = $mwServices->getMainConfig();
$useNPPatrol = $config->get( MainConfigNames::UseNPPatrol );
$useRCPatrol = $config->get( MainConfigNames::UseRCPatrol );
$needsPatrol = $useRCPatrol || $useNPPatrol;
if ( $needsPatrol && $user->authorizeWrite( 'autopatrol', $title ) ) {
$pageUpdater->setRcPatrolStatus( RecentChange::PRC_AUTOPATROLLED );
}
$url = wfMessage( 'babel-url' )->inContentLanguage()->plain();
$commentStoreComment = CommentStoreComment::newUnsavedComment(
wfMessage( 'babel-autocreate-reason', $url )
);
$pageUpdater->saveRevision( $commentStoreComment );
} );
}
/**
* Get user object.
*
* @return User|null User object for autocreate user, null if invalid.
*/
public static function user(): ?User {
$userName = wfMessage( self::MSG_USERNAME )->inContentLanguage()->plain();
return User::newSystemUser( $userName, [ 'steal' => true ] );
}
/**
* Returns the text to use when creating a babel category with the given code and level
* @param string $code Code of language that the category is for.
* @param string|null $level Level that the category is for.
* @param string|null $parent An eventual parent category to add to the newly-created category if one is created.
* @return string The text to use to create the category.
*/
public static function getCategoryText( string $code, ?string $level, ?string $parent ): string {
global $wgLanguageCode;
$language = BabelLanguageCodes::getName( $code, $wgLanguageCode );
if ( !$parent ) {
$parent = "";
} else {
$sortkey = $level ?? $code;
$parent = "[[Category:$parent|{$sortkey}]]";
}
$params = [ $language, $code, $parent ];
if ( $level === null ) {
$text = wfMessage( 'babel-autocreate-text-main', $params )->inContentLanguage()->plain();
} else {
array_unshift( $params, $level );
$text = wfMessage( 'babel-autocreate-text-levels', $params )->inContentLanguage()->plain();
}
return $text;
}
}