web/enmi/Zend/Service/Ebay/Finding/ListingInfo.php
changeset 19 1c2f13fd785c
parent 0 4eba9c11703f
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/web/enmi/Zend/Service/Ebay/Finding/ListingInfo.php	Thu Jan 20 19:30:54 2011 +0100
@@ -0,0 +1,211 @@
+<?php
+/**
+ * Zend Framework
+ *
+ * LICENSE
+ *
+ * This source file is subject to the new BSD license that is bundled
+ * with this package in the file LICENSE.txt.
+ * It is also available through the world-wide-web at this URL:
+ * http://framework.zend.com/license/new-bsd
+ * If you did not receive a copy of the license and are unable to
+ * obtain it through the world-wide-web, please send an email
+ * to license@zend.com so we can send you a copy immediately.
+ *
+ * @category   Zend
+ * @package    Zend_Service
+ * @subpackage Ebay
+ * @copyright  Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
+ * @license    http://framework.zend.com/license/new-bsd     New BSD License
+ * @version    $Id: ListingInfo.php 22791 2010-08-04 16:11:47Z renanbr $
+ */
+
+/**
+ * @see Zend_Service_Ebay_Finding_Abstract
+ */
+require_once 'Zend/Service/Ebay/Finding/Abstract.php';
+
+/**
+ * @category   Zend
+ * @package    Zend_Service
+ * @subpackage Ebay
+ * @copyright  Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
+ * @license    http://framework.zend.com/license/new-bsd     New BSD License
+ * @uses       Zend_Service_Ebay_Finding_Abstract
+ */
+class Zend_Service_Ebay_Finding_ListingInfo extends Zend_Service_Ebay_Finding_Abstract
+{
+    /**
+     * Shows whether or not the seller will accept a best offer for the
+     * associated item.
+     *
+     * Best Offer allows a buyer to make a lower-priced binding offer on a fixed
+     * price item. Buyers cannot see how many offers have been made (only the
+     * seller can see this information). To make a best offer on a listing, use
+     * the eBay Web site.
+     *
+     * @var boolean
+     */
+    public $bestOfferEnabled;
+
+    /**
+     * Used with competitive-bid auctions, the associated item includes a Buy It
+     * Now option if this value returns true.
+     *
+     * Buy It Now lets a user purchase the item at a fixed price, effectively
+     * ending the auction. On most sites, the Buy It Now option is removed (and
+     * this value returns false) once a valid bid is made on the associated item
+     * (a valid bid could be a bid above the reserve price).
+     *
+     * @var boolean
+     */
+    public $buyItNowAvailable;
+
+    /**
+     * The Buy It Now Price of the item (if any), in the currency of the site on
+     * which the item was listed.
+     *
+     * You can use this field to determine if the item was originally listed
+     * with Buy It Now, even if the Buy It Now option is no longer available for
+     * the item.
+     *
+     * For Basic Fixed-Price (FixedPrice), Store Inventory (StoreInventory), and
+     * Ad Format (AdFormat) listings, currentPrice is the current fixed price.
+     *
+     * Only returned if an item was listed with Buy It Now.
+     *
+     * @var float
+     */
+    public $buyItNowPrice;
+
+    /**
+     * The listing's Buy It Now Price (if any), converted into the currency of
+     * the site to which you sent your search request.
+     *
+     * For active items, refresh this value every 24 hours to pick up changes in
+     * conversion rates (if this value has been converted).
+     *
+     * Price fields are returned as doubles, not necessarily in the traditional
+     * monetary format of the site's country. For example, a US Dollar value
+     * might be returned as 3.880001 instead of 3.88.
+     *
+     * Only returned if an item was listed with Buy It Now.
+     *
+     * @var float
+     */
+    public $convertedBuyItNowPrice;
+
+    /**
+     * Time stamp specifying when the listing is scheduled to end, or the actual
+     * end time if the item listing has ended.
+     *
+     * This value is returned in GMT, the ISO 8601 date and time format
+     * (YYYY-MM-DDTHH:MM:SS.SSSZ). See the "dateTime" type for information about
+     * the time format, and for details on converting to and from the GMT time
+     * zone.
+     *
+     * @var integer
+     */
+    public $endTime;
+
+    /**
+     * If true, a generic gift icon displays next the listing's title in search
+     * and browse pages.
+     *
+     * @var boolean
+     */
+    public $gift;
+
+    /**
+     * The format of the listing, such as online auction, fixed price, or
+     * advertisement.
+     *
+     * Applicable values:
+     *
+     *     AdFormat
+     *     Advertisement to solicit inquiries on listings such as real estate.
+     *     Permits no bidding on that item, service, or property. To express
+     *     interest, a buyer fills out a contact form that eBay forwards to the
+     *     seller as a lead. This format does not enable buyers and sellers to
+     *     transact online through eBay and eBay Feedback is not available for
+     *     ad format listings.
+     *
+     *     Auction
+     *     Competitive-bid online auction format. Buyers engage in competitive
+     *     bidding, although Buy It Now may be offered as long as no valid bids
+     *     have been placed. Online auctions are listed on eBay.com; they can
+     *     also be listed in a seller's eBay Store if the seller is a Store
+     *     owner.
+     *
+     *     AuctionWithBIN
+     *     Same as Auction format, but Buy It Now is enabled. AuctionWithBIN
+     *     changes to Auction if a valid bid has been placed on the item. Valid
+     *     bids include bids that are equal to or above any specified reserve
+     *     price.
+     *
+     *     Classified
+     *     Classified Ads connect buyers and sellers, who then complete the sale
+     *     outside of eBay. This format does not enable buyers and sellers to
+     *     transact online through eBay and eBay Feedback is not available for
+     *     these listing types.
+     *
+     *     FixedPrice
+     *     A fixed-price listing. Auction-style bidding is not allowed. On some
+     *     sites, this auction format is also known as "Buy It Now Only" (not to
+     *     be confused with the Buy It Now option available with
+     *     competitive-bidding auctions). Fixed-price listings appear on
+     *     eBay.com; they can also be listed in a seller's eBay Store if the
+     *     seller is a Store owner.
+     *
+     *     StoreInventory
+     *     A fixed-price format for eBay Store sellers. Store Inventory listings
+     *     appear after other listings in regular browse and search item
+     *     listings on eBay. Store items have a lower Insertion Fee and longer
+     *     listing durations. This selling type can only be specified by sellers
+     *     who have an eBay Store. Store Inventory listings are listed on
+     *     eBay.com as well as in the seller's eBay Store.
+     *
+     * @var string
+     */
+    public $listingType;
+
+    /**
+     * Time stamp that eBay recorded as the moment the listing was made
+     * available.
+     *
+     * This value is returned in GMT, the ISO 8601 date and time format
+     * (YYYY-MM-DDTHH:MM:SS.SSSZ). See the "dateTime" type for information about
+     * the time format, and for details on converting to and from the GMT time
+     * zone. Note that it is possible for startTime to be different from the
+     * value returned by GetSingleItem.
+     *
+     * @var integer
+     */
+    public $startTime;
+
+    /**
+     * @return void
+     */
+    protected function _init()
+    {
+        parent::_init();
+        $ns = Zend_Service_Ebay_Finding::XMLNS_FINDING;
+
+        $this->bestOfferEnabled       = $this->_query(".//$ns:bestOfferEnabled[1]", 'boolean');
+        $this->buyItNowAvailable      = $this->_query(".//$ns:buyItNowAvailable[1]", 'boolean');
+        $this->buyItNowPrice          = $this->_query(".//$ns:buyItNowPrice[1]", 'float');
+        $this->convertedBuyItNowPrice = $this->_query(".//$ns:convertedBuyItNowPrice[1]", 'float');
+        $this->endTime                = $this->_query(".//$ns:endTime[1]", 'string');
+        $this->gift                   = $this->_query(".//$ns:gift[1]", 'boolean');
+        $this->listingType            = $this->_query(".//$ns:listingType[1]", 'string');
+        $this->startTime              = $this->_query(".//$ns:startTime[1]", 'string');
+
+        $this->_attributes['buyItNowPrice'] = array(
+            'currencyId' => $this->_query(".//$ns:buyItNowPrice[1]/@currencyId[1]", 'string')
+        );
+
+        $this->_attributes['convertedBuyItNowPrice'] = array(
+            'currencyId' => $this->_query(".//$ns:convertedBuyItNowPrice[1]/@currencyId[1]", 'string')
+        );
+    }
+}