easy_svg_pro_import_max_entries

Filter · Easy SVG Pro · Status: Stable

When someone imports a ZIP, Easy SVG Pro reads at most 2000 icons out of it. This filter changes that number. It protects the server from an archive with tens of thousands of tiny files, and lets a site with a really large icon set raise the limit on purpose.

Usage

apply_filters( 'easy_svg_pro_import_max_entries', int $max )

Applied in includes/editor/set-import.php, inside zip_entries_from_path(). The result is cast to an integer.

When to use it

• You import a set with more than 2000 icons in one archive and the import stops short.
• You want a tighter limit on a small shared host, so nobody can tie up a worker with a giant archive.
• You run automated imports (wp easy-svg pack import) and want a limit that matches what your packs really hold.

Do not use it when:

• The archive is big in bytes rather than in files. That is easy_svg_pro_import_max_total_bytes.
• You import an SVG icon font, not a ZIP. That is easy_svg_pro_import_font_max_bytes.
• One single SVG inside the ZIP is too large. Each entry is held to the free plugin's size limit, easy_svg_max_bytes.

Parameters

Return value

Default

2000.

Examples

Allow larger sets

/**
 * Our icon library ships 3500 icons in one pack.
 */
function acme_import_max_entries( $max ) {
	return max( $max, 4000 );
}
add_filter( 'easy_svg_pro_import_max_entries', 'acme_import_max_entries' );

max() keeps a higher limit that another plugin may have set.

Raise the limit only for WP-CLI

/**
 * The browser keeps the default. Deploy scripts may read more.
 */
function acme_import_max_entries_cli( $max ) {
	if ( defined( 'WP_CLI' ) && WP_CLI ) {
		return 10000;
	}

	return $max;
}
add_filter( 'easy_svg_pro_import_max_entries', 'acme_import_max_entries_cli' );

When you raise the number of entries, raise easy_svg_pro_import_max_total_bytes as well, or the byte limit stops the import first.

A tighter limit on a small host, never zero

function acme_import_max_entries_small( $max ) {
	return max( 1, min( (int) $max, 500 ) );
}
add_filter( 'easy_svg_pro_import_max_entries', 'acme_import_max_entries_small' );

How it works

Every import of a ZIP goes through one reader, so one rule applies everywhere:

For each entry, in archive order, the reader:

1. stops when the number of kept entries has reached your limit,
2. skips a name with .. or a leading /,
3. skips anything that is not manifest.json or a .svg file,
4. skips an entry larger than its own cap: easy_svg_max_bytes() for an SVG (2 MB when the free plugin is missing), 1 MB for the manifest. The size is checked as declared and again after reading,
5. adds the bytes to a running total and stops when that passes the total byte limit,
6. keeps the entry.

Nothing is written to disk. After reading, every SVG goes through the site sanitizer and hardener before it is stored.

Pitfalls

• Entries past the limit are silent. They are never read, so they do not show up as refused either. An import of 2500 files reports 2000 icons and no warning. Count what you expect.
• Archive order decides. Which 2000 files make it depends on the order inside the ZIP, not on the manifest.
• Zero means nothing. Returning 0, null or false stops every ZIP import on the site.
• Memory grows with it. Every entry is held in memory, then again with its label, then again prepared. Plan for about three times the bytes you allow.
• Not for folders. Theme folders and drop-ins under wp-content/easy-svg-icons use easy_svg_pro_source_max_icons instead.

Related

• easy_svg_pro_import_max_total_bytes
• easy_svg_pro_import_font_max_bytes
• POST easy-svg-pro/v1/packs/import
• POST easy-svg-pro/v1/sets/{id}/import
• wp easy-svg pack import