vBulletin v6.0.4

vB_Api_Content_Attach extends vB_Api_Content
in package

vB_Api_Content_Attach

Table of Contents

Methods

__serialize()  : array<string|int, mixed>
__sleep()  : array<string|int, mixed>
__unserialize()  : void
__wakeup()  : void
add()  : int
Adds a new node
callNamed()  : The
Call the given api function by name with a named arguments list.
checkApiState()  : mixed
This method checks whether the API method is enabled.
cleanInput()  : mixed
Cleans the input in the $data array, directly updating $data.
cleanPreviewContent()  : mixed
Takes a node record and removes the data cannot be viewed based on public_preview.
clearCache()  : mixed
Clears all previously loaded API objects.
createQuoteText()  : string
This returns the text to quote a node. Used initially for private messaging.
delete()  : bool
Permanently deletes a node
deleteAttachment()  : mixed
Remove an attachment
extractMedia()  : mixed
Extracts the video and photo content from text.
fetchAttachByFiledataids()  : array<string|int, mixed>
Fetch information of attachments without data
fetchImage()  : mixed
Fetch image information about an attachment
fetchImageByFiledataid()  : mixed
Alias for vB_Api_Filedata::fetchImageByFiledataid
fetchTableName()  : array<string|int, mixed>
Returns the tables used by this content type.
getApiClassName()  : mixed
getAttachmentPermissions()  : array<string|int, mixed>
Retrieves the permissions for the specified file type and upload method
getAutoparseLinks()  : mixed
Returns the autoparselinks setting. In the public API for createcontent getPreview() use, not really meant for regular usage.
getAvailableSettings()  : array<string|int, mixed>
Returns an array of settings that can be saved.
getBareContent()  : mixed
Returns the node content, channel routeid and title, and starter route and title, but no permissions or other subsidiary data
getBbcodeOptions()  : mixed
Returns an array with bbcode options for the node.
getContent()  : mixed
Alias for @getFullContent
getContentApi()  : mixed
Returns a content api of the appropriate type
getConversationParent()  : array<string|int, mixed>|false
Gets the conversation starter for a node. If the node is a channel it returns the channel array.
getFullContent()  : array<string|int, mixed>
Returns the node content plus the channel routeid and title, and starter route and title, and permissions and other data
getGenericChannelAttachmentPermissions()  : mixed
getImageExtensions()  : array<string|int, mixed>
Returns a string[] of accepted extensions that use the img tag for display.
getQuoteText()  : string
This returns the text to quote a node. Used initially for private messaging.
getTextCountChange()  : int
Returns textCountChange property
getTimeNow()  : int
Gives the current board time- needed to set publishdate.
instance()  : vB_Api
Returns an instance of the API object which translates exceptions to an array Use this method for API clients.
instanceInternal()  : vB_Api
Returns an instance of the API object which doesn't handle exceptions This should only be used in other API objects, not for clients of the API
isImage()  : array<string|int, mixed>
Returns an true of the extension & size requested would be treated as an image attachment
isPublished()  : bool
Determines if this record is in a published state
isVisitorMessage()  : bool
Determines whether a specific node is a visitor message
map_vb4_input_to_vb5()  : string
Returns vb5 api method name.
map_vb5_errors_to_vb4()  : mixed
Alters the error array in any way necessary to interface correctly with vb4.
map_vb5_output_to_vb4()  : mixed
Alters the output array in any way necessary to interface correctly with vb4.
setFavicon()  : mixed
Sets the main logo for a file
setLogo()  : mixed
Sets the main logo for a file
update()  : bool
Updates a record
upload()  : array<string|int, mixed>
Uploads a file
uploadPhoto()  : array<string|int, mixed>
Uploads a photo. Only use for images.
uploadProfilePicture()  : array<string|int, mixed>
Uploads a file without dimension check - to be cropped later. Only use for images.
uploadUrl()  : mixed
Upload an image based on the url

Methods

__serialize()

public __serialize() : array<string|int, mixed>
Return values
array<string|int, mixed>

__sleep()

public __sleep() : array<string|int, mixed>
Return values
array<string|int, mixed>

__unserialize()

public __unserialize(array<string|int, mixed> $serialized) : void
Parameters
$serialized : array<string|int, mixed>

add()

Adds a new node

public add(mixed $data[, mixed $options = array() ]) : int
Parameters
$data : mixed
$options : mixed = array()
Return values
int —

the new nodeid

callNamed()

Call the given api function by name with a named arguments list.

public callNamed() : The

Used primarily to translate REST requests into API calls.

Return values
The —

return of the method or an error if the method doesn't exist, or is static, a constructor or destructor, or otherwise shouldn't be callable as and API method. It is also an error if the value of a paramater is not provided and that parameter doesn't have a default value.

checkApiState()

This method checks whether the API method is enabled.

public checkApiState(mixed $method) : mixed

For extensions check make sure $controller property is already set.

Parameters
$method : mixed

cleanInput()

Cleans the input in the $data array, directly updating $data.

public cleanInput(mixed $data[, mixed $nodeid = false ]) : mixed

Note: This is called from the cleanInput method in the text API for all the attachments to the text node.

Parameters
$data : mixed
$nodeid : mixed = false

cleanPreviewContent()

Takes a node record and removes the data cannot be viewed based on public_preview.

public cleanPreviewContent(mixed $record) : mixed

It's called from the search Api.

Parameters
$record : mixed

clearCache()

Clears all previously loaded API objects.

public static clearCache() : mixed

Intended for use in tests where the loading pattern can cause issues with objects that cache thier own data.

createQuoteText()

This returns the text to quote a node. Used initially for private messaging.

public createQuoteText(mixed $nodeid, mixed $pageText) : string
Parameters
$nodeid : mixed
$pageText : mixed
Return values
string —

Quote text.

delete()

Permanently deletes a node

public delete(mixed $nodeid) : bool
Parameters
$nodeid : mixed
Return values
bool

deleteAttachment()

Remove an attachment

public deleteAttachment(mixed $id) : mixed
Parameters
$id : mixed

extractMedia()

Extracts the video and photo content from text.

public extractMedia(mixed $rawtext) : mixed
Parameters
$rawtext : mixed
Return values
mixed —

Array of "photo", "video". Each is an array of images.

fetchAttachByFiledataids()

Fetch information of attachments without data

public fetchAttachByFiledataids(array<string|int, mixed> $filedataids) : array<string|int, mixed>
Parameters
$filedataids : array<string|int, mixed>

Array of file data ID

Tags
deprecated

This function returns incorrect results when more than one attachment exists for a given filedataid. This can happen when a user loads the same file more than once (we only store a given attachment once to save space).

Return values
array<string|int, mixed> —

The attachment data array

fetchImage()

Fetch image information about an attachment

public fetchImage(mixed $id[, mixed $type = vB_Api_Filedata::SIZE_FULL ][, mixed $includeData = true ]) : mixed
Parameters
$id : mixed
$type : mixed = vB_Api_Filedata::SIZE_FULL
$includeData : mixed = true
Return values
mixed —

Array of data, includes: filesize, dateline, htmltype, filename, extension, and filedataid

fetchImageByFiledataid()

Alias for vB_Api_Filedata::fetchImageByFiledataid

public fetchImageByFiledataid(mixed $id[, mixed $type = vB_Api_Filedata::SIZE_FULL ][, mixed $includeData = true ][, mixed $attachmentnodeid = 0 ]) : mixed
Parameters
$id : mixed
$type : mixed = vB_Api_Filedata::SIZE_FULL
$includeData : mixed = true
$attachmentnodeid : mixed = 0
Tags
see
vB_Api_Filedata::fetchImageByFiledataid

fetchTableName()

Returns the tables used by this content type.

public fetchTableName() : array<string|int, mixed>
Return values
array<string|int, mixed> —

Array of table names

getApiClassName()

public static getApiClassName(mixed $controller) : mixed
Parameters
$controller : mixed

getAttachmentPermissions()

Retrieves the permissions for the specified file type and upload method

public getAttachmentPermissions(mixed $data) : array<string|int, mixed>
Parameters
$data : mixed
Return values
array<string|int, mixed> —

$results

getAutoparseLinks()

Returns the autoparselinks setting. In the public API for createcontent getPreview() use, not really meant for regular usage.

public getAutoparseLinks(mixed $data) : mixed
Parameters
$data : mixed

Input array similar to what would be passed into content_text::text() expected: htmlstate, disable_bbcode, parentid

Return values
mixed —

['autoparselinks' => (bool)]

getAvailableSettings()

Returns an array of settings that can be saved.

public getAvailableSettings() : array<string|int, mixed>
Return values
array<string|int, mixed> —

Key 'settings' => array of available setting names

getBareContent()

Returns the node content, channel routeid and title, and starter route and title, but no permissions or other subsidiary data

public getBareContent(mixed $nodeid[, mixed $permissions = false ]) : mixed
Parameters
$nodeid : mixed
$permissions : mixed = false

getBbcodeOptions()

Returns an array with bbcode options for the node.

public getBbcodeOptions(int $nodeId) : mixed
Parameters
$nodeId : int

getContent()

Alias for @getFullContent

public getContent(mixed $nodeid[, mixed $permissions = false ]) : mixed
Parameters
$nodeid : mixed
$permissions : mixed = false

getContentApi()

Returns a content api of the appropriate type

public static getContentApi(mixed $contenttypeid) : mixed
Parameters
$contenttypeid : mixed
Return values
mixed —

Content api object

getConversationParent()

Gets the conversation starter for a node. If the node is a channel it returns the channel array.

public getConversationParent(int $nodeid) : array<string|int, mixed>|false
Parameters
$nodeid : int
Tags
throws
vB_Exception_Api
Return values
array<string|int, mixed>|false —

The starter node array. False when the node lookup fails

getFullContent()

Returns the node content plus the channel routeid and title, and starter route and title, and permissions and other data

public getFullContent(int $nodeid[, array<string|int, mixed> $permissions = false ]) : array<string|int, mixed>
Parameters
$nodeid : int
$permissions : array<string|int, mixed> = false

(unused)

Return values
array<string|int, mixed> —

The standard array of node data

getGenericChannelAttachmentPermissions()

public getGenericChannelAttachmentPermissions(mixed $nodeid) : mixed
Parameters
$nodeid : mixed

getImageExtensions()

Returns a string[] of accepted extensions that use the img tag for display.

public getImageExtensions() : array<string|int, mixed>
Return values
array<string|int, mixed> —

'extensions' => string[]

getQuoteText()

This returns the text to quote a node. Used initially for private messaging.

public getQuoteText(mixed $nodeid) : string
Parameters
$nodeid : mixed
Return values
string —

Quote text

getTextCountChange()

Returns textCountChange property

public getTextCountChange() : int
Return values
int

getTimeNow()

Gives the current board time- needed to set publishdate.

public getTimeNow() : int
Return values
int

instance()

Returns an instance of the API object which translates exceptions to an array Use this method for API clients.

public static instance(string $controller[, bool $refresh_cache = false ]) : vB_Api
Parameters
$controller : string

-- name of the API controller to load

$refresh_cache : bool = false

-- true if we want to force the cache to update with a new api object primarily intended for testing

Return values
vB_Api

instanceInternal()

Returns an instance of the API object which doesn't handle exceptions This should only be used in other API objects, not for clients of the API

public static instanceInternal(string $controller[, bool $refresh_cache = false ]) : vB_Api
Parameters
$controller : string

-- name of the API controller to load

$refresh_cache : bool = false

-- true if we want to force the cache to update with a new api object primarily intended for testing

Return values
vB_Api

isImage()

Returns an true of the extension & size requested would be treated as an image attachment

public isImage(string $extension[, string $type = vB_Api_Filedata::SIZE_FULL ]) : array<string|int, mixed>
Parameters
$extension : string

File extension of attachment

$type : string = vB_Api_Filedata::SIZE_FULL

'icon'|'thumb'|'small'|'medium'|'large'|'full'

Return values
array<string|int, mixed> —

Key 'settings' => array of available setting names

isPublished()

Determines if this record is in a published state

public isPublished(mixed $data) : bool
Parameters
$data : mixed
Return values
bool

isVisitorMessage()

Determines whether a specific node is a visitor message

public isVisitorMessage(mixed $nodeid) : bool
Parameters
$nodeid : mixed
Return values
bool

map_vb4_input_to_vb5()

Returns vb5 api method name.

public static map_vb4_input_to_vb5(string $method, array<string|int, mixed> &$request) : string

May alter request array.

Parameters
$method : string

-- vb4 method name

$request : array<string|int, mixed>

-- $_REQUEST array for this api request

Return values
string

map_vb5_errors_to_vb4()

Alters the error array in any way necessary to interface correctly with vb4.

public static map_vb5_errors_to_vb4(string $method, array<string|int, mixed> &$data) : mixed
Parameters
$method : string

-- vb4 method name

$data : array<string|int, mixed>

-- error array from vb5

map_vb5_output_to_vb4()

Alters the output array in any way necessary to interface correctly with vb4.

public static map_vb5_output_to_vb4(string $method, array<string|int, mixed> &$data) : mixed
Parameters
$method : string

-- vb4 method name

$data : array<string|int, mixed>

-- output array from vb5

setFavicon()

Sets the main logo for a file

public setFavicon(mixed $filedataid[, mixed $styleselection = 'current' ]) : mixed
Parameters
$filedataid : mixed
$styleselection : mixed = 'current'
Return values
mixed —

Array of data, includes error message or an int- normally 1.

Sets the main logo for a file

public setLogo(mixed $filedataid[, mixed $styleselection = 'current' ]) : mixed
Parameters
$filedataid : mixed
$styleselection : mixed = 'current'
Return values
mixed —

Array of data, includes error message or an int- normally 1.

update()

Updates a record

public update(mixed $nodeid, mixed $data) : bool
Parameters
$nodeid : mixed
$data : mixed
Return values
bool

upload()

Uploads a file

public upload(mixed $file) : array<string|int, mixed>
Parameters
$file : mixed
Return values
array<string|int, mixed> —

Array of data, which will include either error info or a filedataid

uploadPhoto()

Uploads a photo. Only use for images.

public uploadPhoto(mixed $file) : array<string|int, mixed>
Parameters
$file : mixed
Return values
array<string|int, mixed> —

Array of data, which will include either error info or a filedataid

uploadProfilePicture()

Uploads a file without dimension check - to be cropped later. Only use for images.

public uploadProfilePicture(mixed $file) : array<string|int, mixed>
Parameters
$file : mixed
Return values
array<string|int, mixed> —

Array of data, which will include either error info or a filedataid

uploadUrl()

Upload an image based on the url

public uploadUrl(mixed $url[, mixed $attachment = false ][, mixed $uploadfrom = '' ]) : mixed
Parameters
$url : mixed
$attachment : mixed = false
$uploadfrom : mixed = ''
Return values
mixed —

Array of data, includes filesize, dateline, htmltype, filename, extension, and filedataid


        

        
    




    

    

                                

                

                                
    

        On this page

        
    


                

                            

            

    

        

            
Search results