=== Cryptocurrency Product for WooCommerce ===
Contributors: ethereumicoio, freemius
Tags: woocommerce, ethereum, erc20, NFT, bitcoin
Requires at least: 4.7
Tested up to: 6.8.2
Stable tag: 3.20.2
Donate link: https://etherscan.io/address/0x476Bb28Bc6D0e9De04dB5E19912C392F9a76535d
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Requires PHP: 7.2.5

Cryptocurrency Ethereum Crypto WordPress Plugin for WooCommerce enables customers to buy Ether, Bitcoin or any ERC20 or NFT (ERC721) token.

== Description ==

Cryptocurrency Ethereum Crypto WordPress Plugin for WooCommerce is the best [WooCommerce](https://woocommerce.com/?aff=12943&cid=17113767) plugin that allows you to sell Ether, [Bitcoin](https://ethereumico.io/product/bitcoin-wordpress-plugin/) or any [NFT](https://ethereumico.io/product/nft-wordpress-plugin/) or ERC20 token for fiat money like USD, EUR, … or any cryptocurrency, like [Bitcoin](https://ethereumico.io/product/bitcoin-wordpress-plugin/), [Litecoin](https://ethereumico.io/product/litecoin-wordpress-plugin-for-woocommerce/), [Dogecoin](https://ethereumico.io/product/dogecoin-wordpress-plugin-for-woocommerce/) or any other [WooCommerce](https://woocommerce.com/?aff=12943&cid=17113767) supports.

https://youtu.be/cJQ7fH955Jo

You can sell your [NFT](https://ethereumico.io/product/nft-wordpress-plugin/) or ERC20 tokens for USD, EUR, or even Ether or another ERC20 token by using the [Ether and ERC20 tokens WooCommerce Payment Gateway](https://wordpress.org/plugins/ether-and-erc20-tokens-woocommerce-payment-gateway/) plugin.

> It can be a valuable addition to your ICO strategy with the [Ethereum ICO WordPress](https://ethereumico.io/product/ethereum-ico-wordpress-plugin/) plugin!

[Binance Smart Chain (BSC)](https://ethereumico.io/knowledge-base/binance-smart-chain-config/), [Polygon (MATIC)](https://ethereumico.io/knowledge-base/polygon-matic-wordpress-plugin/) and any other EVM-compatible blockchain is supported in the [PRO version](https://checkout.freemius.com/mode/dialog/plugin/4418/plan/7115/?trial=paid "The Cryptocurrency Product for WooCommerce Professional plugin")!

> The [Wordpress Ethereum Wallet](https://ethereumico.io/product/wordpress-ethereum-wallet-plugin/) plugin  auto-creates a user wallet upon registration and allows user to send Ether, [NFT](https://ethereumico.io/product/nft-wordpress-plugin/) or ERC20 tokens from it. Using these two plugins your non-techie customers can register to obtain an Ethereum account address and then buy your tokens to be sent to this new address.

== Live Demo ==

You can buy the [Testcoin TSX Token](https://ethereumico.io/product/tsx/) to see this WooCommerce Crypto Plugin in action.

The [Testcoin TSX Token](https://ethereumico.io/product/tsx/) product is a ERC20 token product configured with a help of this plugin. You can buy this token with fiat money, Bitcoin or Ether. TSX tokens would be sent to your wallet automatically and immediately.

== FREE Features ==

* Sell Ether for any [WooCommerce](https://woocommerce.com/?aff=12943&cid=17113767) supported currency
* Your customer can buy Ether just like any other product in [WooCommerce](https://woocommerce.com/?aff=12943&cid=17113767)
* The `Ethereum address` required input field is added to the Checkout page for all Cryptocurrency products
* Custom user meta key can be configured to fill the `Ethereum address` field automatically. With a plugin like [Ultimate Member](https://wordpress.org/plugins/ultimate-member/) you can configure your registration form to include a required `Ethereum address` field. You can use this address on a checkout page then.
* You also can disable the `Ethereum address` field to restrict user to buy only to the address they provide you on registration.
* The `Register on checkout` is supported without the `Ethereum address` input requirement
* Friendly admin panel
* `Ethereum Address` input field on the `Add new order` page to send Ether manually from admin panel
* Free to use for Ether. No fee.
* The minimum amount of Ether can be set for purchase to protect you from spam purchases
* The quantity increase/decrease step is configured per product
* The Ethereum transaction hash and link is added to the order notes to assist you in corner cases
* Stock availability is auto-managed
* Decimal product quantities can be inputted by users - you can sell 0.5 Ether for example
* The Ethereum Gas price is auto adjusted according to the [etherchain.org](https://www.etherchain.org) API
* The `Hot wallet` private key is auto generated first time plugin is installed
* Previous `Hot wallet` private key is stored in a hidden option object when new one is entered. This feature can save your life, seriously ;-)


== PRO Features ==

Includes all FREE features, plus:

* Sell any `ERC20` token for any [WooCommerce](https://woocommerce.com/?aff=12943&cid=17113767) supported currency
* Your customer can buy Ether or `ERC20` tokens just like any other product in [WooCommerce](https://woocommerce.com/?aff=12943&cid=17113767)
* Dynamic ETH or ERC20 token price from `Coinmarketcap.com`, `Cryptocompare.com`, `Coingecko.com` or `metals-api.com` can be configured. Set token price in Ether or any other crypto including the token itself, if listed on exchange, or bound it to a gold price
* The `Input in store currency` option: input product price in the store currency like USD, instead of the cryptocurrency selected
* The `Input in fixed store currency` option allows to create product with fixed price like 100$, but with a dynamic amount of cryptocurrency to be sent after this product purchase
* The `Ethereum Address` input box on the `Add new order` page is pre-populated with an address generated by the [Ethereum Wallet](https://ethereumico.io/product/wordpress-ethereum-wallet-plugin/) plugin if installed
* Display base cryptocurrency price for dynamically priced products option
* Use `Ethereum Node JSON-RPC Endpoint` setting for your own Ethereum or Ethereum fork node usage
* The `Expiration period` configuration option can be used to set the number of days to wait till mark an order as expired if no payment or blockchain transaction confirmation is detected. It is set to one week (7 days) by default.
* The `Require enough Ether on a Checkout page?` configuration option can be used to prevent spam orders creation by users with not enough Ether on their balances to pay for it.
* [Binance Smart Chain (BSC)](https://ethereumico.io/knowledge-base/binance-smart-chain-config/), [Polygon (MATIC)](https://ethereumico.io/knowledge-base/polygon-matic-wordpress-plugin/) and any other EVM-compatible blockchain support
* The [MultiSend](http://ethereumico.io/multisend) contract can be used to process many ERC20 orders at once to speedup orders processing up to 200 times and save gas fees.
* The [MultiSend](http://ethereumico.io/multisend) can be disabled in plugin settings if your token contract makes it impossible to use

> Take a full featured 7 days Trial for the PRO version! [The Cryptocurrency Product for WooCommerce Professional plugin 7 days Trial](https://checkout.freemius.com/mode/dialog/plugin/4418/plan/7115/?trial=paid "The Cryptocurrency Product for WooCommerce Professional plugin 7 days Trial")

= NFT Add-On =

The [NFT Add-On](https://ethereumico.io/product/nft-wordpress-plugin/) is available to sell any non-fungible ERC721 NFT token just like any other product in [WooCommerce](https://woocommerce.com/?aff=12943&cid=17113767). To use it, install the Cryptocurrency Product for WooCommerce and then go to Settings > Cryptocurrency Product > Add-Ons > NFT.

https://youtu.be/cJQ7fH955Jo

= Bitcoin Add-On =

The [Bitcoin Add-On](https://ethereumico.io/product/bitcoin-wordpress-plugin/) is available to sell Bitcoin just like any other product in [WooCommerce](https://woocommerce.com/?aff=12943&cid=17113767). To use it, install the Cryptocurrency Product for WooCommerce and then go to Settings > Cryptocurrency Product > Add-Ons > Bitcoin.

https://youtu.be/cw95Rz2zqRQ

= Litecoin Add-On =

The [Litecoin Add-On](https://ethereumico.io/product/litecoin-wordpress-plugin-for-woocommerce/) is available to sell Litecoin just like any other product in [WooCommerce](https://woocommerce.com/?aff=12943&cid=17113767). To use it, install the Cryptocurrency Product for WooCommerce and then go to Settings > Cryptocurrency Product > Add-Ons > Litecoin.

= Dash Add-On =

The [Dash Add-On](https://ethereumico.io/product/dash-wordpress-plugin-for-woocommerce/) is available to sell Dash just like any other product in [WooCommerce](https://woocommerce.com/?aff=12943&cid=17113767). To use it, install the Cryptocurrency Product for WooCommerce and then go to Settings > Cryptocurrency Product > Add-Ons > Dash.

= Dogecoin Add-On =

The [Dogecoin Add-On](https://ethereumico.io/product/dogecoin-wordpress-plugin-for-woocommerce/) is available to sell Dogecoin just like any other product in [WooCommerce](https://woocommerce.com/?aff=12943&cid=17113767). To use it, install the Cryptocurrency Product for WooCommerce and then go to Settings > Cryptocurrency Product > Add-Ons > Dogecoin.

= ERC20 Dividend Payments Add-On =

The [ERC20 Dividend Payments Add-On](https://ethereumico.io/product/erc20-dividend-token-payments/) is available to pay holders ERC20 dividends. To use it, install the Cryptocurrency Product for WooCommerce and then go to Settings > Cryptocurrency Product > Add-Ons > Dividends.

= Dynamic Price Add-On =

The [Dynamic Price Add-On](https://ethereumico.io/product/dynamic-price-wordpress-plugin-for-woocommerce/) is available. Create WooCommerce products dynamically priced as Bitcoin, Gold or any other currency, cryptocurrency or precious metal. Common usecase for the Dynamic Price WordPress Plugin is to implement a manual cryptocurrency delivery. To use it, install the Cryptocurrency Product for WooCommerce and then go to Settings > Cryptocurrency Product > Add-Ons > No-Op.

= WC Vendors Marketplace Add-On =

The [WC Vendors Marketplace Add-On](https://ethereumico.io/product/wc-vendors-marketplace-cryptocurrency-addon/) is available to support frontend features on your multi-vendor store. To use it, install the Cryptocurrency Product for WooCommerce and then go to Settings > Cryptocurrency Product > Add-Ons > WC Vendors Marketplace.

= WCFM Marketplace Add-On =

The [WCFM Marketplace Add-On](https://ethereumico.io/product/wcfm-marketplace-cryptocurrency-addon/) is available to support frontend features on your multi-vendor store. To use it, install the Cryptocurrency Product for WooCommerce and then go to Settings > Cryptocurrency Product > Add-Ons > WCFM Marketplace.

== Screenshots ==

1. The ERC20 token product in a store
2. The ERC20 token product settings
3. Hot wallet settings
4. API keys settings
5. Blockchain settings
6. Custom user field settings
7. The Cryptocurrency product checkout page
8. The order details
9. Set token price in Ether or any other crypto including the token itself, if listed on exchange
10. Existing NFT token product settings
11. The Bitcoin product settings

== Disclaimer ==

**By using this free plugin you accept all responsibility for handling the account balances for all your users.**

Under no circumstances is **ethereumico.io** or any of its affiliates responsible for any damages incurred by the use of this plugin.

Every effort has been made to harden the security of this plugin, but its safe operation depends on your site being secure overall. You, the site administrator, must take all necessary precautions to secure your WordPress installation before you connect it to any live wallets.

You are strongly advised to take the following actions (at a minimum):

- [Educate yourself about cold and hot cryptocurrency storage](https://en.bitcoin.it/wiki/Cold_storage)
- Obtain hardware wallet to store your coins
- [Educate yourself about hardening WordPress security](https://codex.wordpress.org/Hardening_WordPress)
- [Install a security plugin such as Jetpack](https://jetpack.com/pricing/?aff=9181&cid=886903) or any other security plugin
- **Enable SSL on your site** if you have not already done so.

> By continuing to use the Cryptocurrency Product for WooCommerce plugin, you indicate that you have understood and agreed to this disclaimer.

== Installation ==

* Make sure that [System Requirements](https://ethereumico.io/knowledge-base/cryptocurrency-product-for-woocommerce-plugin-system-requirements/) are met on your hosting provider. These providers are tested for compliance: [Cloudways](https://www.cloudways.com/en/?id=462243)
* Install and activate it as you would any other plugin
* Head over to Settings » Cryptocurrency Product

https://youtu.be/xg5k8Jc0VvA

== l10n ==

This plugin is localization ready.

Languages this plugin is available now:

* English
* Russian(Русский)
* German(Deutsche) by Johannes from decentris dot com

Feel free to translate this plugin to your language.

== Frequently Asked Questions ==

= Does this plugin takes any fees? =

> You pay NO FEE except the standard Ethereum transaction [gas fee](https://ethereum.org/en/developers/docs/gas/)

= How to configure the Ethereum Mainnet? =

https://youtu.be/CY_Oa-HOt5w

> Use this step by step guide: [Install and Configure](https://ethereumico.io/knowledge-base/cryptocurrency-product-for-woocommerce-plugin-install-and-configure)

= How to configure the Polygon (MATIC) Mainnet? =

https://youtu.be/ZDX4HD_TS5w

> Use this step by step guide: [Install and Configure](https://ethereumico.io/knowledge-base/binance-smart-chain-config/)

= How to configure the Binance Smart Chain (BSC) Mainnet? =

https://youtu.be/AF6PD0Frpck

> Use this step by step guide: [Install and Configure](https://ethereumico.io/knowledge-base/polygon-matic-wordpress-plugin/)

= How to configure for NFT tokens selling? =

https://youtu.be/eQMWirBXcXU

= How to Top Up Hot Wallet with ETH/BNB/MATIC? =

https://youtu.be/KD9BSP4iwTo

= How to test the Ether product on a Görli testnet? =

* Set the `Blockchain` setting to `Ethereum Görli Testnet`
* Request some Görli Ether from some faucet
* Install, configure to use the `Ethereum Görli Testnet` and enable the [Ether and ERC20 tokens WooCommerce Payment Gateway](https://wordpress.org/plugins/ether-and-erc20-tokens-woocommerce-payment-gateway/) plugin
* Create an Ether type cryptocurrency product
* Make a deposit of the Görli Ether for that product. See Installation/Deposit section for details.
* Buy this product for free by the [Ether and ERC20 tokens WooCommerce Payment Gateway](https://wordpress.org/plugins/ether-and-erc20-tokens-woocommerce-payment-gateway/) method. Input another Ethereum wallet address on the checkout page
* Check that proper amount of Görli Ether has been sent to your payment address

= How to test the Ether product on a Sepolia testnet? =

* Set the `Blockchain` setting to `Ethereum Sepolia Testnet`
* Request some Sepolia Ether from some faucet
* Install, configure to use `Ethereum Sepolia Testnet` and enable the [Ether and ERC20 tokens WooCommerce Payment Gateway](https://wordpress.org/plugins/ether-and-erc20-tokens-woocommerce-payment-gateway/) plugin
* Create an Ether type cryptocurrency product
* Make a deposit of the Sepolia Ether for that product. See Installation/Deposit section for details.
* Buy this product for free by the [Ether and ERC20 tokens WooCommerce Payment Gateway](https://wordpress.org/plugins/ether-and-erc20-tokens-woocommerce-payment-gateway/) method. Input another Ethereum wallet address on the checkout page
* Check that proper amount of Sepolia Ether has been sent to your payment address

= How to test the ERC20 product on a Görli testnet? =

[PRO version only!](https://checkout.freemius.com/mode/dialog/plugin/4418/plan/7115/?trial=paid "The Cryptocurrency Product for WooCommerce Professional plugin")

* Set the `Blockchain` setting to `Ethereum Görli Testnet`
* Request some Görli Ether from some faucet
* Buy some `0xb4354f51b51ab69d7415d54108dd2f68223c3239` TSX token by sending some Görli Ether amount to it's Crowdsale contract: `0x448276ac3c99620f02cc2ac60964aca44b20929a`
* Install, configure to use the `Ethereum Görli Testnet` and enable the [Ether and ERC20 tokens WooCommerce Payment Gateway](https://wordpress.org/plugins/ether-and-erc20-tokens-woocommerce-payment-gateway/) plugin
* Create a ERC20 type cryptocurrency product. Set the ERC20 token address setting to the `0xb4354f51b51ab69d7415d54108dd2f68223c3239`
* Make a deposit of the ERC20 token for that product. See Installation/Deposit section for details.
* Buy this product for free by the [Ether and ERC20 tokens WooCommerce Payment Gateway](https://wordpress.org/plugins/ether-and-erc20-tokens-woocommerce-payment-gateway/) method. Input another Ethereum wallet address on the checkout page
* Check that proper amount of TSX token has been sent to your payment address

= How to test the ERC20 product on a Sepolia testnet? =

[PRO version only!](https://checkout.freemius.com/mode/dialog/plugin/4418/plan/7115/?trial=paid "The Cryptocurrency Product for WooCommerce Professional plugin")

* Set the `Blockchain` setting to `Ethereum Sepolia Testnet`
* Request some Sepolia Ether from some faucet
* Buy some `0x9295a2ba374cf5d575d076c0a48ed12287ad4659` TSX token by sending some Sepolia Ether amount to it's Crowdsale contract: `0x1ddef0c5628fc54c1eb0f91a3fdba57b05549d13`
* Install, configure to use `Ethereum Sepolia Testnet` and enable the [Ether and ERC20 tokens WooCommerce Payment Gateway](https://wordpress.org/plugins/ether-and-erc20-tokens-woocommerce-payment-gateway/) plugin
* Create a ERC20 type cryptocurrency product. Set the ERC20 token address setting to the `0x9295a2ba374cf5d575d076c0a48ed12287ad4659`
* Make a deposit of the ERC20 token for that product. See Installation/Deposit section for details.
* Buy this product for free by the [Ether and ERC20 tokens WooCommerce Payment Gateway](https://wordpress.org/plugins/ether-and-erc20-tokens-woocommerce-payment-gateway/) method. Input another Ethereum wallet address on the checkout page
* Check that proper amount of TSX token has been sent to your payment address

== Changelog ==

= 3.20.2 =

* freemius library version update
* etherscan API v2 migration
* rate sources metadata update

= 3.20.1 =

* freemius library version update

= 3.20.0 =

* Checkout page blocks support for the Ethereum address field.
* freemius library version update

= 3.19.0 =

* Multisend can be disabled in plugin settings if your token contract makes it impossible to use
* ru_RU and de_DE l10n improved

= 3.18.1 =

* WooCommerce HPOS compatibility [improved](https://stackoverflow.com/a/78780956/4256005)
* Multisend fix to prevent same order to be sent twice if put to Processint status several times

= 3.18.0 =

* WooCommerce HPOS compatibility implemented

= 3.17.0 =

* long pending tx auto speedup is implemented
* freemius library version update
* Fix ERC20 token standard name display
* The polygon amoy testnet support is added
