=== GNU Taler Payment Gateway for WooCommerce ===
Version: 1.1.0
Author: Taler Systems SA
Contributors: gnutaler
Tags: WooCommerce, e-commerce, Taler, Payment Gateway
Requires at least: 6.5
WC Requires at least: 9.6
Tested up to: 10.1
Stable tag: 7.4
Requires PHP: 7.2
License: GNU General Public License v2.0+
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Online payment plugin for WooCommerce powered by GNU Taler

== Description ==

This plugin provides a safe and secure way to pay via the GNU Taler system. The plugin sends a request to, and receives a response from, the GNU Taler Backend.

Next, the plugin confirms the transaction again and redirects the customer to his own wallet to confirm the transaction.

The plugin also provides the possibility for the administrator to send the custumer a refund.

For refunds, the plugin sends a refund request to the GNU Taler back-end and receives a refund-URI.  This URI is forwarded to the customer via an e-mail to confirm the refund.


== Build instructions ==

To build this project from source, run:

```
npm install
npm run packages-update
npm run build
```

== Installation ==

1. Ensure you have latest version of WooCommerce plugin installed and
   are running PHP 7.1 or later

2. Upload (or copy) the plugin directory (`GNU-Taler-Payment-Gateway`)
   to the `/wp-content/plugins/` directory of your
   WordPress/WooCommerce site, or install the plugin through the
   WordPress plugins interface at `<your-site>/wp-admin/plugins.php`.

3. Activate the GNU Taler Payment Gateway for WooCommerce plugin
   through the 'Plugins' screen in WordPress.

4. In the WordPress interface, navigate to
     WooCommerce -> Settings->Payments tab.
   Locate the `GNU Taler Gateway` entry and click the
   `Set up` button to configure the plugin.

5. For the access token, obtain an E-commerce access token from
   the GNU Taler merchant backend via the "Access tokens" menu
   (available starting with GNU Taler 1.1)

== Frequently Asked Questions ==

*Q: Where can customers get digital cash to pay?*

A: Since 2025 GNU Taler is operated in Switzerland by
   Taler Operations AG (https://taler-ops.ch/) and
   is available to Swiss businesses and residents.

*Q: Where else can I get a bank account to test the plugin?*

A: You need to have a "bank" account to receive or
   withdraw cash. For testing, you can easily get a
   bank account using "KUDOS" for testing at:
   https://bank.demo.taler.net/

*Q: What is needed to make a payment with GNU Taler?*

A: The customer needs the GNU Taler Wallet.
   The customer can get a wallet here:
   https://wallet.taler.net/

*Q: Can the plugin work without WooCommerce?*

A: For the plugin to work correctly you must to have
   WooCommerce installed on a WordPress site.


== Changelog ==

= 1.1.0 =

* Adapt plugin to new "Blocks" API of WooCommerce taking inspiration
  from the woocommerce-gateway-dummy (GPLv3+).
* Added bin/install_phpcs.sh to easily install phpcs and dependencies

= 0.9.4 =

* Use billing address in contract if shipping address is not given

= 0.9.3 =

* Fix log logic
* Fix header transmission

= 0.9.2 =

* Improve comments about settings, especially explain "secret-token:" prefix.
* Automatically add "Bearer" to "Authorization" header.
* Minor refactoring to match contemporary plugins better.

= 0.8.0 =

* Adaptations to GNU Taler Merchant API 1:0:0
* Ensure plugin follows Wordpress guidelines. First upload to WordPress.