oxbasketitem.php

Go to the documentation of this file.

<?php

class oxBasketItem extends oxSuperCfg
{
    protected $_sProductId = null;

    protected $_sTitle = null;

    protected $_sVarSelect = null;

    protected $_sIcon = null;

    protected $_sLink = null;

    protected $_oPrice = null;

    protected $_oUnitPrice = null;

    protected $_dAmount = 0.0;

    protected $_dWeight = 0;

    protected $_aSelList = array();

    protected $_sShopId = null;

    protected $_sNativeShopId = null;

    protected $_blSkipDiscounts = false;

    protected $_aPersistentParameters = array();

    protected $_blBundle = false;

    protected $_blIsDiscountArticle = false;

    protected $_oArticle = null;

    protected $_sDimageDirNoSsl = null;

    protected $_sDimageDirSsl = null;

    protected $_aChosenSelectlist = array();

    protected $_sWrappingId = null;

     protected $_sWishId = null;

    protected $_sWishArticleId = null;

    protected $_blCheckArticleStock = true;


    protected $_iLanguageId = null;
    
    public function init( $sProductID, $dAmount, $aSel = null, $aPersParam = null, $blBundle = null )
    {
        $this->_setArticle( $sProductID );
        $this->setAmount( $dAmount );
        $this->_setSelectList( $aSel );
        $this->setPersParams( $aPersParam );
        $this->setBundle( $blBundle );
        $this->setLanguageId( oxLang::getInstance()->getBaseLanguage() );
    }

    public function initFromOrderArticle( $oOrderArticle )
    {
        $this->_setFromOrderArticle( $oOrderArticle );
        $this->setAmount( $oOrderArticle->oxorderarticles__oxamount->value );
        $this->_setSelectList( $oOrderArticle->getOrderArticleSelectList() );
        $this->setPersParams( $oOrderArticle->getPersParams() );
    }

    public function setAsDiscountArticle( $blIsDiscountArticle )
    {
        $this->_blIsDiscountArticle = $blIsDiscountArticle;
    }

    public function setStockCheckStatus( $blStatus )
    {
        $this->_blCheckArticleStock = $blStatus;
    }

    public function getStockCheckStatus()
    {
        return $this->_blCheckArticleStock;
    }

    public function setAmount( $dAmount, $blOverride = true, $sItemKey = null )
    {
        //validating amount
        $oValidator = oxNew( 'oxinputvalidator' );

        try {
            $dAmount = $oValidator->validateBasketAmount( $dAmount );
        } catch( oxArticleInputException $oEx ) {
            $oEx->setArticleNr( $this->getProductId() );
            $oEx->setProductId( $this->getProductId() );
            // setting additional information for excp and then rethrowing
            throw $oEx;
        }

        $oArticle = $this->getArticle();


        // setting default
        $iOnStock = true;

        if ( $blOverride ) {
            $this->_dAmount  = $dAmount;
        } else {
            $this->_dAmount += $dAmount;
        }

        // checking for stock
        if ( $this->getStockCheckStatus() == true ) {
            $dArtStockAmount = $this->getSession()->getBasket()->getArtStockInBasket( $oArticle->getId(), $sItemKey );
            $iOnStock = $oArticle->checkForStock( $this->_dAmount, $dArtStockAmount );
            if ( $iOnStock !== true ) {
                if ( $iOnStock === false ) {
                    // no stock !
                    $this->_dAmount = 0;
                } else {
                    // limited stock
                    $this->_dAmount = $iOnStock;
                    $blOverride = true;
                }
            }
        }

        // calculating general weight
        $this->_dWeight = $oArticle->oxarticles__oxweight->value * $this->_dAmount;

        if ( $iOnStock !== true ) {
            $oEx = oxNew( 'oxOutOfStockException' );
            $oEx->setMessage( 'EXCEPTION_OUTOFSTOCK_OUTOFSTOCK' );
            $oEx->setArticleNr( $oArticle->oxarticles__oxartnum->value );
            $oEx->setProductId( $oArticle->getProductId() );
            $oEx->setRemainingAmount( $this->_dAmount );
            throw $oEx;
        }
    }

    public function setPrice( $oPrice )
    {
        $this->_oPrice = oxNew( 'oxprice' );
        $this->_oPrice->setBruttoPriceMode();
        $this->_oPrice->setVat( $oPrice->getVAT() );
        $this->_oPrice->addPrice( $oPrice );
        $this->_oPrice->multiply( $this->getAmount() );

        $this->_oUnitPrice = oxNew( 'oxprice' );
        $this->_oUnitPrice->setBruttoPriceMode();
        $this->_oUnitPrice->setVat( $oPrice->getVAT() );
        $this->_oUnitPrice->addPrice( $oPrice );

        $this->_setDeprecatedValues();
    }

    public function getImageUrl()
    {
        $blIsSSl = $this->getConfig()->isSsl();
        if ( $blIsSSl ) {
            return $this->_sDimageDirSsl;
        } else {
            return $this->_sDimageDirNoSsl;
        }
    }

    public function getIconUrl()
    {
        return $this->getConfig()->getIconUrl( $this->getIcon() );
    }

    public function getArticle( $blCheckProduct = true, $sProductId = null, $blDisableLazyLoading = false )
    {
        if ( $this->_oArticle === null || ( !$this->_oArticle->isOrderArticle() && $blDisableLazyLoading ) ) {
            $sProductId = $sProductId ? $sProductId : $this->_sProductId;
            if ( !$sProductId ) {
                //this excpetion may not be caught, anyhow this is a critical exception
                $oEx = oxNew( 'oxArticleException' );
                $oEx->setMessage( 'EXCEPTION_ARTICLE_NOPRODUCTID' );
                throw $oEx;
            }

            $this->_oArticle = oxNew( 'oxarticle' );
            // #M773 Do not use article lazy loading on order save
            if ( $blDisableLazyLoading ) {
                $this->_oArticle->modifyCacheKey('_allviews');
                $this->_oArticle->disableLazyLoading();
            }

            // performance:
            // - skipping variants loading
            // - skipping 'ab' price info
            // - load parent field
            $this->_oArticle->setNoVariantLoading( true );
            $this->_oArticle->setSkipAbPrice( true );
            $this->_oArticle->setLoadParentData( true );
            if ( !$this->_oArticle->load( $sProductId ) ) {
                $oEx = oxNew( 'oxNoArticleException' );
                $oLang = oxLang::getInstance();
                $oEx->setMessage( sprintf($oLang->translateString( 'EXCEPTION_ARTICLE_ARTICELDOESNOTEXIST', $oLang->getBaseLanguage() ), $sProductId) );
                $oEx->setArticleNr( $sProductId );
                $oEx->setProductId( $sProductId );
                throw $oEx;
            }

            // cant put not visible product to basket (M:1286)
            if ( $blCheckProduct && !$this->_oArticle->isVisible() ) {
                $oEx = oxNew( 'oxNoArticleException' );
                $oLang = oxLang::getInstance();
                $oEx->setMessage( sprintf($oLang->translateString( 'EXCEPTION_ARTICLE_ARTICELDOESNOTEXIST', $oLang->getBaseLanguage() ), $this->_oArticle->oxarticles__oxartnum->value) );
                $oEx->setArticleNr( $sProductId );
                $oEx->setProductId( $sProductId );
                throw $oEx;
            }

            // cant put not buyable product to basket
            if ( $blCheckProduct && !$this->_oArticle->isBuyable() ) {
                $oEx = oxNew( 'oxArticleInputException' );
                $oEx->setMessage( 'EXCEPTION_ARTICLE_ARTICELNOTBUYABLE' );
                $oEx->setArticleNr( $sProductId );
                $oEx->setProductId( $sProductId );
                throw $oEx;
            }
        }

        return $this->_oArticle;
    }

    public function getdBundledAmount()
    {
        return $this->isBundle()?$this->_dAmount:0;
    }

    public function getPrice()
    {
        return $this->_oPrice;
    }

    public function getUnitPrice()
    {
        return $this->_oUnitPrice;
    }

    public function getAmount()
    {
        return $this->_dAmount;
    }

    public function getWeight()
    {
        return $this->_dWeight;
    }

    public function getTitle()
    {
        if ( $this->_sTitle === null || $this->getLanguageId() != oxLang::getInstance()->getBaseLanguage() ) {

            $this->setLanguageId( oxLang::getInstance()->getBaseLanguage() );    
            
            $oArticle = $this->getArticle( );
            $this->_sTitle = $oArticle->oxarticles__oxtitle->value;
            
            if ( $oArticle->oxarticles__oxvarselect->value ) {
                $this->_sTitle = $this->_sTitle. ', ' . $this->getVarSelect();
            }
        }
        
        return $this->_sTitle;
    }

    public function getIcon()
    {
        return $this->_sIcon;
    }

    public function getLink()
    {
        return $this->_sLink;
    }

    public function getShopId()
    {
        return $this->_sShopId;
    }

    public function getSelList()
    {
        return $this->_aSelList;
    }

    public function getChosenSelList()
    {
        return $this->_aChosenSelectlist;
    }

    public function isBundle()
    {
        return $this->_blBundle;
    }

    public function isDiscountArticle()
    {
        return $this->_blIsDiscountArticle;
    }

    public function isSkipDiscount()
    {
        return $this->_blSkipDiscounts;
    }

    public function __get( $sName )
    {
        if ( $sName == 'oProduct' ) {
            return $this->getArticle();
        }
    }

    public function __sleep()
    {
        $aRet = array();
        foreach ( get_object_vars( $this ) as $sKey => $sVar ) {
            if ( $sKey != '_oArticle' ) {
                $aRet[] = $sKey;
            }
        }
        return $aRet;
    }

    protected function _setDeprecatedValues()
    {
        $oUnitPrice = $this->getUnitPrice();
        $oPrice = $this->getPrice();

        // product VAT percent
        $this->vatPercent = $this->getVatPercent();

        // VAT value
        $this->dvat = $oUnitPrice->getVATValue();

        // unit non formatted price
        $this->dprice = $oUnitPrice->getBruttoPrice();

        // formatted unit price
        $this->fprice = $this->getFUnitPrice();

        // non formatted unit NETTO price
        $this->dnetprice = $oUnitPrice->getNettoPrice();

        // non formatted total NETTO price
        $this->dtotalnetprice = $oPrice->getNettoPrice();

        // formatter total NETTO price
        $this->ftotalnetprice = oxLang::getInstance()->formatCurrency( $oPrice->getNettoPrice() );

        // non formatted total BRUTTO price
        $this->dtotalprice = $oPrice->getBruttoPrice();

        // formatted total BRUTTO price
        $this->ftotalprice = $this->getFTotalPrice();

        // total VAT
        $this->dtotalvat = $oPrice->getVATValue();

        // formatted title
        $this->title = $this->getTitle();

        // icon URL
        $this->icon  = $this->getIcon();

        // details URL
        $this->link  = $this->getLink();

        // amount of items in basket
        $this->dAmount  = $this->getAmount();

        // weight
        $this->dWeight  = $this->getWeight();

        // select list
        $this->aSelList = $this->getSelList();

        // product id
        $this->sProduct = $this->getProductId();

        // product id
        $this->varselect = $this->getVarSelect();

        // is bundle ?
        $this->blBundle = $this->isBundle();

        // bundle amount
        $this->dBundledAmount = $this->getdBundledAmount();

        // skip discounts ?
        $this->blSkipDiscounts     = $this->isSkipDiscount();

        // is discount item ?
        $this->blIsDiscountArticle = $this->isDiscountArticle();

        // dyn image location
        $this->dimagedir = $this->getImageUrl();

        // setting wrapping paper info
        $this->wrapping  = $this->getWrappingId();

        $this->oWrap = $this->getWrapping();

        $this->aPersParam = $this->getPersParams();

        //chosen select list
        $this->chosen_selectlist = $this->getChosenSelList();
    }

    protected function _setArticle( $sProductId )
    {
        $oArticle = $this->getArticle( true, $sProductId );

        // product ID
        $this->_sProductId = $sProductId;

        $this->getTitle();
       
        // icon and details URL's
        $this->_sIcon = $oArticle->oxarticles__oxicon->value;
        $this->_sLink = $oArticle->getLink();

        // shop Ids
        $this->_sShopId       = $this->getConfig()->getShopId();
        $this->_sNativeShopId = $oArticle->oxarticles__oxshopid->value;

        // SSL/NON SSL image paths
        $this->_sDimageDirNoSsl = $oArticle->nossl_dimagedir;
        $this->_sDimageDirSsl   = $oArticle->ssl_dimagedir;
    }

    protected function _setFromOrderArticle( $oOrderArticle )
    {
        // overriding whole article
        $this->_oArticle = $oOrderArticle;

        // product ID
        $this->_sProductId = $oOrderArticle->getProductId();

        // products title
        $this->_sTitle = $oOrderArticle->oxarticles__oxtitle->value;

        // shop Ids
        $this->_sShopId       = $this->getConfig()->getShopId();
        $this->_sNativeShopId = $oOrderArticle->oxarticles__oxshopid->value;
    }

    protected function _setSelectList( $aSelList )
    {
        // checking for default select list
        $aSelectLists = $this->getArticle()->getSelectLists();
        if ( !$aSelList || is_array($aSelList) && count($aSelList) == 0 ) {
            if ( $iSelCnt = count( $aSelectLists ) ) {
                $aSelList = array_fill( 0, $iSelCnt, '0' );
            }
        }

        $this->_aSelList = $aSelList;

        //
        if ( count( $this->_aSelList ) && is_array($this->_aSelList) ) {
            foreach ( $this->_aSelList as $conkey => $iSel ) {
                $this->_aChosenSelectlist[$conkey] = new Oxstdclass();
                $this->_aChosenSelectlist[$conkey]->name  = $aSelectLists[$conkey]['name'];
                $this->_aChosenSelectlist[$conkey]->value = $aSelectLists[$conkey][$iSel]->name;
            }
        }
    }

    public function getPersParams()
    {
        return $this->_aPersistentParameters;
    }

    public function setPersParams( $aPersParam )
    {
        $this->_aPersistentParameters = $aPersParam;
    }

    public function setBundle( $blBundle )
    {
        $this->_blBundle = $blBundle;
    }

    public function setSkipDiscounts( $blSkip )
    {
        $this->_blSkipDiscounts = $blSkip;
    }

    public function getProductId()
    {
        return $this->_sProductId;
    }

    public function setWrapping( $sWrapId )
    {
        $this->_sWrappingId = $sWrapId;
    }

    public function getWrappingId()
    {
        return $this->_sWrappingId;
    }

    public function getWrapping()
    {
        $oWrap = null;
        if ( $sWrapId = $this->getWrappingId() ) {
            $oWrap = oxNew( 'oxwrapping' );
            $oWrap->load( $sWrapId );
        }
        return $oWrap;
    }

    public function getWishId()
    {
        return $this->_sWishId;
    }

    public function setWishId( $sWishId )
    {
        $this->_sWishId = $sWishId;
    }

    public function setWishArticleId( $sArticleId )
    {
        $this->_sWishArticleId = $sArticleId;
    }

    public function getWishArticleId()
    {
        return $this->_sWishArticleId;
    }

    public function getFUnitPrice()
    {
        return oxLang::getInstance()->formatCurrency( $this->getUnitPrice()->getBruttoPrice() );
    }

    public function getFTotalPrice()
    {
        return oxLang::getInstance()->formatCurrency( $this->getPrice()->getBruttoPrice() );
    }

    public function getVatPercent()
    {
        return oxLang::getInstance()->formatVat( $this->getPrice()->getVat() );
    }

    public function getVarSelect()
    {
        if ( $this->_sVarSelect === null || $this->getLanguageId() != oxLang::getInstance()->getBaseLanguage() ) {
            $oArticle = $this->getArticle( );
            $this->_sVarSelect = $oArticle->oxarticles__oxvarselect->value ? $oArticle->oxarticles__oxvarselect->value : '';
        }
        
        return $this->_sVarSelect;
    }
    
    public function getLanguageId()
    {
        return $this->_iLanguageId;
    }
    
    public function setLanguageId( $iLanguageId )
    {
        $this->_iLanguageId = $iLanguageId;
    }
}