Saudi Riyal Symbol
This module adds the official Saudi Riyal symbol (﷼) to your Drupal site, ensuring it displays correctly in the editor and on the front-end. It includes a dedicated font and a CKEditor button for easy insertion, and also supports a `[riyal]` token for use in various text fields without altering your site's theme fonts.
Adds the new official Saudi Riyal Symbol (﷼ / Unicode U+20C1) to your Drupal site and makes it render correctly everywhere: in the CKEditor 5 editor and on the front-end, on any theme.
The symbol was introduced in 2025 and most system/web fonts don't yet include the glyph, so it normally shows as a "tofu" box (□). This module bundles the official Saudi Riyal font and renders the sign with it, without touching your theme's own fonts.
Features
- CKEditor 5 toolbar button to insert the Saudi Riyal Symbol directly while editing.
[riyal]token: type[riyal]in any text field (a title/string field or a rich-text body) and it's replaced with the symbol on display. No closing tag needed.- Bundled font: ships the official Saudi Riyal font; no external requests or CDN.
- Theme-agnostic: uses a dedicated
.saudi-riyal-signwrapper and CSSunicode-range, so only the symbol glyph uses the bundled font. Your theme's fonts (including custom fonts) are never overridden. Works with Bootstrap themes and fully custom themes alike. - Loads only when needed: the font CSS is attached to a page only when the symbol/token is actually present, so there's no performance cost on pages that don't use it.
- Works with any field formatter: rich-text fields are handled by a text filter inside the normal text-format pipeline (so it composes correctly with "Trimmed", "Summary", etc.); plain-text fields are handled by a field preprocess hook.
Requirements
- Drupal 10 / 11
- Core CKEditor 5 and Filter modules
Installation
Install as you would any contributed module:
composer require drupal/saudi_riyal_symbol drush en saudi_riyal_symbol
Or download and place in modules/contrib, then enable it from the Drupal admin interface.
Usage
In CKEditor 5: add the "Saudi Riyal Sign" button to your toolbar via Configuration → Content authoring → Text formats and editors, then click it to insert the symbol.
With the token: type [riyal] anywhere in a text field, for example 1,000 [riyal], and it renders as 1,000 ﷼. The token is case-insensitive and tolerates spaces.
Configuration
For the [riyal] token to work in rich-text (formatted) fields, enable the "Render the Saudi Riyal Sign" filter on the relevant text format(s) at Text formats and editors. Place it last in the filter order. Plain-text fields (string fields) need no configuration; they work automatically.