Открытые статические члены
static	getMetadataByUrl ($url, $addIfNew=true, $reuseExistingMetadata=true)

static	showView ($userField, $userFieldParams, &$cacheTag, $edit=false)

static	showEdit ($userField, $userFieldParams)

static	isUrlCached ($url)

static	getMetadataAndHtmlByUrl ($url, $addIfNew=true, $reuseExistingMetadata=true)

static	getMetadataAndHtmlByIds (array $ids, $checkAccess=true, $userId=0)

static	getMetadataByIds (array $ids)

static	reserveIdForUrl ($url)

static	resolveTemporaryMetadata ($id, $checkAccess=true, $userId=0)

static	getDynamicPreview ($url, $checkAccess=true, $userId=0)

static	getImAttach ($url, $checkAccess=true, $userId=0)

static	getImRich ($url, $checkAccess=true, $userId=0)

static	checkDynamicPreviewAccess ($url, $userId=0)

static	setMetadataImage ($id, $imageUrl)

static	isEnabled ()

static	sign ($id)

static	getCurrentUserId ()

static	isIpAddressPrivate ($ipAddress)

static	isHostTrusted (Uri $uri)

static	fetchVideoMetaData ($url)

static	getInnerFrameUrl ($id, $provider='')

Открытые атрибуты
const	SIGN_SALT = 'url_preview'

const	USER_AGENT = 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/118.0.0.0 Safari/537.36 (Bitrix link preview)'

const	MAX_DESCRIPTION = 500

const	MAX_FILE_SIZE = 1048576

const	FILE_RANGE = 1023

const	IFRAME_MAX_WIDTH = 640

const	IFRAME_MAX_HEIGHT = 340

Защищенные статические члены
static	refreshMetadata (array &$metadata)

static	getUrlInfoFromExternal ($url, $method, $checkAccess=true, $userId=0)

static	fetchUrlMetadata ($url)

static	isUrlLocal (Uri $uri)

static	getRemoteUrlMetadata (Uri $uri)

static	getTempPath (string $fileName)

static	downloadFile (string $url, ?string &$fileName=null, ?int $range=null)

static	saveImage (string $tempPath, ?string $fileName)

static	fetchImageMetadata (string $imageUrl, array &$metadata)

static	normalizeUrl ($url)

static	getOptionSaveImages ()

static	validateRemoteMetadata (array $metadata)

static	unfoldShortLink ($shortUrl)

static	getFileMetadata (HttpClient $client)

Статические защищенные данные
static	$trustedHosts

Подробное описание

См. определение в файле urlpreview.php строка 17

Методы

◆ checkDynamicPreviewAccess()

static checkDynamicPreviewAccess	(		$url,
			$userId = 0 )

static

Returns true if current user has read access to the content behind internal url.

Аргументы

string $url URL of the internal document. @params int $userId. ID of the users to check access. If userId == 0, will check access for current user.

Возвращает: bool True if current user has read access to the main entity of the document, or false otherwise.

См. определение в файле urlpreview.php строка 496

◆ downloadFile()

static downloadFile	(	string	$url,
		?string &	$fileName = null,
		?int	$range = null )

staticprotected

См. определение в файле urlpreview.php строка 769

◆ fetchImageMetadata()

static fetchImageMetadata	(	string	$imageUrl,
		array &	$metadata )

staticprotected

См. определение в файле urlpreview.php строка 839

◆ fetchUrlMetadata()

static fetchUrlMetadata ( $url )

staticprotected

Аргументы

string $url URL of the document.

Возвращает: array|false Fetched metadata or false if metadata was not found, or was invalid.

См. определение в файле urlpreview.php строка 621

◆ fetchVideoMetaData()

static fetchVideoMetaData ( $url )

static

Returns video metaData for $url if its host is trusted.

Аргументы

string $url

Возвращает: array|false

См. определение в файле urlpreview.php строка 1035

◆ getCurrentUserId()

static getCurrentUserId ( )

static

Returns id of currently logged user.

Возвращает: int User's id.

См. определение в файле urlpreview.php строка 929

◆ getDynamicPreview()

static getDynamicPreview	(	$url,
		$checkAccess = true,
		$userId = 0 )

static

Returns HTML code for the dynamic (internal url) preview.

Аргументы

string	$url	URL of the internal document.
bool	$checkAccess	Should method check current user's access to the entity, or not. @params int $userId. ID of the users to check access. If userId == 0, will check access for current user.

Возвращает: string|false HTML code of the preview, or false if case of any errors (including access denied)/

См. определение в файле urlpreview.php строка 436

◆ getFileMetadata()

static getFileMetadata ( HttpClient $client )

staticprotected

Returns metadata for downloadable file.

Аргументы

HttpClient $client

Возвращает: array|bool Metadata record if mime type and filename were detected, or false otherwise.

См. определение в файле urlpreview.php строка 961

◆ getImAttach()

static getImAttach	(	$url,
		$checkAccess = true,
		$userId = 0 )

static

Returns attach for the IM message with the requested internal entity content.

Аргументы

string	$url	URL of the internal document.
bool	$checkAccess	Should method check current user's access to the entity, or not. @params int $userId. ID of the users to check access. If userId == 0, will check access for current user.

Возвращает: \CIMMessageParamAttach | false

См. определение в файле urlpreview.php строка 474

◆ getImRich()

static getImRich	(	$url,
		$checkAccess = true,
		$userId = 0 )

static

Аргументы

	$url
bool	$checkAccess
int	$userId

Возвращает: \Bitrix\Im\V2\Entity\Url\RichData | false

См. определение в файле urlpreview.php строка 485

◆ getInnerFrameUrl()

static getInnerFrameUrl	(		$id,
			$provider = '' )

static

Returns inner frame url to embed third parties html video players.

Аргументы

int	$id
string	$provider

Возвращает: bool|string

См. определение в файле urlpreview.php строка 1083

◆ getMetadataAndHtmlByIds()

static getMetadataAndHtmlByIds	(	array	$ids,
			$checkAccess = true,
			$userId = 0 )

static

Returns stored metadata for array of IDs

Аргументы

array	$ids	Array of record's IDs.
bool	$checkAccess	Should method check current user's access to the internal entities, or not. @params int $userId. ID of the users to check access. If == 0, will check access for current user.

Возвращает: array|false Array with provided IDs as the keys.

См. определение в файле urlpreview.php строка 260

◆ getMetadataAndHtmlByUrl()

static getMetadataAndHtmlByUrl	(	$url,
		$addIfNew = true,
		$reuseExistingMetadata = true )

static

If url is remote - returns metadata for this url. If url is local - checks current user access to the entity behind the url, and returns html preview for this entity.

Аргументы

string	$url	Document's URL.
bool	$addIfNew	Should method fetch and store metadata for the document, if it is not found in database. @params bool $reuseExistingMetadata Allow reading of the cached metadata.

Возвращает: array|false Metadata for the document, or false if metadata could not be fetched/parsed.

См. определение в файле urlpreview.php строка 227

◆ getMetadataByIds()

static getMetadataByIds ( array $ids )

static

См. определение в файле urlpreview.php строка 303

◆ getMetadataByUrl()

static getMetadataByUrl	(	$url,
		$addIfNew = true,
		$reuseExistingMetadata = true )

static

Returns associated metadata for the specified URL

Аргументы

string	$url	URL.
bool	$addIfNew	Should metadata be fetched and saved, if not found in database.
bool	$reuseExistingMetadata	Allow reading of the cached metadata.

Возвращает: array|false Metadata for the URL if found, or false otherwise.

См. определение в файле urlpreview.php строка 50

◆ getOptionSaveImages()

static getOptionSaveImages ( )

staticprotected

Returns value of the option for saving images locally.

Возвращает: bool True if images should be saved locally.

См. определение в файле urlpreview.php строка 904

◆ getRemoteUrlMetadata()

static getRemoteUrlMetadata ( Uri $uri )

staticprotected

Аргументы

Uri $uri Absolute URL to get metadata for.

Возвращает: array|false

См. определение в файле urlpreview.php строка 682

◆ getTempPath()

static getTempPath ( string $fileName )

staticprotected

См. определение в файле urlpreview.php строка 761

◆ getUrlInfoFromExternal()

static getUrlInfoFromExternal	(	$url,
		$method,
		$checkAccess = true,
		$userId = 0 )

staticprotected

См. определение в файле urlpreview.php строка 586

◆ isEnabled()

static isEnabled ( )

static

Checks if UrlPreview is enabled in module option

Возвращает: bool True if UrlPreview is enabled in module options.

См. определение в файле urlpreview.php строка 564

◆ isHostTrusted()

static isHostTrusted ( Uri $uri )

static

Returns true if host of $uri is in $trustedHosts list.

Аргументы

Uri $uri

Возвращает: bool

См. определение в файле urlpreview.php строка 1017

◆ isIpAddressPrivate()

static isIpAddressPrivate ( $ipAddress )

static

Аргументы

string $ipAddress

Возвращает: bool

См. определение в файле urlpreview.php строка 1006

◆ isUrlCached()

static isUrlCached ( $url )

static

Checks if metadata for the provided url is already fetched and cached.

Аргументы

string $url Document's URL.

Возвращает: bool True if metadata for the url is located in database, false otherwise.

См. определение в файле urlpreview.php строка 207

◆ isUrlLocal()

static isUrlLocal ( Uri $uri )

staticprotected

Returns true if given URL is local

Аргументы

Uri $uri Absolute URL to be checked.

Возвращает: bool

См. определение в файле urlpreview.php строка 667

◆ normalizeUrl()

static normalizeUrl ( $url )

staticprotected

If provided url does not contain scheme part, tries to add it

Аргументы

string $url URL to be fixed.

Возвращает: string Fixed URL.

См. определение в файле urlpreview.php строка 875

◆ refreshMetadata()

static refreshMetadata ( array & $metadata )

staticprotected

См. определение в файле urlpreview.php строка 407

◆ reserveIdForUrl()

static reserveIdForUrl ( $url )

static

Creates temporary record for url

Аргументы

string $url URL for which temporary record should be created.

Возвращает: int Temporary record's id.

См. определение в файле urlpreview.php строка 344

◆ resolveTemporaryMetadata()

static resolveTemporaryMetadata	(	$id,
		$checkAccess = true,
		$userId = 0 )

static

Fetches and stores metadata for temporary record, created by UrlPreview::reserveIdForUrl. If metadata could not be fetched, deletes record.

Аргументы

int	$id	Metadata record's id.
bool	$checkAccess	Should method check current user's access to the entity, or not. @params int $userId. ID of the users to check access. If == 0, will check access for current user.

Возвращает: array|false Metadata if fetched, false otherwise.

См. определение в файле urlpreview.php строка 370

◆ saveImage()

static saveImage	(	string	$tempPath,
		?string	$fileName )

staticprotected

Аргументы

string	$tempPath
string \| null	$fileName

Возвращает: integer Saved file identifier

См. определение в файле urlpreview.php строка 816

◆ setMetadataImage()

static setMetadataImage	(		$id,
			$imageUrl )

static

Sets main image url for the metadata with given id.

Аргументы

int	$id	ID of the metadata to set image url.
string	$imageUrl	Url of the image.

Возвращает: bool Returns true in case of successful update, or false otherwise.

Исключения

ArgumentException

См. определение в файле urlpreview.php строка 526

◆ showEdit()

static showEdit	(		$userField,
			$userFieldParams )

static

Returns html code for url preview edit form

Аргументы

array	$userField	Userfield's value.
array	$userFieldParams	Userfield's parameters.

Возвращает: string HTML code for the preview.

См. определение в файле urlpreview.php строка 196

◆ showView()

static showView	(		$userField,
			$userFieldParams,
		&	$cacheTag,
			$edit = false )

static

Returns html code for url preview

Аргументы

array	$userField	Userfield's value.
array	$userFieldParams	Userfield's parameters.
string	$cacheTag	Cache tag for returned preview (out param).
bool	$edit	Show method build preview for editing the userfield.

Возвращает: string HTML code for the preview.

См. определение в файле urlpreview.php строка 112

◆ sign()

static sign ( $id )

static

Signs value using UrlPreview salt

Аргументы

string $id Unsigned value.

Возвращает: string Signed value.

Исключения

Bitrix\Main\ArgumentTypeException

См. определение в файле urlpreview.php строка 580

◆ unfoldShortLink()

static unfoldShortLink ( $shortUrl )

staticprotected

Unfolds internal short url. If url is not classified as a short link, returns input $url.

Аргументы

string $shortUrl Short URL.

Возвращает: string Full URL.

См. определение в файле urlpreview.php строка 939

◆ validateRemoteMetadata()

static validateRemoteMetadata ( array $metadata )

staticprotected

Checks if metadata is complete.

Аргументы

array $metadata HTML document metadata.

Возвращает: bool True if metadata is complete, false otherwise.

См. определение в файле urlpreview.php строка 919

Данные класса

◆ $trustedHosts

$trustedHosts

staticprotected

Инициализатор

= [
        'youtube.com' => 'youtube.com',
        'youtu.be' => 'youtu.be',
        'vimeo.com' => 'vimeo.com',
        'rutube.ru' => 'rutube.ru',
        'facebook.com' => 'facebook.com',
        'fb.watch' => 'fb.watch',
        'vk.com' => 'vk.com',
        'instagram.com' => 'instagram.com',
    ]

См. определение в файле urlpreview.php строка 31

◆ FILE_RANGE

const FILE_RANGE = 1023

См. определение в файле urlpreview.php строка 26

◆ IFRAME_MAX_HEIGHT

const IFRAME_MAX_HEIGHT = 340

См. определение в файле urlpreview.php строка 29

◆ IFRAME_MAX_WIDTH

const IFRAME_MAX_WIDTH = 640

См. определение в файле urlpreview.php строка 28

◆ MAX_DESCRIPTION

const MAX_DESCRIPTION = 500

См. определение в файле urlpreview.php строка 22

◆ MAX_FILE_SIZE

const MAX_FILE_SIZE = 1048576

См. определение в файле urlpreview.php строка 24

◆ SIGN_SALT

const SIGN_SALT = 'url_preview'

См. определение в файле urlpreview.php строка 19

◆ USER_AGENT

const USER_AGENT = 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/118.0.0.0 Safari/537.36 (Bitrix link preview)'

См. определение в файле urlpreview.php строка 20

Bitrix-D7 23.9

Открытые статические члены

Открытые атрибуты

Защищенные статические члены

Статические защищенные данные

Подробное описание

Методы

◆ checkDynamicPreviewAccess()

◆ downloadFile()

◆ fetchImageMetadata()

◆ fetchUrlMetadata()

◆ fetchVideoMetaData()

◆ getCurrentUserId()

◆ getDynamicPreview()

◆ getFileMetadata()

◆ getImAttach()

◆ getImRich()

◆ getInnerFrameUrl()

◆ getMetadataAndHtmlByIds()

◆ getMetadataAndHtmlByUrl()

◆ getMetadataByIds()

◆ getMetadataByUrl()

◆ getOptionSaveImages()

◆ getRemoteUrlMetadata()

◆ getTempPath()

◆ getUrlInfoFromExternal()

◆ isEnabled()

◆ isHostTrusted()

◆ isIpAddressPrivate()

◆ isUrlCached()

◆ isUrlLocal()

◆ normalizeUrl()

◆ refreshMetadata()

◆ reserveIdForUrl()

◆ resolveTemporaryMetadata()

◆ saveImage()

◆ setMetadataImage()

◆ showEdit()

◆ showView()

◆ sign()

◆ unfoldShortLink()

◆ validateRemoteMetadata()

Данные класса

◆ $trustedHosts

◆ FILE_RANGE

◆ IFRAME_MAX_HEIGHT

◆ IFRAME_MAX_WIDTH

◆ MAX_DESCRIPTION

◆ MAX_FILE_SIZE

◆ SIGN_SALT

◆ USER_AGENT