| 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/DiscussionTools/modules/ |
Upload File : |
const ThreadItem = require( './ThreadItem.js' ),
moment = require( './lib/moment-timezone/moment-timezone-with-data-1970-2030.js' );
/**
* A comment item
*
* @class CommentItem
* @extends ThreadItem
* @constructor
* @param {number} level
* @param {Object} range
* @param {Object[]} [signatureRanges] Objects describing the extent of signatures (plus
* timestamps) for this comment. There is always at least one signature, but there may be
* multiple. The author and timestamp of the comment is determined from the first signature.
* @param {Object[]} [timestampRanges] Objects describing the extent of timestamps within
* the above signatures.
* @param {moment} [timestamp] Timestamp (Moment object)
* @param {string} [author] Comment author's username
* @param {string|null} [displayName] Comment author's display name
*/
function CommentItem( level, range, signatureRanges, timestampRanges, timestamp, author, displayName ) {
// Parent constructor
CommentItem.super.call( this, 'comment', level, range );
this.signatureRanges = signatureRanges || [];
this.timestampRanges = timestampRanges || [];
this.timestamp = timestamp || null;
this.author = author || null;
this.displayName = displayName || null;
/**
* @member {ThreadItem} Parent thread item
*/
this.parent = null;
}
OO.inheritClass( CommentItem, ThreadItem );
/**
* Get the comment timestamp in the format used in IDs and names.
*
* Depending on the date of the comment, this may use one of two formats:
*
* - For dates prior to 'DiscussionToolsTimestampFormatSwitchTime' (by default 2022-07-12):
* Uses ISO 8601 date. Almost DateTimeInterface::RFC3339_EXTENDED, but ending with 'Z' instead
* of '+00:00', like Date#toISOString in JavaScript.
*
* - For dates on or after 'DiscussionToolsTimestampFormatSwitchTime' (by default 2022-07-12):
* Uses MediaWiki timestamp (TS_MW in MediaWiki PHP code).
*
* @return {string} Comment timestamp in standard format
*/
CommentItem.prototype.getTimestampString = function () {
const dtConfig = require( './config.json' );
const switchTime = moment.utc( dtConfig.switchTime );
if ( this.timestamp < switchTime ) {
return this.timestamp.utc().toISOString();
} else {
// Switch to English locale to avoid number formatting
return this.timestamp.utc().locale( 'en' ).format( 'YYYYMMDDHHmmss' );
}
};
/**
* @return {HeadingItem} Closest ancestor which is a HeadingItem
*/
CommentItem.prototype.getHeading = function () {
let parent = this;
while ( parent && parent.type !== 'heading' ) {
parent = parent.parent;
}
return parent;
};
/**
* @return {HeadingItem|null} Closest heading that can be used for topic subscriptions
*/
CommentItem.prototype.getSubscribableHeading = function () {
let heading = this.getHeading();
while ( heading && heading.type === 'heading' && !heading.isSubscribable() ) {
heading = heading.parent;
}
return ( heading && heading.type === 'heading' ) ? heading : null;
};
// TODO: Implement getBodyRange/getBodyHTML/getBodyText/getMentions if required
module.exports = CommentItem;