=== Currency Preamble for WooCommerce ===
Contributors: sseyisamuel
Donate link: https://collegeprowebsites.com/
Tags: woocommerce, currency, prices, ecommerce, multi-currency
Requires at least: 5.5
Tested up to: 6.9
Requires PHP: 7.2
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add a custom currency preamble (e.g., CAD, USD) before or after WooCommerce prices to make pricing clearer for your customers.

== Description ==

Many stores sell across regions, and customers can easily confuse pricing if they don't know which currency applies (e.g., CAD vs USD).

This plugin solves that problem by letting you add a currency preamble before or after the price display.

= Examples =

* CAD $19.99
* $19.99 USD

= Features =

* Add custom preamble text (e.g., CAD, USD)
* Choose position: before or after the price
* Disable easily when not needed
* Works across all WooCommerce price displays (product pages, cart, checkout, emails)
* Lightweight & secure – no unnecessary bloat
* Translation ready

= Perfect for: =

* Stores serving multiple regions
* Canadian stores differentiating from USD
* International stores needing currency clarity
* Any shop wanting clearer price display

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/currency-preamble-for-woocommerce/` directory, or install through the WordPress plugins screen
2. Activate the plugin through the 'Plugins' screen in WordPress
3. Go to **WooCommerce → Settings → General** and scroll to **Currency Preamble** section
4. Enter your desired preamble text (e.g., CAD, USD) and choose position
5. Save changes

== Frequently Asked Questions ==

= Can I disable the preamble? =

Yes! Either leave the text field blank or set the position to "Disable" in the settings.

= Does it work on checkout and order emails? =

Yes, it applies globally wherever WooCommerce displays prices, including cart, checkout, order emails, and admin reports.

= Will this work with my currency symbol? =

Yes, it works with any currency symbol configured in WooCommerce. The preamble appears alongside your existing currency symbol.

= Does it support multiple currencies? =

This plugin adds a static preamble to all prices. For dynamic multi-currency switching, you'll need a dedicated multi-currency plugin.

= Is it translation ready? =

Yes! The plugin is fully translation ready with included .pot file.

== Screenshots ==

1. Settings page in WooCommerce → Settings → General
2. Example: CAD $19.99 displayed on product page
3. Cart page showing preamble on all prices
4. Checkout total with currency preamble


== Changelog ==

= 1.0.1 =
* Fixed: Currency preamble now displays correctly on sale prices
* Fixed: Preamble appears before both original and sale price when position is set to "before"
* Fixed: Plugin icon
   
= 1.0.0 =
* Initial release.


== Additional Information ==

For support, feature requests, or bug reports, please visit the plugin support forum or contact us through our website.

Plugin developed by [CollegeproWebsites](https://collegeprowebsites.com/)