mirror of
https://gerrit.wikimedia.org/r/mediawiki/extensions/Echo
synced 2024-11-15 03:35:01 +00:00
19c55cd7ca
Add documentation and recommendation to one public method and make getTitleWithSection safer. Change-Id: I9c17032a80e736751d21c16ca0178b54c498bded
133 lines
3 KiB
PHP
133 lines
3 KiB
PHP
<?php
|
|
|
|
use MediaWiki\Revision\RevisionRecord;
|
|
|
|
/**
|
|
* Component that represents a section of a page to be used from EchoEventPresentationModel subclass.
|
|
*/
|
|
class EchoPresentationModelSection {
|
|
|
|
/**
|
|
* @var string|false|null
|
|
*/
|
|
private $rawSectionTitle = null;
|
|
|
|
/**
|
|
* @var string|false|null
|
|
*/
|
|
private $parsedSectionTitle = null;
|
|
|
|
/**
|
|
* @var EchoEvent
|
|
*/
|
|
private $event;
|
|
|
|
/**
|
|
* @var User
|
|
*/
|
|
private $user;
|
|
|
|
/**
|
|
* @var Language
|
|
*/
|
|
private $language;
|
|
|
|
/**
|
|
* EchoPresentationModelSection constructor.
|
|
*
|
|
* @param EchoEvent $event
|
|
* @param User $user
|
|
* @param Language $language
|
|
*/
|
|
public function __construct( EchoEvent $event, User $user, Language $language ) {
|
|
$this->event = $event;
|
|
$this->user = $user;
|
|
$this->language = $language;
|
|
}
|
|
|
|
/**
|
|
* Get the raw (unparsed) section title
|
|
* @return string|false Section title
|
|
*/
|
|
private function getRawSectionTitle() {
|
|
if ( $this->rawSectionTitle !== null ) {
|
|
return $this->rawSectionTitle;
|
|
}
|
|
$sectionTitle = $this->event->getExtraParam( 'section-title' );
|
|
if ( !$sectionTitle ) {
|
|
$this->rawSectionTitle = false;
|
|
return false;
|
|
}
|
|
// Check permissions
|
|
if ( !$this->event->userCan( RevisionRecord::DELETED_TEXT, $this->user ) ) {
|
|
$this->rawSectionTitle = false;
|
|
return false;
|
|
}
|
|
|
|
$this->rawSectionTitle = $sectionTitle;
|
|
return $this->rawSectionTitle;
|
|
}
|
|
|
|
/**
|
|
* Get the section title parsed to plain text
|
|
* @return string|false Section title (plain text)
|
|
*/
|
|
private function getParsedSectionTitle() {
|
|
if ( $this->parsedSectionTitle !== null ) {
|
|
return $this->parsedSectionTitle;
|
|
}
|
|
$rawSectionTitle = $this->getRawSectionTitle();
|
|
if ( !$rawSectionTitle ) {
|
|
$this->parsedSectionTitle = false;
|
|
return false;
|
|
}
|
|
$this->parsedSectionTitle = EchoDiscussionParser::getTextSnippet(
|
|
$rawSectionTitle,
|
|
$this->language,
|
|
150,
|
|
$this->event->getTitle()
|
|
);
|
|
return $this->parsedSectionTitle;
|
|
}
|
|
|
|
/**
|
|
* Check if there is a section.
|
|
*
|
|
* This also returns false if the revision is deleted,
|
|
* even if there is a section, because the section can't
|
|
* be viewed in that case.
|
|
* @return bool Whether there is a section
|
|
*/
|
|
public function exists() {
|
|
return (bool)$this->getRawSectionTitle();
|
|
}
|
|
|
|
/**
|
|
* Get a Title pointing to the section, if available.
|
|
* @return Title
|
|
*/
|
|
public function getTitleWithSection() {
|
|
$title = $this->event->getTitle();
|
|
$section = $this->getParsedSectionTitle();
|
|
if ( $section ) {
|
|
$fragment = substr( Parser::guessSectionNameFromStrippedText( $section ), 1 );
|
|
$title = $title->createFragmentTarget( $fragment );
|
|
}
|
|
return $title;
|
|
}
|
|
|
|
/**
|
|
* Get truncated section title, according to user's language.
|
|
* You should only call this if EchoPresentationModelSection::exists returns true.
|
|
* @return string
|
|
*/
|
|
public function getTruncatedSectionTitle() {
|
|
return $this->language->embedBidi( $this->language->truncateForVisual(
|
|
$this->getParsedSectionTitle(),
|
|
EchoEventPresentationModel::SECTION_TITLE_RECOMMENDED_LENGTH,
|
|
'...',
|
|
false
|
|
) );
|
|
}
|
|
}
|