Invision Power Services, Inc. * @copyright (c) Invision Power Services, Inc. * @license https://www.invisioncommunity.com/legal/standards/ * @package Invision Community * @since 25 March 2021 */ namespace IPS\Content; /* To prevent PHP errors (extending class does not exist) revealing path */ if ( !\defined( '\IPS\SUITE_UNIQUE_KEY' ) ) { header( ( isset( $_SERVER['SERVER_PROTOCOL'] ) ? $_SERVER['SERVER_PROTOCOL'] : 'HTTP/1.0' ) . ' 403 Forbidden' ); exit; } /** * Solvable Trait */ trait Recognizable { /** * Can this member "unrecognize" the content author? * * @param \IPS\Member|NULL $member The member to check for (NULL for currently logged in member) * @return boolean */ public function canRemoveRecognize( ?\IPS\Member $member=NULL ): bool { /* Already recognized? (First quick check when built from item::comments() */ $isRecognized = FALSE; if ( isset( $this->recognized ) and $this->recognized ) { $isRecognized = TRUE; } /* Not there, try loading from content */ if ( ! $isRecognized ) { try { $recognize = \IPS\core\Achievements\Recognize::loadFromContent( $this ); $isRecognized = TRUE; } catch ( \Exception $e ) { /* An error, or it doesn't exist */ $isRecognized = FALSE; } } if ( ! $isRecognized ) { return FALSE; } $member = $member ?: \IPS\Member::loggedIn(); /* Moderator check */ return $this->canModerateRecognized( $member ); } /** * Can this member "recognize" the content author? * * @param \IPS\Member|NULL $member The member to check for (NULL for currently logged in member) * @return boolean */ public function canRecognize( ?\IPS\Member $member=NULL ): bool { /* Are achievements enabled? */ if ( !\IPS\Settings::i()->achievements_enabled ) { return FALSE; } /* Already recognized? */ if ( isset( $this->recognized ) ) { return FALSE; } $member = $member ?: \IPS\Member::loggedIn(); /* Moderator check */ if ( ! $this->canModerateRecognized( $member ) ) { return FALSE; } if ( ! $this->author()->member_id ) { return FALSE; } /* Can not recognize yourself */ if ( $member->member_id === $this->author()->member_id ) { return FALSE; } return TRUE; } /** * Check to see if we have moderator permissions * * @param $member * @return bool */ protected function canModerateRecognized( $member ) { $member = $member ?: \IPS\Member::loggedIn(); /* Moderator check */ if ( ! $member->modPermission('can_recognize_content') ) { return FALSE; } if ( $member->modPermission('can_recognize_content') != '*' AND ! \count( $member->modPermission('can_recognize_content_options') ) ) { return FALSE; } return TRUE; } /** * Should we show this recognized data? * * @param \IPS\Member|null $viewing * @return bool */ public function showRecognized( ?\IPS\Member $viewing=NULL ): bool { $viewing = $viewing ?: \IPS\Member::loggedIn(); if ( isset( $this->recognized ) ) { if ( $this->recognized->public or ( ( $viewing->member_id == $this->recognized->member_id ) OR ( $viewing->modPermission('can_recognize_content') ) ) ) { return TRUE; } } return FALSE; } /** * Remove recognition given to this content * * @return void */ public function removeRecognize() { \IPS\core\Achievements\Recognize::loadFromContent( $this )->delete(); } /** * Return a blurb about this * * @return array */ public function recognizedBlurb(): array { $return = [ 'message' => NULL ]; $return['main'] = \IPS\Member::loggedIn()->language()->addToStack( 'recognize_blurb_main', FALSE, [ 'htmlsprintf' => [ $this::$title, $this->recognized->_given_by->link() ] ] ); if ( $this->recognized->badge and $this->recognized->points ) { if ( $this->author()->member_id === \IPS\Member::loggedIn()->member_id ) { $return['awards'] = \IPS\Member::loggedIn()->language()->addToStack( 'recognize_blurb_awarded_points_and_badge', FALSE, ['htmlsprintf' => [$this->recognized->badge()->_title, $this->recognized->points]] ); } else { $return['awards'] = \IPS\Member::loggedIn()->language()->addToStack( 'recognize_blurb_awarded_points_and_badge_third', FALSE, ['htmlsprintf' => [$this->author()->name, $this->recognized->badge()->_title, $this->recognized->points]] ); } } else if ( $this->recognized->points ) { if ( $this->author()->member_id === \IPS\Member::loggedIn()->member_id ) { $return['awards'] = \IPS\Member::loggedIn()->language()->addToStack( 'recognize_blurb_awarded_points', FALSE, [ 'sprintf' => [ $this->recognized->points ] ] ); } else { $return['awards'] = \IPS\Member::loggedIn()->language()->addToStack( 'recognize_blurb_awarded_points_third', FALSE, [ 'sprintf' => [ $this->author()->name, $this->recognized->points ] ] ); } } else if ( $this->recognized->badge ) { if ( $this->author()->member_id === \IPS\Member::loggedIn()->member_id ) { $return['awards'] = \IPS\Member::loggedIn()->language()->addToStack( 'recognize_blurb_awarded_badge', FALSE, [ 'htmlsprintf' => [ $this->recognized->badge()->_title ] ] ); } else { $return['awards'] = \IPS\Member::loggedIn()->language()->addToStack( 'recognize_blurb_awarded_badge_third', FALSE, [ 'htmlsprintf' => [ $this->author()->name, $this->recognized->badge()->_title ] ] ); } } if ( $this->recognized->message ) { $return['message'] = $this->recognized->message; } return $return; } }