GetConfig(); $filePath = cms_join_path($config['root_path'], $params['file']); // Vérifications de sécurité et d'existence if (!file_exists($filePath)) { trigger_error("fetch_svg: fichier introuvable - {$params['file']}", E_USER_WARNING); return ''; } if (!is_readable($filePath)) { trigger_error("fetch_svg: fichier non lisible - {$params['file']}", E_USER_WARNING); return ''; } // Mise en cache optionnelle $cacheKey = 'svg_' . md5($filePath . filemtime($filePath)); $useCache = !empty($params['cache']); if ($useCache && isset($smarty->_cache[$cacheKey])) { $content = $smarty->_cache[$cacheKey]; } else { $content = file_get_contents($filePath); if ($content === false) { trigger_error("fetch_svg: erreur de lecture - {$params['file']}", E_USER_WARNING); return ''; } // Compression optimisée avec une seule passe $patterns = [ '/<\?.*\?>/', // Instructions PHP '//', // Commentaires '/\s*<\/g>/', // Groupes vides '/\s*\n\s*/', // Sauts de ligne et espaces autour '/\t+/', // Tabulations '/\s{2,}/', // Espaces multiples '/>\s+<', '"']; $content = preg_replace($patterns, $replacements, $content); // Stockage en cache if ($useCache) { $smarty->_cache[$cacheKey] = $content; } } // Génération du préfixe unique if (!empty($params['prefix'])) { $prefix = $params['prefix']; } else { // Utilisation d'un identifiant plus léger et unique static $counter = 0; $prefix = 'svg-' . (++$counter) . '-'; } // Préfixage des IDs et références (optimisé) if ($prefix) { $content = preg_replace_callback( '/\b(id|href|xlink:href)=(["\'])([^"\']+)\2/', function($matches) use ($prefix) { $attr = $matches[1]; $quote = $matches[2]; $value = $matches[3]; // Préfixer les IDs et les références internes if ($attr === 'id') { return "{$attr}={$quote}{$prefix}{$value}{$quote}"; } elseif (strpos($value, '#') === 0) { return "{$attr}={$quote}#{$prefix}" . substr($value, 1) . "{$quote}"; } return $matches[0]; }, $content ); // url() dans les styles $content = preg_replace('/url$#([^)]+)$/', 'url(#' . $prefix . '$1)', $content); } // Classes CSS optionnelles if (!empty($params['class'])) { $content = preg_replace('/

Author: Jocelyn LUSSEAU • Koa'link

Version: 1.0

Last Update: October 2025

Purpose: Fetches SVG files, optimizes them by removing unnecessary whitespace and comments, and prefixes IDs to prevent conflicts when multiple SVGs are used on the same page.

Features:

Automatic SVG compression and optimization
Unique ID prefixing to avoid conflicts
Optional caching for improved performance
CSS class injection support
Security checks for file access

License: Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0)

What does this plugin do?

The fetch_svg plugin loads SVG files from your server, optimizes them, and outputs them inline in your HTML. It automatically prefixes all IDs within the SVG to prevent conflicts when using multiple SVG files on the same page.

How do I use it?

Use the plugin in your Smarty templates with the following syntax:

{fetch_svg file='path/to/your/file.svg'}

Parameters

Parameter	Required	Default	Description
file	Yes	-	Path to the SVG file relative to the CMS root directory. Example: `images/icons/home.svg`
prefix	No	Auto-generated	Custom prefix for IDs within the SVG. If not specified, a unique prefix is automatically generated. Example: `prefix='icon-home-'`
cache	No	false	Enable caching to improve performance. Set to `true` to cache the processed SVG. Example: `cache=true`
class	No	-	CSS class(es) to add to the SVG element. Example: `class='icon icon-large'`
assign	No	-	Assign the SVG content to a Smarty variable instead of outputting it directly. Example: `assign='svg_content'`

Examples

Basic Usage

{fetch_svg file='images/logo.svg'}

Loads and displays the SVG file with automatic ID prefixing.

With CSS Class

{fetch_svg file='images/icons/home.svg' class='header-icon'}

Adds the class "header-icon" to the SVG element.

With Caching

{fetch_svg file='images/logo.svg' cache=true}

Enables caching for better performance when the same SVG is used multiple times.

With Custom Prefix

{fetch_svg file='images/icons/user.svg' prefix='user-icon-'}

Uses "user-icon-" as the prefix for all IDs in the SVG.

Assign to Variable

{fetch_svg file='images/icon.svg' assign='my_svg'}
{$my_svg}

Stores the SVG content in the variable $my_svg for later use.

Combined Parameters

{fetch_svg file='images/logo.svg' class='site-logo' cache=true prefix='logo-'}

Combines multiple parameters for maximum control.

What does the plugin optimize?

Removes XML/PHP processing instructions
Strips HTML comments
Removes empty groups
Compresses whitespace and line breaks
Removes unnecessary semicolons
Prefixes all id attributes
Updates all internal references (href, xlink:href, url())

Why use ID prefixing?

SVG files often contain IDs for gradients, masks, filters, and other elements. When you use multiple SVGs on the same page, duplicate IDs can cause conflicts, resulting in incorrect rendering. This plugin automatically prefixes all IDs to make them unique.

Performance Tips

Use cache=true for SVGs that don't change frequently
Keep SVG files optimized before uploading (use tools like SVGO)
Use assign if you need to reuse the same SVG multiple times in a template

Troubleshooting

SVG not displaying: Check that the file path is correct and relative to your CMS root directory.

File not found error: Verify the file exists and is readable by the web server.

IDs still conflicting: Make sure you're not manually setting the same prefix for different SVGs.