vBulletin 5.6.5 API

vB_Api_Bbcode extends vB_Api
in package

vB_Api_Bbcode

Tags
access

public

Table of Contents

ALLOW_BBCODE_ALIGN  = 16
ALLOW_BBCODE_BASIC  = 1
ALLOW_BBCODE_CODE  = 128
ALLOW_BBCODE_COLOR  = 2
ALLOW_BBCODE_CUSTOM  = 4096
ALLOW_BBCODE_FONT  = 8
ALLOW_BBCODE_HTML  = 512
ALLOW_BBCODE_IMG  = 1024
ALLOW_BBCODE_LIST  = 32
ALLOW_BBCODE_PHP  = 256
ALLOW_BBCODE_QUOTE  = 2048
ALLOW_BBCODE_SIZE  = 4
ALLOW_BBCODE_URL  = 64
ALLOW_BBCODE_USER  = 16384
EDITOR_INDENT  = 40
$controller  : string
API Controller
$customTags  : array<string|int, mixed>
Contains an array of user specified custom BB code tags.
$db  : vB_Database
Database object.
$disabled  : bool
Indicates whether the API was disabled
$disableFalseReturnOnly  : array<string|int, mixed>
{@inheritDoc} Methods include: getSignatureInfo
$disableWhiteList  : array<string|int, mixed>
Contains white listed methods which act as normal when API is disabled no matter of special scenarios like forum closed, password expiry, ip ban and others.
$instances  : mixed
$instancesRaw  : array<string|int, mixed>
We want API subclasses to access the instances only through getters
$vb4_input_mappings  : mixed
$wrappers  : mixed
__serialize()  : mixed
__sleep()  : mixed
__unserialize()  : mixed
__wakeup()  : mixed
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.
clearCache()  : mixed
Clears all previously loaded API objects.
convertUrlToBbcode()  : string
Converts URLs into bbcode with [URL]
convertWysiwygTextToBbcode()  : string
Converts text from an editor into text ready to be saved with bbcode converted
extractVideo()  : mixed
Extracts the video and photo content from text.
fetchSmilies()  : array<string|int, mixed>
Returns an array of smilie information.
fetchTagList()  : array<string|int, mixed>
Returns the list of default BB code tags
getApiClassName()  : mixed
getSignatureInfo()  : array<string|int, mixed>
Fetches and parses to html a user's signature
hasBbcode()  : bool
Determines if the text contains bbcode.
initInfo()  : array<string|int, mixed>
Returns an array of bbcode parsing information. {@see vB_Api_Bbcode::fetchTagList}
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
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.
parseSignature()  : string
Fetches and parses to html a user's signature
parseSignatures()  : array<string|int, mixed>
Fetches and parses to html signatures
parseWysiwygHtmlToBbcode()  : string
Parses HTML produced by a WYSIWYG editor and produces the corresponding BBCode formatted text
__construct()  : mixed
Constructor
checkHasAdminPermission()  : none
Determines if the calling user has the given admin permission, and if not throws an exception
checkHasPermission()  : none
Determines if the calling user has the given bitfield permission, and if not, throws a 'no_permission' exception.
checkIsLoggedIn()  : mixed
Determines if the calling user has the given admin permission, and if not throws an exception
doParseSignature()  : array<string|int, mixed>
Used by getSignatureInfo and parseSignatures to parse a signature
fetchBbcodeOptions()  : array<string|int, mixed>
Compiles and returns an array of various bbcode-related vboptions.
fetchCustomTags()  : array<string|int, mixed>
Loads any user specified custom BB code tags.
getApiClass()  : mixed
getApiClassNameInternal()  : mixed
hasAdminPermission()  : bool
Determines if the calling user has the given admin permission
inDebugMode()  : mixed
isDisableFalseReturnOnly()  : bool
Checks if method returns false response only when API is disabled.
isWhiteListed()  : bool
Checks if method is white listed when API is disabled.
setController()  : mixed
Set controller
cms_vb4_to_vb5_method_mapping()  : mixed
default_vb4_to_vb5_method_mapping()  : mixed
hasAdminPermissionInternal()  : mixed
Internal function to power the previous cover functions
remove_nulls()  : mixed
wrapLoggerIfNeeded()  : mixed
Wrap the api object with the log wrapper class if needed.

Constants

ALLOW_BBCODE_ALIGN

public mixed ALLOW_BBCODE_ALIGN = 16

ALLOW_BBCODE_BASIC

public mixed ALLOW_BBCODE_BASIC = 1

ALLOW_BBCODE_CODE

public mixed ALLOW_BBCODE_CODE = 128

ALLOW_BBCODE_COLOR

public mixed ALLOW_BBCODE_COLOR = 2

ALLOW_BBCODE_CUSTOM

public mixed ALLOW_BBCODE_CUSTOM = 4096

ALLOW_BBCODE_FONT

public mixed ALLOW_BBCODE_FONT = 8

ALLOW_BBCODE_HTML

public mixed ALLOW_BBCODE_HTML = 512

ALLOW_BBCODE_IMG

public mixed ALLOW_BBCODE_IMG = 1024

ALLOW_BBCODE_LIST

public mixed ALLOW_BBCODE_LIST = 32

ALLOW_BBCODE_PHP

public mixed ALLOW_BBCODE_PHP = 256

ALLOW_BBCODE_QUOTE

public mixed ALLOW_BBCODE_QUOTE = 2048

ALLOW_BBCODE_SIZE

public mixed ALLOW_BBCODE_SIZE = 4

ALLOW_BBCODE_URL

public mixed ALLOW_BBCODE_URL = 64

ALLOW_BBCODE_USER

public mixed ALLOW_BBCODE_USER = 16384

EDITOR_INDENT

public int EDITOR_INDENT = 40

Properties

$controller

API Controller

protected string $controller

$disabled

Indicates whether the API was disabled

protected bool $disabled = alse

$disableFalseReturnOnly

{@inheritDoc} Methods include: getSignatureInfo

protected array<string|int, mixed> $disableFalseReturnOnly = array('getSignatureInfo')

$disableWhiteList

Contains white listed methods which act as normal when API is disabled no matter of special scenarios like forum closed, password expiry, ip ban and others.

protected array<string|int, mixed> $disableWhiteList = array()

$instances

private static mixed $instances

$instancesRaw

We want API subclasses to access the instances only through getters

private static array<string|int, mixed> $instancesRaw

$vb4_input_mappings

private static mixed $vb4_input_mappings = array( 'blog.post_comment' => array('method' => 'vb4_blog.post_comment'), 'blog.post_postcomment' => array('method' => 'vb4_blog.post_postcomment'), 'blog.post_updateblog' => array('method' => 'vb4_blog.post_updateblog'), 'blog.post_newblog' => array('method' => 'vb4_blog.post_newblog'), 'blog.post_editblog' => array('method' => 'vb4_blog.post_editblog'), 'blog_list' => array('method' => 'vb4_blog.bloglist'), 'api_init' => array('method' => 'api.init'), 'api_cmssectionlist' => array('method' => 'Vb4_Cms.sectionlist'), 'api_cmscategorylist' => array('method' => 'Vb4_Cms.categorylist'), /* // These can no longer be mapped directly to vB_Api_User::login/logout // due to additional processing of devicetoken that may be required // for mapi calls. 'login_login' => array( 'method' => 'user.login', 'request_mappings' => array( 'vb_login_username' => 'username', 'vb_login_password' => 'password', 'vb_login_md5password' => 'md5password', 'vb_login_md5password_utf' => 'md5passwordutf' ) ), 'login_logout' => array( 'method' => 'user.logout' ), */ 'get_vbfromfacebook' => array('method' => 'vb4_facebook.getVbfromfacebook'), )

$wrappers

private static mixed $wrappers

Methods

__serialize()

public __serialize() : mixed
Return values
mixed —

__sleep()

public __sleep() : mixed
Return values
mixed —

__unserialize()

public __unserialize(mixed $serialized) : mixed
Parameters
$serialized : mixed
Return values
mixed —

__wakeup()

public __wakeup() : mixed
Return values
mixed —

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
Return values
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.

Return values
mixed —

convertUrlToBbcode()

Converts URLs into bbcode with [URL]

public convertUrlToBbcode(mixed $messagetext) : string
Parameters
$messagetext : mixed
Return values
string —

Converted text

convertWysiwygTextToBbcode()

Converts text from an editor into text ready to be saved with bbcode converted

public convertWysiwygTextToBbcode(mixed $text, mixed $options) : string
Parameters
$text : mixed
$options : mixed
Return values
string —

Converted Text

extractVideo()

Extracts the video and photo content from text.

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

Array of 'url', 'provider', 'code'

fetchSmilies()

Returns an array of smilie information.

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

Smilie information corresponding to the data in the "smilie" field, with one extra column "smilielen".

fetchTagList()

Returns the list of default BB code tags

public fetchTagList([mixed $prepend_path = '' ][, mixed $force_all = false ]) : array<string|int, mixed>
Parameters
$prepend_path : mixed = ''
$force_all : mixed = false
Return values
array<string|int, mixed> —

Array of BB code tags. Format: array( defaultTags => array vB_Api_Bbcode::fetchTagList customTags => array @see vB_Api_Bbcode::fetchCustomTags defaultOptions => array vB_Api_Bbcode::fetchBbcodeOptions() )

getApiClassName()

public static getApiClassName(mixed $controller) : mixed
Parameters
$controller : mixed
Return values
mixed —

getSignatureInfo()

Fetches and parses to html a user's signature

public getSignatureInfo(int $userid[, string $signature = false ][, bool $skipdupcheck = false ]) : array<string|int, mixed>
Parameters
$userid : int
$signature : string = false

optionally pass the signature to avoid fetching it again

$skipdupcheck : bool = false

-- skips the check for multiple sigpic usages in the signature.

Return values
array<string|int, mixed> —

Array containing the parsed signature: (same as doParseSignature)

array(
    signature => parsed HTML signature
    allowed => array of bbcode tags the user is allowed to use in their signature
    disabled => array of bbcode tags the user is NOT allowed to use in their signature
)

hasBbcode()

Determines if the text contains bbcode.

public hasBbcode(mixed $text) : bool
Parameters
$text : mixed
Return values
bool —

True if the text contains valid bbcode, false if not.

initInfo()

Returns an array of bbcode parsing information. {@see vB_Api_Bbcode::fetchTagList}

public initInfo() : array<string|int, mixed>
Tags
see
vB_Api_Bbcode::fetchTagList
see
vB_Api_Bbcode::fetchCustomTags()
Return values
array<string|int, mixed> —

Bbcode parsing information. Format:

array(
    defaultTags => array vB_Api_Bbcode::fetchTagList
    customTags => array @see vB_Api_Bbcode::fetchCustomTags
    defaultOptions => array vB_Api_Bbcode::fetchBbcodeOptions()
)

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 —

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

Return values
mixed —

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

Return values
mixed —

parseSignature()

Fetches and parses to html a user's signature

public parseSignature(int $userid[, string $signature = false ][, bool $skipdupcheck = false ]) : string
Parameters
$userid : int
$signature : string = false

optionally pass the signature to avoid fetching it again

$skipdupcheck : bool = false

-- skips the check for multiple sigpic usages in the signature.

Tags
deprecated

Please use getSignatureInfo instead

Return values
string —

the parsed (html) signature

parseSignatures()

Fetches and parses to html signatures

public parseSignatures(array<string|int, mixed> $userIds[, array<string|int, mixed> $rawSignatures = array() ]) : array<string|int, mixed>
Parameters
$userIds : array<string|int, mixed>
$rawSignatures : array<string|int, mixed> = array()

(Optional) Raw signatures to avoid fetching them again

Return values
array<string|int, mixed> —

the parsed (html) signatures keyed by the userid.

parseWysiwygHtmlToBbcode()

Parses HTML produced by a WYSIWYG editor and produces the corresponding BBCode formatted text

public parseWysiwygHtmlToBbcode(mixed $text) : string
Parameters
$text : mixed
Return values
string —

BBCode text

__construct()

Constructor

protected __construct() : mixed
Return values
mixed —

checkHasAdminPermission()

Determines if the calling user has the given admin permission, and if not throws an exception

protected checkHasAdminPermission(string|array<string|int, mixed> $adminPermission) : none

Checks for:

  • A valid CP Session
  • The passed adminpermission.
Parameters
$adminPermission : string|array<string|int, mixed>

The admin permission to check. If an array then the check passes if the user has any of the permissions given.

Tags
throws
inlinemodauth_required

-- The current session is not a mod/admin session

throws
nopermission_loggedin

-- The user does not have the given permission

throws
no_permission

-- The user is not logged in at all.

Return values
none —

checkHasPermission()

Determines if the calling user has the given bitfield permission, and if not, throws a 'no_permission' exception.

protected checkHasPermission(string $group, string $permission) : none
Parameters
$group : string

The permission group where the permission is located

$permission : string

The permission to check

Tags
throws
no_permission
Return values
none —

checkIsLoggedIn()

Determines if the calling user has the given admin permission, and if not throws an exception

protected checkIsLoggedIn() : mixed
Return values
mixed —

doParseSignature()

Used by getSignatureInfo and parseSignatures to parse a signature

protected doParseSignature(mixed $userid[, mixed $signature = false ][, mixed $skipdupcheck = false ]) : array<string|int, mixed>
Parameters
$userid : mixed
$signature : mixed = false
$skipdupcheck : mixed = false
Return values
array<string|int, mixed> —

Array containing the parsed signature:

array(
    signature => parsed signature
    allowed => array of bbcode tags the user is allowed to use in their signature
    disabled => array of bbcode tags the user is NOT allowed to use in their signature
)

fetchBbcodeOptions()

Compiles and returns an array of various bbcode-related vboptions.

protected fetchBbcodeOptions() : array<string|int, mixed>
Return values
array<string|int, mixed> —

Array of various bbcode-related vboptions.

array(
    privatemessage => array(
        allowhtml
        allowbbcode
        allowimagecode
        allowsmilies
    )
    nonforum => array(
        dohtml
        dobbcode
        doimagecode
        dosmilies
    )
    arrays similar to 'nonforum' for visitormessage, groupmessage, and socialmessage.
)

fetchCustomTags()

Loads any user specified custom BB code tags.

protected fetchCustomTags() : array<string|int, mixed>
Return values
array<string|int, mixed> —

Array of custom BB code tags. Format:

array(
    option => array(
        bbcode_tag => array(
            html => replacement string
            strip_empty => int
            stop_parse => int
            disable_smilies => int
            disable_wordwrap => int
        )
        [...]
    )
    no_option => array(
        bbcode_tag => array(
            html => replacement string
            strip_empty => int
            stop_parse => int
            disable_smilies => int
            disable_wordwrap => int
        )
        [...]
    )
)

getApiClass()

protected static getApiClass(mixed $controller[, mixed $errorCheck = true ]) : mixed
Parameters
$controller : mixed
$errorCheck : mixed = true
Return values
mixed —

getApiClassNameInternal()

protected static getApiClassNameInternal(mixed $controller) : mixed
Parameters
$controller : mixed
Return values
mixed —

hasAdminPermission()

Determines if the calling user has the given admin permission

protected hasAdminPermission(string|array<string|int, mixed> $adminPermission) : bool

Useful if you need to know if the calling user but do not care why they do not have that permission. Generally useful if there is a behavior difference between admins and non admins, but the call can be processed for either.

Parameters
$adminPermission : string|array<string|int, mixed>

The admin permission to check. If an array then the check passes if the user has any of the permissions given.

Return values
bool —

true if checks pass, false otherwise

inDebugMode()

protected inDebugMode() : mixed
Return values
mixed —

isDisableFalseReturnOnly()

Checks if method returns false response only when API is disabled.

protected isDisableFalseReturnOnly(mixed $method) : bool
Parameters
$method : mixed
Return values
bool —

Indicates whether method returns false response only.

isWhiteListed()

Checks if method is white listed when API is disabled.

protected isWhiteListed(mixed $method) : bool
Parameters
$method : mixed
Return values
bool —

Indicates whether method is or is not a white list.

setController()

Set controller

protected setController(mixed $controller) : mixed
Parameters
$controller : mixed
Return values
mixed —

cms_vb4_to_vb5_method_mapping()

private static cms_vb4_to_vb5_method_mapping(mixed $method, mixed &$request) : mixed
Parameters
$method : mixed
$request : mixed
Return values
mixed —

default_vb4_to_vb5_method_mapping()

private static default_vb4_to_vb5_method_mapping(mixed $method) : mixed
Parameters
$method : mixed
Return values
mixed —

hasAdminPermissionInternal()

Internal function to power the previous cover functions

private hasAdminPermissionInternal(mixed $adminPermission) : mixed
@param string|array $adminPermission The admin permission to check.  If an array

then the check passes if the user has any of the permissions given.

Parameters
$adminPermission : mixed
Return values
mixed —

remove_nulls()

private static remove_nulls(mixed &$data) : mixed
Parameters
$data : mixed
Return values
mixed —

wrapLoggerIfNeeded()

Wrap the api object with the log wrapper class if needed.

private static wrapLoggerIfNeeded(mixed $controller, mixed $api_object) : mixed
Parameters
$controller : mixed
$api_object : mixed
Return values
mixed —

Search results