Enables scripted content fragments to use Media

Properties

NameTypeDescriptionDefaultOptions
ContentTypeIdGuidMedia content type identifier
CurrentMediaCurrent contextual media gallery post
CurrentViewTypestringCurrent contextual view type

Methods

AreRatingsEnabled

Returns whether ratings are enabled on a media gallery post

Usage

#set($booleanResponse = $core_v2_media.AreRatingsEnabled($id))

Parameters

NameTypeDescriptionRequiredDefaultOptions
idintIdRequired

Return Type

bool

Create

Creates a new media post

Usage

#set($mediaResponse = $core_v2_media.Create($mediaGalleryId, $name, $contentType, $fileName, "%{Description = $descriptionArg, FeaturedImage = $featuredImageArg, FileData = $fileDataArg, FileUrl = $fileUrlArg, IsFeatured = $isFeaturedArg, Tags = $tagsArg}"))

Parameters

NameTypeDescriptionRequiredDefaultOptions
mediaGalleryIdintMedia Gallery IdRequired
namestringNameRequired
contentTypestringContent TypeRequired
fileNamestringFile NameRequired
DescriptionstringDescriptionOptional
FeaturedImagestringUsed to include a featured image when IsFeatured is true.Optional
FileDataByte[]FileData or FileUrl is required.Optional
FileUrlstringFileData or FileUrl is required.Optional
IsFeaturedboolIs FeaturedOptionalFalse
TagsstringA comma separated list of tags.Optional

Return Type

Media

Delete

Deletes a media gallery post

Usage

#set($additionalInfoResponse = $core_v2_media.Delete($mediaGalleryId, $fileId))

Parameters

NameTypeDescriptionRequiredDefaultOptions
mediaGalleryIdintMedia Gallery IdRequired
fileIdintFile IdRequired

Return Type

AdditionalInfo

Download

Downloads the media gallery file in response to the the current HTTP request

Usage

$core_v2_media.Download($mediaId)

Parameters

NameTypeDescriptionRequiredDefaultOptions
mediaIdintMedia IdRequired

Get

Gets a media gallery post

Usage

#set($mediaResponse = $core_v2_media.Get($mediaGalleryId, $fileId))

Parameters

NameTypeDescriptionRequiredDefaultOptions
mediaGalleryIdintMedia Gallery IdRequired
fileIdintFile IdRequired

Return Type

Media

Get

Gets a media gallery post

Usage

#set($mediaResponse = $core_v2_media.Get($contentId))

Parameters

NameTypeDescriptionRequiredDefaultOptions
contentIdGuidContent IdRequired

Return Type

Media

Get

Gets a media gallery post

Usage

#set($mediaResponse = $core_v2_media.Get($fileId))

Parameters

NameTypeDescriptionRequiredDefaultOptions
fileIdintFile IdRequired

Return Type

Media

GetRating

Gets the rating

Usage

#set($ratingResponse = $core_v2_media.GetRating($id))

Parameters

NameTypeDescriptionRequiredDefaultOptions
idintIdRequired

Return Type

Rating

IncrementViewCount

Increments the view count on a media gallery post

Usage

$core_v2_media.IncrementViewCount($id)

Parameters

NameTypeDescriptionRequiredDefaultOptions
idintIdRequired

IsFavorite

Returns favorite status for the accessing user

Usage

#set($booleanResponse = $core_v2_media.IsFavorite($id))

Parameters

NameTypeDescriptionRequiredDefaultOptions
idintIdRequired

Return Type

bool

IsSubscribed

Returns subscribed status for the accessing user

Usage

#set($booleanResponse = $core_v2_media.IsSubscribed($id))

Parameters

NameTypeDescriptionRequiredDefaultOptions
idintIdRequired

Return Type

bool

List

Lists media gallery posts

Usage

#set($pagedListResponse = $core_v2_media.List("%{GalleryId = $galleryIdArg, GalleryIds = $galleryIdsArg, GroupId = $groupIdArg, IncludeSubGroups = $includeSubGroupsArg, IncludeUnpublished = $includeUnpublishedArg, PageIndex = $pageIndexArg, PageSize = $pageSizeArg, SortBy = $sortByArg, SortOrder = $sortOrderArg}"))

Parameters

NameTypeDescriptionRequiredDefaultOptions
GalleryIdintGallery IdOptional
GalleryIdsstringUsed to filter by a list of media galleries. Multiple values are separated with commas.Optional
GroupIdintGroup IdOptional
IncludeSubGroupsboolUsed when filtering by group.Optional
IncludeUnpublishedboolSpecifies whether to include unpublished posts.OptionalFalse
PageIndexintSpecify the page number of paged results to return. Zero-based index.Optional0
PageSizeintSpecify the number of results to return per page.Optional20
SortBystringSort ByOptionalPostDateAuthor, Comments, Downloads, PostDate, Rating, Score:SCORE_ID, Subject, Views
SortOrderstringSort OrderOptionalAscendingAscending, Descending

Return Type

PagedList<Media>

List

Lists media gallery posts

Usage

#set($pagedListResponse = $core_v2_media.List())

Return Type

PagedList<Media>

Preview

Previews a media gallery post

Usage

#set($mediaResponse = $core_v2_media.Preview($mediaGalleryId, $name, $contentType, $fileName, "%{Description = $descriptionArg, FeaturedImage = $featuredImageArg, FileData = $fileDataArg, FileUrl = $fileUrlArg, IsFeatured = $isFeaturedArg, Tags = $tagsArg}"))

Parameters

NameTypeDescriptionRequiredDefaultOptions
mediaGalleryIdintMedia Gallery IdRequired
namestringNameRequired
contentTypestringContent TypeRequired
fileNamestringFile NameRequired
DescriptionstringDescriptionOptional
FeaturedImagestringUsed to include a featured image when IsFeatured is true.Optional
FileDataByte[]FileData or FileUrl is required.Optional
FileUrlstringFileData or FileUrl is required.Optional
IsFeaturedboolIs FeaturedOptionalFalse
TagsstringA comma separated list of tags.Optional

Return Type

Media

Preview

Previews a media gallery post

Usage

#set($mediaResponse = $core_v2_media.Preview($mediaGalleryId, $fileId, "%{ContentType = $contentTypeArg, Description = $descriptionArg, FeaturedImage = $featuredImageArg, FileData = $fileDataArg, FileName = $fileNameArg, FileUrl = $fileUrlArg, IsFeatured = $isFeaturedArg, Name = $nameArg, Tags = $tagsArg}"))

Parameters

NameTypeDescriptionRequiredDefaultOptions
mediaGalleryIdintMedia Gallery IdRequired
fileIdintFile IdRequired
ContentTypestringContent TypeOptional
DescriptionstringDescriptionOptional
FeaturedImagestringUsed to include a featured image when IsFeatured is true.Optional
FileDataByte[]FileData or FileUrl is required.Optional
FileNamestringFile NameOptional
FileUrlstringFileData or FileUrl is required.Optional
IsFeaturedboolIs FeaturedOptionalFalse
NamestringNameOptional
TagsstringA comma separated list of tags.Optional

Return Type

Media

SetFavorite

Sets favorite status for the accessing user

Usage

$core_v2_media.SetFavorite($id, $favorite)

Parameters

NameTypeDescriptionRequiredDefaultOptions
idintIdRequired
favoriteboolFavoriteRequired

SetRating

Sets the rating for the accessing user

Usage

$core_v2_media.SetRating($id, $rating)

Parameters

NameTypeDescriptionRequiredDefaultOptions
idintIdRequired
ratingintRatingRequired

SetSubscribed

Sets subscribed status for the accessing user

Usage

#set($additionalInfoResponse = $core_v2_media.SetSubscribed($id, $subscribe))

Parameters

NameTypeDescriptionRequiredDefaultOptions
idintIdRequired
subscribeboolSubscribeRequired

Return Type

AdditionalInfo

Update

Updates a media post

Usage

#set($mediaResponse = $core_v2_media.Update($mediaGalleryId, $fileId, "%{ContentType = $contentTypeArg, Description = $descriptionArg, FeaturedImage = $featuredImageArg, FileData = $fileDataArg, FileName = $fileNameArg, FileUrl = $fileUrlArg, IsFeatured = $isFeaturedArg, Name = $nameArg, Tags = $tagsArg}"))

Parameters

NameTypeDescriptionRequiredDefaultOptions
mediaGalleryIdintMedia Gallery IdRequired
fileIdintFile IdRequired
ContentTypestringRequired when updating FileData or FileUrl.Optional
DescriptionstringDescriptionOptional
FeaturedImagestringUsed to include a featured image when IsFeatured is true.Optional
FileDataByte[]File DataOptional
FileNamestringRequired when updating FileData or FileUrl.Optional
FileUrlstringFile UrlOptional
IsFeaturedboolIs FeaturedOptional
NamestringNameOptional
TagsstringA comma separated list of tags.Optional

Return Type

Media