Leírás
Ever wanted to add a special character while working within the WordPress block editor (Gutenberg) and suddenly find yourself longing for the days of the Classic Editor and the Special Character inserter? Well long no more, the Insert Special Characters plugin is here to ease your publishing woes!
Note: you can display the popover via the ctrl
/cmd
+ o
keyboard shortcut.
Development takes place in the GitHub repository.
Technical Notes
- Requires PHP 7.4+.
- Requires WordPress 5.7+
- Issues and Pull requests welcome in the GitHub repository.
Extending
To control the available tabs and characters, developers can filter the data set using the insertspecialcharacters-characters
JavaScript (wp.hooks
) filter.
For example, to create a character inserter that only provides currency symbols:
wp.hooks.addFilter(
'insertspecialcharacters-characters', // The filter name.
'mycallback', // Our callback namespace.
function( component ) { // The callback function.
// Return the categories/characters to display.
// The data structure is: { category: [ character data ], category2: ... }
return {
"Currency": [
{ "entity": "$", "hex": "", "name": "Dollar Sign", "char": "$" },
{ "entity": "€", "hex": "AC;", "name": "Euro Sign", "char": "€" },
{ "entity": "¢", "hex": "�A2;", "name": "Cent Sign", "char": "¢" },
{ "entity": "£", "hex": "�A3;", "name": "Pound Sign", "char": "£" },
{ "entity": "¥", "hex": "�A5;", "name": "Yen Sign", "char": "¥" },
]
};
}
);
Képernyőmentések
Telepítés
- Install the plugin via the plugin installer, either by searching for it or uploading a .zip file.
- Activate the plugin.
- Use Insert Special Characters!
GYIK
-
How come I do not see all the special characters?
-
When a character is displayed using a font that doesn’t support that character, a default „not defined” glyph from that font is used. The „not defined” glyph in most fonts has the appearance of a rectangular box, or some variation of that.
One example of a font with support for wide range of glyphs is the Noto family by Google Fonts, which can be loaded by the theme to render the missing characters.
Vélemények
Közreműködők és fejlesztők
“Insert Special Characters” egy nyílt forráskódú szoftver. A bővítményhez a következő személyek járultak hozzá:
Közreműködők“Insert Special Characters” 5 nyelvre lett lefordítva. Köszönet a fordítóknak az áldozatos munkájukért!
“Insert Special Characters” fordítása a saját nyelvünkre.
Érdekeltek vagyunk a fejlesztésben?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Változási napló
1.1.2 – 2024-01-08
- Added: Support for the WordPress.org plugin preview (props @dkotter, @jeffpaul via #232).
- Fixed: Issue with blocks crashing due to faux caret (props @Sidsector9, @dkotter, @ankitguptaindia via #225).
- Fixed: Issue with characters added to the beginning trimming text from the end (props @Sidsector9, @dkotter, @ankitguptaindia via #225).
- Changed: Bump WordPress „tested up to” version to 6.4 (props @qasumitbagthariya, @jeffpaul, @QAharshalkadu, @ankitguptaindia, @dhanendran, @iamdharmesh via #228).
1.1.1 – 2023-10-17
- Fixed: Address an issue where some blocks would crash due to a missing attribute (props @dkotter via #221).
- Security: Bump
@babel/traverse
from 7.20.5 to 7.23.2 (props @dependabot, @dkotter via #219).
1.1.0 – 2023-10-16
- Added: Show a faux cursor to preserve context (props @Sidsector9, @helen, @ravinderk via #207).
- Added: Check for minimum required PHP version before loading the plugin (props @kmgalanakis, @peterwilsoncc via #210).
- Changed: Bump WordPress „tested up to” version to 6.3 (props @kmgalanakis, @jeffpaul, @peterwilsoncc via #212, #215).
- Fixed: Ensure that when highlighting a special character, the block doesn’t crash (props @jrmd, @dkotter via #204).
- Security: Bump
semver
from 5.7.1 to 5.7.2 (props @dependabot, @dkotter via #202). - Security: Bump
word-wrap
from 1.2.3 to 1.2.4 (props @dependabot, @Sidsector9 via #206). - Security: Bump
@cypress/request
from 2.88.10 to 3.0.0,cypress
from 12.8.1 to 13.3.1 and@10up/cypress-wp-utils
from 0.1.0 to 0.2.0 (props @dependabot, @dkotter via #213). - Security: Bump
tough-cookie
from 4.1.2 to 4.1.3 and@cypress/request
from 2.88.10 to 2.88.12 (props @dependabot, @ravinderk via #214). - Security: Bump
postcss
from 8.4.20 to 8.4.31 (props @dependabot, @faisal-alvi via #216).
1.0.7 – 2023-06-28
- Added: Mochawesome reporter added for Cypress test report (props @jayedul, @peterwilsoncc via #194).
- Changed: Bump WordPress „tested up to” version 6.2 (props @jayedul, @peterwilsoncc, @Sidsector9 via #192, #193).
- Changed: Run E2E tests on the zip generated by „Build release zip” action (props @jayedul, @peterwilsoncc via #190).
- Fixed: Maintain text formatting when inserting a character (props @jrmd, @Sidsector9 via #187).
- Fixed: Ensure grid positioning is correct when text is selected (props @bmarshall511, @peterwilsoncc via #195).
- Fixed: Popover grid positioning in the Site Editor (props @bmarshall511, @fabiankaegy via #199).
- Fixed: Address failing E2E tests in WP 6.2 (props @ggutenberg, @iamdharmesh via #189).
- Security: Bump
@sideway/formula
from 3.0.0 to 3.0.1 (props @dependabot, @faisal-alvi via #186). - Security: Bump
webpack
from 5.75.0 to 5.76.1 (props @dependabot, @faisal-alvi via #188). - Security: Bump
simple-git
from 3.15.1 to 3.19.1 (props @dependabot, @dkotter via #200). - Security: Bump
ua-parser-js
from 0.7.32 to 0.7.35 (props @dependabot, @dkotter via #201).
1.0.6 – 2023-02-07
Note that this release bumps the WordPress minimum from 5.7 to 6.1. and minimum PHP version from 5.6 to 7.4
- Added: Scanning of dependencies to ensure they are GPL-compatible (props @jeffpaul, @vikrampm1, @GeekMasher, @dkotter, @Sidsector9 via #157, #164).
- Added: GitHub Action workflow to build a pre-release ZIP (props @Sidsector9, @dkotter via #174).
- Changed: Support Level from
Active
toStable
(props @jeffpaul, @Sidsector9 via #184). - Changed: Bump minimum PHP version from 5.6 to 7.4 (props @Sidsector9, @cadic via #166).
- Changed: Bump minimum WordPress version from 5.5 to 5.7 (props @Sidsector9, @cadic via #166).
- Changed: Bump minimum supported WordPress version from 5.7 to 6.1 (props @Sidsector9, @faisal-alvi, @iamdharmesh, @jeffpaul via #173).
- Changed: Bump minimum Node version from 12 to 16 (props @Sidsector9, @cadic via #166).
- Changed: Updated documentation and plugin screencast GIF demo (props @jeffpaul, @cadic via #163).
- Fixed: Non-breaking spacing
character (props @redorca, @Sidsector9, @iamdharmesh via #159). - Fixed: WordPress minimum supported version to 5.5 (props @grappler, @dkotter via #158).
- Fixed: Translation issue for the string „Most Used” (props @alexclassroom, @Sidsector9, @faisal-alvi, @iamdharmesh via #172).
- Security: Bump
wp-env
from 4.9 to to 5.3 (props @peterwilsoncc, @Sidsector9 via #161). - Security: Bump
loader-utils
from 2.0.2 to 2.0.4 (props @dependabot, @Sidsector9 via #171). - Security: Bump
simple-git
from 3.14.1 to 3.16.0 (props @dependabot, @jeffpaul via #175, #182). - Security: Bump
json5
from 1.0.1 to 1.0.2 (props @dependabot, @Sidsector9 via #180). - Security: Bump
ua-parser-js
from 0.7.32 to 0.7.33 (props @dependabot, @peterwilsoncc via #183). - Security: Bump
http-cache-semantics
from 4.1.0 to 4.1.1 (props @dependabot, @Sidsector9 via #185).
1.0.5 – 2022-07-18
Note that this release bumps the WordPress minimum supported version from 5.4 to 5.5.
- Added: Most and last used character palette. Most used palette can be turned on by going to
Settings > Writing
(props @Sidsector9, @faisal-alvi via #147). - Added: End-to-end testing with Cypress (props @Sidsector9, @iamdharmesh via #116).
- Added: More robust PHP testing, including PHP 8 compatibility (props @Sidsector9, @dkotter, @cadic via #118, #129).
- Added: Dependency security scanning (props @jeffpaul, @Sidsector9 via #126).
- Changed: Character palette UI changed to be in alignment with Gutenberg (props @Sidsector9, @faisal-alvi via #147).
- Changed: Bump WordPress version „tested up to” 6.0 (props @vikrampm1, @jeffpaul via #125).
- Changed: Bump WordPress minimum supported version from 5.4 to 5.5 (props @dkotter, @jeffpaul, @peterwilsoncc via #150).
- Changed: Release instructions to ensure dependency updates are included (props @jeffpaul via #155).
- Fixed: Address an issue where the inserter popup can overflow which prevents user from selecting characters (props @cldhmmr, @Sidsector9, @peterwilsoncc via #130).
- Fixed: Ensure required WordPress libraries were included as dependencies (props @peterwilsoncc, @Sidsector9, @iamdharmesh via #132).
- Security: Bump
guzzlehttp/psr7
from 1.6.1 to 1.8.5 (props @dependabot via #119). - Security: Bump
minimist
from 1.2.5 to 1.2.6 (props @dependabot via #120). - Security: Bump
ansi-regex
from 3.0.0 to 3.0.1 (props @dependabot via #121). - Security: Bump
async
from 2.6.3 to 2.6.4 (props @dependabot via #124). - Security: Bump
semver-regex
from 3.1.3 to 3.1.4 (props @dependabot via #128). - Security: Bump
react-character-map
from 0.4.4 to 0.4.6 (props @dependabot via #139). - Security: Bump
@wordpress/env
from 4.3.1 to 4.9.0 (props @dependabot via #140). - Security: Bump
@10up/cypress-wp-utils
fromecf048c
tod52e775
(props @dependabot via #142). - Security: Bump
husky
from 4.3.8 to 8.0.1 (props @dependabot via #144).
1.0.4 – 2022-01-27
- Added: Many new special characters (e.g., ⅐, ⅑, ⅒, single quotation marks, ß, ẞ, Ć, ć, Ḉ, ḉ) and grouping (Music) (props @jeffpaul, @Sidsector9).
- Added: Issue management automation and CodeQL analysis via GitHub Actions (props @jeffpaul, @cadic).
- Changed: Move icon from dropdown to block format toolbar (props @pabamato, @jeffpaul, @Sidsector9, @mahnunchik).
- Changed: Updated
react-character-map
from 0.4.2 to 0.4.4 (props @jeffpaul, @Sidsector9). - Changed: Bump WordPress „tested up to” version 5.9 (props @cadic, @sudip-10up).
- Changed: Documentation updates (props @faisal-alvi, @sudip-10up).
- Fixed: Character map popover scrolling issue on mobile viewport (props @ajmaurya99, @Sidsector9, @adamsilverstein, @helen).
1.0.3 – 2021-08-17
- Added: Many new special characters (e.g., em dash, en dash, hair space, thin space, no-break space, en space, em space, zero width non-joiner, non-breaking hyphen) and groupings (Currency, Punctuation, Greek).
- Added: Focus style on buttons to improve accessibility for keyboard users (props @samikeijonen).
- Added: WP Acceptance tests (props @johnwatkins0, @jeffpaul).
- Changed: Update to React Character Map
v0.4.2
(props @johnwatkins0, @dinhtungdu, @jeffpaul). - Changed: Integrate @wordpress/scripts for building and linting (props @johnwatkins0, @ocean90, @adamsilverstein).
- Changed: Renamed release branch from
master
totrunk
, so please make sure to update and direct references tomaster
in downstream code (props @jeffpaul). - Changed: Bump WordPress version „tested up to” 5.8 (props @jeffpaul, @davidchabbi, @pabamato, @ankitguptaindia, @phpbits, @BBerg10up).
- Changed: Documentation updates (props @bobbingwide).
- Fixed: Make UI text in the component translatable (props @johnwatkins0, @dinhtungdu).
- Fixed: Popover initial focus on top instead of bottom or center of the contents (props @phpbits, @BBerg10up).
- Fixed: Compatility with the new widget screen in WordPress 5.8 and formatting of returned elements (props @phpbits).
- Security: Bump
acorn
from 5.7.3 to 5.7.4 (props @dependabot). - Security: Bump
ini
from 1.3.5 to 1.3.7 (props @dependabot). - Security: Bump
elliptic
from 6.5.2 to 6.5.4 (props @dependabot). - Security: Bump
y18n
from 4.0.0 to 4.0.1 (props @dependabot). - Security: Bump
rmccue/requests
from 1.7.0 to 1.8.0 (props @dependabot). - Security: Bump
ssri
from 6.0.1 to 6.0.2 (props @dependabot). - Security: Bump
lodash
from 4.17.15 to 4.17.21 (props @dependabot). - Security: Bump
browserslist
from 4.8.7 to 4.16.6 (props @dependabot). - Security: Bump
path-parse
from 1.0.6 to 1.0.7 (props @dependabot).
1.0.2 – 2019-11-22
- Changed: Relicensed from MIT to GPLv2.
- Fixed: Hook on
enqueue_block_editor_assets
so script is only enqueued in editor (props @adamsilverstein, @josch87). - Fixed: Register text domain to ensure translations can be loaded (props @ocean90).
- Fixed: Bump WordPress version „tested up to” 5.3 (props @adamsilverstein).
- Fixed: Documentation and credits (props @jeffpaul).
1.0.1 – 2019-09-06
- Added: Documentation for keyboard shortcut (props @mrwweb, @jeffpaul).
- Fixed: Ensure character map appears as expected in Firefox (props @adamsilverstein).
1.0.0 – 2019-08-21
- Added: Initial plugin release 🎉.
- Added: Wrap React Character Map in a Gutenberg Popover (props @adamsilverstein).
- Added: Plugin header and icon images (props @dillonmccallum).