В зависимости от настроек, аддон может требовать от web-сервера поддержки правил rewrite
Позволяет сохранять изображения SVG (масштабируемая векторная графика) в качестве шаблонов. Это создает новый файл svg.php в корневом каталоге XF.
Чтобы сгенерировать ссылку на шаблон SVG (в конце имени шаблона должен быть .svg!);
{{ getSvgUrl('tempate.svg') }}
В разделе «Информация о форуме», если установлен параметр «Использовать дружественные URL-адреса» (useFriendlyUrls), создается следующий URL:
/data/svg/<style_id>/<langauge_id>/<style_last_modified>/<templateName.svg>
иначе
svg.php?svg=<templateName>&s=<style_id>&l=<langauge_id>&d=<style_last_modified>
Рендеринг в PNG
Для рендеринга SVG в PNG требуется внешняя поддержка, и в зависимости от ОС это может привести к странным ограничениям или плохому рендерингу.
Поддержка php-imagick
Не рекомендуется использовать Imagick, если это может помочь!
Ubuntu (using
***** The main PPA for supported PHP versions with many PECL ext... : Ondřej Surý PPA);
sudo apt install php7.4-imagick libmagickcore-6.q16-3-extra
sudo systemctl restart php7.4-fpm
Примечание; некоторые дистрибутивы требуют установки libmagickcore-6.q16-3-extra для включения поддержки SVG.
Более старые версии Imagick имеют плохую поддержку SVG, помимо плохой репутации Imagick в области безопасности.
Поддержка CLI
Это общий аварийный выход для подключения произвольного преобразования в png с использованием proc_open в php.
Настройте рендеринг с помощью опции proc_open с;
<CLI-binary> {destFile} {sourceFile}
{sourceFile} - это исходный SVG, записанный как временный файл. {destFile} - это целевой PNG-файл как временный файл.
В качестве альтернативы ввод / вывод может осуществляться через pipes.
Примечание; имена шаблонов представляют собой только буквенно-цифровые строки, которые принудительно проверяются перед вызовом параметра CLI.
поддержка resvg CLI
Пример использования
resvg, настройте команду CLI с помощью;
/usr/local/bin/resvg --quiet {sourceFile} {destFile}
Предварительно скомпилированный двоичный файл
Предварительно скомпилированный двоичный файл linux x86_64 доступен
здесь. Скомпилирован на CentOS 7, работает на Ubuntu 18.04 / 20.04
Компиляция
Компиляция может привязываться к более новым версиям glibc, что может вызвать проблемы с зависимостью.
curl https://sh.rustup.rs -sSf | sh
source $HOME/.cargo/env
cargo install resvg
cp ~/.cargo/bin/resvg /usr/local/bin/resvg
chmod +x /usr/local/bin/resvg
Поддержка Inkscape CLI
Примечание; используйте snap, иначе у вас может быть слишком старый экземпляр!
sudo snap install inkscape
Настройте команду CLI PIPE с помощью;
inkscape --export-type=png -p
Особенности
Условный рендеринг SVG в PNG (для CSS/LESS)
Пример условного CSS для использования png поверх svg для мобильных клиентов
.mod_interrupt--svg.mod_interrupt
{
&--stop
{
&:before
{
content: url({{ getSvgUrl('sv_bbcode_modinterrupt_stop.svg') }}) !important;
}
<xf:if is="$xf.svg.as.png">
.is-tablet &:before,
.is-mobile &:before
{
content: url({{ getSvgUrlAs('sv_bbcode_modinterrupt_stop.svg', 'png') }}) !important;
}
</xf:if>
}
}
Явное использование в шаблонах;
<xf:if is="$xf.svg.enabled">
<xf:if is="$xf.svg.as.png and $xf.mobileDetect and $xf.mobileDetect.isMobile()">
<img src="{{ getSvgUrlAs('example.svg', 'png') }}"/>
<xf:else />
<img src="{{ getSvgUrlAs('example.svg', 'svg') }}"/>
</xf:if>
<xf:else />
<i class="fa fa-stop" />
</xf:if>
Интеграция маршрутизации XenForo 2
Хотя правила rewrite рекомендуются, это дополнение поддерживает расширение системы маршрутизации XenForo для обеспечения поддержки нулевой конфигурации для шаблонов SVG.
Конфигурация rewrite URL Nginx
location ^~ /data/svg/ {
access_log off;
rewrite ^/data/svg/([^/]+)/([^/]+)/([^/]+)/([^\.]+\..*)$ /svg.php?svg=$4&s=$1&l=$2&d=$3$args last;
return 403;
}
Конфигурация rewrite URL-адресов Apache
Добавьте правило перед финалом index.php;
RewriteRule ^data/svg/([^/]+)/([^/]+)/([^/]+)/([^\.]+\..*)$ svg.php?svg=$4&s=$1&l=$2&d=$3 [B,NC,L,QSA]
т.е. должно выглядеть примерно так:
# If you are having problems with the rewrite rules, remove the "#" from the
# line that begins "RewriteBase" below. You will also have to change the path
# of the rewrite to reflect the path to your XenForo installation.
#RewriteBase /xenforo
RewriteCond %{REQUEST_FILENAME} -f [OR]
RewriteCond %{REQUEST_FILENAME} -l [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^.*$ - [NC,L]
RewriteRule ^(data/|js/|styles/|install/|favicon\.ico|crossdomain\.xml|robots\.txt) - [NC,L]
RewriteRule ^data/svg/([^/]+)/([^/]+)/([^/]+)/([^\.]+\..*)$ svg.php?svg=$4&s=$1&l=$2&d=$3 [B,NC,L,QSA]
RewriteRule ^.*$ index.php [NC,L]
Для работы требуется дополнение Browser Detection
