sydney/IPB
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Version 5.0.0 beta 1

Browse Source
This commit is contained in:
Neo committed 2025-12-19 16:27:35 -08:00
1 parent 25ddeb65d6
commit 15c7beabc5
6736 files changed
+627902 -497943
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

system/Member/Club/Page.php
+79 -59
View File
@@ -11,47 +11,67 @@
namespace IPS\Member\Club;
/* To prevent PHP errors (extending class does not exist) revealing path */
if ( !\defined( '\IPS\SUITE_UNIQUE_KEY' ) )
use IPS\File;
use IPS\Helpers\Form;
use IPS\Helpers\Form\CheckboxSet;
use IPS\Helpers\Form\Editor;
use IPS\Helpers\Form\Text;
use IPS\Helpers\Form\YesNo;
use IPS\Http\Url;
use IPS\Http\Url\Friendly;
use IPS\Http\Url\Internal;
use IPS\Member;
use IPS\Member\Club;
use IPS\Patterns\ActiveRecord;
use IPS\Settings;
use OutOfRangeException;
use function count;
use function defined;
use function in_array;
use function is_array;
if ( !defined( '\IPS\SUITE_UNIQUE_KEY' ) )
{
header( ( isset( $_SERVER['SERVER_PROTOCOL'] ) ? $_SERVER['SERVER_PROTOCOL'] : 'HTTP/1.0' ) . ' 403 Forbidden' );
header( ( $_SERVER['SERVER_PROTOCOL'] ?? 'HTTP/1.0' ) . ' 403 Forbidden' );
exit;
}
/**
* Club Page Model
*/
class _Page extends \IPS\Patterns\ActiveRecord
class Page extends ActiveRecord
{
/**
* @brief [ActiveRecord] Multiton Store
*/
protected static $multitons;
protected static array $multitons;
/**
* @brief [ActiveRecord] Database Table
*/
public static $databaseTable = 'core_club_pages';
public static ?string $databaseTable = 'core_club_pages';
/**
* @brief [ActiveRecord] Database Prefix
*/
public static $databasePrefix = 'page_';
public static string $databasePrefix = 'page_';
/**
* @brief Club Store
*/
protected static $clubs = array();
protected static array $clubs = array();
/**
* Get Club
*
* @return \IPS\Member\Club
* @return Club
*/
public function get_club(): \IPS\Member\Club
public function get_club(): Club
{
if ( !isset( static::$clubs[ $this->_data['club'] ] ) )
{
static::$clubs[ $this->_data['club'] ] = \IPS\Member\Club::load( $this->_data['club'] );
static::$clubs[ $this->_data['club'] ] = Club::load( $this->_data['club'] );
}
return static::$clubs[ $this->_data['club'] ];
@@ -60,10 +80,10 @@ class _Page extends \IPS\Patterns\ActiveRecord
/**
* Set Club
*
* @param \IPS\Member\Club $club The club
* @param Club $club The club
* @return void
*/
public function set_club( \IPS\Member\Club $club )
public function set_club( Club $club ) : void
{
$this->_data['club'] = $club->id;
unset( static::$clubs[ $club->id ] );
@@ -78,7 +98,7 @@ class _Page extends \IPS\Patterns\ActiveRecord
{
if ( !$this->_data['seo_title'] )
{
$this->seo_title = \IPS\Http\Url\Friendly::seoTitle( $this->_data['title'] );
$this->seo_title = Friendly::seoTitle( $this->_data['title'] );
$this->save();
}
@@ -91,10 +111,10 @@ class _Page extends \IPS\Patterns\ActiveRecord
* @param string $title The page title
* @return void
*/
public function set_title( string $title )
public function set_title( string $title ) : void
{
$this->_data['title'] = $title;
$this->_data['seo_title'] = \IPS\Http\Url\Friendly::seoTitle( $title );
$this->_data['seo_title'] = Friendly::seoTitle( $title );
}
/**
@@ -103,9 +123,9 @@ class _Page extends \IPS\Patterns\ActiveRecord
* @param array|NULL $value The value to set
* @return void
*/
public function set_can_view( ?array $value )
public function set_can_view( ?array $value ) : void
{
if ( \is_array( $value ) )
if ( is_array( $value ) )
{
$this->_data['can_view'] = implode( ',', $value );
}
@@ -128,30 +148,30 @@ class _Page extends \IPS\Patterns\ActiveRecord
/**
* Form
*
* @param \IPS\Helpers\Form $form Form Object
* @param \IPS\Member\Club $club Club this page belongs too.
* @param \IPS\Member\Club\Page|NULL $current If we are editing, the current page.
* @param Form $form Form Object
* @param Club $club Club this page belongs too.
* @param Page|NULL $current If we are editing, the current page.
* @return void
*/
public static function form( \IPS\Helpers\Form $form, \IPS\Member\Club $club, ?\IPS\Member\Club\Page $current = NULL )
public static function form( Form $form, Club $club, ?Page $current = NULL ) : void
{
$form->hiddenValues['page_club'] = $club->id;
$form->add( new \IPS\Helpers\Form\Text( 'club_page_title', ( $current ) ? $current->title : NULL, TRUE ) );
$form->add( new \IPS\Helpers\Form\Editor( 'club_page_content', ( $current ) ? $current->content : NULL, TRUE, array(
$form->add( new Text( 'club_page_title', ( $current ) ? $current->title : NULL, TRUE ) );
$form->add( new Editor( 'club_page_content', ( $current ) ? $current->content : NULL, TRUE, array(
'app' => 'core',
'key' => 'ClubPage',
'autoSaveKey' => ( $current ) ? "club-page-{$current->id}" : "club-page-new",
'attachIds' => ( $current ) ? array( $current->id, NULL, NULL ) : NULL
) ) );
if ( $club->type !== \IPS\Member\Club::TYPE_PUBLIC )
if ( $club->type !== Club::TYPE_PUBLIC )
{
$defaults = array( 'member', 'moderator' );
if ( $club->type !== \IPS\Member\Club::TYPE_PRIVATE )
if ( $club->type !== Club::TYPE_PRIVATE )
{
$defaults[] = 'nonmember';
}
$form->add( new \IPS\Helpers\Form\CheckboxSet( 'page_can_view', ( $current AND $current->can_view ) ? $current->can_view : $defaults, FALSE, array( 'options' => array(
$form->add( new CheckboxSet( 'page_can_view', ( $current AND $current->can_view ) ? $current->can_view : $defaults, FALSE, array( 'options' => array(
'nonmember' => 'club_page_nonmembers',
'member' => 'club_page_members',
'moderator' => 'club_page_moderators'
@@ -159,9 +179,9 @@ class _Page extends \IPS\Patterns\ActiveRecord
}
/* Add the index setting if this page is shown to guests */
if ( $club->type !== \IPS\Member\Club::TYPE_PRIVATE AND \IPS\Member::loggedIn()->group['gbw_club_manage_indexing'] )
if ( $club->type !== Club::TYPE_PRIVATE AND Member::loggedIn()->group['gbw_club_manage_indexing'] )
{
$form->add( new \IPS\Helpers\Form\YesNo('club_page_meta_index', ( $current ) ? $current->meta_index : TRUE, FALSE, [], NULL, NULL, NULL, 'club_page_meta_index' ) );
$form->add( new YesNo('club_page_meta_index', ( $current ) ? $current->meta_index : TRUE, FALSE, [], NULL, NULL, NULL, 'club_page_meta_index' ) );
}
}
@@ -171,9 +191,9 @@ class _Page extends \IPS\Patterns\ActiveRecord
* @param $values array Values
* @return void
*/
public function formatFormValues( array $values )
public function formatFormValues( array $values ) : void
{
$this->club = \IPS\Member\Club::load( $values['page_club'] );
$this->club = Club::load( $values['page_club'] );
$this->title = $values['club_page_title'];
$this->content = $values['club_page_content'];
if ( array_key_exists( 'page_can_view', $values ) )
@@ -194,11 +214,11 @@ class _Page extends \IPS\Patterns\ActiveRecord
* URL
*
* @param NULL|string $action Value for the "do" parameter, or NULL for no action.
* @return \IPS\Http\Url\Friendly
* @return Friendly
*/
public function url( ?string $action = NULL ): \IPS\Http\Url\Internal
public function url( ?string $action = NULL ): Internal
{
$return = \IPS\Http\Url::internal( "app=core&module=clubs&controller=page&id={$this->id}", 'front', 'clubs_page', array( $this->seo_title ) );
$return = Url::internal( "app=core&module=clubs&controller=page&id={$this->id}", 'front', 'clubs_page', array( $this->seo_title ) );
if ( $action )
{
@@ -212,17 +232,17 @@ class _Page extends \IPS\Patterns\ActiveRecord
* Load and check permissions
*
* @param int $id ID of the page to load
* @param \IPS\Member|NULL $member Optional member to check against
* @return \IPS\Member\Club\Page
* @throws \OutOfRangeException
* @param Member|NULL $member Optional member to check against
* @return Page
* @throws OutOfRangeException
*/
public static function loadAndCheckPerms( int $id, ?\IPS\Member $member = NULL ): \IPS\Member\Club\Page
public static function loadAndCheckPerms( int $id, ?Member $member = NULL ): Page
{
$page = static::load( $id );
if ( !$page->canView( $member ) )
{
throw new \OutOfRangeException;
throw new OutOfRangeException;
}
return $page;
@@ -231,12 +251,12 @@ class _Page extends \IPS\Patterns\ActiveRecord
/**
* Can view this page
*
* @param \IPS\Member|NULL $member The member trying to view the page.
* @param Member|NULL $member The member trying to view the page.
* @return bool
*/
public function canView( ?\IPS\Member $member = NULL ): bool
public function canView( ?Member $member = NULL ): bool
{
$member = $member ?: \IPS\Member::loggedIn();
$member = $member ?: Member::loggedIn();
/* If NULL, everyone can view */
if ( $this->can_view === NULL )
@@ -251,30 +271,30 @@ class _Page extends \IPS\Patterns\ActiveRecord
}
/* If it's not approved, only moderators and the person who created it can see it */
if ( \IPS\Settings::i()->clubs_require_approval and !$this->club->approved )
if ( Settings::i()->clubs_require_approval and !$this->club->approved )
{
return ( $member->modPermission('can_access_all_clubs') or ( $this->club->owner AND $member->member_id == $this->club->owner->member_id ) );
}
/* Owner or leader? */
if ( $member->member_id === $this->club->owner->member_id OR $this->club->memberStatus( $member ) === \IPS\Member\Club::STATUS_LEADER )
if ( $member->member_id === $this->club->owner->member_id OR $this->club->memberStatus( $member ) === Club::STATUS_LEADER )
{
return TRUE;
}
/* Moderators? */
if ( \in_array( 'moderator', $this->can_view ) AND $this->club->memberStatus( $member ) === \IPS\Member\Club::STATUS_MODERATOR )
if ( in_array( 'moderator', $this->can_view ) AND $this->club->memberStatus( $member ) === Club::STATUS_MODERATOR )
{
return TRUE;
}
/* Members */
if ( \in_array( 'member', $this->can_view ) AND \in_array( $this->club->memberStatus( $member ), array( \IPS\Member\Club::STATUS_MEMBER, \IPS\Member\Club::STATUS_INVITED, \IPS\Member\Club::STATUS_INVITED_BYPASSING_PAYMENT, \IPS\Member\Club::STATUS_EXPIRED, \IPS\Member\Club::STATUS_EXPIRED_MODERATOR ) ) )
if ( in_array( 'member', $this->can_view ) AND in_array( $this->club->memberStatus( $member ), array( Club::STATUS_MEMBER, Club::STATUS_INVITED, Club::STATUS_INVITED_BYPASSING_PAYMENT, Club::STATUS_EXPIRED, Club::STATUS_EXPIRED_MODERATOR ) ) )
{
return TRUE;
}
if ( \in_array( 'nonmember', $this->can_view ) )
if ( in_array( 'nonmember', $this->can_view ) )
{
return TRUE;
}
@@ -286,24 +306,24 @@ class _Page extends \IPS\Patterns\ActiveRecord
/**
* Can Add a page
*
* @param \IPS\Member\Club $club The club the page will be added too.
* @param \IPS\Member|NULL $member The member adding the page.
* @param Club $club The club the page will be added too.
* @param Member|NULL $member The member adding the page.
* @return bool
*/
public static function canAdd( \IPS\Member\Club $club, ?\IPS\Member $member = NULL ): bool
public static function canAdd( Club $club, ?Member $member = NULL ): bool
{
$member = $member ?: \IPS\Member::loggedIn();
$member = $member ?: Member::loggedIn();
return $club->owner->member_id === $member->member_id OR $club->isLeader( $member );
}
/**
* Can edit this page
*
* @param \IPS\Member|NULL $member The member editing the page.
* @param Member|NULL $member The member editing the page.
* @return bool
* @note Functionally, this is no different from canAdd, however it's been abstracted out for third parties.
*/
public function canEdit( ?\IPS\Member $member = NULL ): bool
public function canEdit( ?Member $member = NULL ): bool
{
return static::canAdd( $this->club, $member );
}
@@ -311,11 +331,11 @@ class _Page extends \IPS\Patterns\ActiveRecord
/**
* Can delete this page
*
* @param \IPS\Member|NULL
* @param Member|NULL $member
* @return bool
* @note Functionally, this is no different from canAdd, however it's been abstracted out for third parties.
*/
public function canDelete( ?\IPS\Member $member = NULL ): bool
public function canDelete( ?Member $member = NULL ): bool
{
return static::canAdd( $this->club, $member );
}
@@ -323,17 +343,17 @@ class _Page extends \IPS\Patterns\ActiveRecord
/**
* Delete
*
* @param bool $updateClub Update club tabs
* @return void
* @param bool $updateClub Update club tabs
* @return void
*/
public function delete( $updateClub=TRUE )
public function delete( bool $updateClub=TRUE ): void
{
\IPS\File::unclaimAttachments( 'core_ClubPage', $this->id );
File::unclaimAttachments( 'core_ClubPage', $this->id );
if( $updateClub === TRUE )
{
$tabs = @json_decode( $this->club->menu_tabs, TRUE );
if ( is_countable( $tabs ) AND \count( $tabs ) )
if ( is_countable( $tabs ) AND count( $tabs ) )
{
if ( isset( $tabs['page-' . $this->id] ) )
{