8 * This source file is subject to the new BSD license that is bundled
9 * with this package in the file LICENSE.txt.
10 * It is also available through the world-wide-web at this URL:
11 * http://framework.zend.com/license/new-bsd
12 * If you did not receive a copy of the license and are unable to
13 * obtain it through the world-wide-web, please send an email
14 * to license@zend.com so we can send you a copy immediately.
19 * @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
20 * @license http://framework.zend.com/license/new-bsd New BSD License
25 * @see Zend_Gdata_Extension
27 require_once 'Zend/Gdata/Extension.php';
30 * @see Zend_Gdata_Entry
32 require_once 'Zend/Gdata/Entry.php';
35 * @see Zend_Gdata_Media_Extension_MediaContent
37 require_once 'Zend/Gdata/Media/Extension/MediaContent.php';
40 * @see Zend_Gdata_Media_Extension_MediaCategory
42 require_once 'Zend/Gdata/Media/Extension/MediaCategory.php';
45 * @see Zend_Gdata_Media_Extension_MediaCopyright
47 require_once 'Zend/Gdata/Media/Extension/MediaCopyright.php';
50 * @see Zend_Gdata_Media_Extension_MediaCredit
52 require_once 'Zend/Gdata/Media/Extension/MediaCredit.php';
55 * @see Zend_Gdata_Media_Extension_MediaDescription
57 require_once 'Zend/Gdata/Media/Extension/MediaDescription.php';
60 * @see Zend_Gdata_Media_Extension_MediaHash
62 require_once 'Zend/Gdata/Media/Extension/MediaHash.php';
65 * @see Zend_Gdata_Media_Extension_MediaKeywords
67 require_once 'Zend/Gdata/Media/Extension/MediaKeywords.php';
70 * @see Zend_Gdata_Media_Extension_MediaPlayer
72 require_once 'Zend/Gdata/Media/Extension/MediaPlayer.php';
75 * @see Zend_Gdata_Media_Extension_MediaRating
77 require_once 'Zend/Gdata/Media/Extension/MediaRating.php';
80 * @see Zend_Gdata_Media_Extension_MediaRestriction
82 require_once 'Zend/Gdata/Media/Extension/MediaRestriction.php';
85 * @see Zend_Gdata_Media_Extension_MediaText
87 require_once 'Zend/Gdata/Media/Extension/MediaText.php';
90 * @see Zend_Gdata_Media_Extension_MediaThumbnail
92 require_once 'Zend/Gdata/Media/Extension/MediaThumbnail.php';
95 * @see Zend_Gdata_Media_Extension_MediaTitle
97 require_once 'Zend/Gdata/Media/Extension/MediaTitle.php';
101 * This class represents the media:group element of Media RSS.
102 * It allows the grouping of media:content elements that are
103 * different representations of the same content. When it exists,
104 * it is a child of an Entry (Atom) or Item (RSS).
107 * @package Zend_Gdata
109 * @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
110 * @license http://framework.zend.com/license/new-bsd New BSD License
112 class Zend_Gdata_Media_Extension_MediaGroup extends Zend_Gdata_Extension
115 protected $_rootElement = 'group';
116 protected $_rootNamespace = 'media';
121 protected $_content = array();
126 protected $_category = array();
129 * @var Zend_Gdata_Media_Extension_MediaCopyright
131 protected $_copyright = null;
136 protected $_credit = array();
139 * @var Zend_Gdata_Media_Extension_MediaDescription
141 protected $_description = null;
146 protected $_hash = array();
149 * @var Zend_Gdata_Media_Extension_MediaKeywords
151 protected $_keywords = null;
156 protected $_player = array();
161 protected $_rating = array();
166 protected $_restriction = array();
171 protected $_mediaText = array();
176 protected $_thumbnail = array();
181 protected $_title = null;
184 * Creates an individual MediaGroup object.
186 public function __construct($element = null)
188 $this->registerAllNamespaces(Zend_Gdata_Media::$namespaces);
189 parent::__construct($element);
193 * Retrieves a DOMElement which corresponds to this element and all
194 * child properties. This is used to build an entry back into a DOM
195 * and eventually XML text for sending to the server upon updates, or
196 * for application storage/persistence.
198 * @param DOMDocument $doc The DOMDocument used to construct DOMElements
199 * @return DOMElement The DOMElement representing this element and all
202 public function getDOM($doc = null, $majorVersion = 1, $minorVersion = null)
204 $element = parent::getDOM($doc, $majorVersion, $minorVersion);
205 foreach ($this->_content as $content) {
206 $element->appendChild($content->getDOM($element->ownerDocument));
208 foreach ($this->_category as $category) {
209 $element->appendChild($category->getDOM($element->ownerDocument));
211 foreach ($this->_credit as $credit) {
212 $element->appendChild($credit->getDOM($element->ownerDocument));
214 foreach ($this->_player as $player) {
215 $element->appendChild($player->getDOM($element->ownerDocument));
217 foreach ($this->_rating as $rating) {
218 $element->appendChild($rating->getDOM($element->ownerDocument));
220 foreach ($this->_restriction as $restriction) {
221 $element->appendChild($restriction->getDOM($element->ownerDocument));
223 foreach ($this->_mediaText as $text) {
224 $element->appendChild($text->getDOM($element->ownerDocument));
226 foreach ($this->_thumbnail as $thumbnail) {
227 $element->appendChild($thumbnail->getDOM($element->ownerDocument));
229 if ($this->_copyright != null) {
230 $element->appendChild(
231 $this->_copyright->getDOM($element->ownerDocument));
233 if ($this->_description != null) {
234 $element->appendChild(
235 $this->_description->getDOM($element->ownerDocument));
237 foreach ($this->_hash as $hash) {
238 $element->appendChild($hash->getDOM($element->ownerDocument));
240 if ($this->_keywords != null) {
241 $element->appendChild(
242 $this->_keywords->getDOM($element->ownerDocument));
244 if ($this->_title != null) {
245 $element->appendChild(
246 $this->_title->getDOM($element->ownerDocument));
252 * Creates individual Entry objects of the appropriate type and
253 * stores them in the $_entry array based upon DOM data.
255 * @param DOMNode $child The DOMNode to process
257 protected function takeChildFromDOM($child)
259 $absoluteNodeName = $child->namespaceURI . ':' . $child->localName;
260 switch ($absoluteNodeName) {
261 case $this->lookupNamespace('media') . ':' . 'content';
262 $content = new Zend_Gdata_Media_Extension_MediaContent();
263 $content->transferFromDOM($child);
264 $this->_content[] = $content;
266 case $this->lookupNamespace('media') . ':' . 'category';
267 $category = new Zend_Gdata_Media_Extension_MediaCategory();
268 $category->transferFromDOM($child);
269 $this->_category[] = $category;
271 case $this->lookupNamespace('media') . ':' . 'copyright';
272 $copyright = new Zend_Gdata_Media_Extension_MediaCopyright();
273 $copyright->transferFromDOM($child);
274 $this->_copyright = $copyright;
276 case $this->lookupNamespace('media') . ':' . 'credit';
277 $credit = new Zend_Gdata_Media_Extension_MediaCredit();
278 $credit->transferFromDOM($child);
279 $this->_credit[] = $credit;
281 case $this->lookupNamespace('media') . ':' . 'description';
282 $description = new Zend_Gdata_Media_Extension_MediaDescription();
283 $description->transferFromDOM($child);
284 $this->_description = $description;
286 case $this->lookupNamespace('media') . ':' . 'hash';
287 $hash = new Zend_Gdata_Media_Extension_MediaHash();
288 $hash->transferFromDOM($child);
289 $this->_hash[] = $hash;
291 case $this->lookupNamespace('media') . ':' . 'keywords';
292 $keywords = new Zend_Gdata_Media_Extension_MediaKeywords();
293 $keywords->transferFromDOM($child);
294 $this->_keywords = $keywords;
296 case $this->lookupNamespace('media') . ':' . 'player';
297 $player = new Zend_Gdata_Media_Extension_MediaPlayer();
298 $player->transferFromDOM($child);
299 $this->_player[] = $player;
301 case $this->lookupNamespace('media') . ':' . 'rating';
302 $rating = new Zend_Gdata_Media_Extension_MediaRating();
303 $rating->transferFromDOM($child);
304 $this->_rating[] = $rating;
306 case $this->lookupNamespace('media') . ':' . 'restriction';
307 $restriction = new Zend_Gdata_Media_Extension_MediaRestriction();
308 $restriction->transferFromDOM($child);
309 $this->_restriction[] = $restriction;
311 case $this->lookupNamespace('media') . ':' . 'text';
312 $text = new Zend_Gdata_Media_Extension_MediaText();
313 $text->transferFromDOM($child);
314 $this->_mediaText[] = $text;
316 case $this->lookupNamespace('media') . ':' . 'thumbnail';
317 $thumbnail = new Zend_Gdata_Media_Extension_MediaThumbnail();
318 $thumbnail->transferFromDOM($child);
319 $this->_thumbnail[] = $thumbnail;
321 case $this->lookupNamespace('media') . ':' . 'title';
322 $title = new Zend_Gdata_Media_Extension_MediaTitle();
323 $title->transferFromDOM($child);
324 $this->_title = $title;
327 parent::takeChildFromDOM($child);
335 public function getContent()
337 return $this->_content;
341 * @param array $value
342 * @return Zend_Gdata_Media_MediaGroup Provides a fluent interface
344 public function setContent($value)
346 $this->_content = $value;
353 public function getCategory()
355 return $this->_category;
359 * @param array $value
360 * @return Zend_Gdata_Media_Extension_MediaGroup
362 public function setCategory($value)
364 $this->_category = $value;
369 * @return Zend_Gdata_Media_Extension_MediaCopyright
371 public function getCopyright()
373 return $this->_copyright;
377 * @param Zend_Gdata_Media_Extension_MediaCopyright $value
378 * @return Zend_Gdata_Media_Extension_MediaGroup
380 public function setCopyright($value)
382 $this->_copyright = $value;
389 public function getCredit()
391 return $this->_credit;
395 * @param array $value
396 * @return Zend_Gdata_Media_Extension_MediaGroup
398 public function setCredit($value)
400 $this->_credit = $value;
405 * @return Zend_Gdata_Media_Extension_MediaTitle
407 public function getTitle()
409 return $this->_title;
413 * @param Zend_Gdata_Media_Extension_MediaTitle $value
414 * @return Zend_Gdata_Media_Extension_MediaGroup
416 public function setTitle($value)
418 $this->_title = $value;
423 * @return Zend_Gdata_Media_Extension_MediaDescription
425 public function getDescription()
427 return $this->_description;
431 * @param Zend_Gdata_Media_Extension_MediaDescription $value
432 * @return Zend_Gdata_Media_Extension_MediaGroup
434 public function setDescription($value)
436 $this->_description = $value;
443 public function getHash()
449 * @param array $value
450 * @return Zend_Gdata_Media_Extension_MediaGroup
452 public function setHash($value)
454 $this->_hash = $value;
459 * @return Zend_Gdata_Media_Extension_MediaKeywords
461 public function getKeywords()
463 return $this->_keywords;
467 * @param array $value
468 * @return Zend_Gdata_Media_Extension_MediaGroup Provides a fluent interface
470 public function setKeywords($value)
472 $this->_keywords = $value;
479 public function getPlayer()
481 return $this->_player;
486 * @return Zend_Gdata_Media_Extension_MediaGroup
488 public function setPlayer($value)
490 $this->_player = $value;
497 public function getRating()
499 return $this->_rating;
504 * @return Zend_Gdata_Media_Extension_MediaGroup
506 public function setRating($value)
508 $this->_rating = $value;
515 public function getRestriction()
517 return $this->_restriction;
522 * @return Zend_Gdata_Media_Extension_MediaGroup
524 public function setRestriction($value)
526 $this->_restriction = $value;
533 public function getThumbnail()
535 return $this->_thumbnail;
540 * @return Zend_Gdata_Media_Extension_MediaGroup
542 public function setThumbnail($value)
544 $this->_thumbnail = $value;
551 public function getMediaText()
553 return $this->_mediaText;
558 * @return Zend_Gdata_Media_Extension_MediaGroup
560 public function setMediaText($value)
562 $this->_mediaText = $value;