504 lines
13 KiB
PHP
504 lines
13 KiB
PHP
<?php
|
|
/**
|
|
* @brief Customer Model
|
|
* @author <a href='https://www.invisioncommunity.com'>Invision Power Services, Inc.</a>
|
|
* @copyright (c) Invision Power Services, Inc.
|
|
* @license https://www.invisioncommunity.com/legal/standards/
|
|
* @package Invision Community
|
|
* @subpackage Nexus
|
|
* @since 11 Feb 2014
|
|
*/
|
|
|
|
namespace IPS\nexus;
|
|
|
|
/* 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;
|
|
}
|
|
|
|
/**
|
|
* Customer Model
|
|
*/
|
|
class _Customer extends \IPS\Member
|
|
{
|
|
/**
|
|
* @brief Multiton Store
|
|
*/
|
|
protected static $multitons;
|
|
|
|
/**
|
|
* @brief Cached logged in member
|
|
*/
|
|
public static $loggedInMember = NULL;
|
|
|
|
/**
|
|
* @brief [ActiveRecord] ID Database Column
|
|
*/
|
|
public static $databaseColumnId = 'member_id';
|
|
|
|
/**
|
|
* Get logged in member
|
|
*
|
|
* @return \IPS\Member
|
|
*/
|
|
public static function loggedIn()
|
|
{
|
|
/* If we haven't loaded the member yet, or if the session member has changed since we last loaded the member, reload and cache */
|
|
if( static::$loggedInMember === NULL )
|
|
{
|
|
static::$loggedInMember = static::load( parent::loggedIn()->member_id );
|
|
}
|
|
|
|
return static::$loggedInMember;
|
|
}
|
|
|
|
/**
|
|
* Construct Load Query
|
|
*
|
|
* @param int|string $id ID
|
|
* @param string $idField The database column that the $id parameter pertains to
|
|
* @param mixed $extraWhereClause Additional where clause(s)
|
|
* @return \IPS\Db\Select
|
|
*/
|
|
protected static function constructLoadQuery( $id, $idField, $extraWhereClause )
|
|
{
|
|
$where = array( array( 'core_members.' . $idField . '=?', $id ) );
|
|
if( $extraWhereClause !== NULL )
|
|
{
|
|
if ( !is_array( $extraWhereClause ) or !is_array( $extraWhereClause[0] ) )
|
|
{
|
|
$extraWhereClause = array( $extraWhereClause );
|
|
}
|
|
$where = array_merge( $where, $extraWhereClause );
|
|
}
|
|
|
|
return static::db()->select( '*, core_members.member_id AS _member_id', static::$databaseTable, $where )->join( 'nexus_customers', 'nexus_customers.member_id=core_members.member_id' );
|
|
}
|
|
|
|
/**
|
|
* Load Record
|
|
*
|
|
* @see \IPS\Db::build
|
|
* @param int|string $id ID
|
|
* @param string $idField The database column that the $id parameter pertains to (NULL will use static::$databaseColumnId)
|
|
* @param mixed $extraWhereClause Additional where clause(s) (see \IPS\Db::build for details)
|
|
* @return static
|
|
* @throws \InvalidArgumentException
|
|
* @throws \OutOfRangeException
|
|
*/
|
|
public static function load( $id, $idField=NULL, $extraWhereClause=NULL )
|
|
{
|
|
/* Guests */
|
|
if( $id === NULL OR $id === 0 OR $id === '' )
|
|
{
|
|
$classname = get_called_class();
|
|
return new $classname;
|
|
}
|
|
|
|
/* If we didn't specify an ID field, assume the default */
|
|
if( $idField === NULL )
|
|
{
|
|
$idField = static::$databasePrefix . static::$databaseColumnId;
|
|
}
|
|
|
|
/* If we did, check it's valid */
|
|
elseif( !in_array( $idField, static::$databaseIdFields ) )
|
|
{
|
|
throw new \InvalidArgumentException;
|
|
}
|
|
|
|
/* Does that exist in the multiton store? */
|
|
if( $idField === static::$databasePrefix . static::$databaseColumnId and !empty( static::$multitons[ $id ] ) )
|
|
{
|
|
return static::$multitons[ $id ];
|
|
}
|
|
|
|
/* If not, find it */
|
|
else
|
|
{
|
|
/* Load it */
|
|
try
|
|
{
|
|
$row = static::constructLoadQuery( $id, $idField, $extraWhereClause )->first();
|
|
}
|
|
catch ( \UnderflowException $e )
|
|
{
|
|
throw new \OutOfRangeException;
|
|
}
|
|
|
|
/* If it doesn't exist in the multiton store, set it */
|
|
if( !isset( static::$multitons[ $row[ static::$databasePrefix . static::$databaseColumnId ] ] ) )
|
|
{
|
|
static::$multitons[ $row['_member_id'] ] = static::constructFromData( $row );
|
|
}
|
|
|
|
/* And return it */
|
|
return static::$multitons[ $row['_member_id'] ];
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Construct ActiveRecord from database row
|
|
*
|
|
* @param array $data Row from database table
|
|
* @param bool $updateMultitonStoreIfExists Replace current object in multiton store if it already exists there?
|
|
* @return static
|
|
*/
|
|
public static function constructFromData( $data, $updateMultitonStoreIfExists = TRUE )
|
|
{
|
|
if ( isset( $data['_member_id'] ) )
|
|
{
|
|
$data['member_id'] = $data['_member_id'];
|
|
unset( $data['_member_id'] );
|
|
}
|
|
|
|
/* If this was guest data there may be no member_id set, which will cause an undefined index */
|
|
if( !isset( $data['member_id'] ) )
|
|
{
|
|
$data['member_id'] = 0;
|
|
}
|
|
|
|
return parent::constructFromData( $data, $updateMultitonStoreIfExists );
|
|
}
|
|
|
|
/**
|
|
* Set Default Values
|
|
*
|
|
* @return void
|
|
*/
|
|
public function setDefaultValues()
|
|
{
|
|
$this->_data['cm_first_name'] = '';
|
|
$this->_data['cm_last_name'] = '';
|
|
parent::setDefaultValues();
|
|
}
|
|
|
|
/**
|
|
* Get customer name
|
|
*
|
|
* @return string
|
|
*/
|
|
public function get_cm_name()
|
|
{
|
|
return ( $this->cm_first_name or $this->cm_last_name ) ? "{$this->cm_first_name} {$this->cm_last_name}" : $this->name;
|
|
}
|
|
|
|
/**
|
|
* Get account credit
|
|
*
|
|
* @return array
|
|
*/
|
|
public function get_cm_credits()
|
|
{
|
|
$amounts = $this->member_id ? json_decode( $this->_data['cm_credits'], TRUE ) : array();
|
|
$return = array();
|
|
foreach ( \IPS\nexus\Money::currencies() as $currency )
|
|
{
|
|
if ( isset( $amounts[ $currency ] ) )
|
|
{
|
|
$return[ $currency ] = new \IPS\nexus\Money( $amounts[ $currency ], $currency );
|
|
}
|
|
else
|
|
{
|
|
$return[ $currency ] = new \IPS\nexus\Money( 0, $currency );
|
|
}
|
|
}
|
|
return $return;
|
|
}
|
|
|
|
/**
|
|
* Set account credit
|
|
*
|
|
* @param array $amounts Amounts
|
|
* @return void
|
|
*/
|
|
public function set_cm_credits( $amounts )
|
|
{
|
|
$save = array();
|
|
foreach ( $amounts as $amount )
|
|
{
|
|
$save[ $amount->currency ] = $amount->amountAsString();
|
|
}
|
|
$this->_data['cm_credits'] = json_encode( $save );
|
|
}
|
|
|
|
/**
|
|
* Get profiles
|
|
*
|
|
* @return array
|
|
*/
|
|
public function get_cm_profiles()
|
|
{
|
|
return ( isset( $this->_data['cm_profiles'] ) and $this->_data['cm_profiles'] ) ? json_decode( $this->_data['cm_profiles'], TRUE ) : array();
|
|
}
|
|
|
|
/**
|
|
* Set profiles
|
|
*
|
|
* @param array $profiles Profiles
|
|
* @return array
|
|
*/
|
|
public function set_cm_profiles( $profiles )
|
|
{
|
|
$this->_data['cm_profiles'] = json_encode( $profiles );
|
|
}
|
|
|
|
/**
|
|
* Get default currency
|
|
*
|
|
* @return void
|
|
*/
|
|
public function defaultCurrency()
|
|
{
|
|
if ( $currencies = json_decode( \IPS\Settings::i()->nexus_currency, TRUE ) )
|
|
{
|
|
foreach ( $currencies as $k => $v )
|
|
{
|
|
if ( in_array( $this->language()->id, $v ) )
|
|
{
|
|
return $k;
|
|
}
|
|
}
|
|
|
|
$keys = array_keys( $currencies );
|
|
return array_shift( $keys );
|
|
}
|
|
else
|
|
{
|
|
return \IPS\Settings::i()->nexus_currency;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Estimated location
|
|
*
|
|
* @return \IPS\GeoLocation|NULL
|
|
*/
|
|
public function estimatedLocation()
|
|
{
|
|
if ( $this->member_id === \IPS\nexus\Customer::loggedIn()->member_id )
|
|
{
|
|
if ( isset( $_SESSION['location'] ) )
|
|
{
|
|
$location = $_SESSION['location'] ? \IPS\GeoLocation::buildFromJson( $_SESSION['location'] ) : NULL;
|
|
}
|
|
else
|
|
{
|
|
try
|
|
{
|
|
$defaultAddress = \IPS\Db::i()->select( 'address', 'nexus_customer_addresses', array( 'member=? AND primary_billing=1', $this->member_id ) )->first();
|
|
$_SESSION['location'] = $defaultAddress;
|
|
$location = \IPS\GeoLocation::buildFromJson( $defaultAddress );
|
|
}
|
|
catch ( \UnderflowException $e )
|
|
{
|
|
try
|
|
{
|
|
$location = \IPS\GeoLocation::getByIp( \IPS\Request::i()->ipAddress() );
|
|
$_SESSION['location'] = json_encode( $location );
|
|
}
|
|
catch ( \Exception $e )
|
|
{
|
|
if( isset( $_SERVER['HTTP_ACCEPT_LANGUAGE'] ) )
|
|
{
|
|
$exploded = explode( '-', $_SERVER['HTTP_ACCEPT_LANGUAGE'] );
|
|
|
|
if ( in_array( mb_strtoupper( $exploded[1] ), \IPS\GeoLocation::$countries ) )
|
|
{
|
|
$location = new \IPS\GeoLocation;
|
|
$location->country = mb_strtoupper( $exploded[1] );
|
|
$_SESSION['location'] = json_encode( $location );
|
|
}
|
|
else
|
|
{
|
|
$location = NULL;
|
|
$_SESSION['location'] = '';
|
|
}
|
|
}
|
|
else
|
|
{
|
|
$location = NULL;
|
|
$_SESSION['location'] = '';
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
else
|
|
{
|
|
try
|
|
{
|
|
$location = \IPS\GeoLocation::buildFromJson( \IPS\Db::i()->select( 'address', 'nexus_customer_addresses', array( 'member=? AND primary_billing=1', $this->member_id ) )->first() );
|
|
}
|
|
catch ( \UnderflowException $e )
|
|
{
|
|
$location = NULL;
|
|
}
|
|
}
|
|
|
|
return $location;
|
|
}
|
|
|
|
/**
|
|
* Save Changed Columns
|
|
*
|
|
* @return void
|
|
*/
|
|
public function save()
|
|
{
|
|
$data = $this->_data;
|
|
|
|
$customerTable = array();
|
|
foreach ( ( $this->_new ? $this->_data : $this->changed ) as $k => $v )
|
|
{
|
|
if ( ( mb_substr( $k, 0, 3 ) === 'cm_' and !in_array( $k, array( 'cm_credits', 'cm_no_sev', 'cm_return_group', 'cm_reg' ) ) ) or mb_substr( $k, 0, 6 ) === 'field_' )
|
|
{
|
|
$customerTable[ $k ] = $v;
|
|
unset( $this->_data[ $k ] );
|
|
unset( $this->changed[ $k ] );
|
|
}
|
|
}
|
|
|
|
parent::save();
|
|
$data['member_id'] = $this->_data['member_id'];
|
|
$this->_data = $data;
|
|
|
|
if ( count( $customerTable ) )
|
|
{
|
|
$customerTable['member_id'] = $this->member_id;
|
|
\IPS\Db::i()->insert( 'nexus_customers', $customerTable, TRUE );
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Log Action
|
|
*
|
|
* @param string $type Log type
|
|
* @param mixed $extra Any extra data for the type
|
|
* @param mixed $by The member performing the action. NULL for currently logged in member or FALSE for no member
|
|
* @return void
|
|
*/
|
|
public function log( $type, $extra=NULL, $by=NULL )
|
|
{
|
|
$this->logHistory( 'nexus', $type, $extra, $by, TRUE );
|
|
}
|
|
|
|
/**
|
|
* Get total amount spent
|
|
*
|
|
* @return string
|
|
*/
|
|
public function totalSpent()
|
|
{
|
|
$return = array();
|
|
foreach ( \IPS\Db::i()->select( 't_currency, ( SUM(t_amount)-SUM(t_partial_refund) ) AS amount', 'nexus_transactions', array( 't_member=? AND ( t_status=? OR t_status=? )', $this->member_id, \IPS\nexus\Transaction::STATUS_PAID, \IPS\nexus\Transaction::STATUS_PART_REFUNDED ), NULL, NULL, 't_currency' ) as $amount )
|
|
{
|
|
$return[] = (string) new \IPS\nexus\Money( $amount['amount'], $amount['t_currency'] );
|
|
}
|
|
return count( $return ) ? implode( ' + ', $return ) : new \IPS\nexus\Money( 0, $this->defaultCurrency() );
|
|
}
|
|
|
|
/**
|
|
* @brief Number of previous purchases by package ID
|
|
*/
|
|
protected $previousPurchasesCount;
|
|
|
|
/**
|
|
* Get number of previous purchases of a package ID (used to calculate loyalty discounts)
|
|
*
|
|
* @param int $packageID Package ID
|
|
* @param bool $activeOnly Active only?
|
|
* @return array
|
|
*/
|
|
public function previousPurchasesCount( $packageID, $activeOnly )
|
|
{
|
|
if ( $this->previousPurchasesCount === NULL )
|
|
{
|
|
$this->previousPurchasesCount['all'] = iterator_to_array( \IPS\Db::i()->select( 'ps_item_id, COUNT(*)', 'nexus_purchases', array( 'ps_app=? AND ps_type=? AND ps_member=?', 'nexus', 'package', $this->member_id ), NULL, NULL, 'ps_item_id' )->setKeyField('ps_item_id')->setValueField('COUNT(*)') );
|
|
$this->previousPurchasesCount['active'] = iterator_to_array( \IPS\Db::i()->select( 'ps_item_id, COUNT(*)', 'nexus_purchases', array( 'ps_app=? AND ps_type=? AND ps_member=? AND ps_active=1', 'nexus', 'package', $this->member_id ), NULL, NULL, 'ps_item_id' )->setKeyField('ps_item_id')->setValueField('COUNT(*)') );
|
|
}
|
|
|
|
return isset( $this->previousPurchasesCount[ $activeOnly ? 'active' : 'all' ][ $packageID ] ) ? $this->previousPurchasesCount[ $activeOnly ? 'active' : 'all' ][ $packageID ] : 0;
|
|
}
|
|
|
|
/**
|
|
* Client Area Links
|
|
*
|
|
* @return array
|
|
*/
|
|
public function clientAreaLinks()
|
|
{
|
|
$return = array( 'invoices' );
|
|
if ( \IPS\Db::i()->select( 'COUNT(*)', 'nexus_purchases', array( 'ps_member=? AND ps_show=1', $this->member_id ) ) )
|
|
{
|
|
$return[] = 'purchases';
|
|
}
|
|
|
|
$return[] = 'addresses';
|
|
if ( count( \IPS\nexus\Gateway::cardStorageGateways() ) )
|
|
{
|
|
$return[] = 'cards';
|
|
}
|
|
if ( count( \IPS\nexus\Customer\CustomField::roots() ) )
|
|
{
|
|
$return[] = 'info';
|
|
}
|
|
|
|
if ( \IPS\Settings::i()->nexus_min_topup or count( json_decode( \IPS\Settings::i()->nexus_payout, TRUE ) ) )
|
|
{
|
|
$return[] = 'credit';
|
|
}
|
|
|
|
$return[] = 'alternatives';
|
|
|
|
if ( count( \IPS\nexus\Donation\Goal::roots() ) )
|
|
{
|
|
$return[] = 'donations';
|
|
}
|
|
|
|
if ( \IPS\Settings::i()->cm_ref_on )
|
|
{
|
|
$return[] = 'referrals';
|
|
}
|
|
|
|
return $return;
|
|
}
|
|
|
|
/**
|
|
* Alternative Contacts
|
|
*
|
|
* @param array $where WHERE clause
|
|
* @return \IPS\Patterns\ActiveRecordIterator
|
|
*/
|
|
public function alternativeContacts( $where = array() )
|
|
{
|
|
$where = count( $where ) ? array( $where ) : $where;
|
|
$where[] = array( 'main_id=?', $this->member_id );
|
|
return new \IPS\Patterns\ActiveRecordIterator( \IPS\Db::i()->select( '*', 'nexus_alternate_contacts', $where )->setKeyField( 'alt_id' ), 'IPS\nexus\Customer\AlternativeContact' );
|
|
}
|
|
|
|
/**
|
|
* Parent Contacts
|
|
*
|
|
* @param array $where WHERE clause
|
|
* @return \IPS\Patterns\ActiveRecordIterator
|
|
*/
|
|
public function parentContacts( $where = array() )
|
|
{
|
|
$where = count( $where ) ? array( $where ) : $where;
|
|
$where[] = array( 'alt_id=?', $this->member_id );
|
|
return new \IPS\Patterns\ActiveRecordIterator( \IPS\Db::i()->select( '*', 'nexus_alternate_contacts', $where )->setKeyField( 'main_id' ), 'IPS\nexus\Customer\AlternativeContact' );
|
|
}
|
|
|
|
/**
|
|
* ACP Customer Page URL
|
|
*
|
|
* @return \IPS\Http\Url
|
|
*/
|
|
public function acpUrl()
|
|
{
|
|
return \IPS\Http\Url::internal( "app=nexus&module=customers&controller=view&id={$this->member_id}", 'admin' );
|
|
}
|
|
} |