=== SPP Custom Currency Symbol for WooCommerce ===
Contributors: developer suspended.suspended
Tags: woocommerce, currency, symbol, custom currency, localization
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Override the default WooCommerce currency symbol with a custom string via a simple settings field.

== Description ==

**SPP Custom Currency Symbol for WooCommerce** simplifies localization setups for storefronts by providing a clean input field that overwrites the default core currency display symbol.

Instead of editing theme files or writing custom code, store owners can set any custom currency symbol (text, HTML entity, or Unicode character) directly from the WooCommerce settings panel.

= Features =

* Simple toggle to enable/disable the custom symbol.
* Text input field for entering any custom currency string.
* Works globally across your entire storefront.
* Integrates natively into WooCommerce settings as a dedicated tab.
* Lightweight — no bloat, no unnecessary assets.
* Compatible with WooCommerce HPOS (High-Performance Order Storage).
* Clean uninstall — removes all data when the plugin is deleted.

= Use Cases =

* Display a localized currency abbreviation (e.g., "Rs." instead of "₹").
* Show a custom HTML entity or Unicode symbol.
* Use text-based currency labels for clarity (e.g., "$", "৳", "kr").

== Installation ==

1. Upload the `spp-custom-currency-symbol-for-woocommerce` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Navigate to **WooCommerce > Settings > Currency Symbol** tab.
4. Check the **Enable Custom Symbol** checkbox.
5. Enter your desired currency symbol in the text field.
6. Click **Save changes**.

== Frequently Asked Questions ==

= Does this plugin require WooCommerce? =

Yes. WooCommerce must be installed and active for this plugin to function.

= Can I use HTML entities as my custom symbol? =

Yes. You can enter HTML entities like `&#8377;` (₹) or `&euro;` (€) and they will render correctly on the storefront.

= Will this affect the currency code used in payment gateways? =

No. This plugin only changes the display symbol. The actual currency code used by WooCommerce for payment processing remains unchanged.

= What happens if I deactivate the plugin? =

The default WooCommerce currency symbol will be restored immediately. Your settings are preserved in case you reactivate later.

= What happens if I delete the plugin? =

All plugin settings are permanently removed from the database via the uninstall routine.

== Screenshots ==

1. The Currency Symbol settings tab in WooCommerce settings.
2. Storefront displaying the custom currency symbol.

== Changelog ==

= 1.0.0 =
* Initial release.
* Added custom currency symbol text field.
* Added enable/disable toggle.
* Added WooCommerce settings tab integration.
* Added HPOS compatibility declaration.
* Added clean uninstall routine.

== Upgrade Notice ==

= 1.0.0 =
Initial release.
