=== WP RupeeFont ===
Contributors: ajmaurya
Tags: indian rupee, rupee symbol, inr, currency symbol, india
Donate link: https://ajmaurya.com/
Requires at least: 5.0
Tested up to: 6.7
Requires PHP: 7.4
Stable tag: 2.0.0
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Indian Rupee symbol (₹) for WordPress. Automatically converts Rs and Rs. to the INR symbol in posts, excerpts, and widgets.

== Description ==

**WP RupeeFont** is a lightweight WordPress plugin that automatically converts "Rs" or "Rs." in your content to the **Indian Rupee symbol (₹)** — the official sign for the Indian Rupee (INR), Unicode code point U+20B9.

Once activated, every `Rs 100`, `Rs.100`, or `Rs. 100` written in your posts, pages, excerpts, and text widgets is rendered as `₹ 100` on the front end. No JavaScript, no bundled fonts, no external requests, no configuration.

= Why a plugin for the rupee symbol? =

The ₹ symbol was introduced by the Government of India in 2010 and added to Unicode the same year. Most systems render it natively today, but a lot of older WordPress content was written with "Rs" or "Rs." because the Unicode character wasn't widely supported at the time. This plugin upgrades that legacy text to the modern Indian Rupee symbol on the fly — without you having to find-and-replace anything in your database.

= Features =

* **Server-side conversion** — runs in PHP via standard WordPress filters; no flash of unconverted content.
* **Zero front-end overhead** — no JavaScript, no CSS, no font files loaded on your site.
* **Zero configuration** — install, activate, done.
* **Word-boundary matching** — words like "Mrs" and "users" are never touched.
* **Code-safe** — text inside `<script>`, `<style>`, `<pre>`, `<code>`, and `<textarea>` is left alone.
* **Block editor and classic editor** both supported.
* **Filters covered:** `the_content`, `the_excerpt`, `widget_text`, `widget_block_content`.
* **Single PHP file** — no dependencies, no admin UI, no database tables.

= Common use cases =

* Indian blogs and news sites with legacy "Rs" pricing in older articles.
* Business and personal sites listing prices in Indian Rupees.
* Travel, finance, and review sites that mention rupee amounts in post content.
* Any WordPress site migrating older content to the modern Unicode rupee symbol.

= About the Indian Rupee Symbol (₹) =

The Indian Rupee sign (₹) was officially adopted by the Government of India on 15 July 2010, designed by D. Udaya Kumar of IIT Guwahati. The design combines the Devanagari letter "र" (ra) with a horizontal stroke representing the Indian tricolour. Its Unicode code point is **U+20B9 INDIAN RUPEE SIGN**, added in Unicode 6.0, and the ISO 4217 currency code for the Indian Rupee is **INR**.

== Installation ==

1. Upload the plugin to `/wp-content/plugins/` or install it via the **Plugins → Add New** screen.
2. Activate it through the **Plugins** menu.
3. Done — there is no configuration screen. Existing "Rs" / "Rs." text in your posts will display as ₹ immediately.

== Frequently Asked Questions ==

= How do I add the Indian Rupee symbol (₹) to my WordPress site? =

Install and activate WP RupeeFont. Any "Rs" or "Rs." already written in your posts, pages, excerpts, and text widgets will render as ₹ on the front end automatically. There are no shortcodes, no settings, and no database changes.

= What is the Unicode for the Indian Rupee symbol? =

The Indian Rupee sign is **U+20B9** in Unicode (named INDIAN RUPEE SIGN), introduced in Unicode 6.0 in October 2010. The character itself is ₹.

= How does the plugin convert Rs to ₹? =

It hooks into the standard WordPress content filters and runs a server-side PHP regular expression that matches "Rs" or "Rs." at word boundaries and replaces them with the Unicode character ₹. The conversion happens before the page is sent to the browser, so visitors never see "Rs" flicker on screen.

= Does the plugin load any JavaScript or fonts? =

No. Version 2.0 removed all bundled JavaScript, CSS, and font files. The plugin adds zero requests and zero bytes to your front-end page weight.

= Does it work with the block editor (Gutenberg)? =

Yes. The plugin filters `the_content`, which is what both the block editor and the classic editor produce on the front end.

= Will it touch text inside code blocks or scripts? =

No. Text inside `<script>`, `<style>`, `<pre>`, `<code>`, and `<textarea>` is left untouched, so code samples and embedded scripts are not affected.

= Why is "Mrs" or "users" not converted? =

The plugin uses a word-boundary match, so "Rs" only converts when it stands alone as a word. Words that happen to contain the letters "Rs" are never changed.

= Why is lowercase "rs" not converted? =

Conversion is case-sensitive (only "Rs" or "Rs."). This is a deliberate choice to avoid false positives such as filenames, identifiers, and words that contain "rs" in lowercase.

= Does this plugin affect prices shown by e-commerce or shop plugins? =

No. E-commerce plugins render prices through their own templating, not through `the_content`, so this plugin does not change cart, checkout, product, or order prices. Most e-commerce plugins already support Indian Rupee as a built-in currency option — that is the right place to configure store pricing. WP RupeeFont is for ordinary post and page text.

= Where in the post content does it run? =

On `the_content` (post body), `the_excerpt` (excerpts), `widget_text` (legacy text widgets), and `widget_block_content` (block widgets).

= How do I disable it for a specific filter? =

Call `remove_filter( 'the_content', 'wp_rupeefont_convert' );` (or any of the other filter names) from your theme's `functions.php` or another plugin.

== Screenshots ==

1. "Rs" in post content rendered as ₹.

== Changelog ==

= 2.0.0 =
* Complete rewrite. Replaced client-side WebRupee JavaScript and bundled font with server-side Unicode (₹) substitution.
* Removed all bundled assets (JS, CSS, font files). The plugin is now a single PHP file.
* Conversion runs in PHP via standard WordPress filters. No front-end requests.
* Skips content inside `<script>`, `<style>`, `<pre>`, `<code>`, and `<textarea>`.
* Conversion is now case-sensitive (only "Rs" / "Rs.") to reduce false positives.
* Now also filters `the_excerpt`, `widget_text`, and `widget_block_content`.
* Tested with WordPress 6.7. Requires PHP 7.4 or later.

= 1.1.0 =
* Missing WebRupee CSS file error resolved.

= 1.0.0 =
* First public release.

== Upgrade Notice ==

= 2.0.0 =
Major rewrite. Now uses the Unicode rupee symbol (₹) instead of a bundled web font. Output HTML changes — see the Description for details.