urlpreviewusertype.php

См. документацию.

<?php
 
namespace Bitrix\Main\UrlPreview;
 
use Bitrix\Main\Localization\Loc;
use Bitrix\Main\Security\Sign\Signer;
use Bitrix\Main\SystemException;
 
Loc::loadMessages(__FILE__);
 
class UrlPreviewUserType
{
    public static function getUserTypeDescription()
    {
        return array(
            "USER_TYPE_ID" => "url_preview",
            "CLASS_NAME" => __CLASS__,
            "DESCRIPTION" => Loc::getMessage('MAIN_URL_PREVIEW_USER_TYPE_NAME'),
            "BASE_TYPE" => "int"
        );
    }

    public static function getDBColumnType($userField)
    {
        $connection = \Bitrix\Main\Application::getConnection();
        $helper = $connection->getSqlHelper();
        return $helper->getColumnTypeByField(new \Bitrix\Main\ORM\Fields\IntegerField('x'));
    }

    public static function prepareSettings($userField)
    {
        //this usertype does not support setting yet
        return array();
    }

    public static function getSettingsHTML($userField, $htmlControl, $varsFromForm)
    {
        return "&nbsp;";
    }

    public static function getEditFormHTML($userField, $htmlControl)
    {
        return UrlPreview::showEdit($userField, array());
    }

    public static function getFilterHTML($userField, $htmlControl)
    {
        return '&nbsp;';
    }

    public static function getAdminListViewHTML($userField, $htmlControl)
    {
        return "&nbsp;";
    }

    public static function getAdminListEditHTML($userField, $htmlControl)
    {
        return "&nbsp;";
    }

    public static function getAdminListEditHTMLMulty($userField, $htmlControl)
    {
        return "&nbsp;";
    }

    public static function getPublicViewHTML($userField, $id, $params = "", $settings = array())
    {
        return UrlPreview::showView($userField, $params, $cacheTag);
    }

    public static function checkfields($userField, $value)
    {
        $result = array();
 
        $signer = new Signer();
        try
        {
            $value = $signer->unsign($value, UrlPreview::SIGN_SALT);
        }
        catch (SystemException $e)
        {
            return $result;
        }
 
        $value = (int)$value;
 
        if($value === 0)
            return $result;
 
        $metadata = UrlMetadataTable::getById($value)->fetch();
        if(!is_array($metadata))
        {
            $result[] = array(
                    "id" => $userField["FIELD_NAME"],
                    "text" => GetMessage("MAIN_URL_PREVIEW_VALUE_NOT_FOUND")
            );
        }
        else if($metadata['TYPE'] === UrlMetadataTable::TYPE_DYNAMIC
                && !UrlPreview::checkDynamicPreviewAccess($metadata['URL']))
        {
            $result[] = array(
                    "id" => $userField["FIELD_NAME"],
                    "text" => GetMessage("MAIN_URL_PREVIEW_VALUE_NO_ACCESS",
                            array('#URL#' => $metadata['URL'])
                    )
            );
        }
 
        return $result;
    }

    public static function onBeforeSave($userField, $value)
    {
        $imageUrl = null;
        if(str_contains($value, ';'))
        {
            [$value, $imageUrl] = explode(';', $value);
        }
 
        $signer = new Signer();
        try
        {
            $value = $signer->unsign($value, UrlPreview::SIGN_SALT);
        }
        catch (SystemException $e)
        {
            return null;
        }
        $metadata = UrlMetadataTable::getById($value)->fetch();
        if(!is_array($metadata))
            return null;
 
        if($metadata['TYPE'] === UrlMetadataTable::TYPE_STATIC)
        {
            if($imageUrl && is_array($metadata['EXTRA']['IMAGES']) && in_array($imageUrl, $metadata['EXTRA']['IMAGES']))
            {
                UrlPreview::setMetadataImage((int)$value, $imageUrl);
            }
            return $value;
        }
        else if($metadata['TYPE'] === UrlMetadataTable::TYPE_DYNAMIC
                && UrlPreview::checkDynamicPreviewAccess($metadata['URL']))
        {
            return $value;
        }
 
        return null;
    }
}