Magento 2 Documentation  2.3
Documentation for Magento 2 CMS v2.3 (December 2018)
Public Member Functions | Protected Member Functions | Protected Attributes
Collection Class Reference
Inheritance diagram for Collection:
AbstractCollection AbstractDb SourceProviderInterface Collection ArrayInterface CollectionDataSourceInterface OptionSourceInterface ArgumentInterface

Public Member Functions

 setLoadDefault ($loadDefault)
 
 getLoadDefault ()
 
 setWithoutDefaultFilter ()
 
 addGroupFilter ($groupId)
 
 addStatusFilter ($status)
 
 addIdFilter ($store)
 
 addWebsiteFilter ($website)
 
 addCategoryFilter ($category)
 
 toOptionArray ()
 
 toOptionHash ()
 
 load ($printQuery=false, $logQuery=false)
 
 loadByCategoryIds (array $categories)
 
 addRootCategoryIdAttribute ()
 
- Public Member Functions inherited from AbstractCollection
 __construct (\Magento\Framework\Data\Collection\EntityFactoryInterface $entityFactory, \Psr\Log\LoggerInterface $logger, \Magento\Framework\Data\Collection\Db\FetchStrategyInterface $fetchStrategy, \Magento\Framework\Event\ManagerInterface $eventManager, \Magento\Framework\DB\Adapter\AdapterInterface $connection=null, \Magento\Framework\Model\ResourceModel\Db\AbstractDb $resource=null)
 
 getMainTable ()
 
 setMainTable ($table)
 
 getSelect ()
 
 addFieldToSelect ($field, $alias=null)
 
 addExpressionFieldToSelect ($alias, $expression, $fields)
 
 removeFieldFromSelect ($field, $isAlias=false)
 
 removeAllFieldsFromSelect ()
 
 setModel ($model)
 
 getModelName ()
 
 setResourceModel ($model)
 
 getResourceModelName ()
 
 getResource ()
 
 getTable ($table)
 
 getAllIds ()
 
 join ($table, $cond, $cols=' *')
 
 setResetItemsDataChanged ($flag)
 
 resetItemsDataChanged ()
 
 save ()
 
 __sleep ()
 
 __wakeup ()
 
- Public Member Functions inherited from AbstractDb
 __construct (EntityFactoryInterface $entityFactory, Logger $logger, FetchStrategyInterface $fetchStrategy, \Magento\Framework\DB\Adapter\AdapterInterface $connection=null)
 
 getResource ()
 
 addBindParam ($name, $value)
 
 getIdFieldName ()
 
 setConnection (\Magento\Framework\DB\Adapter\AdapterInterface $conn)
 
 getSelect ()
 
 getConnection ()
 
 getSize ()
 
 getSelectCountSql ()
 
 getSelectSql ($stringMode=false)
 
 setOrder ($field, $direction=self::SORT_ORDER_DESC)
 
 addOrder ($field, $direction=self::SORT_ORDER_DESC)
 
 unshiftOrder ($field, $direction=self::SORT_ORDER_DESC)
 
 addFieldToFilter ($field, $condition=null)
 
 distinct ($flag)
 
 load ($printQuery=false, $logQuery=false)
 
 loadWithFilter ($printQuery=false, $logQuery=false)
 
 fetchItem ()
 
 getData ()
 
 resetData ()
 
 loadData ($printQuery=false, $logQuery=false)
 
 printLogQuery ($printQuery=false, $logQuery=false, $sql=null)
 
 addFilterToMap ($filter, $alias, $group='fields')
 
 __clone ()
 
 joinExtensionAttribute (JoinDataInterface $join, JoinProcessorInterface $extensionAttributesJoinProcessor)
 
 getItemObjectClass ()
 
 __sleep ()
 
 __wakeup ()
 
- Public Member Functions inherited from Collection
 __construct (EntityFactoryInterface $entityFactory)
 
 addFilter ($field, $value, $type='and')
 
 addFieldToFilter ($field, $condition)
 
 getFilter ($field)
 
 isLoaded ()
 
 getCurPage ($displacement=0)
 
 getLastPageNumber ()
 
 getPageSize ()
 
 getSize ()
 
 getFirstItem ()
 
 getLastItem ()
 
 getItems ()
 
 getColumnValues ($colName)
 
 getItemsByColumnValue ($column, $value)
 
 getItemByColumnValue ($column, $value)
 
 addItem (\Magento\Framework\DataObject $item)
 
 getAllIds ()
 
 removeItemByKey ($key)
 
 removeAllItems ()
 
 clear ()
 
 walk ($callback, array $args=[])
 
 each ($objMethod, $args=[])
 
 setDataToAll ($key, $value=null)
 
 setCurPage ($page)
 
 setPageSize ($size)
 
 setOrder ($field, $direction=self::SORT_ORDER_DESC)
 
 setItemObjectClass ($className)
 
 getNewEmptyItem ()
 
 distinct ($flag)
 
 loadData ($printQuery=false, $logQuery=false)
 
 load ($printQuery=false, $logQuery=false)
 
 loadWithFilter ($printQuery=false, $logQuery=false)
 
 toXml ()
 
 toArray ($arrRequiredFields=[])
 
 toOptionArray ()
 
 toOptionHash ()
 
 getItemById ($idValue)
 
 getIterator ()
 
 count ()
 
 getFlag ($flag)
 
 setFlag ($flag, $value=null)
 
 hasFlag ($flag)
 
 __sleep ()
 
 __wakeup ()
 
- Public Member Functions inherited from SourceProviderInterface
 getIdFieldName ()
 
 addFieldToFilter ($attribute, $condition=null)
 

Protected Member Functions

 _construct ()
 
- Protected Member Functions inherited from AbstractCollection
 _construct ()
 
 _initSelect ()
 
 _initSelectFields ()
 
 _getInitialFieldsToSelect ()
 
 _initInitialFieldsToSelect ()
 
 _init ($model, $resourceModel)
 
 _beforeLoad ()
 
 _afterLoad ()
 
- Protected Member Functions inherited from AbstractDb
 _setIdFieldName ($fieldName)
 
 _getItemId (\Magento\Framework\DataObject $item)
 
 _renderFilters ()
 
 _renderFiltersBefore ()
 
 _translateCondition ($field, $condition)
 
 _getMappedField ($field)
 
 _getMapper ()
 
 _getConditionSql ($fieldName, $condition)
 
 _getConditionFieldName ($fieldName)
 
 _renderOrders ()
 
 _renderLimit ()
 
 _beforeLoad ()
 
 beforeAddLoadedItem (\Magento\Framework\DataObject $item)
 
 _toOptionArray ($valueField=null, $labelField='name', $additional=[])
 
 _toOptionHash ($valueField=null, $labelField='name')
 
 _afterLoadData ()
 
 _afterLoad ()
 
 _logQuery ($sql)
 
 _reset ()
 
 _fetchAll (Select $select)
 
 _initSelect ()
 
- Protected Member Functions inherited from Collection
 _setIsLoaded ($flag=true)
 
 _addItem ($item)
 
 _getItemId (\Magento\Framework\DataObject $item)
 
 _renderFilters ()
 
 _renderOrders ()
 
 _renderLimit ()
 
 _toOptionArray ($valueField='id', $labelField='name', $additional=[])
 
 _toOptionHash ($valueField='id', $labelField='name')
 

Protected Attributes

 $_eventPrefix = 'store_collection'
 
 $_eventObject = 'store_collection'
 
- Protected Attributes inherited from AbstractCollection
 $_model
 
 $_resourceModel
 
 $_resource
 
 $_fieldsToSelect = null
 
 $_initialFieldsToSelect = null
 
 $_fieldsToSelectChanged = false
 
 $_joinedTables = []
 
 $_mainTable = null
 
 $_resetItemsDataChanged = false
 
 $_eventPrefix = ''
 
 $_eventObject = ''
 
 $_eventManager = null
 
- Protected Attributes inherited from AbstractDb
 $_conn
 
 $_select
 
 $_idFieldName
 
 $_bindParams = []
 
 $_data = null
 
 $_map = null
 
 $_fetchStmt = null
 
 $_isOrdersRendered = false
 
 $_logger
 
 $extensionAttributesJoinProcessor
 
- Protected Attributes inherited from Collection
 $_items = []
 
 $_itemObjectClass = \Magento\Framework\DataObject::class
 
 $_orders = []
 
 $_filters = []
 
 $_isFiltersRendered = false
 
 $_curPage = 1
 
 $_pageSize = false
 
 $_totalRecords
 
 $_isCollectionLoaded
 
 $_flags = []
 
 $_entityFactory
 

Additional Inherited Members

- Data Fields inherited from Collection
const SORT_ORDER_ASC = 'ASC'
 
const SORT_ORDER_DESC = 'DESC'
 

Detailed Description

Stores collection

@api

Since
100.0.2

Definition at line 14 of file Collection.php.

Member Function Documentation

◆ _construct()

_construct ( )
protected

Define resource model

Returns
void

Definition at line 35 of file Collection.php.

36  {
37  $this->setFlag('load_default_store', false);
38  $this->_init(\Magento\Store\Model\Store::class, \Magento\Store\Model\ResourceModel\Store::class);
39  }

◆ addCategoryFilter()

addCategoryFilter (   $category)

Add root category id filter to store collection

Parameters
int | array$category
Returns
$this

Definition at line 127 of file Collection.php.

128  {
129  if (!is_array($category)) {
130  $category = [$category];
131  }
132  return $this->loadByCategoryIds($category);
133  }

◆ addGroupFilter()

addGroupFilter (   $groupId)

Add filter by group id. Group id can be passed as one single value or array of values.

Parameters
int | array$groupId
Returns
$this

Definition at line 82 of file Collection.php.

83  {
84  return $this->addFieldToFilter('main_table.group_id', ['in' => $groupId]);
85  }

◆ addIdFilter()

addIdFilter (   $store)

Add store id(s) filter to collection

Parameters
int | array$store
Returns
$this

Definition at line 105 of file Collection.php.

106  {
107  return $this->addFieldToFilter('main_table.store_id', ['in' => $store]);
108  }

◆ addRootCategoryIdAttribute()

addRootCategoryIdAttribute ( )

Add store root category data to collection

Returns
$this

Definition at line 202 of file Collection.php.

203  {
204  if (!$this->getFlag('store_group_table_joined')) {
205  $this->getSelect()->join(
206  ['group_table' => $this->getTable('store_group')],
207  'main_table.group_id = group_table.group_id',
208  ['root_category_id']
209  );
210  $this->setFlag('store_group_table_joined', true);
211  }
212 
213  return $this;
214  }

◆ addStatusFilter()

addStatusFilter (   $status)

Add filter by status to collection

Parameters
int$status
Returns
$this
Since
100.1.0

Definition at line 94 of file Collection.php.

95  {
96  return $this->addFieldToFilter('main_table.is_active', ['eq' => $status]);
97  }
$status
Definition: order_status.php:8

◆ addWebsiteFilter()

addWebsiteFilter (   $website)

Add filter by website to collection

Parameters
int | array$website
Returns
$this

Definition at line 116 of file Collection.php.

117  {
118  return $this->addFieldToFilter('main_table.website_id', ['in' => $website]);
119  }

◆ getLoadDefault()

getLoadDefault ( )

Is load default (admin) store

Returns
bool @SuppressWarnings(PHPMD.BooleanGetMethodName)

Definition at line 59 of file Collection.php.

60  {
61  return $this->getFlag('load_default_store');
62  }

◆ load()

load (   $printQuery = false,
  $logQuery = false 
)

Load collection data

Parameters
bool$printQuery
bool$logQuery
Returns
$this

Definition at line 162 of file Collection.php.

163  {
164  if (!$this->getLoadDefault()) {
165  $this->setWithoutDefaultFilter();
166  }
167 
168  if (!$this->isLoaded()) {
169  $this->addOrder(
170  'CASE WHEN main_table.store_id = 0 THEN 0 ELSE 1 END',
171  \Magento\Framework\DB\Select::SQL_ASC
172  )->addOrder(
173  'main_table.sort_order',
174  \Magento\Framework\DB\Select::SQL_ASC
175  )->addOrder(
176  'main_table.name',
177  \Magento\Framework\DB\Select::SQL_ASC
178  );
179  }
180  return parent::load($printQuery, $logQuery);
181  }
addOrder($field, $direction=self::SORT_ORDER_DESC)
Definition: AbstractDb.php:286
const SQL_ASC
Definition: Select.php:81

◆ loadByCategoryIds()

loadByCategoryIds ( array  $categories)

Add root category id filter to store collection

Parameters
array$categories
Returns
$this

Definition at line 189 of file Collection.php.

190  {
192  $this->addFieldToFilter('group_table.root_category_id', ['in' => $categories]);
193 
194  return $this;
195  }
$categories

◆ setLoadDefault()

setLoadDefault (   $loadDefault)

Set flag for load default (admin) store

Parameters
bool$loadDefault
Returns
$this

Definition at line 47 of file Collection.php.

48  {
49  $this->setFlag('load_default_store', (bool)$loadDefault);
50  return $this;
51  }

◆ setWithoutDefaultFilter()

setWithoutDefaultFilter ( )

Add disable default store filter to collection

Returns
$this

Definition at line 69 of file Collection.php.

70  {
71  $this->addFieldToFilter('main_table.store_id', ['gt' => 0]);
72  return $this;
73  }

◆ toOptionArray()

toOptionArray ( )

Convert items array to array for select options

Returns
array

Implements OptionSourceInterface.

Definition at line 140 of file Collection.php.

141  {
142  return $this->_toOptionArray('store_id', 'name');
143  }
_toOptionArray($valueField=null, $labelField='name', $additional=[])
Definition: AbstractDb.php:641

◆ toOptionHash()

toOptionHash ( )

Convert items array to hash for select options

Returns
array

Definition at line 150 of file Collection.php.

151  {
152  return $this->_toOptionHash('store_id', 'name');
153  }
_toOptionHash($valueField=null, $labelField='name')
Definition: AbstractDb.php:656

Field Documentation

◆ $_eventObject

$_eventObject = 'store_collection'
protected

Definition at line 28 of file Collection.php.

◆ $_eventPrefix

$_eventPrefix = 'store_collection'
protected

Definition at line 21 of file Collection.php.


The documentation for this class was generated from the following file: