Standard::isModified() - Code Metrics - aimeos/aimeos-core - Measure and Improve Code Quality continuously with Scrutinizer

Standard::isModified() A
last analyzed 2025-09-17 18:05 UTC

↳ Parent: Standard

Complexity

Conditions	2
Paths	2

Size

Total Lines	3
Code Lines	1

Duplication

Lines	0
Ratio	0 %

Importance

Changes

Metric	Value
cc	2
eloc	1
c	0
b	0
f	0
nc	2
nop	0
dl	0
loc	3
rs	10

<?php

/**
 * @license LGPLv3, https://opensource.org/licenses/LGPL-3.0
 * @copyright Metaways Infosystems GmbH, 2011
 * @copyright Aimeos (aimeos.org), 2015-2025
 * @package MShop
 * @subpackage Catalog
 */


namespace Aimeos\MShop\Catalog\Item;

use \Aimeos\MShop\Common\Item\Config;
filter:
    dependency_paths: ["lib/*"]
use \Aimeos\MShop\Common\Item\ListsRef;
filter:
    dependency_paths: ["lib/*"]


/**
 * Generic interface for catalog items.
 *
 * @package MShop
 * @subpackage Catalog
 */
class Standard
	extends \Aimeos\MShop\Common\Item\Base
	implements \Aimeos\MShop\Catalog\Item\Iface
{
	use Config\Traits, ListsRef\Traits {
filter:
    dependency_paths: ["lib/*"]
		ListsRef\Traits::__clone as __cloneList;
		ListsRef\Traits::getName as getNameList;
	}


	private \Aimeos\MW\Tree\Node\Iface $node;
	private array $deletedItems = [];
	private array $children;


	/**
	 * Initializes the catalog item.
	 *
	 * @param \Aimeos\MW\Tree\Node\Iface $node Tree node
	 * @param array $values Assoicative list of key/value pairs
	 * @param \Aimeos\MShop\Catalog\Item\Iface[] $children List of children of the item
	 * @param \Aimeos\MShop\Common\Item\Lists\Iface[] $listItems List of list items
	 * @param \Aimeos\MShop\Common\Item\Iface[] $refItems List of referenced items
	 */
	public function __construct( \Aimeos\MW\Tree\Node\Iface $node, array $values = [], array $children = [],
		array $listItems = [], array $refItems = [] )
	{
		parent::__construct( '', $values );

		map( $children )->implements( \Aimeos\MShop\Catalog\Item\Iface::class, true );

		$this->initListItems( $listItems, $refItems );
		$this->children = $children;
		$this->node = $node;
	}


	/**
	 * Clones internal objects of the catalog item.
	 */
	public function __clone()
	{
		parent::__clone();
		$this->__cloneList();
		$this->node = clone $this->node;
	}


	/**
	 * Tests if the item property for the given name is available
	 *
	 * @param string $name Name of the property
	 * @return bool True if the property exists, false if not
	 */
	public function __isset( string $name ) : bool
	{
		if( $name === 'children' ) {
			return true;
		}

		return parent::__isset( $name ) ?: isset( $this->node->$name );
	}


	/**
	 * Returns the item property for the given name
	 *
	 * @param string $name Name of the property
	 * @param mixed $default Default value if property is unknown
	 * @return mixed|null Property value or default value if property is unknown
	 */
	public function get( string $name, $default = null )
	{
		if( $name === 'children' ) {
			return $this->children;
		}

		if( ( $value = parent::get( $name ) ) !== null ) {
			return $value;
		}

		return $this->node->$name ?? $default;
	}


	/**
	 * Returns the unique ID of the node.
	 *
	 * @return string|null Unique ID of the node
	 */
	public function getId() : ?string
	{
		return $this->node->getId();
	}


	/**
	 * Sets the unique ID of the node.
	 *
	 * @param string|null $id Unique ID of the node
	 * @return \Aimeos\MShop\Catalog\Item\Iface Catalog item for chaining method calls
	 */
	public function setId( ?string $id = null ) : \Aimeos\MShop\Common\Item\Iface
	{
		$this->node->setId( $id );
		return $this;
	}


	/**
	 * Returns the site ID of the item.
	 *
	 * @return string Site ID of the item
	 */
	public function getSiteId() : string
	{
		return (string) $this->node->siteid;
	}


	/**
	 * Returns the internal name of the item.
	 *
	 * @return string Name of the item
	 */
	public function getLabel() : string
	{
		return $this->node->getLabel();
	}


	/**
	 * Sets the new internal name of the item.
	 *
	 * @param string $name New name of the item
	 * @return \Aimeos\MShop\Catalog\Item\Iface Catalog item for chaining method calls
	 */
	public function setLabel( string $name ) : \Aimeos\MShop\Common\Item\Tree\Iface
	{
		$this->node->setLabel( $name );
		return $this;
	}


	/**
	 * Returns the localized text type of the item or the internal label if no name is available.
	 *
	 * @param string $type Text type to be returned
	 * @param string|null $langId Two letter ISO Language code of the text
	 * @return string Specified text type or label of the item
	 */
	public function getName( string $type = 'name', ?string $langId = null ) : string
	{
		$name = $this->getNameList( $type, $langId );

		if( $type === 'url' && $name === $this->getLabel() ) {
			return $this->getUrl();
		}

		return $name;
	}


	/**
	 * Returns the URL segment for the catalog item.
	 *
	 * @return string URL segment of the catalog item
	 */
	public function getUrl() : string
	{
		return (string) ( $this->node->url ?: \Aimeos\Base\Str::slug( $this->getLabel() ) );
	}


	/**
	 * Sets a new URL segment for the catalog.
	 *
	 * @param string|null $url New URL segment of the catalog item
	 * @return \Aimeos\MShop\Catalog\Item\Iface Catalog item for chaining method calls
	 */
	public function setUrl( ?string $url ) : \Aimeos\MShop\Catalog\Item\Iface
	{
		$this->node->url = (string) $url;
		return $this;
	}


	/**
	 * Returns the config property of the catalog.
	 *
	 * @return array Returns the config of the catalog node
	 */
	public function getConfig() : array
	{
		return (array) $this->get( 'config', [] );
	}


	/**
	 * Sets the config property of the catalog item.
	 *
	 * @param array $config Configuration to be set for the catalog node
	 * @return \Aimeos\MShop\Catalog\Item\Iface Catalog item for chaining method calls
	 */
	public function setConfig( array $config ) : \Aimeos\MShop\Common\Item\Iface
	{
		if( !$this->compareConfig( $this->getConfig(), $config ) ) {
			$this->set( 'config', $config );
		}

		return $this;
	}


	/**
	 * Returns the code of the item.
	 *
	 * @return string Code of the item
	 */
	public function getCode() : string
	{
		return $this->node->getCode();
	}


	/**
	 * Sets the new code of the item.
	 *
	 * @param string $code New code of the item
	 * @return \Aimeos\MShop\Catalog\Item\Iface Catalog item for chaining method calls
	 */
	public function setCode( string $code ) : \Aimeos\MShop\Common\Item\Tree\Iface
	{
		$this->node->setCode( \Aimeos\Utils::code( $code ) );
		return $this;
	}


	/**
	 * Returns the status of the item.
	 *
	 * @return int Greater than zero if enabled, zero or negative values if disabled
	 */
	public function getStatus() : int
	{
		return $this->node->getStatus();
	}


	/**
	 * Sets the new status of the item.
	 *
	 * @param int $status True if enabled, false if not
	 * @return \Aimeos\MShop\Catalog\Item\Iface Catalog item for chaining method calls
	 */
	public function setStatus( int $status ) : \Aimeos\MShop\Common\Item\Iface
	{
		$this->node->setStatus( $status );
		return $this;
	}


	/**
	 * Returns the URL target specific for that category
	 *
	 * @return string URL target specific for that category
	 */
	public function getTarget() : string
	{
		return (string) $this->node->target;
	}


	/**
	 * Sets a new URL target specific for that category
	 *
	 * @param string $value New URL target specific for that category
	 * @return \Aimeos\MShop\Catalog\Item\Iface Catalog item for chaining method calls
	 */
	public function setTarget( ?string $value ) : \Aimeos\MShop\Catalog\Item\Iface
	{
		$this->node->target = (string) $value;
		return $this;
	}


	/**
	 * Returns modify date/time of the order item base product.
	 *
	 * @return string|null Returns modify date/time of the order base item
	 */
	public function getTimeModified() : ?string
	{
		return $this->node->mtime;
	}


	/**
	 * Returns the create date of the item.
	 *
	 * @return string|null ISO date in YYYY-MM-DD hh:mm:ss format
	 */
	public function getTimeCreated() : ?string
	{
		return $this->node->ctime;
	}


	/**
	 * Returns the editor code of editor who created/modified the item at last.
	 *
	 * @return string Editor who created/modified the item at last
	 */
	public function editor() : string
	{
		return (string) $this->node->editor;
	}


	/**
	 * Adds a child node to this node.
	 *
	 * @param \Aimeos\MShop\Common\Item\Tree\Iface $item Child node to add
	 * @return \Aimeos\MShop\Common\Item\Tree\Iface Tree item for chaining method calls
	 */
	public function addChild( \Aimeos\MShop\Common\Item\Tree\Iface $item ) : \Aimeos\MShop\Common\Item\Tree\Iface
	{
		// don't set the modified flag as it's only for the values
		$this->children[] = $item;

		return $this;
	}


	/**
	 * Removes a child node from this node.
	 *
	 * @param \Aimeos\MShop\Common\Item\Tree\Iface $item Child node to remove
	 * @return \Aimeos\MShop\Common\Item\Tree\Iface Tree item for chaining method calls
	 */
	public function deleteChild( \Aimeos\MShop\Common\Item\Tree\Iface $item ) : \Aimeos\MShop\Common\Item\Tree\Iface
	{
		foreach( $this->children as $idx => $child )
		{
			if( $child === $item )
			{
				$this->deletedItems[] = $item;
				unset( $this->children[$idx] );
			}
		}

		return $this;
	}


	/**
	 * Returns a child of this node identified by its index.
	 *
	 * @param int $index Index of child node
	 * @return \Aimeos\MShop\Catalog\Item\Iface Selected node
	 */
	public function getChild( int $index ) : \Aimeos\MShop\Common\Item\Tree\Iface
	{
		if( isset( $this->children[$index] ) ) {
			return $this->children[$index];
		}

		throw new \Aimeos\MShop\Catalog\Exception( sprintf( 'Child node with index "%1$d" not available', $index ) );
	}


	/**
	 * Returns all children of this node.
	 *
	 * @return \Aimeos\Map Numerically indexed list of children implementing \Aimeos\MShop\Catalog\Item\Iface
	 */
	public function getChildren() : \Aimeos\Map
	{
		return map( $this->children );
	}


	/**
	 * Returns the deleted children.
	 *
	 * @return \Aimeos\Map List of removed children implementing \Aimeos\MShop\Catalog\Item\Iface
	 */
	public function getChildrenDeleted() : \Aimeos\Map
	{
		return map( $this->deletedItems );
	}


	/**
	 * Tests if a node has children.
	 *
	 * @return bool True if node has children, false if not
	 */
	public function hasChildren() : bool
	{
		if( count( $this->children ) > 0 ) {
			return true;
		}

		return $this->node->hasChildren();
	}


	/**
	 * Returns the internal node.
	 *
	 * For internal use only!
	 *
	 * @return \Aimeos\MW\Tree\Node\Iface Internal node object
	 */
	public function getNode() : \Aimeos\MW\Tree\Node\Iface
	{
		return $this->node;
	}


	/**
	 * Returns the level of the item in the tree
	 *
	 * For internal use only!
	 *
	 * @return int Level of the item starting with "0" for the root node
	 */
	public function getLevel() : int
	{
		return $this->node->level ?: 0;
	}


	/**
	 * Returns the ID of the parent category
	 *
	 * For internal use only!
	 *
	 * @return string|null Unique ID of the parent category
	 */
	public function getParentId() : ?string
	{
		return $this->node->parentid;
	}


	/**
	 * Tests if the item is available based on status, time, language and currency
	 *
	 * @return bool True if available, false if not
	 */
	public function isAvailable() : bool
	{
		return parent::isAvailable() && $this->getStatus() > 0;
	}


	/**
	 * Checks, whether this node was modified.
	 *
	 * @return bool True if the content of the node is modified, false if not
	 */
	public function isModified() : bool
	{
		return parent::isModified() || $this->node->isModified();
	}


	/*
	 * Sets the item values from the given array and removes that entries from the list
	 *
	 * @param array &$list Associative list of item keys and their values
	 * @param bool True to set private properties too, false for public only
	 * @return \Aimeos\MShop\Catalog\Item\Iface Catalog item for chaining method calls
	 */
	public function fromArray( array &$list, bool $private = false ) : \Aimeos\MShop\Common\Item\Iface
	{
		$item = parent::fromArray( $list, $private );

		foreach( $list as $key => $value )
		{
			switch( $key )
			{
				case 'catalog.url': $item->setUrl( $value ); break;
				case 'catalog.code': $item->setCode( $value ); break;
				case 'catalog.label': $item->setLabel( $value ); break;
				case 'catalog.target': $item->setTarget( $value ); break;
				case 'catalog.status': $item->setStatus( (int) $value ); break;
				case 'catalog.config': $item->setConfig( (array) $value ); break;
				case 'catalog.id': !$private ?: $item->setId( $value ); break;
				default: continue 2;
			}

			unset( $list[$key] );
		}

		return $item;
	}


	/**
	 * Returns the public values of the node as array.
	 *
	 * @param bool True to return private properties, false for public only
	 * @return array Assciative list of key/value pairs
	 */
	public function toArray( bool $private = false ) : array
	{
		$list = [
			'catalog.url' => $this->getUrl(),
			'catalog.code' => $this->getCode(),
			'catalog.label' => $this->getLabel(),
			'catalog.config' => $this->getConfig(),
			'catalog.status' => $this->getStatus(),
			'catalog.target' => $this->getTarget(),
			'catalog.hasChildren' => $this->hasChildren(),
		];

		if( $private === true )
		{
			$list['catalog.id'] = $this->getId();
			$list['catalog.level'] = $this->getLevel();
			$list['catalog.siteid'] = $this->getSiteId();
			$list['catalog.parentid'] = $this->getParentId();
			$list['catalog.ctime'] = $this->getTimeCreated();
			$list['catalog.mtime'] = $this->getTimeModified();
			$list['catalog.editor'] = $this->editor();
		}

		return $list;
	}


	/**
	 * Returns the node and its children as list
	 *
	 * @return \Aimeos\Map List of IDs as keys and items implementing \Aimeos\MShop\Catalog\Item\Iface
	 */
	public function toList() : \Aimeos\Map
	{
		$list = map( [$this->getId() => $this] );

		foreach( $this->getChildren() as $child ) {
			$list = $list->union( $child->toList() );
		}

		return $list;
	}
}


1			<?php
2
3			/**
4			* @license LGPLv3, https://opensource.org/licenses/LGPL-3.0
5			* @copyright Metaways Infosystems GmbH, 2011
6			* @copyright Aimeos (aimeos.org), 2015-2025
7			* @package MShop
8			* @subpackage Catalog
9			*/
10
11
12			namespace Aimeos\MShop\Catalog\Item;
13
14			use \Aimeos\MShop\Common\Item\Config;
			0 ignored issues – show Bug introduced 2022-07-05 10:43 UTC by Report Bug Copy Issue Report The type `\Aimeos\MShop\Common\Item\Config` was not found. Maybe you did not declare it correctly or list all dependencies? The issue could also be caused by a filter entry in the build configuration. If the path has been excluded in your configuration, e.g. `excluded_paths: ["lib/"]`, you can move it to the dependency path list as follows: filter: dependency_paths: ["lib/"] For further information see https://scrutinizer-ci.com/docs/tools/php/php-scrutinizer/#list-dependency-paths Loading history...
15			use \Aimeos\MShop\Common\Item\ListsRef;
			0 ignored issues – show Bug introduced 2022-07-05 10:43 UTC by Report Bug Copy Issue Report The type `\Aimeos\MShop\Common\Item\ListsRef` was not found. Maybe you did not declare it correctly or list all dependencies? The issue could also be caused by a filter entry in the build configuration. If the path has been excluded in your configuration, e.g. `excluded_paths: ["lib/"]`, you can move it to the dependency path list as follows: filter: dependency_paths: ["lib/"] For further information see https://scrutinizer-ci.com/docs/tools/php/php-scrutinizer/#list-dependency-paths Loading history...
16
17
18			/**
19			* Generic interface for catalog items.
20			*
21			* @package MShop
22			* @subpackage Catalog
23			*/
24			class Standard
25			extends \Aimeos\MShop\Common\Item\Base
26			implements \Aimeos\MShop\Catalog\Item\Iface
27			{
28			use Config\Traits, ListsRef\Traits {
			0 ignored issues – show Bug introduced 2022-07-05 10:43 UTC by Report Bug Copy Issue Report The type `\Aimeos\MShop\Common\Item\Config\Traits` was not found. Maybe you did not declare it correctly or list all dependencies? The issue could also be caused by a filter entry in the build configuration. If the path has been excluded in your configuration, e.g. `excluded_paths: ["lib/"]`, you can move it to the dependency path list as follows: filter: dependency_paths: ["lib/"] For further information see https://scrutinizer-ci.com/docs/tools/php/php-scrutinizer/#list-dependency-paths Loading history... Bug introduced 2022-07-05 10:43 UTC by Report Bug Copy Issue Report The type `\Aimeos\MShop\Common\Item\ListsRef\Traits` was not found. Maybe you did not declare it correctly or list all dependencies? The issue could also be caused by a filter entry in the build configuration. If the path has been excluded in your configuration, e.g. `excluded_paths: ["lib/"]`, you can move it to the dependency path list as follows: filter: dependency_paths: ["lib/"] For further information see https://scrutinizer-ci.com/docs/tools/php/php-scrutinizer/#list-dependency-paths Loading history...
29			ListsRef\Traits::__clone as __cloneList;
30			ListsRef\Traits::getName as getNameList;
31			}
32
33
34			private \Aimeos\MW\Tree\Node\Iface $node;
35			private array $deletedItems = [];
36			private array $children;
37
38
39			/**
40			* Initializes the catalog item.
41			*
42			* @param \Aimeos\MW\Tree\Node\Iface $node Tree node
43			* @param array $values Assoicative list of key/value pairs
44			* @param \Aimeos\MShop\Catalog\Item\Iface[] $children List of children of the item
45			* @param \Aimeos\MShop\Common\Item\Lists\Iface[] $listItems List of list items
46			* @param \Aimeos\MShop\Common\Item\Iface[] $refItems List of referenced items
47			*/
48			public function __construct( \Aimeos\MW\Tree\Node\Iface $node, array $values = [], array $children = [],
49			array $listItems = [], array $refItems = [] )
50			{
51			parent::__construct( '', $values );
52
53			map( $children )->implements( \Aimeos\MShop\Catalog\Item\Iface::class, true );
54
55			$this->initListItems( $listItems, $refItems );
56			$this->children = $children;
57			$this->node = $node;
58			}
59
60
61			/**
62			* Clones internal objects of the catalog item.
63			*/
64			public function __clone()
65			{
66			parent::__clone();
67			$this->__cloneList();
68			$this->node = clone $this->node;
69			}
70
71
72			/**
73			* Tests if the item property for the given name is available
74			*
75			* @param string $name Name of the property
76			* @return bool True if the property exists, false if not
77			*/
78			public function __isset( string $name ) : bool
79			{
80			if( $name === 'children' ) {
81			return true;
82			}
83
84			return parent::__isset( $name ) ?: isset( $this->node->$name );
85			}
86
87
88			/**
89			* Returns the item property for the given name
90			*
91			* @param string $name Name of the property
92			* @param mixed $default Default value if property is unknown
93			* @return mixed\|null Property value or default value if property is unknown
94			*/
95			public function get( string $name, $default = null )
96			{
97			if( $name === 'children' ) {
98			return $this->children;
99			}
100
101			if( ( $value = parent::get( $name ) ) !== null ) {
102			return $value;
103			}
104
105			return $this->node->$name ?? $default;
106			}
107
108
109			/**
110			* Returns the unique ID of the node.
111			*
112			* @return string\|null Unique ID of the node
113			*/
114			public function getId() : ?string
115			{
116			return $this->node->getId();
117			}
118
119
120			/**
121			* Sets the unique ID of the node.
122			*
123			* @param string\|null $id Unique ID of the node
124			* @return \Aimeos\MShop\Catalog\Item\Iface Catalog item for chaining method calls
125			*/
126			public function setId( ?string $id = null ) : \Aimeos\MShop\Common\Item\Iface
127			{
128			$this->node->setId( $id );
129			return $this;
130			}
131
132
133			/**
134			* Returns the site ID of the item.
135			*
136			* @return string Site ID of the item
137			*/
138			public function getSiteId() : string
139			{
140			return (string) $this->node->siteid;
141			}
142
143
144			/**
145			* Returns the internal name of the item.
146			*
147			* @return string Name of the item
148			*/
149			public function getLabel() : string
150			{
151			return $this->node->getLabel();
152			}
153
154
155			/**
156			* Sets the new internal name of the item.
157			*
158			* @param string $name New name of the item
159			* @return \Aimeos\MShop\Catalog\Item\Iface Catalog item for chaining method calls
160			*/
161			public function setLabel( string $name ) : \Aimeos\MShop\Common\Item\Tree\Iface
162			{
163			$this->node->setLabel( $name );
164			return $this;
165			}
166
167
168			/**
169			* Returns the localized text type of the item or the internal label if no name is available.
170			*
171			* @param string $type Text type to be returned
172			* @param string\|null $langId Two letter ISO Language code of the text
173			* @return string Specified text type or label of the item
174			*/
175			public function getName( string $type = 'name', ?string $langId = null ) : string
176			{
177			$name = $this->getNameList( $type, $langId );
178
179			if( $type === 'url' && $name === $this->getLabel() ) {
180			return $this->getUrl();
181			}
182
183			return $name;
184			}
185
186
187			/**
188			* Returns the URL segment for the catalog item.
189			*
190			* @return string URL segment of the catalog item
191			*/
192			public function getUrl() : string
193			{
194			return (string) ( $this->node->url ?: \Aimeos\Base\Str::slug( $this->getLabel() ) );
195			}
196
197
198			/**
199			* Sets a new URL segment for the catalog.
200			*
201			* @param string\|null $url New URL segment of the catalog item
202			* @return \Aimeos\MShop\Catalog\Item\Iface Catalog item for chaining method calls
203			*/
204			public function setUrl( ?string $url ) : \Aimeos\MShop\Catalog\Item\Iface
205			{
206			$this->node->url = (string) $url;
207			return $this;
208			}
209
210
211			/**
212			* Returns the config property of the catalog.
213			*
214			* @return array Returns the config of the catalog node
215			*/
216			public function getConfig() : array
217			{
218			return (array) $this->get( 'config', [] );
219			}
220
221
222			/**
223			* Sets the config property of the catalog item.
224			*
225			* @param array $config Configuration to be set for the catalog node
226			* @return \Aimeos\MShop\Catalog\Item\Iface Catalog item for chaining method calls
227			*/
228			public function setConfig( array $config ) : \Aimeos\MShop\Common\Item\Iface
229			{
230			if( !$this->compareConfig( $this->getConfig(), $config ) ) {
231			$this->set( 'config', $config );
232			}
233
234			return $this;
235			}
236
237
238			/**
239			* Returns the code of the item.
240			*
241			* @return string Code of the item
242			*/
243			public function getCode() : string
244			{
245			return $this->node->getCode();
246			}
247
248
249			/**
250			* Sets the new code of the item.
251			*
252			* @param string $code New code of the item
253			* @return \Aimeos\MShop\Catalog\Item\Iface Catalog item for chaining method calls
254			*/
255			public function setCode( string $code ) : \Aimeos\MShop\Common\Item\Tree\Iface
256			{
257			$this->node->setCode( \Aimeos\Utils::code( $code ) );
258			return $this;
259			}
260
261
262			/**
263			* Returns the status of the item.
264			*
265			* @return int Greater than zero if enabled, zero or negative values if disabled
266			*/
267			public function getStatus() : int
268			{
269			return $this->node->getStatus();
270			}
271
272
273			/**
274			* Sets the new status of the item.
275			*
276			* @param int $status True if enabled, false if not
277			* @return \Aimeos\MShop\Catalog\Item\Iface Catalog item for chaining method calls
278			*/
279			public function setStatus( int $status ) : \Aimeos\MShop\Common\Item\Iface
280			{
281			$this->node->setStatus( $status );
282			return $this;
283			}
284
285
286			/**
287			* Returns the URL target specific for that category
288			*
289			* @return string URL target specific for that category
290			*/
291			public function getTarget() : string
292			{
293			return (string) $this->node->target;
294			}
295
296
297			/**
298			* Sets a new URL target specific for that category
299			*
300			* @param string $value New URL target specific for that category
301			* @return \Aimeos\MShop\Catalog\Item\Iface Catalog item for chaining method calls
302			*/
303			public function setTarget( ?string $value ) : \Aimeos\MShop\Catalog\Item\Iface
304			{
305			$this->node->target = (string) $value;
306			return $this;
307			}
308
309
310			/**
311			* Returns modify date/time of the order item base product.
312			*
313			* @return string\|null Returns modify date/time of the order base item
314			*/
315			public function getTimeModified() : ?string
316			{
317			return $this->node->mtime;
318			}
319
320
321			/**
322			* Returns the create date of the item.
323			*
324			* @return string\|null ISO date in YYYY-MM-DD hh:mm:ss format
325			*/
326			public function getTimeCreated() : ?string
327			{
328			return $this->node->ctime;
329			}
330
331
332			/**
333			* Returns the editor code of editor who created/modified the item at last.
334			*
335			* @return string Editor who created/modified the item at last
336			*/
337			public function editor() : string
338			{
339			return (string) $this->node->editor;
340			}
341
342
343			/**
344			* Adds a child node to this node.
345			*
346			* @param \Aimeos\MShop\Common\Item\Tree\Iface $item Child node to add
347			* @return \Aimeos\MShop\Common\Item\Tree\Iface Tree item for chaining method calls
348			*/
349			public function addChild( \Aimeos\MShop\Common\Item\Tree\Iface $item ) : \Aimeos\MShop\Common\Item\Tree\Iface
350			{
351			// don't set the modified flag as it's only for the values
352			$this->children[] = $item;
353
354			return $this;
355			}
356
357
358			/**
359			* Removes a child node from this node.
360			*
361			* @param \Aimeos\MShop\Common\Item\Tree\Iface $item Child node to remove
362			* @return \Aimeos\MShop\Common\Item\Tree\Iface Tree item for chaining method calls
363			*/
364			public function deleteChild( \Aimeos\MShop\Common\Item\Tree\Iface $item ) : \Aimeos\MShop\Common\Item\Tree\Iface
365			{
366			foreach( $this->children as $idx => $child )
367			{
368			if( $child === $item )
369			{
370			$this->deletedItems[] = $item;
371			unset( $this->children[$idx] );
372			}
373			}
374
375			return $this;
376			}
377
378
379			/**
380			* Returns a child of this node identified by its index.
381			*
382			* @param int $index Index of child node
383			* @return \Aimeos\MShop\Catalog\Item\Iface Selected node
384			*/
385			public function getChild( int $index ) : \Aimeos\MShop\Common\Item\Tree\Iface
386			{
387			if( isset( $this->children[$index] ) ) {
388			return $this->children[$index];
389			}
390
391			throw new \Aimeos\MShop\Catalog\Exception( sprintf( 'Child node with index "%1$d" not available', $index ) );
392			}
393
394
395			/**
396			* Returns all children of this node.
397			*
398			* @return \Aimeos\Map Numerically indexed list of children implementing \Aimeos\MShop\Catalog\Item\Iface
399			*/
400			public function getChildren() : \Aimeos\Map
401			{
402			return map( $this->children );
403			}
404
405
406			/**
407			* Returns the deleted children.
408			*
409			* @return \Aimeos\Map List of removed children implementing \Aimeos\MShop\Catalog\Item\Iface
410			*/
411			public function getChildrenDeleted() : \Aimeos\Map
412			{
413			return map( $this->deletedItems );
414			}
415
416
417			/**
418			* Tests if a node has children.
419			*
420			* @return bool True if node has children, false if not
421			*/
422			public function hasChildren() : bool
423			{
424			if( count( $this->children ) > 0 ) {
425			return true;
426			}
427
428			return $this->node->hasChildren();
429			}
430
431
432			/**
433			* Returns the internal node.
434			*
435			* For internal use only!
436			*
437			* @return \Aimeos\MW\Tree\Node\Iface Internal node object
438			*/
439			public function getNode() : \Aimeos\MW\Tree\Node\Iface
440			{
441			return $this->node;
442			}
443
444
445			/**
446			* Returns the level of the item in the tree
447			*
448			* For internal use only!
449			*
450			* @return int Level of the item starting with "0" for the root node
451			*/
452			public function getLevel() : int
453			{
454			return $this->node->level ?: 0;
455			}
456
457
458			/**
459			* Returns the ID of the parent category
460			*
461			* For internal use only!
462			*
463			* @return string\|null Unique ID of the parent category
464			*/
465			public function getParentId() : ?string
466			{
467			return $this->node->parentid;
468			}
469
470
471			/**
472			* Tests if the item is available based on status, time, language and currency
473			*
474			* @return bool True if available, false if not
475			*/
476			public function isAvailable() : bool
477			{
478			return parent::isAvailable() && $this->getStatus() > 0;
479			}
480
481
482			/**
483			* Checks, whether this node was modified.
484			*
485			* @return bool True if the content of the node is modified, false if not
486			*/
487			public function isModified() : bool
488			{
489			return parent::isModified() \|\| $this->node->isModified();
490			}
491
492
493			/*
494			* Sets the item values from the given array and removes that entries from the list
495			*
496			* @param array &$list Associative list of item keys and their values
497			* @param bool True to set private properties too, false for public only
498			* @return \Aimeos\MShop\Catalog\Item\Iface Catalog item for chaining method calls
499			*/
500			public function fromArray( array &$list, bool $private = false ) : \Aimeos\MShop\Common\Item\Iface
501			{
502			$item = parent::fromArray( $list, $private );
503
504			foreach( $list as $key => $value )
505			{
506			switch( $key )
507			{
508			case 'catalog.url': $item->setUrl( $value ); break;
509			case 'catalog.code': $item->setCode( $value ); break;
510			case 'catalog.label': $item->setLabel( $value ); break;
511			case 'catalog.target': $item->setTarget( $value ); break;
512			case 'catalog.status': $item->setStatus( (int) $value ); break;
513			case 'catalog.config': $item->setConfig( (array) $value ); break;
514			case 'catalog.id': !$private ?: $item->setId( $value ); break;
515			default: continue 2;
516			}
517
518			unset( $list[$key] );
519			}
520
521			return $item;
522			}
523
524
525			/**
526			* Returns the public values of the node as array.
527			*
528			* @param bool True to return private properties, false for public only
529			* @return array Assciative list of key/value pairs
530			*/
531			public function toArray( bool $private = false ) : array
532			{
533			$list = [
534			'catalog.url' => $this->getUrl(),
535			'catalog.code' => $this->getCode(),
536			'catalog.label' => $this->getLabel(),
537			'catalog.config' => $this->getConfig(),
538			'catalog.status' => $this->getStatus(),
539			'catalog.target' => $this->getTarget(),
540			'catalog.hasChildren' => $this->hasChildren(),
541			];
542
543			if( $private === true )
544			{
545			$list['catalog.id'] = $this->getId();
546			$list['catalog.level'] = $this->getLevel();
547			$list['catalog.siteid'] = $this->getSiteId();
548			$list['catalog.parentid'] = $this->getParentId();
549			$list['catalog.ctime'] = $this->getTimeCreated();
550			$list['catalog.mtime'] = $this->getTimeModified();
551			$list['catalog.editor'] = $this->editor();
552			}
553
554			return $list;
555			}
556
557
558			/**
559			* Returns the node and its children as list
560			*
561			* @return \Aimeos\Map List of IDs as keys and items implementing \Aimeos\MShop\Catalog\Item\Iface
562			*/
563			public function toList() : \Aimeos\Map
564			{
565			$list = map( [$this->getId() => $this] );
566
567			foreach( $this->getChildren() as $child ) {
568			$list = $list->union( $child->toList() );
569			}
570
571			return $list;
572			}
573			}
574

aimeos / aimeos-core

Standard::isModified() A last analyzed 2025-09-17 18:05 UTC

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like

Standard::isModified() A
last analyzed 2025-09-17 18:05 UTC