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.
nullDetails- Type
- string
- Inherited_from
- \Zend_Gdata_Photos_AlbumQuery::$$_albumId

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

string $_category = nullCategory for the query
Inherited from: \Zend_Gdata_Query::$$_category\Zend_Gdata_Photos_UserQuery::$$_category\Zend_Gdata_Photos_AlbumQuery::$$_categorynullDetails- Type
- string
- Inherited_from
- \Zend_Gdata_Query::$$_category
- Inherited_from
- \Zend_Gdata_Photos_UserQuery::$$_category
- Inherited_from
- \Zend_Gdata_Photos_AlbumQuery::$$_category

string $_defaultFeedUri = nullDefault URL
Inherited from: \Zend_Gdata_Query::$$_defaultFeedUri\Zend_Gdata_Photos_UserQuery::$$_defaultFeedUri\Zend_Gdata_Photos_AlbumQuery::$$_defaultFeedUrinullDetails- 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 = nullBase URL TODO: Add setters and getters
Inherited from: \Zend_Gdata_Query::$$_url\Zend_Gdata_Photos_UserQuery::$$_url\Zend_Gdata_Photos_AlbumQuery::$$_urlnullDetails- 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_USERA 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_USERDetails- Type
- string
- Inherited_from
- \Zend_Gdata_Photos_UserQuery::$$_user
- Inherited_from
- \Zend_Gdata_Photos_AlbumQuery::$$_user
Methods

__construct() : voidCreate 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() : stringGet 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() : stringGet 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() : stringGet 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() : stringGet 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() : stringGet 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() : stringGet the photo ID which is to be returned.
| Type | Description |
|---|---|
| string | The ID of the photo to retrieve. |
- See
- \global\setPhoto

getProjection() : stringGets 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 = '') : stringReturns 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() : stringGet 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() : stringGet 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() : stringGets 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() : stringGet 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) : voidSet 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_AlbumQuerySet 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) : voidSet 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) : voidSet 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) : voidSet 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_UserQuerySet'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) : voidSet 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) : voidSet 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_UserQuerySet'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) : voidSet 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. |