<?php
/**
 * This file is part of OXID eSales PayPal module.
 *
 * OXID eSales PayPal module 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 3 of the License, or
 * (at your option) any later version.
 *
 * OXID eSales PayPal module 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 OXID eSales PayPal module.  If not, see <http://www.gnu.org/licenses/>.
 *
 * @link      http://www.oxid-esales.com
 * @copyright (C) OXID eSales AG 2003-2013
 */

/**
 * PayPal IPN handler class.
 *
 * Handle PayPal notifications.
 *  - Extract data.
 *  - Check if valid.
 *  - Call order methods to save data.
 */
class oePayPalIPNHandler extends oePayPalController
{

	// [...]

    /**
     * IPN handling function.
     *  - Call to check if request is valid (from PayPal and to correct shop).
     *  - Initiate payment status changes according to IPN information.
     *
     * @return null
     */
    public function handleRequest()
    {
        $blRequestHandled = false;
        $blRequestValid = $this->requestValid();

        if ( $blRequestValid ) {
            $oRequest = $this->getPayPalRequest();
            $oLang = $this->getPayPalConfig()->getLang();

            $oProcessor = $this->getProcessor();
            $oProcessor->setRequest( $oRequest );
            $oProcessor->setLang( $oLang );

            $blRequestHandled = $oProcessor->process();
        }
        die( $blRequestHandled ? 'valid' : 'invalid' );
    }

	// [...]
	
}