galleryalbums.class.php

一个用PHP编写的

<?php

	lt_include( PLOG_CLASS_PATH."class/dao/model.class.php" );
    lt_include( PLOG_CLASS_PATH."class/gallery/dao/galleryalbum.class.php" );
    lt_include( PLOG_CLASS_PATH."class/gallery/dao/galleryresources.class.php" );
	lt_include( PLOG_CLASS_PATH.'class/dao/daocacheconstants.properties.php' );
    
    /**
	 * \ingroup Gallery
	 *
     * Database access for GalleryAlbum objects.
	 *
	 * Please keep in mind that in the context of this library, every album has to have an user who
	 * owns it. When this library is used within pLog, users don't own albums but blogs do so we will
	 * use blog identifier instead of user identifiers. The reason for this change on how things are
	 * called was that this library can also be used outside pLog, and outside pLog we will most likely
	 * not have blogs but users.
	 *
	 * @see GalleryAlbum
	 * @see Model
     */
    class GalleryAlbums extends Model
    {

    	var $_childAlbums;
        var $resources;

		/**
		 * Constructor. Calls the Model constructor and does nothing more.
		 */
    	function GalleryAlbums()
        {
        	$this->Model();
            $this->_childAlbums = Array();
			
			$this->table = $this->getPrefix()."gallery_albums";
        }

        /**
         * Returns an array with all the albums that belong to the given
         * owner
         *
         * @param ownerId The identifier of the owner whose albums we'd like to fetch
         * @param onlyShownAlbums Returns only those albums that have the show_album
         * field set to true, or all of them otherwise
		 * @param page The page we'd like to see
		 * @param itemsPerPage number of items per page
		 * @return An array containing GalleryAlbum objects, representing the
         * albums we fetched from the db.
         */
        function getUserAlbums( $ownerId, $onlyShownAlbums = false, $page = DEFAULT_PAGING_ENABLED, $itemsPerPage = DEFAULT_ITEMS_PER_PAGE )
        {
        	$albums = $this->getMany( "owner_id",
        	                          $ownerId,
        	                          CACHE_USERALBUMS,
        	                          Array( CACHE_GALLERYALBUM => "getId" ),
									  Array( "date" => "ASC" ),
									  "",
        	                          $page,
        	                          $itemsPerPage );
        	if( !$albums )
        		return Array();
        		
        	$result = Array();
			if( $onlyShownAlbums ) {
				foreach( $albums as $album ) {
					if( $album->getShowAlbum())
						$result[] = $album;
				}
			}
			else
				$result = $albums;
				
			return( $result );
        }       

		/**
		 * Returns a specific album from the database.
		 *
		 * @param id A valid album identifier.
		 * @param ownerId (optional) The album should have the given id _and_ it should
		 * belong to the given user.
		 * @param fetchResources (optional) Whether at the same time, we should also fetch the
		 * resources that are associated to this album. Set it to 'false' if you only need
		 * to access the album and do not need to use methods such as GalleryAlbum::getResources()
		 * to fetch the resources that have been categorized under this album. It of course
		 * saves resources and database queries.
		 * @param onlyShownAlbums Forces to retrieve only the albums that have been set to appear
		 * in the main page. If set to 'true', we will generate an error if the album exists, 
		 * has the specified id and belongs to the specified user _but_ it is not supposed to be 
		 * shown in the main page.
		 * @return Returns a valid GalleryAlbum object or 'false' if the album could not be found.
		 */
        function getAlbum( $id, $ownerId = -1, $fetchResources = true, $onlyShownAlbums = false )
        {
        	$album = $this->get( "id", $id, CACHE_GALLERYALBUM );
        	if( !$album )
        		return false;
        	if( $ownerId > -1 && $album->getOwnerId() != $ownerId )
        		return false;
        	if( $onlyShownAlbums && !$album->getShowAlbum())
        		return false;
        		
        	return( $album );
        }
		
		/**
		 * Returns a specific album from the database given its 'mangled name'
		 *
		 * @param id A valid album identifier.
		 * @param ownerId (optional) The album should have the given id _and_ it should
		 * belong to the given user.
		 * @param fetchResources (optional) Whether at the same time, we should also fetch the
		 * resources that are associated to this album. Set it to 'false' if you only need
		 * to access the album and do not need to use methods such as GalleryAlbum::getResources()
		 * to fetch the resources that have been categorized under this album. It of course
		 * saves resources and database queries.
		 * @param onlyShownAlbums Forces to retrieve only the albums that have been set to appear
		 * in the main page. If set to 'true', we will generate an error if the album exists, 
		 * has the specified id and belongs to the specified user _but_ it is not supposed to be 
		 * shown in the main page.
		 * @return Returns a valid GalleryAlbum object or 'false' if the album could not be found.
		 */
		function getAlbumByName( $id, $ownerId = -1, $fetchResources = true, $onlyShownAlbums = false )
		{
			// there might be more than one with the same name...
        	$albums = $this->getMany( "mangled_name", $id, CACHE_GALLERYALBUMBYNAME );
			$found = false;
			foreach( $albums as $album ) {
				if( $this->check( $album, $ownerId, $onlyShownAlbums )) {
					$found = true;
					break;
				}
			}
			        		
        	return( $album );		
		}

		/**
		 * @private
		 */
		function check( $album, $ownerId = -1, $onlyShownAlbums = false )
		{
			if( $ownerId > -1 && $album->getOwnerId() != $ownerId )
				return false;
			if( $onlyShownAlbums && !$album->getShowAlbum())
				return false;
				
			return( true );
		}
				
		
        /**
         * Returns an array with all the child albums of the given album, but only
         * the ones at the first level (it is not recursive!)
         *
         * @param albumId The album identfitier whose children we'd like to get.
		 * @param ownerId To whom should this album belong.
         * @param onlyShownAlbums Returns only those albums that have the show_album
         * field set to true, or all of them otherwise
         * @return An array of GalleryAlbum objects
         */
        function getChildAlbums( $albumId, $ownerId, $onlyShownAlbums = false )
        {
        	$albums = $this->getUserAlbums( $ownerId, $onlyShownAlbums );
			
			// return an empty array if there are no albums
        	if( !$albums )
        		return Array();
				
        	$result = Array();
        	foreach( $albums as $album ) {
        		if( $album->getParentId() == $albumId )
        			$result[] = $album;
        	}
        	
        	return( $result );
        }

        /**
         * Returns an array with all the parent album ids of the given album
         *
         * @param album The album object whose parents we'd like to get.
         * @return An array of GalleryAlbum Id
         */        
		function getAllParentAlbumIds( $album ) {
		            
		    $currentParentId = $album->getParentId();
		    $parentAlbumsIds = array();
		
		    while ( $currentParentId != 0 ) {
		        $parentAlbumsIds[] = $currentParentId;
		        $parentAlbum = $this->getAlbum( $currentParentId, -1, false, false );
		        $currentParentId = $parentAlbum->getParentId();
		    }
		    return $parentAlbumsIds;
		}
		
        /**
         * Adds an album to the database
         *
		 * @param album A GalleryAlbum object, with all its data filled in
		 * @return Returns true if successful or false otherwise.
		 * @see GAlleryAlbum
         */
		function addAlbum( &$album )
        {        	
        	if(( $result = $this->add( $album ))) {
    	        $this->_cache->removeData( $album->getOwnerId(), CACHE_USERALBUMS );
    	        $this->_cache->removeData( $album->getOwnerId(), CACHE_USERALBUMS_NESTED );    	        
    	        if( $album->getParentId() > 0 ) {
	    	        // update the counters of the parent if there's any
    	        	$parent = $album->getParent();
    	        	if( $parent ) {
	    	        	$parent->setNumChildren( $parent->getNumChildren() + 1 );
    		        	$this->updateAlbum( $parent );
    		        }
    	        }
    	    }
            
            return $result;
        }