File indexing completed on 2024-12-29 05:27:36

 <?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_Feed
  * @copyright  Copyright (c) 2005-2015 Zend Technologies USA Inc. (http://www.zend.com)
  * @license    http://framework.zend.com/license/new-bsd     New BSD License
  * @version    $Id$
  */
 
 
 /**
  * ITunes rss extension
  *
  * Classes used to describe the itunes channel extension
  *
  * @category   Zend
  * @package    Zend_Feed
  * @copyright  Copyright (c) 2005-2015 Zend Technologies USA Inc. (http://www.zend.com)
  * @license    http://framework.zend.com/license/new-bsd     New BSD License
  */
 class Zend_Feed_Builder_Header_Itunes extends ArrayObject
 {
     /**
      * Constructor
      *
      * @param  array $categories Categories columns and in iTunes Music Store Browse
      * @return void
      */
     public function __construct(array $categories)
     {
         $this->setCategories($categories);
     }
 
     /**
      * Sets the categories column and in iTunes Music Store Browse
      * $categories must conform to the following format:
      * <code>
      * array(array('main' => 'main category',
      *             'sub' => 'sub category' // optionnal
      *            ),
      *       // up to 3 rows
      *      )
      * </code>
      *
      * @param  array $categories
      * @return Zend_Feed_Builder_Header_Itunes
      * @throws Zend_Feed_Builder_Exception
      */
     public function setCategories(array $categories)
     {
         $nb = count($categories);
         if (0 === $nb) {
             /**
              * @see Zend_Feed_Builder_Exception
              */
             // require_once 'Zend/Feed/Builder/Exception.php';
             throw new Zend_Feed_Builder_Exception("you have to set at least one itunes category");
         }
         if ($nb > 3) {
             /**
              * @see Zend_Feed_Builder_Exception
              */
             // require_once 'Zend/Feed/Builder/Exception.php';
             throw new Zend_Feed_Builder_Exception("you have to set at most three itunes categories");
         }
         foreach ($categories as $i => $category) {
             if (empty($category['main'])) {
                 /**
                  * @see Zend_Feed_Builder_Exception
                  */
                 // require_once 'Zend/Feed/Builder/Exception.php';
                 throw new Zend_Feed_Builder_Exception("you have to set the main category (category #$i)");
             }
         }
         $this->offsetSet('category', $categories);
         return $this;
     }
 
     /**
      * Sets the artist value, default to the feed's author value
      *
      * @param  string $author
      * @return Zend_Feed_Builder_Header_Itunes
      */
     public function setAuthor($author)
     {
         $this->offsetSet('author', $author);
         return $this;
     }
 
     /**
      * Sets the owner of the postcast
      *
      * @param  string $name  default to the feed's author value
      * @param  string $email default to the feed's email value
      * @return Zend_Feed_Builder_Header_Itunes
      * @throws Zend_Feed_Builder_Exception
      */
     public function setOwner($name = '', $email = '')
     {
         if (!empty($email)) {
             /**
              * @see Zend_Validate_EmailAddress
              */
             // require_once 'Zend/Validate/EmailAddress.php';
             $validate = new Zend_Validate_EmailAddress();
             if (!$validate->isValid($email)) {
                 /**
                  * @see Zend_Feed_Builder_Exception
                  */
                 // require_once 'Zend/Feed/Builder/Exception.php';
                 throw new Zend_Feed_Builder_Exception("you have to set a valid email address into the itunes owner's email property");
             }
         }
         $this->offsetSet('owner', array('name' => $name, 'email' => $email));
         return $this;
     }
 
     /**
      * Sets the album/podcast art picture
      * Default to the feed's image value
      *
      * @param  string $image
      * @return Zend_Feed_Builder_Header_Itunes
      */
     public function setImage($image)
     {
         $this->offsetSet('image', $image);
         return $this;
     }
 
     /**
      * Sets the short description of the podcast
      * Default to the feed's description
      *
      * @param  string $subtitle
      * @return Zend_Feed_Builder_Header_Itunes
      */
     public function setSubtitle($subtitle)
     {
         $this->offsetSet('subtitle', $subtitle);
         return $this;
     }
 
     /**
      * Sets the longer description of the podcast
      * Default to the feed's description
      *
      * @param  string $summary
      * @return Zend_Feed_Builder_Header_Itunes
      */
     public function setSummary($summary)
     {
         $this->offsetSet('summary', $summary);
         return $this;
     }
 
     /**
      * Prevent a feed from appearing
      *
      * @param  string $block can be 'yes' or 'no'
      * @return Zend_Feed_Builder_Header_Itunes
      * @throws Zend_Feed_Builder_Exception
      */
     public function setBlock($block)
     {
         $block = strtolower($block);
         if (!in_array($block, array('yes', 'no'))) {
             /**
              * @see Zend_Feed_Builder_Exception
              */
             // require_once 'Zend/Feed/Builder/Exception.php';
             throw new Zend_Feed_Builder_Exception("you have to set yes or no to the itunes block property");
         }
         $this->offsetSet('block', $block);
         return $this;
     }
 
     /**
      * Configuration of the parental advisory graphic
      *
      * @param  string $explicit can be 'yes', 'no' or 'clean'
      * @return Zend_Feed_Builder_Header_Itunes
      * @throws Zend_Feed_Builder_Exception
      */
     public function setExplicit($explicit)
     {
         $explicit = strtolower($explicit);
         if (!in_array($explicit, array('yes', 'no', 'clean'))) {
             /**
              * @see Zend_Feed_Builder_Exception
              */
             // require_once 'Zend/Feed/Builder/Exception.php';
             throw new Zend_Feed_Builder_Exception("you have to set yes, no or clean to the itunes explicit property");
         }
         $this->offsetSet('explicit', $explicit);
         return $this;
     }
 
     /**
      * Sets a comma separated list of 12 keywords maximum
      *
      * @param  string $keywords
      * @return Zend_Feed_Builder_Header_Itunes
      */
     public function setKeywords($keywords)
     {
         $this->offsetSet('keywords', $keywords);
         return $this;
     }
 
     /**
      * Sets the new feed URL location
      *
      * @param  string $url
      * @return Zend_Feed_Builder_Header_Itunes
      */
     public function setNewFeedUrl($url)
     {
         $this->offsetSet('new_feed_url', $url);
         return $this;
     }
 
     /**
      * Read only properties accessor
      *
      * @param  string $name property to read
      * @return mixed
      */
     public function __get($name)
     {
         if (!$this->offsetExists($name)) {
             return NULL;
         }
 
         return $this->offsetGet($name);
     }
 
     /**
      * Write properties accessor
      *
      * @param  string $name  name of the property to set
      * @param  mixed  $value value to set
      * @return void
      */
     public function __set($name, $value)
     {
         $this->offsetSet($name, $value);
     }
 
     /**
      * Isset accessor
      *
      * @param  string $key
      * @return boolean
      */
     public function __isset($key)
     {
         return $this->offsetExists($key);
     }
 
     /**
      * Unset accessor
      *
      * @param  string $key
      * @return void
      */
     public function __unset($key)
     {
         if ($this->offsetExists($key)) {
             $this->offsetUnset($key);
         }
     }
 
 }