CommentsExtension::getCommentsEnabled() - Code Metrics - Inspection of "FIX: NON JS page now has a 'Reply To' link, click..." - silverstripe/silverstripe-comments - Measure and Improve Code Quality continuously with Scrutinizer

Completed
Pull Request — master (#173)

by Gordon
created 2016-02-16 13:02 UTC
CommentsExtension::getCommentsEnabled() A

↳ Parent: CommentsExtension
Complexity

Conditions	3
Paths	3
Size

Total Lines	11
Code Lines	6
Duplication

Lines	0
Ratio	0 %
Metric	Value
dl	0
loc	11
rs	9.4285
cc	3
eloc	6
nc	3
nop	0
<?php

/**
 * Extension to {@link DataObject} to enable tracking comments.
 *
 * @package comments
 */
class CommentsExtension extends DataExtension {
    /**
     * Default configuration values
     *
     * enabled:                     Allows commenting to be disabled even if the extension is present
     * enabled_cms:                 Allows commenting to be enabled or disabled via the CMS
     * require_login:               Boolean, whether a user needs to login (required for required_permission)
     * require_login_cms:           Allows require_login to be set via the CMS
     * required_permission:         Permission (or array of permissions) required to comment
     * include_js:                  Enhance operation by ajax behaviour on moderation links (required for use_preview)
     * use_gravatar:                Set to true to show gravatar icons
     * gravatar_default:            Theme for 'not found' gravatar {@see http://gravatar.com/site/implement/images}
     * gravatar_rating:             Gravatar rating (same as the standard default)
     * show_comments_when_disabled: Show older comments when commenting has been disabled.
     * order_comments_by:           Default sort order.
     * order_replies_by:            Sort order for replies.
     * comments_holder_id:          ID for the comments holder
     * comment_permalink_prefix:    ID prefix for each comment
     * require_moderation:          Require moderation for all comments
     * require_moderation_cms:      Ignore other comment moderation config settings and set via CMS
     * frontend_moderation:         Display unmoderated comments in the frontend, if the user can moderate them.
     * frontend_spam:               Display spam comments in the frontend, if the user can moderate them.
     * html_allowed:                Allow for sanitized HTML in comments
     * use_preview:                 Preview formatted comment (when allowing HTML)
     * nested_comments:             Enable nested comments
     * nested_depth:                Max depth of nested comments in levels (where root is 1 depth) 0 means no limit.
     *
     * @var array
     *
     * @config
     */
    private static $comments = array(
        'enabled' => true,
        'enabled_cms' => false,
        'require_login' => false,
        'require_login_cms' => false,
        'required_permission' => false,
        'include_js' => true,
        'use_gravatar' => false,
        'gravatar_size' => 80,
        'gravatar_default' => 'identicon',
        'gravatar_rating' => 'g',
        'show_comments_when_disabled' => false,
        'order_comments_by' => '"Created" DESC',
        'order_replies_by' => false,
        'comments_per_page' => 10,
        'comments_holder_id' => 'comments-holder',
        'comment_permalink_prefix' => 'comment-',
        'require_moderation' => false,
        'require_moderation_nonmembers' => false,
        'require_moderation_cms' => false,
        'frontend_moderation' => false,
        'frontend_spam' => false,
        'html_allowed' => false,
        'html_allowed_elements' => array('a', 'img', 'i', 'b'),
        'use_preview' => false,
        'nested_comments' => false,
        'nested_depth' => 2,
    );

    /**
     * @var array
     */
    private static $db = array(
        'ProvideComments' => 'Boolean',
        'ModerationRequired' => 'Enum(\'None,Required,NonMembersOnly\',\'None\')',
        'CommentsRequireLogin' => 'Boolean',
    );

    /**
     * CMS configurable options should default to the config values, but respect
     * default values specified by the object
     */
    public function populateDefaults() {
        $defaults = $this->owner->config()->defaults;

        // Set if comments should be enabled by default
        if(isset($defaults['ProvideComments'])) {
            $this->owner->ProvideComments = $defaults['ProvideComments'];
        } else {
            $this->owner->ProvideComments = $this->owner->getCommentsOption('enabled') ? 1 : 0;
        }

        // If moderation options should be configurable via the CMS then
        if(isset($defaults['ModerationRequired'])) {
            $this->owner->ModerationRequired = $defaults['ModerationRequired'];
        } elseif($this->owner->getCommentsOption('require_moderation')) {
            $this->owner->ModerationRequired = 'Required';
        } elseif($this->owner->getCommentsOption('require_moderation_nonmembers')) {
            $this->owner->ModerationRequired = 'NonMembersOnly';
        } else {
            $this->owner->ModerationRequired = 'None';
        }

        // Set login required
        if(isset($defaults['CommentsRequireLogin'])) {
            $this->owner->CommentsRequireLogin = $defaults['CommentsRequireLogin'];
        } else {
            $this->owner->CommentsRequireLogin = $this->owner->getCommentsOption('require_login') ? 1 : 0;
        }
    }


    /**
     * If this extension is applied to a {@link SiteTree} record then
     * append a Provide Comments checkbox to allow authors to trigger
     * whether or not to display comments
     *
     * @todo Allow customization of other {@link Commenting} configuration
     *
     * @param FieldList $fields
     */
    public function updateSettingsFields(FieldList $fields) {

        $options = FieldGroup::create()->setTitle(_t('CommentsExtension.COMMENTOPTIONS', 'Comments'));

        // Check if enabled setting should be cms configurable
        if($this->owner->getCommentsOption('enabled_cms')) {
            $options->push(new CheckboxField('ProvideComments', _t('Comment.ALLOWCOMMENTS', 'Allow Comments')));
        }

        // Check if we should require users to login to comment
        if($this->owner->getCommentsOption('require_login_cms')) {
            $options->push(
                new CheckboxField(
                    'CommentsRequireLogin',
                    _t('Comments.COMMENTSREQUIRELOGIN', 'Require login to comment')
                )
            );
        }

        if($options->FieldList()->count()) {
            if($fields->hasTabSet()) {
                $fields->addFieldsToTab('Root.Settings', $options);
function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
            } else {
                $fields->push($options);
            }
        }

        // Check if moderation should be enabled via cms configurable
        if($this->owner->getCommentsOption('require_moderation_cms')) {
            $moderationField = new DropdownField('ModerationRequired', 'Comment Moderation', array(
                'None' => _t('CommentsExtension.MODERATIONREQUIRED_NONE', 'No moderation required'),
                'Required' => _t('CommentsExtension.MODERATIONREQUIRED_REQUIRED', 'Moderate all comments'),
                'NonMembersOnly' => _t(
                    'CommentsExtension.MODERATIONREQUIRED_NONMEMBERSONLY',
                    'Only moderate non-members'
                ),
            ));
            if($fields->hasTabSet()) {
                $fields->addFieldsToTab('Root.Settings', $moderationField);
function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
            } else {
                $fields->push($moderationField);
            }
        }
    }

    /**
     * Get comment moderation rules for this parent
     *
     * None:           No moderation required
     * Required:       All comments
     * NonMembersOnly: Only anonymous users
     *
     * @return string
     */
    public function getModerationRequired() {
        if($this->owner->getCommentsOption('require_moderation_cms')) {
            return $this->owner->getField('ModerationRequired');
        } elseif($this->owner->getCommentsOption('require_moderation')) {
            return 'Required';
        } elseif($this->owner->getCommentsOption('require_moderation_nonmembers')) {
            return 'NonMembersOnly';
        } else {
            return 'None';
        }
    }

    /**
     * Determine if users must be logged in to post comments
     *
     * @return boolean
     */
    public function getCommentsRequireLogin() {
        if($this->owner->getCommentsOption('require_login_cms')) {
            return (bool) $this->owner->getField('CommentsRequireLogin');
        } else {
            return (bool) $this->owner->getCommentsOption('require_login');
        }
    }

    /**
     * Returns the RelationList of all comments against this object. Can be used as a data source
     * for a gridfield with write access.
     *
     * @return CommentList
     */
    public function AllComments() {
        $order = $this->owner->getCommentsOption('order_comments_by');
        $comments = CommentList::create($this->ownerBaseClass)
            ->forForeignID($this->owner->ID)
            ->sort($order);
        $this->owner->extend('updateAllComments', $comments);
        return $comments;
    }

    /**
     * Returns all comments against this object, with with spam and unmoderated items excluded, for use in the frontend
     *
     * @return CommentList
     */
    public function AllVisibleComments() {
        $list = $this->AllComments();

        // Filter spam comments for non-administrators if configured
        $showSpam = $this->owner->getCommentsOption('frontend_spam') && $this->owner->canModerateComments();
        if(!$showSpam) {
            $list = $list->filter('IsSpam', 0);
        }

        // Filter un-moderated comments for non-administrators if moderation is enabled
        $showUnmoderated = ($this->owner->ModerationRequired === 'None')
            || ($this->owner->getCommentsOption('frontend_moderation') && $this->owner->canModerateComments());
        if(!$showUnmoderated) {
            $list = $list->filter('Moderated', 1);
        }

        $this->owner->extend('updateAllVisibleComments', $list);
        return $list;
    }

    /**
     * Returns the root level comments, with spam and unmoderated items excluded, for use in the frontend
     *
     * @return CommentList
     */
    public function Comments() {
        $list = $this->AllVisibleComments();

        // If nesting comments, only show root level
        if($this->owner->getCommentsOption('nested_comments')) {
            $list = $list->filter('ParentCommentID', 0);
        }

        $this->owner->extend('updateComments', $list);
        return $list;
    }

    /**
     * Returns a paged list of the root level comments, with spam and unmoderated items excluded,
     * for use in the frontend
     *
     * @return PaginatedList
     */
    public function PagedComments() {

        $list = $this->Comments();

        // Add pagination
        $list = new PaginatedList($list, Controller::curr()->getRequest());
        $list->setPaginationGetVar('commentsstart' . $this->owner->ID);
        $list->setPageLength($this->owner->getCommentsOption('comments_per_page'));

        $this->owner->extend('updatePagedComments', $list);
        return $list;
    }

    /**
     * Check if comments are configured for this page even if they are currently disabled.
     * Do not include the comments on pages which don't have id's such as security pages
     *
     * @deprecated since version 2.0
     *
     * @return boolean
     */
    public function getCommentsConfigured() {
        Deprecation::notice('2.0', 'getCommentsConfigured is deprecated. Use getCommentsEnabled instead');
        return true; // by virtue of all classes with this extension being 'configured'
    }

    /**
     * Determine if comments are enabled for this instance
     *
     * @return boolean
     */
    public function getCommentsEnabled() {
        // Don't display comments form for pseudo-pages (such as the login form)
        if(!$this->owner->exists()) return false;

        // Determine which flag should be used to determine if this is enabled
        if($this->owner->getCommentsOption('enabled_cms')) {
            return $this->owner->ProvideComments;
        } else {
            return $this->owner->getCommentsOption('enabled');
        }
    }

    /**
     * Get the HTML ID for the comment holder in the template
     *
     * @return string
     */
    public function getCommentHolderID() {
        return $this->owner->getCommentsOption('comments_holder_id');
    }

    /**
     * @deprecated since version 2.0
     */
    public function getPostingRequiresPermission() {
        Deprecation::notice('2.0', 'Use getPostingRequiredPermission instead');
        return $this->getPostingRequiredPermission();
    }

    /**
     * Permission codes required in order to post (or empty if none required)
     *
     * @return string|array Permission or list of permissions, if required
     */
    public function getPostingRequiredPermission() {
        return $this->owner->getCommentsOption('required_permission');
    }

    public function canPost() {
        Deprecation::notice('2.0', 'Use canPostComment instead');
        return $this->canPostComment();
    }

    /**
     * Determine if a user can post comments on this item
     *
     * @param Member $member Member to check
     *
     * @return boolean
     */
    public function canPostComment($member = null) {
        // Deny if not enabled for this object
        if(!$this->owner->CommentsEnabled) return false;

        // Check if member is required
        $requireLogin = $this->owner->CommentsRequireLogin;
        if(!$requireLogin) return true;

        // Check member is logged in
        $member = $member ?: Member::currentUser();
        if(!$member) return false;

        // If member required check permissions
        $requiredPermission = $this->owner->PostingRequiredPermission;
        if($requiredPermission && !Permission::checkMember($member, $requiredPermission)) return false;

        return true;
    }

    /**
     * Determine if this member can moderate comments in the CMS
     *
     * @param Member $member
     *
     * @return boolean
     */
    public function canModerateComments($member = null) {
        // Deny if not enabled for this object
        if(!$this->owner->CommentsEnabled) return false;

        // Fallback to can-edit
        return $this->owner->canEdit($member);
    }

    public function getRssLink() {
        Deprecation::notice('2.0', 'Use getCommentRSSLink instead');
        return $this->getCommentRSSLink();
    }

    /**
     * Gets the RSS link to all comments
     *
     * @return string
     */
    public function getCommentRSSLink() {
        return Controller::join_links(Director::baseURL(), 'CommentingController/rss');
    }

    public function getRssLinkPage() {
        Deprecation::notice('2.0', 'Use getCommentRSSLinkPage instead');
        return $this->getCommentRSSLinkPage();
    }

    /**
     * Get the RSS link to all comments on this page
     *
     * @return string
     */
    public function getCommentRSSLinkPage() {
        return Controller::join_links(
            $this->getCommentRSSLink(), $this->ownerBaseClass, $this->owner->ID
        );
    }

    /**
     * Comments interface for the front end. Includes the CommentAddForm and the composition
     * of the comments display.
     *
     * To customize the html see templates/CommentInterface.ss or extend this function with
     * your own extension.
     *
     * @todo Cleanup the passing of all this configuration based functionality
     *
     * @see  docs/en/Extending
     */
    public function CommentsForm() {
        // Check if enabled
        $enabled = $this->getCommentsEnabled();
        if($enabled && $this->owner->getCommentsOption('include_js')) {
            Requirements::javascript(THIRDPARTY_DIR . '/jquery/jquery.js');
            Requirements::javascript(THIRDPARTY_DIR . '/jquery-entwine/dist/jquery.entwine-dist.js');
            Requirements::javascript(THIRDPARTY_DIR . '/jquery-validate/lib/jquery.form.js');
            Requirements::javascript(COMMENTS_THIRDPARTY . '/jquery-validate/jquery.validate.min.js');
            Requirements::add_i18n_javascript('comments/javascript/lang');
            Requirements::javascript('comments/javascript/CommentsInterface.js');
        }

        $controller = CommentingController::create();
        $controller->setOwnerRecord($this->owner);
        $controller->setBaseClass($this->ownerBaseClass);
        $controller->setOwnerController(Controller::curr());

        $moderatedSubmitted = Session::get('CommentsModerated');
        Session::clear('CommentsModerated');

        $form = ($enabled) ? $controller->CommentsForm() : false;

        // a little bit all over the show but to ensure a slightly easier upgrade for users
        // return back the same variables as previously done in comments
        return $this
            ->owner
            ->customise(array(
                'AddCommentForm' => $form,
                'ModeratedSubmitted' => $moderatedSubmitted,
            ))
            ->renderWith('CommentsInterface');
    }


    /*
    JavaScript form reply requires an empty form, when the reply button is
    clicked the correct values are inserted, the form moved, and then shown
     */
    public function getReplyFormForJavaScript() {
        // Build reply controller
        $controller = CommentingController::create();
        $controller->setOwnerRecord($this->owner);
        $controller->setBaseClass($this->owner->ClassName);
        $controller->setOwnerController(Controller::curr());
        $comment = new Comment();
        $comment->ID='JSOnly';
        $comment->ParentID = $this->owner->ID;
        return $controller->ReplyForm($comment);
    }


    /**
     * Returns whether this extension instance is attached to a {@link SiteTree} object
     *
     * @return bool
     */
    public function attachedToSiteTree() {
        $class = $this->ownerBaseClass;

        return (is_subclass_of($class, 'SiteTree')) || ($class == 'SiteTree');

    }

    /**
     * @deprecated 1.0 Please use {@link CommentsExtension->CommentsForm()}
     */
    public function PageComments() {
        // This method is very commonly used, don't throw a warning just yet
        Deprecation::notice('1.0', '$PageComments is deprecated. Please use $CommentsForm');
        return $this->CommentsForm();
    }

    /**
     * Get the commenting option for this object
     *
     * This can be overridden in any instance or extension to customise the option available
     *
     * @param string $key
     *
     * @return mixed Result if the setting is available, or null otherwise
     */
    public function getCommentsOption($key) {
        $settings = $this->owner // In case singleton is called on the extension directly
            ? $this->owner->config()->comments
            : Config::inst()->get(__CLASS__, 'comments');
        $value = null;
        if(isset($settings[$key])) $value = $settings[$key];

        // To allow other extensions to customise this option
        if($this->owner) $this->owner->extend('updateCommentsOption', $key, $value);
        return $value;
    }

    /**
     * Add moderation functions to the current fieldlist
     *
     * @param FieldList $fields
     */
    protected function updateModerationFields(FieldList $fields) {
        Requirements::css(COMMENTS_DIR . '/css/cms.css');

        $newComments = $this->owner->AllComments()->filter('Moderated', 0);

        $newGrid = new CommentsGridField(
            'NewComments',
            _t('CommentsAdmin.NewComments', 'New'),
            $newComments,
            CommentsGridFieldConfig::create()
        );

        $approvedComments = $this->owner->AllComments()->filter('Moderated', 1)->filter('IsSpam', 0);

        $approvedGrid = new CommentsGridField(
            'ApprovedComments',
            _t('CommentsAdmin.Comments', 'Approved'),
            $approvedComments,
            CommentsGridFieldConfig::create()
        );

        $spamComments = $this->owner->AllComments()->filter('Moderated', 1)->filter('IsSpam', 1);

        $spamGrid = new CommentsGridField(
            'SpamComments',
            _t('CommentsAdmin.SpamComments', 'Spam'),
            $spamComments,
            CommentsGridFieldConfig::create()
        );

        $newCount = '(' . count($newComments) . ')';
        $approvedCount = '(' . count($approvedComments) . ')';
        $spamCount = '(' . count($spamComments) . ')';

        if($fields->hasTabSet()) {
            $tabs = new TabSet(
                'Comments',
                new Tab('CommentsNewCommentsTab', _t('CommentAdmin.NewComments', 'New') . ' ' . $newCount,
                    $newGrid
                ),
                new Tab('CommentsCommentsTab', _t('CommentAdmin.Comments', 'Approved') . ' ' . $approvedCount,
                    $approvedGrid
                ),
                new Tab('CommentsSpamCommentsTab', _t('CommentAdmin.SpamComments', 'Spam') . ' ' . $spamCount,
                    $spamGrid
                )
            );
            $fields->addFieldToTab('Root', $tabs);
        } else {
            $fields->push($newGrid);
            $fields->push($approvedGrid);
            $fields->push($spamGrid);
        }
    }

    public function updateCMSFields(FieldList $fields) {
        // Disable moderation if not permitted
        if($this->owner->canModerateComments()) {
            $this->updateModerationFields($fields);
        }

        // If this isn't a page we should merge the settings into the CMS fields
        if(!$this->attachedToSiteTree()) {
            $this->updateSettingsFields($fields);
        }
    }
}

silverstripe / silverstripe-comments

Pull Request — master (#173)

CommentsExtension::getCommentsEnabled() A

Complexity

Size

Duplication

Duplication Side-by-Side

Filter issues like
