Overview

Packages

  • currencysymbol
  • MAbout
  • Mage
    • Admin
    • Adminhtml
    • AdminNotification
    • Api
    • Api2
    • Authorizenet
    • Backup
    • Bundle
    • Captcha
    • Catalog
    • CatalogIndex
    • CatalogInventory
    • CatalogRule
    • CatalogSearch
    • Centinel
    • Checkout
    • Cms
    • Compiler
    • Connect
    • Contacts
    • Core
    • Cron
    • CurrencySymbol
    • Customer
    • Dataflow
    • Directory
    • DirtectPost
    • Downloadable
    • Eav
    • GiftMessage
    • GoogleAnalytics
    • GoogleBase
    • GoogleCheckout
    • ImportExport
    • Index
    • Install
    • Log
    • Media
    • Newsletter
    • Oauth
    • Page
    • PageCache
    • Paygate
    • Payment
    • Paypal
    • PaypalUk
    • Persistent
    • Poll
    • ProductAlert
    • Rating
    • Reports
    • Review
    • Rss
    • Rule
    • Sales
    • SalesRule
    • Sedfriend
    • Sendfriend
    • Shipping
    • Sitemap
    • Tag
    • Tax
    • Usa
    • Weee
    • Widget
    • Wishlist
    • XmlConnect
  • None
  • Phoenix
    • Moneybookers
  • PHP
  • Zend
    • Date
    • Mime
    • XmlRpc

Classes

  • Mage_Newsletter_Block_Subscribe
  • Mage_Newsletter_Helper_Data
  • Mage_Newsletter_ManageController
  • Mage_Newsletter_Model_Message
  • Mage_Newsletter_Model_Mysql4_Problem
  • Mage_Newsletter_Model_Mysql4_Problem_Collection
  • Mage_Newsletter_Model_Mysql4_Queue
  • Mage_Newsletter_Model_Mysql4_Queue_Collection
  • Mage_Newsletter_Model_Mysql4_Subscriber
  • Mage_Newsletter_Model_Mysql4_Subscriber_Collection
  • Mage_Newsletter_Model_Mysql4_Template
  • Mage_Newsletter_Model_Mysql4_Template_Collection
  • Mage_Newsletter_Model_Observer
  • Mage_Newsletter_Model_Problem
  • Mage_Newsletter_Model_Queue
  • Mage_Newsletter_Model_Resource_Problem
  • Mage_Newsletter_Model_Resource_Problem_Collection
  • Mage_Newsletter_Model_Resource_Queue
  • Mage_Newsletter_Model_Resource_Queue_Collection
  • Mage_Newsletter_Model_Resource_Subscriber
  • Mage_Newsletter_Model_Resource_Subscriber_Collection
  • Mage_Newsletter_Model_Resource_Template
  • Mage_Newsletter_Model_Resource_Template_Collection
  • Mage_Newsletter_Model_Session
  • Mage_Newsletter_Model_Subscriber
  • Mage_Newsletter_Model_Template
  • Mage_Newsletter_Model_Template_Filter
  • Mage_Newsletter_SubscriberController
  • Overview
  • Package
  • Class
  • Tree
  1: <?php
  2: /**
  3:  * Magento
  4:  *
  5:  * NOTICE OF LICENSE
  6:  *
  7:  * This source file is subject to the Open Software License (OSL 3.0)
  8:  * that is bundled with this package in the file LICENSE.txt.
  9:  * It is also available through the world-wide-web at this URL:
 10:  * http://opensource.org/licenses/osl-3.0.php
 11:  * If you did not receive a copy of the license and are unable to
 12:  * obtain it through the world-wide-web, please send an email
 13:  * to license@magentocommerce.com so we can send you a copy immediately.
 14:  *
 15:  * DISCLAIMER
 16:  *
 17:  * Do not edit or add to this file if you wish to upgrade Magento to newer
 18:  * versions in the future. If you wish to customize Magento for your
 19:  * needs please refer to http://www.magentocommerce.com for more information.
 20:  *
 21:  * @category    Mage
 22:  * @package     Mage_Newsletter
 23:  * @copyright   Copyright (c) 2012 Magento Inc. (http://www.magentocommerce.com)
 24:  * @license     http://opensource.org/licenses/osl-3.0.php  Open Software License (OSL 3.0)
 25:  */
 26: 
 27: 
 28: /**
 29:  * Newsletter queue collection.
 30:  *
 31:  * @category    Mage
 32:  * @package     Mage_Newsletter
 33:  * @author      Magento Core Team <core@magentocommerce.com>
 34:  */
 35: class Mage_Newsletter_Model_Resource_Queue_Collection extends Mage_Core_Model_Resource_Db_Collection_Abstract
 36: {
 37:     /**
 38:      * True when subscribers info joined
 39:      *
 40:      * @var bool
 41:      */
 42:     protected $_addSubscribersFlag   = false;
 43: 
 44:     /**
 45:      * True when filtered by store
 46:      *
 47:      * @var bool
 48:      */
 49:     protected $_isStoreFilter        = false;
 50: 
 51:     /**
 52:      * Initializes collection
 53:      *
 54:      */
 55:     protected function _construct()
 56:     {
 57:         $this->_map['fields']['queue_id'] = 'main_table.queue_id';
 58:         $this->_init('newsletter/queue');
 59:     }
 60: 
 61:     /**
 62:      * Joines templates information
 63:      *
 64:      * @deprecated since 1.4.0.1
 65:      *
 66:      * @return Mage_Newsletter_Model_Resource_Queue_Collection
 67:      */
 68:     public function addTemplateInfo()
 69:     {
 70:         $this->getSelect()->joinLeft(array('template'=>$this->getTable('template')),
 71:             'template.template_id=main_table.template_id',
 72:             array('template_subject','template_sender_name','template_sender_email')
 73:         );
 74:         $this->_joinedTables['template'] = true;
 75:         return $this;
 76:     }
 77: 
 78:     /**
 79:      * Adds subscribers info to selelect
 80:      *
 81:      * @return Mage_Newsletter_Model_Resource_Queue_Collection
 82:      */
 83:     protected function _addSubscriberInfoToSelect()
 84:     {
 85:         /** @var $select Varien_Db_Select */
 86:         $select = $this->getConnection()->select()
 87:             ->from(array('qlt' => $this->getTable('newsletter/queue_link')), 'COUNT(qlt.queue_link_id)')
 88:             ->where('qlt.queue_id = main_table.queue_id');
 89:         $totalExpr = new Zend_Db_Expr(sprintf('(%s)', $select->assemble()));
 90:         $select = $this->getConnection()->select()
 91:             ->from(array('qls' => $this->getTable('newsletter/queue_link')), 'COUNT(qls.queue_link_id)')
 92:             ->where('qls.queue_id = main_table.queue_id')
 93:             ->where('qls.letter_sent_at IS NOT NULL');
 94:         $sentExpr  = new Zend_Db_Expr(sprintf('(%s)', $select->assemble()));
 95: 
 96:         $this->getSelect()->columns(array(
 97:             'subscribers_sent'  => $sentExpr,
 98:             'subscribers_total' => $totalExpr
 99:         ));
100:         return $this;
101:     }
102: 
103:     /**
104:      * Adds subscribers info to select and loads collection
105:      *
106:      * @param bool $printQuery
107:      * @param bool $logQuery
108:      * @return Mage_Newsletter_Model_Resource_Queue_Collection
109:      */
110:     public function load($printQuery = false, $logQuery = false)
111:     {
112:         if ($this->_addSubscribersFlag && !$this->isLoaded()) {
113:             $this->_addSubscriberInfoToSelect();
114:         }
115:         return parent::load($printQuery, $logQuery);
116:     }
117: 
118:     /**
119:      * Joines subscribers information
120:      *
121:      * @return Mage_Newsletter_Model_Resource_Queue_Collection
122:      */
123:     public function addSubscribersInfo()
124:     {
125:         $this->_addSubscribersFlag = true;
126:         return $this;
127:     }
128: 
129:     /**
130:      * Checks if field is 'subscribers_total', 'subscribers_sent'
131:      * to add specific filter or adds reguler filter
132:      *
133:      * @param string $field
134:      * @param mixed $condition
135:      * @return Mage_Newsletter_Model_Resource_Queue_Collection
136:      */
137:     public function addFieldToFilter($field, $condition = null)
138:     {
139:         if (in_array($field, array('subscribers_total', 'subscribers_sent'))) {
140:             $this->addFieldToFilter('main_table.queue_id', array('in'=>$this->_getIdsFromLink($field, $condition)));
141:             return $this;
142:         } else {
143:             return parent::addFieldToFilter($field, $condition);
144:         }
145:     }
146: 
147:     /**
148:      * Returns ids from queue_link table
149:      *
150:      * @param string $field
151:      * @param mixed $condition
152:      * @return array
153:      */
154:     protected function _getIdsFromLink($field, $condition)
155:     {
156:         $select = $this->getConnection()->select()
157:             ->from(
158:                 $this->getTable('newsletter/queue_link'),
159:                 array('queue_id', 'total' => new Zend_Db_Expr('COUNT(queue_link_id)'))
160:             )
161:             ->group('queue_id')
162:             ->having($this->_getConditionSql('total', $condition));
163: 
164:         if ($field == 'subscribers_sent') {
165:             $select->where('letter_sent_at IS NOT NULL');
166:         }
167: 
168:         $idList = $this->getConnection()->fetchCol($select);
169: 
170:         if (count($idList)) {
171:             return $idList;
172:         }
173: 
174:         return array(0);
175:     }
176: 
177:     /**
178:      * Set filter for queue by subscriber.
179:      *
180:      * @param int $subscriberId
181:      * @return Mage_Newsletter_Model_Resource_Queue_Collection
182:      */
183:     public function addSubscriberFilter($subscriberId)
184:     {
185:         $this->getSelect()->join(array('link'=>$this->getTable('newsletter/queue_link')),
186:             'main_table.queue_id=link.queue_id',
187:             array('letter_sent_at')
188:         )
189:         ->where('link.subscriber_id = ?', $subscriberId);
190: 
191:         return $this;
192:     }
193: 
194:     /**
195:      * Add filter by only ready fot sending item
196:      *
197:      * @return Mage_Newsletter_Model_Resource_Queue_Collection
198:      */
199:     public function addOnlyForSendingFilter()
200:     {
201:         $this->getSelect()
202:             ->where('main_table.queue_status in (?)', array(Mage_Newsletter_Model_Queue::STATUS_SENDING,
203:                                                             Mage_Newsletter_Model_Queue::STATUS_NEVER))
204:             ->where('main_table.queue_start_at < ?', Mage::getSingleton('core/date')->gmtdate())
205:             ->where('main_table.queue_start_at IS NOT NULL');
206: 
207:         return $this;
208:     }
209: 
210:     /**
211:      * Add filter by only not sent items
212:      *
213:      * @return Mage_Newsletter_Model_Resource_Queue_Collection
214:      */
215:     public function addOnlyUnsentFilter()
216:     {
217:         $this->addFieldToFilter('main_table.queue_status', Mage_Newsletter_Model_Queue::STATUS_NEVER);
218: 
219:            return $this;
220:     }
221: 
222:     /**
223:      * Returns options array
224:      *
225:      * @return array
226:      */
227:     public function toOptionArray()
228:     {
229:         return $this->_toOptionArray('queue_id', 'template_subject');
230:     }
231: 
232:     /**
233:      * Filter collection by specified store ids
234:      *
235:      * @param array|int $storeIds
236:      * @return Mage_Newsletter_Model_Resource_Queue_Collection
237:      */
238:     public function addStoreFilter($storeIds)
239:     {
240:         if (!$this->_isStoreFilter) {
241:             $this->getSelect()->joinInner(array('store_link' => $this->getTable('newsletter/queue_store_link')),
242:                 'main_table.queue_id = store_link.queue_id', array()
243:             )
244:             ->where('store_link.store_id IN (?)', $storeIds)
245:             ->group('main_table.queue_id');
246:             $this->_isStoreFilter = true;
247:         }
248:         return $this;
249:     }
250: }
251: 
Magento 1.7.0.2 API documentation generated by ApiGen 2.8.0