Changeset 15698 for trunk/inc

Timestamp:

11/24/11 03:20:35 (6 months ago)

Author:

Alexander Trofimov

Message:

Accounts and Profiles

Location:

trunk/inc

Files:

• admin.inc.php (deleted)
• classes/BxDolAccount.php (added)
• classes/BxDolAccountQuery.php (added)
• classes/BxDolProfile.php (modified) (1 diff)
• classes/BxDolProfileQuery.php (modified) (4 diffs)
• classes/BxDolTemplate.php (modified) (2 diffs)
• design.inc.php (modified) (2 diffs)
• languages.inc.php (modified) (1 diff)
• membership_levels.inc.php (modified) (1 diff)
• profiles.inc.php (modified) (17 diffs)
• utils.inc.php (modified) (3 diffs)

trunk/inc/classes/BxDolProfile.php

@@ -1 @@
-<?
+<?php defined('BX_DOL') or die('hack attempt');
+/**
+ * Copyright (c) BoonEx Pty Limited - http://www.boonex.com/
+ * CC-BY License - http://creativecommons.org/licenses/by/3.0/
+ *
+ * @defgroup    DolphinCore Dolphin Core
+ * @{
+ */
 
-// TODO: decide later what to do with profiles functionality
-// TODO: remove couples
-// TODO: remove profile cache
-
-/***************************************************************************
-*                            Dolphin Smart Community Builder
-*                              -------------------
-*     begin                : Mon Mar 23 2006
-*     copyright            : (C) 2007 BoonEx Group
-*     website              : http://www.boonex.com
-* This file is part of Dolphin - Smart Community Builder
-*
-* Dolphin is free software; you can redistribute it and/or modify it under
-* the terms of the GNU General Public License as published by the
-* Free Software Foundation; either version 2 of the
-* License, or  any later version.
-*
-* Dolphin is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
-* without even the implied warranty of  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
-* See the GNU General Public License for more details.
-* You should have received a copy of the GNU General Public License along with Dolphin,
-* see license.txt file; if not, write to marketing@boonex.com
-***************************************************************************/
-
-bx_import('BxDolMistake');
 bx_import('BxDolProfileQuery');
 
-class BxDolProfile extends BxDolMistake
-{
+class BxDolProfile extends BxDol {
+
     var $_iProfileID;
-    var $_aProfile;
-    var $bCouple;
-    var $_iCoupleID;
-    var $_aCouple;
+    var $_oQuery;
 
     /**
      * Constructor
-     *
-     * @return User
      */
-    function BxDolProfile( $vProfileID, $bWithEmail = 1 )
-    {
-        $this -> _iProfileID = $this -> getID( $vProfileID, $bWithEmail );
+    protected function __construct ($iProfileId) {
+        $iProfileId = (int)$iProfileId;
+        $sClass = get_class($this) . '_' . $iProfileId;
+        if (isset($GLOBALS['bxDolClasses'][$sClass]))
+            trigger_error ('Multiple instances are not allowed for the class: ' . get_class($this), E_USER_ERROR);
+
+        parent::__construct();
+
+        $this->_iProfileID = $iProfileId; // since constructor is protected $iProfileId is always valid
+        $this->_oQuery = BxDolProfileQuery::getInstance();
     }
 
     /**
-     * Enter description here...
-     *
-     * @param unknown_type $ID
-     * @param unknown_type $float
+     * Prevent cloning the instance
      */
-    function getProfileThumbnail( $float )
-    {
-        $ret = $this -> getProfileImageUrl( $iProfileID, 0);
+    public function __clone() {
+        $sClass = get_class($this) . '_' . $this->_iProfileID;
+        if (isset($GLOBALS['bxDolClasses'][$sClass]))
+            trigger_error('Clone is not allowed for the class: ' . get_class($this), E_USER_ERROR);
     }
 
     /**
-     * return link to profile image only.
-     *
-     * @param unknown_type $ID
-     * @param unknown_type $imageNum
+     * Get singleton instance of the class
      */
-    function getProfileImageUrl( $imageNum )
-    {
+    public static function getInstance($mixedProfileId) {
 
+        $iProfileId = self::getID($mixedProfileId);
+        if (!$iProfileId)
+            return false;
+
+        $sClass = __CLASS__ . '_' . $iProfileId;
+        if (!isset($GLOBALS['bxDolClasses'][$sClass]))
+            $GLOBALS['bxDolClasses'][$sClass] = new BxDolProfile($iProfileId);
+
+        return $GLOBALS['bxDolClasses'][$sClass];
     }
 
     /**
-     *  return assoc array of all frofile fields
+     * Get profile id
      */
-    function getProfileData() {
-        global $aUser;
-
-        $bUseCacheSystem = ( getParam('enable_cache_system') == 'on' ) ? true : false;
-
-        $oPDb = new BxDolProfileQuery();
-        $sProfileCache = BX_DIRECTORY_PATH_CACHE . 'user' . $this -> _iProfileID . '.php';
-        if( $bUseCacheSystem && file_exists( $sProfileCache ) && is_file( $sProfileCache ) ) {
-            require_once($sProfileCache);
-            $this -> _aProfile = $aUser[$this -> _iProfileID];
-        } else
-            $this -> _aProfile = $oPDb -> getProfileDataById( $this -> _iProfileID );
-
-
-        //get couple data
-        if( $this -> _aProfile['Couple'] ) {
-            $this -> bCouple = true;
-            $this -> _iCoupleID = $this -> _aProfile['Couple'];
-
-            $sProfileCache = BX_DIRECTORY_PATH_CACHE . 'user' . $this -> _iCoupleID . '.php';
-            if( $bUseCacheSystem && file_exists( $sProfileCache ) && is_file( $sProfileCache ) ) {
-                require_once($sProfileCache);
-                $this -> _aCouple = $aUser[$this -> _iCoupleID];
-            } else
-                $this -> _aCouple = $oPDb -> getProfileDataById( $this -> _iCoupleID );
-        }
-
-        return $this -> _aProfile;
+    public function id() {
+        return $this->_oQuery->getIdById($this->_iProfileID);
     }
 
     /**
-     * Update profile info to database
-     *
-     *
-     * @param int $iUserID
-     * @param array $aData
-     * where the key of the array is name of database table field
-     *
-     * example:
-     * $aData['Sex'] = 'male';
-     *
+     * Get profile info
      */
-    function updateProfileData( $aData )
-    {
-        if( is_array( $aData ) )
-        {
-            $sQueryAdd = '';
-            foreach($aData as $key => $value )
-            {
-                $sQueryAdd .= " `$key` = '$value', ";
-            }
-        }
-
-        $this -> updateProfileDataFile( $iProfileID );
+    public function getInfo($iProfileId) {
+        return $this->_oQuery->getInfoById((int)$iProfileId ? $iAccountId : $this->_iProfileID);
     }
 
     /**
-     * function create cache data file
-     *
-     * @param int $iProfileID
+     * Validate profile id. 
+     * @param $s - profile id
+     * @return profile id or false if profile was not found
      */
-    function updateProfileDataFile( $iProfileID )
-    {
-
+    static public function getID($s) {
+        $iId = BxDolProfileQuery::getInstance()->getIdById((int)$s);
+        return $iId ? $iId : false;
     }
 
     /**
-     * Print code for membership status
-     * $memberID - member ID
-     * $offer_upgrade - will this code be printed at [c]ontrol [p]anel
-     * $credits - will print credits status if $credits == 1
+     * Delete profile.
      */
-    function getMembershipStatus( $iPrifileID, $offer_upgrade = true, $credits = 0 )
-    {
+    function delete($ID = false) {
 
-    }
+        $ID = (int)$ID;
+        if (!$ID)
+            $ID = $this->_iProfileID;
 
-    /**
-     * Shows how many days, hours, minutes member was onine last time
-     *
-     * @param  $lastNavTime
-     *
-     * @return int
-     */
-    /*function  getProfileLastOnlinePeriod( $lastNavTime )
-    {
+        $aProfileInfo = $this->_oQuery->getInfoById($ID);
+        if (!$aProfileInfo)
+            return false;
 
-    }*/
+        // create system event before deletion
+        $isStopDeletion = false;
+        bx_alert('profile', 'before_delete', $ID, 0, array('stop_deletion' => &$isStopDeletion));
+        if ($isStopDeletion)
+            return false;
 
+        // delete associated content 
+        // TODO: remake deletion of associated content
+        $this->_oQuery->res("DELETE FROM `sys_fave_list` WHERE ID = {$ID} OR Profile = {$ID}" );
+        $this->_oQuery->res("DELETE FROM `sys_friend_list` WHERE ID = {$ID} OR Profile = {$ID}");
+        $this->_oQuery->res("DELETE FROM `sys_acl_levels_members` WHERE `IDMember` = {$ID}");
+        $this->_oQuery->res("DELETE FROM `sys_tags` WHERE `ObjID` = {$ID} AND `Type` = 'profile'");
 
-    function getNickName()
-    {
-        $oProfileQuery = new BxDolProfileQuery();
-        return process_line_output( $oProfileQuery -> getNickName( $this -> _iProfileID ) );
-    }
+        // delete profile votings
+        bx_import('BxDolVoting');
+        $oVotingProfile = new BxDolVoting ('profile', 0, 0);
+        $oVotingProfile->deleteVotings ($ID);
 
-    function getPassword()
-    {
+        // delete profile comments
+        bx_import('BxDolCmts');
+        $oCmts = new BxDolCmts('profile', $ID);
+        $oCmts->onObjectDelete();
+        // delete all comments in all comments' systems, this user posted
+        $oCmts->onAuthorDelete($ID);
 
-    }
+        // delete profile
+        if (!$this->_oQuery->delete($ID))
+            return false;
 
-    function getID( $vID, $bWithEmail = 1 )
-    {
-        $oPDb = new BxDolProfileQuery();
+        // create system event
+        bx_alert('profile', 'delete', $ID);
 
-        if ( $bWithEmail )
-        {
-            if ( eregi("^[_.0-9a-z-]+@([0-9a-z][0-9a-z-]+.)+[a-z]{2,4}$", $vID) )
-            {
-                $aMail = $oPDb -> getIdByEmail( $vID );
-                if ( (int)$aMail['ID'] )
-                {
-                    return (int)$aMail['ID'];
-                }
-            }
-        }
+        // unset class instance to prevent creating the instance again
+        $sClass = get_class($this) . '_' . $ID;
+        unset($GLOBALS['bxDolClasses'][$sClass]);
 
-        $iID = (int)$vID;
-        if ( strcmp("$vID", "$iID") == 0 )
-        {
-            return $iID;
-        }
-        else
-        {
-            $aNick = $oPDb -> getIdByNickname( $vID );
-            if ( (int)$aNick['ID'] )
-            {
-                return (int)$aNick['ID'];
-            }
-        }
+        $this->_iProfileID = 0;
 
-        return false;
+        return true;
     }
 
 }
-?>
+
+/** @} */
+

trunk/inc/classes/BxDolProfileQuery.php

@@ -1 @@
-<?php
+<?php defined('BX_DOL') or die('hack attempt');
 /**
- * @package     Dolphin Core
- * @copyright   Copyright (c) BoonEx Pty Limited - http://www.boonex.com/
- * @license     CC-BY - http://creativecommons.org/licenses/by/3.0/
+ * Copyright (c) BoonEx Pty Limited - http://www.boonex.com/
+ * CC-BY License - http://creativecommons.org/licenses/by/3.0/
+ *
+ * @defgroup    DolphinCore Dolphin Core
+ * @{
  */
-defined('BX_DOL') or die('hack attempt');
 
 bx_import('BxDolDb');
 
 /**
- * All queries related to basic profiles functionality
+ * All queries related to profiles
  */
 class BxDolProfileQuery extends BxDolDb {
 
-    var $_sTable = '`Profiles`';
-
-    function BxDolProfileQuery() {
+    public function __construct() {
 
         if (isset($GLOBALS['bxDolClasses'][get_class($this)]))
             trigger_error ('Multiple instances are not allowed for the class: ' . get_class($this), E_USER_ERROR);
 
-        parent::BxDolDb();
+        parent::__construct();
     }
 
@@ -45 +44 @@
      * Get profile by specified field name and value.
      * It is for internal usage only.
-     * Use other funtions to get profile info, like getProfileById, getProfileByEmail, etc.
+     * Use other funtions to get profile info, like getInfoById, etc.
      * @param string $sField database field name
      * @param mixed $sValue database field value
      * @return array with porfile info
      */
-    protected function _getProfileDataByField ($sField, $sValue) {
-        $sSql = $this->prepare("SELECT * FROM " . $this->_sTable . " WHERE `$sField` = ? LIMIT 1", $sValue);
-        return (int)$this->getRow($sSql);
+    protected function getProfilesByAccount ($iAccountId) {
+        $sSql = $this->prepare("SELECT * FROM `sys_profiles` WHERE `account_id` = ? LIMIT 1", $iAccountId);
+        return $this->getAllWithKey($sSql, 'id');
+    }
+
+    /**
+     * Get profile by specified field name and value.
+     * It is for internal usage only.
+     * Use other funtions to get profile info, like getInfoById, etc.
+     * @param string $sField database field name
+     * @param mixed $sValue database field value
+     * @return array with porfile info
+     */
+    protected function _getDataByField ($sField, $sValue) {
+        $sSql = $this->prepare("SELECT * FROM `sys_profiles` WHERE `$sField` = ? LIMIT 1", $sValue);
+        return $this->getRow($sSql);
+    }
+
+    /**
+     * get profile id by id
+     */
+    public function getIdById($iId) {
+        return (int)$this->_getFieldByField('id', 'id', $iId);
     }
 
@@ -60 +79 @@
      * @return array with profile info
      */
-    function getProfileDataById( $iID )    {
-        return $this->_getProfileDataByField('ID', (int)$iID);
-    }
-
-    /**
-     * @see getProfileIdByEmail
-     */
-    function getIdByEmail($sEmail) {
-        return $this->getProfileIdByEmail($sEmail);
-    }
-
-    /**
-     * Get profile id by email
-     * @param string $s search profile by this email string
-     * @return profile id
-     */
-    public function getProfileIdByEmail ($s) {
-        return (int)$this->_getProfileFieldByField('ID', 'Email', $s);
-    }
-
-    /**
-     * @see getProfileIdByNickName
-     */
-    function getIdByNickname($sNickname) {
-        return $this->getProfileIdByNickName($sNickname);
-    }
-
-    /**
-     * Get profile id by nickname
-     * @param string $s search profile by this nickname string
-     * @return profile id
-     */
-    public function getProfileIdByNickName ($s) {
-        return (int)$this->_getProfileFieldByField('ID', 'NickName', $s);
-    }
-
-    /**
-     * Get profile nickname by id
-     * @param string $s search profile by this id
-     * @return profile nickname
-     */
-    function getNickName($iID) {
-        return $this->_getProfileFieldByField('NickName', 'ID', (int)$iID);
-    }
-
-    /**
-     * Get profile email by id
-     * @param string $s search profile by this id
-     * @return profile email
-     */
-    function getEmail($iID) {
-        return $this->_getProfileFieldByField('Email', 'ID', (int)$iID);
+    public function getInfoById( $iID )    {
+        return $this->_getDataByField('id', (int)$iID);
     }
 
@@ -117 +86 @@
      * Get profile field by specified field name and value.
      * In most cases it is for internal usage only.
-     * Use other funtions to get profile info, like getProfileIdByEmail, etc.
+     * Use other funtions to get profile info, like getIdByEmail, etc.
      * @param string $sFieldRequested database field name to return
      * @param string $sFieldSearch database field name to search for
      * @param mixed $sValue database field value
-     * @return profile id
+     * @return specified profile field value
      */
-    protected function _getProfileFieldByField ($sFieldRequested, $sFieldSearch, $sValue) {
-        $sSql = $this->prepare("SELECT `$sFieldRequested` FROM " . $this->_sTable . " WHERE `$sFieldSearch` = ? LIMIT 1", $sValue);
+    protected function _getFieldByField ($sFieldRequested, $sFieldSearch, $sValue) {
+        $sSql = $this->prepare("SELECT `$sFieldRequested` FROM `sys_profiles` WHERE `$sFieldSearch` = ? LIMIT 1", $sValue);
         return $this->getOne($sSql);
+    }
+
+    /**
+     * Update some field by profile id
+     * In most cases it is for internal usage only.
+     * Use other funtions to get profile info, like updateLogged, etc.
+     * @param string $sFieldRequested database field name to return
+     * @param string $sFieldSearch database field name to search for
+     * @param mixed $sValue database field value
+     * @return specified profile field value
+     */
+    protected function _updateField ($iId, $sFieldForUpdate, $sValue) {
+        $sSql = $this->prepare("UPDATE `sys_profiles` SET `$sFieldForUpdate` = ? WHERE `id` = ? LIMIT 1", $sValue, $iId);
+        return $this->query($sSql);
+    }
+
+    /**
+     * Delete profile info by id
+     * @param int $iID profile id
+     * @return affected rows
+     */
+    public function delete($iID) {
+        $sSql = $this->prepare("DELETE FROM `sys_profiles` WHERE `id` = ? LIMIT 1", $iID);
+        return $this->query($sSql);
     }
 
 }
 
+/** @} */
+

trunk/inc/classes/BxDolTemplate.php

@@ -846 +846 @@
                     //bx_import('BxTemplMemberMenu');
                     //$oMemberMenu = new BxTemplMemberMenu();
-                    $sRet = 'TODO: member menu';//$oMemberMenu -> genMemberMenu($iProfileId);
+                    $sRet = ''; //$oMemberMenu -> genMemberMenu($iProfileId); // TODO: member menu
                 }
                 break;
@@ -1793 +1793 @@
         </div>';
     }
+
+    function getPageCode($oTemplate = null) {
+        if (empty($oTemplate))
+           $oTemplate = $this;
+
+        header( 'Content-type: text/html; charset=utf-8' );
+        echo $oTemplate->parsePageByName('page_' . $oTemplate->getPageNameIndex() . '.html', $oTemplate->getPageContent());
+    }
 }
+

trunk/inc/design.inc.php

@@ -6 +6 @@
  */
 defined('BX_DOL') or die('hack attempt');
-
-/**
- * Put design progress bar code
- *  $text     - progress bar text
- *  $width    - width of progress bar in pixels
- *  $max_pos  - maximal position of progress bar
- *  $curr_pos - current position of progress bar
- **/
-function DesignProgressPos( $text, $width, $max_pos, $curr_pos, $progress_num = '1' ) {
-    $percent = ( $max_pos ) ? $curr_pos * 100 / $max_pos : $percent = 0;
-    return DesignProgress( $text, $width, $percent, $progress_num );
-}
-
-/**
- * TODO: move html to template
- * Put design progress bar code
- *  $text     - progress bar text
- *  $width    - width of progress bar in pixels
- *  $percent  - current position of progress bar in percents
- **/
-function DesignProgress ( $text, $width, $percent, $progress_num, $id = ''  ) {
-    $ret = "";
-    $ret .= '<div class="rate_block" style="width:' . $width . 'px;">';
-        $ret .= '<div class="rate_text"' . ( $id ? " id=\"{$id}_text\"" : '' ) . '>';
-            $ret .= $text;
-        $ret .= '</div>';
-        $ret .= '<div class="rate_scale"' . ( $id ? " id=\"{$id}_scale\"" : '' ) . '>';
-            $ret .= '<div' . ( $id ? " id=\"{$id}_bar\"" : '' ) . ' style="position:relative; height:10px; font-size:1px; width:' . round($percent) . '%; background-image:url(' . getTemplateIcon("scale_index_{$progress_num}.gif") . '); background-repeat:repeat-x;"></div>';
-        $ret .= '</div>';
-    $ret .= '</div>';
-
-    return $ret;
-}
 
 /**
@@ -111 +78 @@
 
 /**
+ * DEPRECATED
  * Put top code for the page
  **/
 function PageCode($oTemplate = null) {
-    if(empty($oTemplate))
+    echo "DEPRECATED: function PageCode, use BxDolTemplate::getPageCode instead";
+    if (empty($oTemplate))
        $oTemplate = BxDolTemplate::getInstance();
-
-    header( 'Content-type: text/html; charset=utf-8' );
-    echo $oTemplate->parsePageByName('page_' . $oTemplate->getPageNameIndex() . '.html', $oTemplate->getPageContent());
+    $oTemplate->getPageCode();
 }
 

trunk/inc/languages.inc.php

@@ -127 +127 @@
             $iLangId = 0;
 
-        //TODO: Move to some profile management class (module).
-        $iProfileId = getLoggedId();
-        $sSql = $oDb->prepare("UPDATE `Profiles` SET `LangID`=? WHERE `ID`=? LIMIT 1", $iLangId, $iProfileId);
-        $oDb->query($sSql);
-        createUserDataFile($iProfileId);
+        $iAccountId = getLoggedId();
+        bx_import('BxDolAccountQuery');
+        $oAccountQuery = BxDolAccountQuery::getInstance();
+        $oAccountQuery->updateLanguage($iAccountId, $iLangId);
     }
 

trunk/inc/membership_levels.inc.php

@@ -615 +615 @@
 }       
 
+
+
+/**
+ * Print code for membership status
+ * $memberID - member ID
+ * $offer_upgrade - will this code be printed at [c]ontrol [p]anel
+ */
+function GetMembershipStatus($memberID, $offer_upgrade = true) {
+    $ret = '';
+
+    $membership_info = getMemberMembershipInfo($memberID);
+
+    $viewMembershipActions = "<br />(<a onclick=\"javascript:window.open('explanation.php?explain=membership&amp;type=".$membership_info['ID']."', '', 'width=660, height=500, menubar=no, status=no, resizable=no, scrollbars=yes, toolbar=no, location=no');\" href=\"javascript:void(0);\">"._t("_VIEW_MEMBERSHIP_ACTIONS")."</a>)<br />";
+
+    // Show colored membership name
+    if ( $membership_info['ID'] == MEMBERSHIP_ID_STANDARD ) {
+        $ret .= _t( "_MEMBERSHIP_STANDARD" ). $viewMembershipActions;
+        if ( $offer_upgrade )
+            $ret .= " ". _t( "_MEMBERSHIP_UPGRADE_FROM_STANDARD" );
+    } else {
+        $ret .= "<font color=\"red\">{$membership_info['Name']}</font>$viewMembershipActions";
+
+        $days_left = (int)( ($membership_info['DateExpires'] - time()) / (24 * 3600) );
+
+        if(!is_null($membership_info['DateExpires'])) {
+            $ret .= ( $days_left > 0 ) ? _t( "_MEMBERSHIP_EXPIRES_IN_DAYS", $days_left ) : _t( "_MEMBERSHIP_EXPIRES_TODAY", date( "H:i", $membership_info['DateExpires'] ), date( "H:i" ) );
+        } else {
+            $ret.= _t("_MEMBERSHIP_EXPIRES_NEVER");
+        }
+    }
+    return $ret;
+}
+
+
+function mem_expiration_letter( $ID, $membership_name, $expire_days ) {
+    $ID = (int)$ID;
+
+    if ( !$ID )
+        return false;
+
+    $p_arr = db_arr( "SELECT `Email` FROM `Profiles` WHERE `ID` = $ID", 0 );
+    if ( !$p_arr )
+        return false;
+
+    bx_import('BxDolEmailTemplates');
+    $rEmailTemplate = new BxDolEmailTemplates();
+    $aTemplate = $rEmailTemplate -> getTemplate( 't_MemExpiration', $ID ) ;
+
+    $recipient  = $p_arr['Email'];
+
+    $aPlus = array();
+    $aPlus['MembershipName'] = $membership_name;
+    $aPlus['ExpireDays'] = $expire_days;
+
+    $mail_ret = sendMail( $recipient, $aTemplate['Subject'], $aTemplate['Body'], $ID, $aPlus  );
+
+    if ($mail_ret)
+        return true;
+    else
+        return false;
+}

trunk/inc/profiles.inc.php

@@ -8 +8 @@
 
 /**
- * The following functions are needed to check whether user is logged in or not, active or not and get his ID.
+ * It is needed to check whether user is logged in or not
  */
 function isLogged() {
     return getLoggedId() != 0;
 }
-function isLoggedActive() {
-    return isProfileActive();
-}
+
+/**
+ * It returns logged in account id
+ */
 function getLoggedId() {
     return isset($_COOKIE['memberID']) && (!empty($GLOBALS['logged']['member']) || !empty($GLOBALS['logged']['admin'])) ? (int)$_COOKIE['memberID'] : 0;
 }
+
+/**
+ * It returns logged in account password
+ */
 function getLoggedPassword() {
     return isset($_COOKIE['memberPassword']) && ($GLOBALS['logged']['member'] || $GLOBALS['logged']['admin']) ? $_COOKIE['memberPassword'] : '';
@@ -24 +29 @@
 
 /**
- * The following functions are needed to check the ROLE of user.
+ * It checks if account is member.
  */
 function isMember($iId = 0) {
     return isRole(BX_DOL_ROLE_MEMBER, $iId);
 }
-if(!function_exists("isAdmin")) {
+
+if (!function_exists("isAdmin")) {
+    /**
+     * It checks if account is admin.
+     */
     function isAdmin($iId = 0) {
         return isRole(BX_DOL_ROLE_ADMIN, $iId);
     }
 }
-function isAffiliate($iId = 0) {
-    return isRole(BX_DOL_ROLE_AFFILIATE, $iId);
-}
-function isModerator($iId = 0) {
-    return isRole(BX_DOL_ROLE_MODERATOR, $iId);
-}
+
+/**
+ * It checks account's role
+ */
 function isRole($iRole, $iId = 0) {
-    $aProfile = getProfileInfo($iId);
-    if($aProfile === false)
-        return false;
-
-    if(!((int)$aProfile['Role'] & $iRole))
+
+    bx_import('BxDolAccount');
+    $oAccount = BxDolAccount::getInstance($iId);
+    if (!$oAccount)
+        return false;
+
+    $aAccountInfo = $oAccount->getInfo();
+
+    if (!$aAccountInfo)
+        return false;
+
+    if (!((int)$aAccountInfo['role'] & $iRole))
         return false;
 
@@ -51 +65 @@
 }
 
-function getID($str, $with_email = 1) {
-
-    bx_import('BxDolProfileQuery');
-    $oProfileQuery = BxDolProfileQuery::getInstance();
-
-    if ($with_email) {
-        if ( preg_match("/^[_\.0-9a-z-]+@([0-9a-z][0-9a-z-]+\.)+[a-z]{2,4}$/", $str) ) {
-            $iMemberId = (int)$oProfileQuery->getProfileIdByEmail($str);
-            if ($iMemberId)
-                return $iMemberId;
-        }
-    }
-
-    $iID = (int)$oProfileQuery->getProfileIdByNickName($str);
-    if(!$iID) {
-        $aProfile = getProfileInfo($str);
-        $iID = isset($aProfile['ID']) ? $aProfile['ID'] : 0;
-    }
-    return $iID;
-}
-
-$aUser = array(); //global cache array
-
-function ShowZodiacSign( $date ) {
-
-    if ( $date == "0000-00-00" )
-        return "";
-
-    if ( strlen($date) ) {
-        $m = substr( $date, -5, 2 );
-        $d = substr( $date, -2, 2 );
-
-        switch ( $m ) {
-            case '01': if ( $d <= 20 ) $sign = "capricorn"; else $sign = "aquarius";
-                break;
-            case '02': if ( $d <= 20 ) $sign = "aquarius"; else $sign = "pisces";
-                break;
-            case '03': if ( $d <= 20 ) $sign = "pisces"; else $sign = "aries";
-                break;
-            case '04': if ( $d <= 20 ) $sign = "aries"; else $sign = "taurus";
-                break;
-            case '05': if ( $d <= 20 ) $sign = "taurus"; else $sign = "gemini";
-                break;
-            case '06': if ( $d <= 21 ) $sign = "gemini"; else $sign = "cancer";
-                break;
-            case '07': if ( $d <= 22 ) $sign = "cancer"; else $sign = "leo";
-                break;
-            case '08': if ( $d <= 23 ) $sign = "leo"; else $sign = "virgo";
-                break;
-            case '09': if ( $d <= 23 ) $sign = "virgo"; else $sign = "libra";
-                break;
-            case '10': if ( $d <= 23 ) $sign = "libra"; else $sign = "scorpio";
-                break;
-            case '11': if ( $d <= 22 ) $sign = "scorpio"; else $sign = "sagittarius";
-                break;
-            case '12': if ( $d <= 21 ) $sign = "sagittarius"; else $sign = "capricorn";
-        }
-
-        bx_import('BxDolTemplate');
-        return '<img src="' . BxDolTemplate::getInstance()->getImageUrl($sign . '.png') . '" alt="' . $sign . '" title="' . $sign . '" />';
-    } else {
-        return "";
-    }
-}
-
-function age( $birth_date ) {
-    if ( $birth_date == "0000-00-00" )
-        return _t("_uknown");
-
-    $bd = explode( "-", $birth_date );
-    $age = date("Y") - $bd[0] - 1;
-
-    $arr[1] = "m";
-    $arr[2] = "d";
-
-    for ( $i = 1; $arr[$i]; $i++ ) {
-        $n = date( $arr[$i] );
-        if ( $n < $bd[$i] )
-            break;
-        if ( $n > $bd[$i] ) {
-            ++$age;
-            break;
-        }
-    }
-
-    return $age;
-}
-
-/**
- * Print code for membership status
- * $memberID - member ID
- * $offer_upgrade - will this code be printed at [c]ontrol [p]anel
- */
-function GetMembershipStatus($memberID, $offer_upgrade = true) {
-    $ret = '';
-
-    $membership_info = getMemberMembershipInfo($memberID);
-
-    $viewMembershipActions = "<br />(<a onclick=\"javascript:window.open('explanation.php?explain=membership&amp;type=".$membership_info['ID']."', '', 'width=660, height=500, menubar=no, status=no, resizable=no, scrollbars=yes, toolbar=no, location=no');\" href=\"javascript:void(0);\">"._t("_VIEW_MEMBERSHIP_ACTIONS")."</a>)<br />";
-
-    // Show colored membership name
-    if ( $membership_info['ID'] == MEMBERSHIP_ID_STANDARD ) {
-        $ret .= _t( "_MEMBERSHIP_STANDARD" ). $viewMembershipActions;
-        if ( $offer_upgrade )
-            $ret .= " ". _t( "_MEMBERSHIP_UPGRADE_FROM_STANDARD" );
-    } else {
-        $ret .= "<font color=\"red\">{$membership_info['Name']}</font>$viewMembershipActions";
-
-        $days_left = (int)( ($membership_info['DateExpires'] - time()) / (24 * 3600) );
-
-        if(!is_null($membership_info['DateExpires'])) {
-            $ret .= ( $days_left > 0 ) ? _t( "_MEMBERSHIP_EXPIRES_IN_DAYS", $days_left ) : _t( "_MEMBERSHIP_EXPIRES_TODAY", date( "H:i", $membership_info['DateExpires'] ), date( "H:i" ) );
-        } else {
-            $ret.= _t("_MEMBERSHIP_EXPIRES_NEVER");
-        }
-    }
-    return $ret;
-}
-
-function isAutoApproval( $sAction ) {
-    $autoApproval_ifPhoto   = ( 'on' == getParam("autoApproval_ifPhoto") );
-    $autoApproval_ifSound   = ( 'on' == getParam("autoApproval_ifSound") );
-    $autoApproval_ifVideo   = ( 'on' == getParam("autoApproval_ifVideo") );
-    $autoApproval_ifProfile = ( 'on' == getParam("autoApproval_ifProfile") );
-    $autoApproval_ifJoin    = ( 'on' == getParam("autoApproval_ifJoin") );
-
-    switch ( $sAction ) {
-        case 'photo':
-            return $autoApproval_ifPhoto;
-        case 'sound':
-            return $autoApproval_ifSound;
-        case 'video':
-            return $autoApproval_ifVideo;
-        case 'profile':
-            return $autoApproval_ifProfile;
-        case 'join':
-            return $autoApproval_ifJoin;
-        default:
-            return false;
-    }
-}
-
-function deleteUserDataFile( $userID ) {
-     global $aUser;
-
-    $bUseCacheSystem = ( getParam('enable_cache_system') == 'on' ) ? true : false;
-    if (!$bUseCacheSystem) return false;
-
-    $userID = (int)$userID;
-    $fileName = BX_DIRECTORY_PATH_CACHE . 'user' . $userID . '.php';
-    if( file_exists($fileName) ) {
-        unlink($fileName);
-    }
-}
-
-function createUserDataFile( $userID ) {
-    global $aUser;
-
-    $bUseCacheSystem = ( getParam('enable_cache_system') == 'on' ) ? true : false;
-    if (!$bUseCacheSystem) return false;
-
-    $userID = (int)$userID;
-    $fileName = BX_DIRECTORY_PATH_CACHE . 'user' . $userID . '.php';
-    if( $userID > 0 ) {
-
-        $aPreUser = getProfileInfoDirect ($userID);
-
-        if( isset( $aPreUser ) and is_array( $aPreUser ) and $aPreUser) {
-            $sUser = '<?';
-            $sUser .= "\n\n";
-            $sUser .= '$aUser[' . $userID . '] = array();';
-            $sUser .= "\n";
-            $sUser .= '$aUser[' . $userID . '][\'datafile\'] = true;';
-            $sUser .= "\n";
-
-            $replaceWhat = array( '\\',   '\''   );
-            $replaceTo   = array( '\\\\', '\\\'' );
-
-            foreach( $aPreUser as $key =>  $value )
-                $sUser .= '$aUser[' . $userID . '][\'' . $key . '\']' . ' = ' . '\'' . str_replace( $replaceWhat, $replaceTo, $value )  . '\'' . ";\n";
-
-            $sUser .= "\n" . '?>';
-
-            if( $file = fopen( $fileName, "w" ) ) {
-                fwrite( $file, $sUser );
-                fclose( $file );
-                @chmod ($fileName, 0666);
-
-                @include( $fileName );
-                return true;
-            } else
-                return false;
-        }
-    } else
-        return false;
-}
-
-/**
- * Check whether the requested profile is active or not.
- */
-function isProfileActive($iId = 0) {
-    $aProfile = getProfileInfo($iId);
-    if($aProfile === false || empty($aProfile))
-        return false;
-
-    return $aProfile['Status'] == 'Active';
-}
-function getProfileInfoDirect ($iProfileID) {
-    return BxDolDb::getInstance()->getRow("SELECT * FROM `Profiles` WHERE `ID`='" . $iProfileID . "' LIMIT 1");
-}
-
-function getProfileInfo($iProfileID = 0, $checkActiveStatus = false, $forceCache = false) {
-    global $aUser;
-
-    $iProfileID = !empty($iProfileID) ? (int)$iProfileID : getLoggedId();
-    if(!$iProfileID)
-        return false;
-
-    if(!isset( $aUser[$iProfileID]) || !is_array($aUser[$iProfileID]) || $forceCache) {
-        $sCacheFile = BX_DIRECTORY_PATH_CACHE . 'user' . $iProfileID . '.php';
-        if( !file_exists( $sCacheFile ) || $forceCache ) {
-            if( !createUserDataFile( $iProfileID ) ) {
-                return getProfileInfoDirect ($iProfileID);
-            }
-        }
-
-        @include( $sCacheFile );
-    }
-
-    if( $checkActiveStatus and $aUser[$iProfileID]['Status'] != 'Active' )
-        return false;
-
-    return $aUser[$iProfileID];
-}
-
-/* osed only for xmlrpc */
-function getNewLettersNum( $iID ) {
-    $sqlQuery =
-    "
-        SELECT
-            COUNT(`Recipient`)
-        FROM
-            `sys_messages`
-        WHERE
-            `Recipient`='$iID'
-                AND
-            `New`='1'
-                  AND
-        NOT FIND_IN_SET('Recipient', `Trash`)
-    ";
-    return (int)db_value($sqlQuery);
-}
-
-/*function for inner using only
-    $ID - profile ID
-    $iFrStatus - friend status (1 - approved, 0 - wait)
-    $iOnline - filter for last nav moment (in minutes)
-    $sqlWhere - add sql Conditions, should beginning from AND
-*/
+
+/**
+ * function for inner using only
+ * @param $ID - profile ID
+ * @param $iFrStatus - friend status (1 - approved, 0 - wait)
+ * @param $iOnline - filter for last nav moment (in minutes)
+ * @param $sqlWhere - add sql Conditions, should beginning from AND
+ */
 function getFriendNumber($iID, $iFrStatus = 1, $iOnline = 0, $sqlWhere = '') {
     $sqlAdd = '';
@@ -399 +162 @@
 }
 
-/*
-* The function returns NickName by given ID. If no ID specified, it tryes to get if from _COOKIE['memberID'];
-*/
-function getNickName( $ID = '' ) {
-    if ( !$ID && !empty($_COOKIE['memberID']) )
-        $ID = (int)$_COOKIE['memberID'];
-
-    if ( !$ID )
-        return '';
-
-    $arr = getProfileInfo( $ID );
-    return $arr['NickName'];
-}
-
-/*
- * The function returns Password by given ID.
- */
-function getPassword( $ID = '' ) {
-    if ( !(int)$ID )
-        return '';
-
-    $arr = getProfileInfo( $ID );
-    return $arr['Password'];
-}
-
-function getProfileLink( $iID, $sLinkAdd = '' ) {
-    $aProfInfo = getProfileInfo( $iID );
-    $iID = ($aProfInfo['Couple'] > 0 && $aProfInfo['ID'] > $aProfInfo['Couple']) ? $aProfInfo['Couple'] : $iID;
-
-    return (getParam('enable_modrewrite') == 'on') ? BX_DOL_URL_ROOT . getNickName($iID) . ( $sLinkAdd ? "?{$sLinkAdd}" : '' ) : BX_DOL_URL_ROOT . 'profile.php?ID='.$iID . ( $sLinkAdd ? "&{$sLinkAdd}" : '' );
-}
-
 function isLoggedBanned($iCurUserID = 0) {
     $iCCurUserID = ($iCurUserID>0) ? $iCurUserID : (int)$_COOKIE['memberID'];
@@ -446 +177 @@
     return false;
 }
+
 function bx_login($iId, $bRememberMe = false) {
 
-    $sPassword = getPassword($iId);
+    bx_import('BxDolAccountQuery');
+    $oAccountQuery = BxDolAccountQuery::getInstance();
+
+    $sPassword = $oAccountQuery->getPassword($iId);
+    if (!$sPassword)
+        return false;
 
     $aUrl = parse_url(BX_DOL_URL_ROOT);
@@ -459 +196 @@
     $_COOKIE['memberPassword'] = $sPassword;
 
-    db_res("UPDATE `Profiles` SET `DateLastLogin`=NOW(), `DateLastNav`=NOW() WHERE `ID`='" . $iId . "'");
-    createUserDataFile($iId);
-
-    require_once(BX_DIRECTORY_PATH_CLASSES . 'BxDolAlerts.php');
-    $oZ = new BxDolAlerts('profile', 'login',  $iId);
-    $oZ->alert();
-
-    return getProfileInfo($iId);
-}
+    $oAccountQuery->updateLoggedIn($iId);
+
+    bx_alert('account', 'login',  $iId);
+
+    return $oAccountQuery->getInfoById($iId);
+}
+
 function bx_logout($bNotify = true) {
-    if($bNotify && isMember()) {
-        require_once(BX_DIRECTORY_PATH_CLASSES . 'BxDolAlerts.php');
-        $oZ = new BxDolAlerts('profile', 'logout', (int)$_COOKIE['memberID']);
-        $oZ->alert();
-    }
+    if ($bNotify && isMember())
+        bx_alert('profile', 'logout', (int)$_COOKIE['memberID']);
 
     $aUrl = parse_url(BX_DOL_URL_ROOT);
@@ -483 +215 @@
     unset($_COOKIE['memberID']);
     unset($_COOKIE['memberPassword']);
-}
-
-function setSearchStartAge($iMin) {
-    if ($iMin <= 0)
-        return false;
-
-    BxDolDb::getInstance()->query("update `sys_profile_fields` set `Min` = $iMin where `Name` = 'DateOfBirth'");
-
-    require_once(BX_DIRECTORY_PATH_CLASSES . 'BxDolPFM.php');
-    $oCacher = new BxDolPFMCacher();
-    $oCacher -> createCache();
-
-    return true;
-}
-
-function setSearchEndAge($iMax) {
-    if ($iMax <= 0)
-        return false;
-
-    BxDolDb::getInstance()->query("update `sys_profile_fields` set `Max` = $iMax where `Name` = 'DateOfBirth'");
-
-    require_once(BX_DIRECTORY_PATH_CLASSES . 'BxDolPFM.php');
-    $oCacher = new BxDolPFMCacher();
-    $oCacher -> createCache();
-
-    return true;
 }
 
@@ -518 +224 @@
 
     $bLogged = false;
-    foreach($aAccTypes as $iKey => $sValue)
-        if($GLOBALS['logged'][$sValue] = member_auth($iKey, false)) {
+    foreach ($aAccTypes as $iKey => $sValue)
+        if ($GLOBALS['logged'][$sValue] = member_auth($iKey, false)) {
             $bLogged = true;
             break;
         }
 
-    if((isset($_COOKIE['memberID']) || isset($_COOKIE['memberPassword'])) && !$bLogged)
+    if ((isset($_COOKIE['memberID']) || isset($_COOKIE['memberPassword'])) && !$bLogged)
         bx_logout(false);
 }
 
-// 0 - member, 1 - admin
-function member_auth($member = 0, $error_handle = true, $bAjx = false) {
-
-       switch ($member) {
+/**
+ * @param $member - 0 = member, 1 = admin
+ * @param $bHandleError - if set to true (it is true by default) then login form is displayedautomatically if user is not logged in
+ * @param $bAjx
+ * @return 
+ */
+function member_auth($member = 0, $bHandleError = true, $bAjx = false) {
+
+    switch ($member) {
         case 0:
-               $mem        = 'member';
-               $login_page = BX_DOL_URL_ROOT . "member.php";
+            $mem        = 'member';
+            $login_page = BX_DOL_URL_ROOT . "member.php";
             $iRole      = BX_DOL_ROLE_MEMBER;
         break;
         case 1:
-               $mem        = 'admin';
-               $login_page = BX_DOL_URL_STUDIO . "index.php";
+            $mem        = 'admin';
+            $login_page = BX_DOL_URL_STUDIO . "index.php";
             $iRole      = BX_DOL_ROLE_ADMIN;
         break;
@@ -545 +256 @@
 
     if (empty($_COOKIE['memberID']) || !isset($_COOKIE['memberPassword'])) {
-        if ($error_handle) {
+        if ($bHandleError) {
             $text = _t("_LOGIN_REQUIRED_AE1");
             if ($member == 0)
@@ -551 +262 @@
 
             $bAjxMode = (isset( $_SERVER['HTTP_X_REQUESTED_WITH'] ) and $_SERVER['HTTP_X_REQUESTED_WITH'] == 'XMLHttpRequest') ? true : false;
-            if ($member=1 && $bAjx==true) $bAjxMode = true;
+            if ($member=1 && $bAjx==true) 
+                $bAjxMode = true;
             login_form($text, $member, $bAjxMode);
         }
@@ -557 +269 @@
     }
 
-    return check_login(bx_process_input($_COOKIE['memberID']), bx_process_input($_COOKIE['memberPassword' ]), $iRole, $error_handle);
-}
-
-// check encrypted password (ex., from Cookie)
-function check_login($ID, $passwd, $iRole = BX_DOL_ROLE_MEMBER, $error_handle = true) {
+    return check_login(bx_process_input($_COOKIE['memberID']), bx_process_input($_COOKIE['memberPassword' ]), $iRole, $bHandleError);
+}
+
+/**
+ * check encrypted password (ex., from Cookie)
+ */
+function check_login($ID, $passwd, $iRole = BX_DOL_ROLE_MEMBER, $bHandleError = true) {
+
     $ID = (int)$ID;
+
+    bx_import('BxDolAccount');
+    $oAccount = BxDolAccount::getInstance($ID);
+    if (!$oAccount) {
+        if ($bHandleError)
+            login_form(_t("_PROFILE_ERR"), $member);
+        return false;
+    }
+
+    $aAccountInfo = $oAccount->getInfo();
 
     switch ($iRole) {
@@ -569 +294 @@
     }
 
-    if (!$ID) {
-        if ($error_handle)
+    // If no such account available
+    if (!$aAccountInfo) {
+        if ($bHandleError)
             login_form(_t("_PROFILE_ERR"), $member);
         return false;
     }
 
-    $aProfile = getProfileInfo($ID);
-
-    // If no such members
-    if (!$aProfile) {
-        if ($error_handle)
-            login_form(_t("_PROFILE_ERR"), $member);
-        return false;
-    }
-
     // If password is incorrect
-    if (strcmp($aProfile['Password'], $passwd) != 0) {
-        if ($error_handle)
+    if (strcmp($aAccountInfo['password'], $passwd) != 0) {
+        if ($bHandleError)
             login_form(_t("_INVALID_PASSWD"), $member);
         return false;
     }
 
-    if (!((int)$aProfile['Role'] & $iRole)) {
-        if ($error_handle)
+    if (!((int)$aAccountInfo['role'] & $iRole)) {
+        if ($bHandleError)
           login_form(_t("_INVALID_ROLE"), $member);
         return false;
     }
 
-    if(((int)$aProfile['Role'] & BX_DOL_ROLE_ADMIN) || ((int)$aProfile['Role'] & BX_DOL_ROLE_MODERATOR)) {
-        if( 'on' != getParam('ext_nav_menu_enabled') ) {
-            update_date_lastnav($ID);
-        }
-
+    if (isAdmin($aAccountInfo['id']))
         return true;
-    }
 
     // if IP is banned
     if ((2 == getParam('ipBlacklistMode') && bx_is_ip_blocked()) || ('on' == getParam('sys_dnsbl_enable') && bx_is_ip_dns_blacklisted('', 'login'))) {
-        if ($error_handle) {
+        if ($bHandleError) {
                 bx_import('BxDolTemplate');
                 $oTemplate = BxDolTemplate::getInstance();
@@ -618 +330 @@
 
     // if profile is banned
-    if (isLoggedBanned($aProfile['ID'])) {
-        if ($error_handle) {
+    if (isLoggedBanned($aAccountInfo['id'])) {
+        if ($bHandleError) {
             bx_import('BxDolTemplate');
             $oTemplate = BxDolTemplate::getInstance();
@@ -629 +341 @@
     }
 
-    if( 'on' != getParam('ext_nav_menu_enabled') ) {
-        update_date_lastnav($ID);
-    }
-
     return true;
 }
@@ -639 +347 @@
  * check unencrypted password
  */
-function check_password($sUsername, $sPassword, $iRole = BX_DOL_ROLE_MEMBER, $error_handle = true) {
-    $iId = getID($sUsername);
-    if (!$iId) return false;
-
-    $aUser = getProfileInfo($iId);
-    $sPassCheck = encryptUserPwd($sPassword, $aUser['Salt']);
-
-    return check_login($iId, $sPassCheck, $iRole, $error_handle);
+function check_password($sLogin, $sPassword, $iRole = BX_DOL_ROLE_MEMBER, $bHandleError = true) {
+
+    bx_import('BxDolAccount');
+    $oAccount = BxDolAccount::getInstance($sLogin);
+    if (!$oAccount) 
+        return false;
+
+    $aAccountInfo = $oAccount->getInfo();
+
+    $sPassCheck = encryptUserPwd($sPassword, $aAccountInfo['salt']);
+
+    return check_login($aAccountInfo['id'], $sPassCheck, $iRole, $bHandleError);
 }
 
@@ -691 +403 @@
     $sEmail = BxDolProfileQuery::getInstance()->getEmail($ID);
     if (!$sEmail) {
-        echo 'aaa' . $sEmail;
         $ret['ErrorCode'] = 7;
         return false;
@@ -731 +442 @@
 }
 
-function get_user_online_status ($ID) {
-    $iOnline = 0;
-    if ($ID && is_numeric($ID) ) {
-        $aMemberInfo  = getProfileInfo($ID);
-        // check user status;
-        if ($aMemberInfo['UserStatus'] != 'offline') {
-            $oDb = BxDolDb::getInstance();
-            $min = getParam("member_online_time");
-            $sQuery = $oDb->prepare("SELECT count(ID) as count_id FROM Profiles WHERE DateLastNav > SUBDATE(NOW(), INTERVAL ? MINUTE) AND ID=?", $min, $ID);
-            $iOnline = $oDb->fromMemory ("member_online_status.$ID.$min", 'getOne', $sQuery);
-        }
-    }
-    return $iOnline;
-}
-
 
 /**

trunk/inc/utils.inc.php

@@ -123 +123 @@
 }
 
-/*
- * functions for limiting maximal word length (returned from ash).
- */
-function WordWrapStr($input, $len = 35) {
-    $output = wordwrap($input, $len, " ", true);
-    return $output;
-}
 
 /*
@@ -331 +324 @@
 }
 
-function process_textarea_output( $text, $maxwordlen = 100 ) {
-    return htmlspecialchars_adv( strmaxwordlen( $text, $maxwordlen ) );
-}
-
 function process_text_withlinks_output( $text, $maxwordlen = 100 ) {
     return nl2br( html_encode( htmlspecialchars_adv( strmaxwordlen( $text, $maxwordlen ) ) ) );
@@ -1373 +1362 @@
 }
 
+/**
+ * Raise an alert
+ * @param string $sType - system type
+ * @param string $sAction - system action
+ * @param int $iObjectId - object id
+ * @param int $iSenderId - sender (action's author) id
+ */
+function bx_alert($sUnit, $sAction, $iObjectId, $iSender = 0, $aExtras = array()) {
+    $o = new BxDolAlerts($sUnit, $sAction, $iObjectId, $iSender, $aExtras);
+    $o->alert();
+}
+
 function getSitesArray ($sLink) {