Comments/includes/CommentsPage.class.php

626 lines
17 KiB
PHP

<?php
/**
* Class for Comments methods that are not specific to one comments,
* but specific to one comment-using page
*/
class CommentsPage extends ContextSource {
/**
* @var Integer: page ID (page.page_id) of this page.
*/
public $id = 0;
/**
* @var Integer: if this is _not_ 0, then the comments are ordered by their
* Comment_Score in descending order
*/
public $orderBy = 0;
/**
* @var Integer: maximum amount of threads of comments shown per page before pagination is enabled;
*/
public $limit = 50;
/**
* @TODO document
*
* @var int
*/
public $pagerLimit = 9;
/**
* The current page of comments we are paged to
*
* @var int
*/
public $currentPagerPage = 0;
/**
* List of users allowed to comment. Empty string - any user can comment
*
* @var string
*/
public $allow = '';
/**
* What voting to disallow - disallow PLUS, MINUS, or BOTH
*
* @var string
*/
public $voting = '';
/**
* @var Boolean: allow positive (plus) votes?
*/
public $allowPlus = true;
/**
* @var Boolean: allow negative (minus) votes?
*/
public $allowMinus = true;
/**
* @TODO document
*
* @var string
*/
public $pageQuery = 'cpage';
/**
* @var Title: title object for this page
*/
public $title = null;
/**
* List of lists of comments on this page.
* Each list is a separate 'thread' of comments, with the parent comment first, and any replies following
* Not populated until display() is called
*
* @var array
*/
public $comments = array();
/**
* Constructor
*
* @param $pageID: current page ID
*/
function __construct ( $pageID, $context ) {
$this->id = $pageID;
$this->setContext( $context );
$this->title = Title::newFromID( $pageID );
}
/**
* Gets the total amount of comments on this page
*
* @return int
*/
function countTotal() {
$dbr = wfGetDB( DB_SLAVE );
$count = 0;
$s = $dbr->selectRow(
'Comments',
array( 'COUNT(*) AS CommentCount' ),
array( 'Comment_Page_ID' => $this->id ),
__METHOD__
);
if ( $s !== false ) {
$count = $s->CommentCount;
}
return $count;
}
/**
* Gets the ID number of the latest comment for the current page.
*
* @return int
*/
function getLatestCommentID() {
$latestCommentID = 0;
$dbr = wfGetDB( DB_SLAVE );
$s = $dbr->selectRow(
'Comments',
array( 'CommentID' ),
array( 'Comment_Page_ID' => $this->id ),
__METHOD__,
array( 'ORDER BY' => 'Comment_Date DESC', 'LIMIT' => 1 )
);
if ( $s !== false ) {
$latestCommentID = $s->CommentID;
}
return $latestCommentID;
}
/**
* Set voting either totally off, or disallow "thumbs down" or disallow
* "thumbs up".
*
* @param string $voting 'OFF', 'PLUS' or 'MINUS' (will be strtoupper()ed)
*/
function setVoting( $voting ) {
$this->voting = $voting;
$voting = strtoupper( $voting );
if ( $voting == 'OFF' ) {
$this->allowMinus = false;
$this->allowPlus = false;
}
if ( $voting == 'PLUS' ) {
$this->allowMinus = false;
}
if ( $voting == 'MINUS' ) {
$this->allowPlus = false;
}
}
/**
* Fetches all comments, called by display().
*
* @return array Array containing every possible bit of information about
* a comment, including score, timestamp and more
*/
public function getComments() {
$dbr = wfGetDB( DB_SLAVE );
// Defaults (for non-social wikis)
$tables = array(
'Comments',
'vote1' => 'Comments_Vote',
'vote2' => 'Comments_Vote',
);
$fields = array(
'Comment_Username', 'Comment_IP', 'Comment_Text',
'Comment_Date', 'Comment_Date AS timestamp',
'Comment_user_id', 'CommentID', 'Comment_Parent_ID',
'vote1.Comment_Vote_Score AS current_vote',
'SUM(vote2.Comment_Vote_Score) AS comment_score'
);
$joinConds = array(
// For current user's vote
'vote1' => array(
'LEFT JOIN',
array(
'vote1.Comment_Vote_ID = CommentID',
'vote1.Comment_Vote_Username' => $this->getUser()->getName()
)
),
// For total vote count
'vote2' => array( 'LEFT JOIN', 'vote2.Comment_Vote_ID = CommentID' )
);
$params = array( 'GROUP BY' => 'CommentID' );
// If SocialProfile is installed, query the user_stats table too.
if (
class_exists( 'UserProfile' ) &&
$dbr->tableExists( 'user_stats' )
) {
$tables[] = 'user_stats';
$fields[] = 'stats_total_points';
$joinConds['Comments'] = array(
'LEFT JOIN', 'Comment_user_id = stats_user_id'
);
}
// Perform the query
$res = $dbr->select(
$tables,
$fields,
array( 'Comment_Page_ID' => $this->id ),
__METHOD__,
$params,
$joinConds
);
$comments = array();
foreach ( $res as $row ) {
if ( $row->Comment_Parent_ID == 0 ) {
$thread = $row->CommentID;
} else {
$thread = $row->Comment_Parent_ID;
}
$data = array(
'Comment_Username' => $row->Comment_Username,
'Comment_IP' => $row->Comment_IP,
'Comment_Text' => $row->Comment_Text,
'Comment_Date' => $row->Comment_Date,
'Comment_user_id' => $row->Comment_user_id,
'Comment_user_points' => ( isset( $row->stats_total_points ) ? number_format( $row->stats_total_points ) : 0 ),
'CommentID' => $row->CommentID,
'Comment_Parent_ID' => $row->Comment_Parent_ID,
'thread' => $thread,
'timestamp' => wfTimestamp( TS_UNIX, $row->timestamp ),
'current_vote' => ( isset( $row->current_vote ) ? $row->current_vote : false ),
'total_vote' => ( isset( $row->comment_score ) ? $row->comment_score : 0 ),
);
$comments[] = new Comment( $this, $this->getContext(), $data );
}
$commentThreads = array();
foreach ( $comments as $comment ) {
if ( $comment->parentID == 0 ) {
$commentThreads[$comment->id] = array( $comment );
} else {
$commentThreads[$comment->parentID][] = $comment;
}
}
return $commentThreads;
}
/**
* @return int The page we are currently paged to
* not used for any API calls
*/
function getCurrentPagerPage() {
if ( $this->currentPagerPage == 0 ) {
$this->currentPagerPage = $this->getRequest()->getInt( $this->pageQuery, 1 );
if ( $this->currentPagerPage < 1 ) {
$this->currentPagerPage = 1;
}
}
return $this->currentPagerPage;
}
/**
* Display pager for the current page.
*
* @param int $pagerCurrent Page we are currently paged to
* @param int $pagesCount The maximum page number
*
* @return string: the links for paging through pages of comments
*/
function displayPager( $pagerCurrent, $pagesCount ) {
// Middle is used to "center" pages around the current page.
$pager_middle = ceil( $this->pagerLimit / 2 );
// first is the first page listed by this pager piece (re quantity)
$pagerFirst = $pagerCurrent - $pager_middle + 1;
// last is the last page listed by this pager piece (re quantity)
$pagerLast = $pagerCurrent + $this->pagerLimit - $pager_middle;
// Prepare for generation loop.
$i = $pagerFirst;
if ( $pagerLast > $pagesCount ) {
// Adjust "center" if at end of query.
$i = $i + ( $pagesCount - $pagerLast );
$pagerLast = $pagesCount;
}
if ( $i <= 0 ) {
// Adjust "center" if at start of query.
$pagerLast = $pagerLast + ( 1 - $i );
$i = 1;
}
$output = '';
if ( $pagesCount > 1 ) {
$output .= '<ul class="c-pager">';
$pagerEllipsis = '<li class="c-pager-item c-pager-ellipsis"><span>...</span></li>';
// Whether to display the "Previous page" link
if ( $pagerCurrent > 1 ) {
$output .= '<li class="c-pager-item c-pager-previous">' .
Html::rawElement(
'a',
array(
'rel' => 'nofollow',
'class' => 'c-pager-link',
'href' => '#cfirst',
'data-' . $this->pageQuery => ( $pagerCurrent - 1 ),
),
'&lt;'
) .
'</li>';
}
// Whether to display the "First page" link
if ( $i > 1 ) {
$output .= '<li class="c-pager-item c-pager-first">' .
Html::rawElement(
'a',
array(
'rel' => 'nofollow',
'class' => 'c-pager-link',
'href' => '#cfirst',
'data-' . $this->pageQuery => 1,
),
1
) .
'</li>';
}
// When there is more than one page, create the pager list.
if ( $i != $pagesCount ) {
if ( $i > 2 ) {
$output .= $pagerEllipsis;
}
// Now generate the actual pager piece.
for ( ; $i <= $pagerLast && $i <= $pagesCount; $i++ ) {
if ( $i == $pagerCurrent ) {
$output .= '<li class="c-pager-item c-pager-current"><span>' .
$i . '</span></li>';
} else {
$output .= '<li class="c-pager-item">' .
Html::rawElement(
'a',
array(
'rel' => 'nofollow',
'class' => 'c-pager-link',
'href' => '#cfirst',
'data-' . $this->pageQuery => $i,
),
$i
) .
'</li>';
}
}
if ( $i < $pagesCount ) {
$output .= $pagerEllipsis;
}
}
// Whether to display the "Last page" link
if ( $pagesCount > ( $i - 1 ) ) {
$output .= '<li class="c-pager-item c-pager-last">' .
Html::rawElement(
'a',
array(
'rel' => 'nofollow',
'class' => 'c-pager-link',
'href' => '#cfirst',
'data-' . $this->pageQuery => $pagesCount,
),
$pagesCount
) .
'</li>';
}
// Whether to display the "Next page" link
if ( $pagerCurrent < $pagesCount ) {
$output .= '<li class="c-pager-item c-pager-next">' .
Html::rawElement(
'a',
array(
'rel' => 'nofollow',
'class' => 'c-pager-link',
'href' => '#cfirst',
'data-' . $this->pageQuery => ( $pagerCurrent + 1 ),
),
'&gt;'
) .
'</li>';
}
$output .= '</ul>';
}
return $output;
}
/**
* Get this list of anon commenters in the given list of comments,
* and return a mapped array of IP adressess to the the number anon poster
* (so anon posters can be called Anon#1, Anon#2, etc
*
* @return array
*/
function getAnonList() {
$counter = 1;
$bucket = array();
$commentThreads = $this->comments;
$comments = array(); // convert 2nd threads array to a simple list of comments
foreach ( $commentThreads as $thread ) {
$comments = array_merge( $comments, $thread );
}
usort( $comments, array( 'CommentFunctions', 'sortTime' ) );
foreach ( $comments as $comment ) {
if (
!array_key_exists( $comment->username, $bucket ) &&
$comment->userID == 0
) {
$bucket[$comment->username] = $counter;
$counter++;
}
}
return $bucket;
}
/**
* Sort an array of comment threads
* @param $threads
* @return mixed
*/
function sort( $threads ) {
global $wgCommentsSortDescending;
if ( $this->orderBy ) {
usort( $threads, array( 'CommentFunctions', 'sortScore' ) );
} elseif ( $wgCommentsSortDescending ) {
usort( $threads, array( 'CommentFunctions', 'sortDesc' ) );
} else {
usort( $threads, array( 'CommentFunctions', 'sortAsc' ) );
}
return $threads;
}
/**
* Convert an array of comment threads into an array of pages (arrays) of comment threads
* @param $comments
* @return array
*/
function page( $comments ) {
return array_chunk( $comments, $this->limit );
}
/**
* Display all the comments for the current page.
* CSS and JS is loaded in CommentsHooks.php
*/
function display() {
$output = '';
$commentThreads = $this->getComments();
$commentThreads = $this->sort( $commentThreads );
$this->comments = $commentThreads;
$commentPages = $this->page( $commentThreads );
$currentPageNum = $this->getCurrentPagerPage();
$numPages = count( $commentPages );
// Suppress random E_NOTICE about "Undefined offset: 0", which seems to
// be breaking ProblemReports (at least on my local devbox, not sure
// about prod). --Jack Phoenix, 13 July 2015
wfSuppressWarnings();
$currentPage = $commentPages[$currentPageNum - 1];
wfRestoreWarnings();
// Load complete blocked list for logged in user so they don't see their comments
$blockList = array();
if ( $this->getUser()->getID() != 0 ) {
$blockList = CommentFunctions::getBlockList( $this->getUser()->getId() );
}
if ( $currentPage ) {
$pager = $this->displayPager( $currentPageNum, $numPages );
$output .= $pager;
$output .= '<a id="cfirst" name="cfirst" rel="nofollow"></a>';
$anonList = $this->getAnonList();
foreach ( $currentPage as $thread ) {
foreach ( $thread as $comment ) {
$output .= $comment->display( $blockList, $anonList );
}
}
$output .= $pager;
}
return $output;
}
/**
* Displays the "Sort by X" form and a link to auto-refresh comments
*
* @return string HTML
*/
function displayOrderForm() {
// ##START## 27.09.2017 von Bernhard Linz
$output = '<div id="spy" class="c-spy">
<a href="javascript:void(0)">' .
wfMessage( 'comments-auto-refresher-enable' )->plain() .
'</a>
</div>
<div class="visualClear"></div>
<br />' . "\n";
/* $output = '<div class="c-order">
<div class="c-order-select">
<form name="ChangeOrder" action="">
<select name="TheOrder">
<option value="0">' .
wfMessage( 'comments-sort-by-date' )->plain() .
'</option>
<option value="1">' .
wfMessage( 'comments-sort-by-score' )->plain() .
'</option>
</select>
</form>
</div>
<div id="spy" class="c-spy">
<a href="javascript:void(0)">' .
wfMessage( 'comments-auto-refresher-enable' )->plain() .
'</a>
</div>
<div class="visualClear"></div>
</div>
<br />' . "\n";
*/
// ##ENDE##
return $output;
}
/**
* Displays the form for adding new comments
*
* @return string HTML output
*/
function displayForm() {
$output = '<form action="" method="post" name="commentForm">' . "\n";
if ( $this->allow ) {
$pos = strpos(
strtoupper( addslashes( $this->allow ) ),
strtoupper( addslashes( $this->getUser()->getName() ) )
);
}
// 'comment' user right is required to add new comments
if ( !$this->getUser()->isAllowed( 'comment' ) ) {
$output .= wfMessage( 'comments-not-allowed' )->parse();
} else {
// Blocked users can't add new comments under any conditions...
// and maybe there's a list of users who should be allowed to post
// comments
if ( $this->getUser()->isBlocked() == false && ( $this->allow == '' || $pos !== false ) ) {
$output .= '<div class="c-form-title">' . wfMessage( 'comments-submit' )->plain() . '</div>' . "\n";
$output .= '<div id="replyto" class="c-form-reply-to"></div>' . "\n";
// Show a message to anons, prompting them to register or log in
if ( !$this->getUser()->isLoggedIn() ) {
$login_title = SpecialPage::getTitleFor( 'Userlogin' );
$register_title = SpecialPage::getTitleFor( 'Userlogin', 'signup' );
$output .= '<div class="c-form-message">' . wfMessage(
'comments-anon-message',
htmlspecialchars( $register_title->getFullURL() ),
htmlspecialchars( $login_title->getFullURL() )
)->text() . '</div>' . "\n";
}
// ##START## 27.09.2017 von Bernhard Linz
if ( !$this->getUser()->isLoggedIn() ) {
$output .= '<p><label for="txt_username">Name oder Emailadresse:</label><br /><input style="margin: 0px; width: 530px;" type="text" name="txt_username" id="txt_username" />' . "</p>";
} else {
$output .= '<p>Benutzer:<b>' . $this->getUser()->getName() . '</b></p>';
}
// ##ENDE## 27.09.2017 von Bernhard Linz
$output .= '<textarea name="commentText" id="comment" rows="5" cols="64"></textarea>' . "\n";
$output .= '<div class="c-form-button"><input type="button" value="' .
wfMessage( 'comments-post' )->plain() . '" class="site-button" /></div>' . "\n";
}
$output .= '<input type="hidden" name="action" value="purge" />' . "\n";
$output .= '<input type="hidden" name="pageId" value="' . $this->id . '" />' . "\n";
$output .= '<input type="hidden" name="commentid" />' . "\n";
$output .= '<input type="hidden" name="lastCommentId" value="' . $this->getLatestCommentID() . '" />' . "\n";
$output .= '<input type="hidden" name="commentParentId" />' . "\n";
$output .= '<input type="hidden" name="' . $this->pageQuery . '" value="' . $this->getCurrentPagerPage() . '" />' . "\n";
$output .= Html::hidden( 'token', $this->getUser()->getEditToken() );
}
$output .= '</form>' . "\n";
return $output;
}
/**
* Purge caches (parser cache and Squid cache)
*/
function clearCommentListCache() {
wfDebug( "Clearing comments for page {$this->id} from cache\n" );
if ( is_object( $this->title ) ) {
$this->title->invalidateCache();
$this->title->purgeSquid();
}
}
}