949c9c932e
* Add missing `ingroup` to class blocks (and remove from any file blocks) as otherwise the file is indexed twice (e.g. in Doxygen) which makes navigation on doc.wikimedia.org rather messy. Remove duplicate descriptions from file blocks in favour of class doc blocks. This reduces needless duplication and was often incorrect or outdated, and helps make file headers more consistently (visually) ignorable. Ref https://gerrit.wikimedia.org/r/q/message:ingroup+is:merged * Widen `@covers` tags in phpunit tests Given all called methods are de-facto and liberally claimed, and that we keep the coverage limited to the subject class, it maintains the spirit and intent by listing the class explicitly instead. PHPUnit offers a more precise tool when you need it (i.e. when testing legacy monster/god classes), but for well-written code, the class-wide tag is exactly what you want. We lose useful coverage and waste valuable time on keeping tags accurate through refactors (or worse, forget to do so). Tracking tiny per-method details wastes time in realizing (and fixing) when people inevitably don't keep them in sync, and time lost in finding uncovered code to write tests to realize it was already covered but "not yet claimed". Ref https://gerrit.wikimedia.org/r/q/owner:Krinkle+is:merged+message:Widen While at it, improve purposes and explainations of several mail-related classes, and set `@since`: - EmailNotification introduced in r22110 (1.11.0), gita6f6e04841, later moved to a separate file inbf8810d6bc(Ic435bbdbb6). - MailAddress introduced in r12082 (1.6.0, 1.5.7), git5cfddf9a82. - UserMailer converted to class with ::send in r26357 (1.12.0), git353f203ce2. Change-Id: I1216781240bcfabdebf109cef8f995355db0f659
122 lines
3.6 KiB
PHP
122 lines
3.6 KiB
PHP
<?php
|
|
/**
|
|
* 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
|
|
*/
|
|
|
|
namespace MediaWiki\Mail;
|
|
|
|
use MediaWiki\Config\Config;
|
|
use MediaWiki\Config\ServiceOptions;
|
|
use MediaWiki\HookContainer\HookContainer;
|
|
use MediaWiki\Permissions\Authority;
|
|
use MediaWiki\User\CentralId\CentralIdLookup;
|
|
use MediaWiki\User\Options\UserOptionsLookup;
|
|
use MediaWiki\User\UserFactory;
|
|
use Wikimedia\Message\IMessageFormatterFactory;
|
|
use Wikimedia\Message\ITextFormatter;
|
|
|
|
/**
|
|
* Factory for EmailUser objects.
|
|
*
|
|
* Obtain via ServiceWiring.
|
|
*
|
|
* @since 1.41
|
|
* @ingroup Mail
|
|
*/
|
|
class EmailUserFactory {
|
|
private ServiceOptions $options;
|
|
private HookContainer $hookContainer;
|
|
private UserOptionsLookup $userOptionsLookup;
|
|
private CentralIdLookup $centralIdLookup;
|
|
private UserFactory $userFactory;
|
|
private IEmailer $emailer;
|
|
private IMessageFormatterFactory $messageFormatterFactory;
|
|
private ITextFormatter $contLangMsgFormatter;
|
|
|
|
/**
|
|
* @internal For use by ServiceWiring only.
|
|
*
|
|
* @param ServiceOptions $options
|
|
* @param HookContainer $hookContainer
|
|
* @param UserOptionsLookup $userOptionsLookup
|
|
* @param CentralIdLookup $centralIdLookup
|
|
* @param UserFactory $userFactory
|
|
* @param IEmailer $emailer
|
|
* @param IMessageFormatterFactory $messageFormatterFactory
|
|
* @param ITextFormatter $contLangMsgFormatter
|
|
*/
|
|
public function __construct(
|
|
ServiceOptions $options,
|
|
HookContainer $hookContainer,
|
|
UserOptionsLookup $userOptionsLookup,
|
|
CentralIdLookup $centralIdLookup,
|
|
UserFactory $userFactory,
|
|
IEmailer $emailer,
|
|
IMessageFormatterFactory $messageFormatterFactory,
|
|
ITextFormatter $contLangMsgFormatter
|
|
) {
|
|
$options->assertRequiredOptions( EmailUser::CONSTRUCTOR_OPTIONS );
|
|
$this->options = $options;
|
|
$this->hookContainer = $hookContainer;
|
|
$this->userOptionsLookup = $userOptionsLookup;
|
|
$this->centralIdLookup = $centralIdLookup;
|
|
$this->userFactory = $userFactory;
|
|
$this->emailer = $emailer;
|
|
$this->messageFormatterFactory = $messageFormatterFactory;
|
|
$this->contLangMsgFormatter = $contLangMsgFormatter;
|
|
}
|
|
|
|
/**
|
|
* @param Authority $sender
|
|
* @return EmailUser
|
|
*/
|
|
public function newEmailUser( Authority $sender ): EmailUser {
|
|
return new EmailUser(
|
|
$this->options,
|
|
$this->hookContainer,
|
|
$this->userOptionsLookup,
|
|
$this->centralIdLookup,
|
|
$this->userFactory,
|
|
$this->emailer,
|
|
$this->messageFormatterFactory,
|
|
$this->contLangMsgFormatter,
|
|
$sender
|
|
);
|
|
}
|
|
|
|
/**
|
|
* @internal Temporary BC method for SpecialEmailUser
|
|
* @param Authority $sender
|
|
* @param Config|null $config
|
|
* @return EmailUser
|
|
*/
|
|
public function newEmailUserBC( Authority $sender, Config $config = null ): EmailUser {
|
|
$options = $config ? new ServiceOptions( EmailUser::CONSTRUCTOR_OPTIONS, $config ) : $this->options;
|
|
return new EmailUser(
|
|
$options,
|
|
$this->hookContainer,
|
|
$this->userOptionsLookup,
|
|
$this->centralIdLookup,
|
|
$this->userFactory,
|
|
$this->emailer,
|
|
$this->messageFormatterFactory,
|
|
$this->contLangMsgFormatter,
|
|
$sender
|
|
);
|
|
}
|
|
}
|