Regicons

Registers Ionicons (filled, outline, and sharp) with the WordPress 7.1 Icons API.

Description

Regicons registers the Ionicons icon set as WordPress icon collections so they appear in the Icon block picker and are available via wp_get_icon() and the Icons REST API.

Collections

SVG icons are derived from Ionicons (MIT). See licenses/IONICONS-LICENSE.md.

Installation

1. Download regicons.zip from the GitHub Releases page.
2. In WordPress admin, go to Plugins → Add New → Upload Plugin.
3. Activate Regicons.
4. Insert an Icon block and choose an Ionicons collection.

Frequently Asked Questions

Which WordPress version is required?

WordPress 7.1 or later (Icons API with public registration helpers).

How do I update Ionicons?

This repository uses Deno. Edit icons.config.json or run deno task icons:update, then commit the regenerated icons/ and assets/icon-manifest.php.

Changelog

0.1.0

• Initial release with Ionicons filled, outline, and sharp collections.

Develop

Requires Deno 2.x. Node.js is not required for build / lint / package. Local Playground runs via deno x.

# Install Deno npm deps (Playground CLI) once
deno task install

# Fetch Ionicons and generate icons + manifest
deno task build

# Bump to the latest Ionicons GitHub release, then rebuild
deno task icons:update

# Generate readme.txt from this README.md
deno task readme

# Start local Playground (auto-mount + WP nightly)
deno task playground

Open the URL printed by the CLI (default http://127.0.0.1:9400), then insert an Icon block and pick an Ionicons collection tab.

Stroke / shape SVGs are converted with oslllo-svg-fixer during deno task build, then sanitized for the WordPress 7.1 Icons allowlist (--unsafe-proto is required under Deno).

Pinned to @wp-playground/cli@1.2.0 because newer CLI releases require a native fs-ext addon that Deno cannot load. Uses WordPress nightly (CLI 1.2.0 does not accept --wp=beta).

readme.txt is generated from this file with @pixelium/wp-readme (deno task readme).

Collection and icon labels in assets/icon-manifest.php are wrapped with __( …, 'pxlm-regicons' ) for GlotPress / WordPress.org language packs.

Release

Push a version tag; GitHub Actions builds icons, generates readme.txt, packs regicons.zip, and creates a Release with the ZIP attached:

git tag v1.0.0
git push origin v1.0.0

Download regicons.zip from the Release Assets (installable plugin archive). Source code archives from GitHub are for development, not for uploading to WordPress.

Local pack (after deno task build):

deno task readme
REGICONS_VERSION=1.0.0 deno task package
# → dist/regicons.zip

License

• Plugin code: GPL-2.0-or-later
• Bundled SVG icons: Ionicons (MIT) — see licenses/IONICONS-LICENSE.md