WP Manifestindependent plugin directory
manifest / editor / custom-emoji

Emoji Autocomplete + Custom Emojis

WordPress plugin that adds :shortcode: autocomplete in the block editor, supports custom emoji uploads (SVG/images), includes Simple Icons slugs, and offers export/import tools.

by James LePage · github.com/jameswlepage/custom-emoji

★ 1stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/jameswlepage/custom-emoji/archive/refs/heads/main.zip
Readme github.com/jameswlepage/custom-emoji ↗

Block editor autocomplete for :shortcode: plus custom emoji uploads (SVG/images), Simple Icons lookup, and export/import tools.

Features

  • :-triggered autocomplete with standard emoji, custom uploads, and Simple Icons slugs (e.g., :github:).
  • Frontend + editor rendering with inline SVG/image output.
  • Admin screen to add/delete custom emojis and media.
  • Tools → Export/Import for JSON backups.
  • SVG upload support (admins) with sanitization.

Installation

  1. Copy this folder to wp-content/plugins/custom-emoji/.
  2. Activate:
    • WP Admin → Plugins → Activate “Emoji Autocomplete + Custom Emojis”, or
    • WP-CLI: wp plugin activate custom-emoji

Usage

  • In the block editor, type : to see autocomplete; pick any standard emoji, custom upload, or Simple Icons slug.
  • Manage custom emojis at Settings → Emojis.
  • Export/Import via Tools → Export/Import (Custom Emojis).

Preview (Playground CLI)

From the plugin root:

npx @wp-playground/cli@latest server \
  --port 9500 \
  --login \
  --mount .:/wordpress/wp-content/plugins/custom-emoji

Open http://127.0.0.1:9500/wp-admin/plugins.php, activate “Emoji Autocomplete + Custom Emojis” once, then create/edit posts to test autocomplete.

Preview (WP-CLI on a local WP install)

wp plugin activate custom-emoji
wp theme activate twentytwentyfour   # or your theme
wp post create --post_title="Emoji Demo" --post_content="Hello :wave: :github:" --post_status=publish

Visit your site to see the rendered emojis. After code changes, reload with: wp plugin deactivate custom-emoji && wp plugin activate custom-emoji.

Releasing

  1. Update the plugin header in custom-emoji.php with the new version and commit your changes.
  2. (Optional) Build a zip locally with bin/build-zip.sh 0.2.0, which creates dist/custom-emoji-0.2.0.zip. This is the exact artifact Actions will publish.
  3. Push your changes and create a GitHub Release using a tag like v0.2.0, then click Publish release.
  4. The “Build Release Zip” workflow packages the plugin, uploads the zip as a workflow artifact, and attaches it to the release automatically. If you need to re-run without publishing a release, trigger the workflow manually via Actions → Build Release Zip → Run workflow and supply the version number.