readme.txt (3461B)
1 === GNU Taler Payment Gateway for WooCommerce === 2 Version: 1.1.0 3 Author: Taler Systems SA 4 Contributors: gnutaler 5 Tags: WooCommerce, e-commerce, Taler, Payment Gateway 6 Requires at least: 6.5 7 WC Requires at least: 9.6 8 Tested up to: 10.1 9 Stable tag: 7.4 10 Requires PHP: 7.2 11 License: GNU General Public License v2.0+ 12 License URI: http://www.gnu.org/licenses/gpl-2.0.html 13 14 Online payment plugin for WooCommerce powered by GNU Taler 15 16 == Description == 17 18 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. 19 20 Next, the plugin confirms the transaction again and redirects the customer to his own wallet to confirm the transaction. 21 22 The plugin also provides the possibility for the administrator to send the custumer a refund. 23 24 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. 25 26 27 == Build instructions == 28 29 To build this project from source, run: 30 31 ``` 32 npm install 33 npm run packages-update 34 npm run build 35 ``` 36 37 == Installation == 38 39 1. Ensure you have latest version of WooCommerce plugin installed and 40 are running PHP 7.1 or later 41 42 2. Upload (or copy) the plugin directory (`GNU-Taler-Payment-Gateway`) 43 to the `/wp-content/plugins/` directory of your 44 WordPress/WooCommerce site, or install the plugin through the 45 WordPress plugins interface at `<your-site>/wp-admin/plugins.php`. 46 47 3. Activate the GNU Taler Payment Gateway for WooCommerce plugin 48 through the 'Plugins' screen in WordPress. 49 50 4. In the WordPress interface, navigate to 51 WooCommerce -> Settings->Payments tab. 52 Locate the `GNU Taler Gateway` entry and click the 53 `Set up` button to configure the plugin. 54 55 5. For the access token, obtain an E-commerce access token from 56 the GNU Taler merchant backend via the "Access tokens" menu 57 (available starting with GNU Taler 1.1) 58 59 == Frequently Asked Questions == 60 61 *Q: Where can customers get digital cash to pay?* 62 63 A: Since 2025 GNU Taler is operated in Switzerland by 64 Taler Operations AG (https://taler-ops.ch/) and 65 is available to Swiss businesses and residents. 66 67 *Q: Where else can I get a bank account to test the plugin?* 68 69 A: You need to have a "bank" account to receive or 70 withdraw cash. For testing, you can easily get a 71 bank account using "KUDOS" for testing at: 72 https://bank.demo.taler.net/ 73 74 *Q: What is needed to make a payment with GNU Taler?* 75 76 A: The customer needs the GNU Taler Wallet. 77 The customer can get a wallet here: 78 https://wallet.taler.net/ 79 80 *Q: Can the plugin work without WooCommerce?* 81 82 A: For the plugin to work correctly you must to have 83 WooCommerce installed on a WordPress site. 84 85 86 == Changelog == 87 88 = 1.1.0 = 89 90 * Adapt plugin to new "Blocks" API of WooCommerce taking inspiration 91 from the woocommerce-gateway-dummy (GPLv3+). 92 * Added bin/install_phpcs.sh to easily install phpcs and dependencies 93 94 = 0.9.4 = 95 96 * Use billing address in contract if shipping address is not given 97 98 = 0.9.3 = 99 100 * Fix log logic 101 * Fix header transmission 102 103 = 0.9.2 = 104 105 * Improve comments about settings, especially explain "secret-token:" prefix. 106 * Automatically add "Bearer" to "Authorization" header. 107 * Minor refactoring to match contemporary plugins better. 108 109 = 0.8.0 = 110 111 * Adaptations to GNU Taler Merchant API 1:0:0 112 * Ensure plugin follows Wordpress guidelines. First upload to WordPress.