Gdata/Photos/PhotoQuery.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 [email protected] so we can send you a copy immediately.
- Category
- Zend
- Copyright
- Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com)
- License
- New BSD License
- Package
- Zend_Gdata
- Subpackage
- Photos
- Version
- $Id: PhotoQuery.php 24593 2012-01-05 20:35:02Z matthew $
\Zend_Gdata_Photos_PhotoQuery
Assists in constructing queries for comment/tag entries.
Instances of this class can be provided in many places where a URL is required.
For information on submitting queries to a server, see the service class, Zend_Gdata_Photos.
- Parent(s)
- \Zend_Gdata_Photos_AlbumQuery < \Zend_Gdata_Photos_UserQuery < \Zend_Gdata_Query
- Category
- Zend
- Copyright
- Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com)
- License
- New BSD License
Properties


string $_albumId = null
Mutually exclusive with AlbumName.
null
Details- Type
- string
- Inherited_from
- \Zend_Gdata_Photos_AlbumQuery::$$_albumId


string $_albumName = null
The name of the album to query for.
Inherited from: \Zend_Gdata_Photos_AlbumQuery::$$_albumNameMutually exclusive with AlbumId.
null
Details- Type
- string
- Inherited_from
- \Zend_Gdata_Photos_AlbumQuery::$$_albumName


string $_category = null
Category for the query
Inherited from: \Zend_Gdata_Query::$$_category\Zend_Gdata_Photos_UserQuery::$$_category\Zend_Gdata_Photos_AlbumQuery::$$_categorynull
Details- Type
- string
- Inherited_from
- \Zend_Gdata_Query::$$_category
- Inherited_from
- \Zend_Gdata_Photos_UserQuery::$$_category
- Inherited_from
- \Zend_Gdata_Photos_AlbumQuery::$$_category


string $_defaultFeedUri = null
Default URL
Inherited from: \Zend_Gdata_Query::$$_defaultFeedUri\Zend_Gdata_Photos_UserQuery::$$_defaultFeedUri\Zend_Gdata_Photos_AlbumQuery::$$_defaultFeedUrinull
Details- Type
- string
- Inherited_from
- \Zend_Gdata_Query::$$_defaultFeedUri
- Inherited_from
- \Zend_Gdata_Photos_UserQuery::$$_defaultFeedUri
- Inherited_from
- \Zend_Gdata_Photos_AlbumQuery::$$_defaultFeedUri


array $_params = array()
Query parameters.
Inherited from: \Zend_Gdata_Query::$$_params\Zend_Gdata_Photos_UserQuery::$$_params\Zend_Gdata_Photos_AlbumQuery::$$_paramsarray()
Details- Type
- array
- Inherited_from
- \Zend_Gdata_Query::$$_params
- Inherited_from
- \Zend_Gdata_Photos_UserQuery::$$_params
- Inherited_from
- \Zend_Gdata_Photos_AlbumQuery::$$_params


string $_projection = 'api'
Indicates the format of data returned in Atom feeds.
Inherited from: \Zend_Gdata_Photos_UserQuery::$$_projection\Zend_Gdata_Photos_AlbumQuery::$$_projectionCan be either 'api' or 'base'. Default value is 'api'.
'api'
Details- Type
- string
- Inherited_from
- \Zend_Gdata_Photos_UserQuery::$$_projection
- Inherited_from
- \Zend_Gdata_Photos_AlbumQuery::$$_projection


string $_type = 'feed'
Indicates whether to request a feed or entry in queries.
Inherited from: \Zend_Gdata_Photos_UserQuery::$$_type\Zend_Gdata_Photos_AlbumQuery::$$_typeDefault value is 'feed';
'feed'
Details- Type
- string
- Inherited_from
- \Zend_Gdata_Photos_UserQuery::$$_type
- Inherited_from
- \Zend_Gdata_Photos_AlbumQuery::$$_type


string $_url = null
Base URL TODO: Add setters and getters
Inherited from: \Zend_Gdata_Query::$$_url\Zend_Gdata_Photos_UserQuery::$$_url\Zend_Gdata_Photos_AlbumQuery::$$_urlnull
Details- Type
- string
- Inherited_from
- \Zend_Gdata_Query::$$_url
- Inherited_from
- \Zend_Gdata_Photos_UserQuery::$$_url
- Inherited_from
- \Zend_Gdata_Photos_AlbumQuery::$$_url


string $_user = \Zend_Gdata_Photos::DEFAULT_USER
A string which, if not null, indicates which user should be retrieved by this query.
Inherited from: \Zend_Gdata_Photos_UserQuery::$$_user\Zend_Gdata_Photos_AlbumQuery::$$_userIf null, the default user will be used instead.
\Zend_Gdata_Photos::DEFAULT_USER
Details- Type
- string
- Inherited_from
- \Zend_Gdata_Photos_UserQuery::$$_user
- Inherited_from
- \Zend_Gdata_Photos_AlbumQuery::$$_user
Methods


__construct() : void
Create a new Query object with default values.
Inherited from: \Zend_Gdata_Photos_UserQuery::__construct()\Zend_Gdata_Photos_AlbumQuery::__construct()

__get( $name) : void
Name | Type | Description |
---|---|---|
$name |


__set( $name, $val) : void
Name | Type | Description |
---|---|---|
$name | ||
$val |


getAccess() : string
Get the visibility filter for entries returned.
Inherited from: \Zend_Gdata_Photos_UserQuery::getAccess()\Zend_Gdata_Photos_AlbumQuery::getAccess()Type | Description |
---|---|
string | The visibility to filter by, or null for the default user. |
- See
- \global\setAccess


getAlbumId() : string
Get the album ID which is to be returned.
Inherited from: \Zend_Gdata_Photos_AlbumQuery::getAlbumId()Type | Description |
---|---|
string | The ID of the album to retrieve. |
- See
- \global\setAlbum


getAlbumName() : string
Get the album name which is to be returned.
Inherited from: \Zend_Gdata_Photos_AlbumQuery::getAlbumName()Type | Description |
---|---|
string | The name of the album to retrieve. |
- See
- \global\setAlbumName


getAlt() : string
Type | Description |
---|---|
string | rss or atom |


getAuthor() : string
Type | Description |
---|---|
string | author |


getImgMax() : string
Get the maximum image size filter for entries returned.
Inherited from: \Zend_Gdata_Photos_UserQuery::getImgMax()\Zend_Gdata_Photos_AlbumQuery::getImgMax()Type | Description |
---|---|
string | The image size size to filter by, or null if no filter is to be applied. |
- See
- \global\setImgMax


getKind() : string
Get the kind of entries to be returned.
Inherited from: \Zend_Gdata_Photos_UserQuery::getKind()\Zend_Gdata_Photos_AlbumQuery::getKind()Type | Description |
---|---|
string | The kind to filter by, or null if no filter is to be applied. |
- See
- \global\setKind


getMaxResults() : int
Type | Description |
---|---|
int | maxResults |


getParam(string $name) : void
Name | Type | Description |
---|---|---|
$name | string |


getPhotoId() : string
Get the photo ID which is to be returned.
Type | Description |
---|---|
string | The ID of the photo to retrieve. |
- See
- \global\setPhoto


getProjection() : string
Gets the format of data in returned in Atom feeds.
Inherited from: \Zend_Gdata_Photos_UserQuery::getProjection()\Zend_Gdata_Photos_AlbumQuery::getProjection()Type | Description |
---|---|
string | projection |
- See
- \global\setProjection


getPublishedMax() : string
Type | Description |
---|---|
string | publishedMax |


getPublishedMin() : string
Type | Description |
---|---|
string | publishedMin |


getQuery() : string
Type | Description |
---|---|
string | query |


getQueryString() : string
Type | Description |
---|---|
string | querystring |


getQueryUrl( $incomingUri = '') : string
Returns the URL generated for this query, based on it's current parameters.
Name | Type | Description |
---|---|---|
$incomingUri |
Type | Description |
---|---|
string | A URL generated based on the state of this query. |
Exception | Description |
---|---|
\Zend_Gdata_App_InvalidArgumentException |


getStartIndex() : int
Type | Description |
---|---|
int | startIndex |


getTag() : string
Get the tag filter for entries returned.
Inherited from: \Zend_Gdata_Photos_UserQuery::getTag()\Zend_Gdata_Photos_AlbumQuery::getTag()Type | Description |
---|---|
string | The tag to filter by, or null if no filter is to be applied. |
- See
- \global\setTag


getThumbsize() : string
Get the thumbnail size filter for entries returned.
Inherited from: \Zend_Gdata_Photos_UserQuery::getThumbsize()\Zend_Gdata_Photos_AlbumQuery::getThumbsize()Type | Description |
---|---|
string | The thumbnail size to filter by, or null if no filter is to be applied. |
- See
- \global\setThumbsize


getType() : string
Gets the type of data in returned in queries.
Inherited from: \Zend_Gdata_Photos_UserQuery::getType()\Zend_Gdata_Photos_AlbumQuery::getType()Type | Description |
---|---|
string | type |
- See
- \global\setType


getUpdatedMax() : string
Type | Description |
---|---|
string | updatedMax |


getUpdatedMin() : string
Type | Description |
---|---|
string | updatedMin |


getUser() : string
Get the user which is to be returned.
Inherited from: \Zend_Gdata_Photos_UserQuery::getUser()\Zend_Gdata_Photos_AlbumQuery::getUser()Type | Description |
---|---|
string | The visibility to retrieve. |
- See
- \global\setUser


resetParameters() : void


setAccess(string $value) : void
Set the visibility filter for entries returned.
Inherited from: \Zend_Gdata_Photos_UserQuery::setAccess()\Zend_Gdata_Photos_AlbumQuery::setAccess()Only entries which match this value will be returned. If null or unset, the default value will be used instead.
Valid values are 'all' (default), 'public', and 'private'.
Name | Type | Description |
---|---|---|
$value | string | The visibility to filter by, or null to use the default value. |


setAlbumId(string $value) : \Zend_Gdata_Photos_AlbumQuery
When set, this album's photographs be returned. If not set or null, the default user's feed will be returned instead.
NOTE: Album and AlbumId are mutually exclusive. Setting one will automatically set the other to null.
Name | Type | Description |
---|---|---|
$value | string | The ID of the album to retrieve, or null to clear. |
Type | Description |
---|---|
\Zend_Gdata_Photos_AlbumQuery | The query object. |


setAlbumName(string $value) : \Zend_Gdata_Photos_AlbumQuery
Set the album name to query for.
Inherited from: \Zend_Gdata_Photos_AlbumQuery::setAlbumName()When set, this album's photographs be returned. If not set or null, the default user's feed will be returned instead.
NOTE: AlbumName and AlbumId are mutually exclusive. Setting one will automatically set the other to null.
Name | Type | Description |
---|---|---|
$value | string | The name of the album to retrieve, or null to clear. |
Type | Description |
---|---|
\Zend_Gdata_Photos_AlbumQuery | The query object. |


setAlt(string $value) : \Zend_Gdata_Query
Name | Type | Description |
---|---|---|
$value | string |
Type | Description |
---|---|
\Zend_Gdata_Query | Provides a fluent interface |


setAuthor(string $value) : \Zend_Gdata_Query
Name | Type | Description |
---|---|---|
$value | string |
Type | Description |
---|---|
\Zend_Gdata_Query | Provides a fluent interface |


setCategory(string $value) : \Zend_Gdata_Query
Name | Type | Description |
---|---|---|
$value | string |
Type | Description |
---|---|
\Zend_Gdata_Query | Provides a fluent interface |


setImgMax(string $value) : void
Set the maximum image size for entries returned.
Inherited from: \Zend_Gdata_Photos_UserQuery::setImgMax()\Zend_Gdata_Photos_AlbumQuery::setImgMax()Only entries which match this value will be returned. If null or unset, this filter will not be applied.
See http://code.google.com/apis/picasaweb/reference.html#Parameters for a list of valid values.
Name | Type | Description |
---|---|---|
$value | string | The image size to filter by, or null if no filter is to be applied. |


setKind(string $value) : void
Set the kind of entries that are returned.
Inherited from: \Zend_Gdata_Photos_UserQuery::setKind()\Zend_Gdata_Photos_AlbumQuery::setKind()Only entries which match this value will be returned. If null or unset, this filter will not be applied.
See http://code.google.com/apis/picasaweb/reference.html#Parameters for a list of valid values.
Name | Type | Description |
---|---|---|
$value | string | The kind to filter by, or null if no filter is to be applied. |


setMaxResults(int $value) : \Zend_Gdata_Query
Name | Type | Description |
---|---|---|
$value | int |
Type | Description |
---|---|
\Zend_Gdata_Query | Provides a fluent interface |


setParam(string $name, string $value) : \Zend_Gdata_Query
Name | Type | Description |
---|---|---|
$name | string | |
$value | string |
Type | Description |
---|---|
\Zend_Gdata_Query | Provides a fluent interface |


setPhotoId(string $value) : void
Set the photo ID to query for.
When set, this photo's comments/tags will be returned. If not set or null, the default user's feed will be returned instead.
Name | Type | Description |
---|---|---|
$value | string | The ID of the photo to retrieve, or null to clear. |


setProjection(string $value) : \Zend_Gdata_Photos_UserQuery
Set's the format of data returned in Atom feeds.
Inherited from: \Zend_Gdata_Photos_UserQuery::setProjection()\Zend_Gdata_Photos_AlbumQuery::setProjection()Can be either 'api' or 'base'. Normally, 'api' will be desired. Default is 'api'.
Name | Type | Description |
---|---|---|
$value | string |
Type | Description |
---|---|
\Zend_Gdata_Photos_UserQuery | Provides a fluent interface |


setPublishedMax(string $value) : \Zend_Gdata_Query
Name | Type | Description |
---|---|---|
$value | string |
Type | Description |
---|---|
\Zend_Gdata_Query | Provides a fluent interface |


setPublishedMin(string $value) : \Zend_Gdata_Query
Name | Type | Description |
---|---|---|
$value | string |
Type | Description |
---|---|
\Zend_Gdata_Query | Provides a fluent interface |


setQuery(string $value) : \Zend_Gdata_Query
Name | Type | Description |
---|---|---|
$value | string |
Type | Description |
---|---|
\Zend_Gdata_Query | Provides a fluent interface |


setStartIndex(int $value) : \Zend_Gdata_Query
Name | Type | Description |
---|---|---|
$value | int |
Type | Description |
---|---|
\Zend_Gdata_Query | Provides a fluent interface |


setTag(string $value) : void
Set the tag for entries that are returned.
Inherited from: \Zend_Gdata_Photos_UserQuery::setTag()\Zend_Gdata_Photos_AlbumQuery::setTag()Only entries which match this value will be returned. If null or unset, this filter will not be applied.
See http://code.google.com/apis/picasaweb/reference.html#Parameters for a list of valid values.
Name | Type | Description |
---|---|---|
$value | string | The tag to filter by, or null if no filter is to be applied. |


setThumbsize(string $value) : void
Set the thumbnail size filter for entries returned.
Inherited from: \Zend_Gdata_Photos_UserQuery::setThumbsize()\Zend_Gdata_Photos_AlbumQuery::setThumbsize()Only entries which match this value will be returned. If null or unset, this filter will not be applied.
See http://code.google.com/apis/picasaweb/reference.html#Parameters for a list of valid values.
Name | Type | Description |
---|---|---|
$value | string | The thumbnail size to filter by, or null if no filter is to be applied. |


setType(string $value) : \Zend_Gdata_Photos_UserQuery
Set's the type of data returned in queries.
Inherited from: \Zend_Gdata_Photos_UserQuery::setType()\Zend_Gdata_Photos_AlbumQuery::setType()Can be either 'feed' or 'entry'. Normally, 'feed' will be desired. Default is 'feed'.
Name | Type | Description |
---|---|---|
$value | string |
Type | Description |
---|---|
\Zend_Gdata_Photos_UserQuery | Provides a fluent interface |


setUpdatedMax(string $value) : \Zend_Gdata_Query
Name | Type | Description |
---|---|---|
$value | string |
Type | Description |
---|---|
\Zend_Gdata_Query | Provides a fluent interface |


setUpdatedMin(string $value) : \Zend_Gdata_Query
Name | Type | Description |
---|---|---|
$value | string |
Type | Description |
---|---|
\Zend_Gdata_Query | Provides a fluent interface |


setUser(string $value) : void
Set the user to query for.
Inherited from: \Zend_Gdata_Photos_UserQuery::setUser()\Zend_Gdata_Photos_AlbumQuery::setUser()When set, this user's feed will be returned. If not set or null, the default user's feed will be returned instead.
Name | Type | Description |
---|---|---|
$value | string | The user to retrieve, or null for the default user. |