diff --git a/readme.txt b/readme.txt index e9bd0cc..505db18 100644 --- a/readme.txt +++ b/readme.txt @@ -10,27 +10,55 @@ License URI: https://github.com/monero-integrations/monerowp/blob/master/LICENSE Monero WooCommerce Extension is a Wordpress plugin that allows to accept monero at WooCommerce-powered online stores. -== Description == - -Your online store must use WooCommerce platform (free wordpress plugin). -Once you installed and activated WooCommerce, you may install and activate Monero WooCommerce Extension. - = Benefits = -* Accept payment directly into your personal Monero wallet. -* Accept payment in monero for physical and digital downloadable products. -* Add monero payments option to your existing online store with alternative main currency. -* Flexible exchange rate calculations fully managed via administrative settings. -* Zero fees and no commissions for monero payments processing from any third party. -* Automatic conversion to Monero via realtime exchange rate feed and calculations. -* Ability to set exchange rate calculation multiplier to compensate for any possible losses due to bank conversions and funds transfer fees. +* Payment validation done through either `monero-wallet-rpc` or the [xmrchain.net blockchain explorer](https://xmrchain.net/). +* Validates payments with `cron`, so does not require users to stay on the order confirmation page for their order to validate. +* Order status updates are done through AJAX instead of Javascript page reloads. +* Customers can pay with multiple transactions and are notified as soon as transactions hit the mempool. +* Configurable block confirmations, from `0` for zero confirm to `60` for high ticket purchases. +* Live price updates every minute; total amount due is locked in after the order is placed for a configurable amount of time (default 60 minutes) so the price does not change after order has been made. +* Hooks into emails, order confirmation page, customer order history page, and admin order details page. +* View all payments received to your wallet with links to the blockchain explorer and associated orders. +* Optionally display all prices on your store in terms of Monero. +* Shortcodes! Display exchange rates in numerous currencies. -== Installation == += Installation = -1. Install "Monero WooCommerce extension" wordpress plugin just like any other Wordpress plugin. -2. Activate -3. Configure it with your wallet rpc address, (username or password not requested), your monero address -4. Enjoy it! +== Automatic method == + +In the "Add Plugins" section of the WordPress admin UI, search for "monero" and click the Install Now button next to "Monero WooCommerce Extension" by mosu-forge, SerHack. This will enable auto-updates, but only for official releases, so if you need to work from git master or your local fork, please use the manual method below. + +== Manual method == + +* Download the plugin from the releases page (https://github.com/monero-integrations/monerowp) or clone with `git clone https://github.com/monero-integrations/monerowp` +* Unzip or place the `monero-woocommerce-gateway` folder in the `wp-content/plugins` directory. +* Activate "Monero Woocommerce Gateway" in your WordPress admin dashboard. +* It is highly recommended that you use native cronjobs instead of WordPress's "Poor Man's Cron" by adding `define('DISABLE_WP_CRON', true);` into your `wp-config.php` file and adding `* * * * * wget -q -O - https://yourstore.com/wp-cron.php?doing_wp_cron >/dev/null 2>&1` to your crontab. + += Configuration = + +== Option 1: Use your wallet address and viewkey == + +This is the easiest way to start accepting Monero on your website. You'll need: + +* Your Monero wallet address starting with `4` +* Your wallet's secret viewkey + +Then simply select the `viewkey` option in the settings page and paste your address and viewkey. You're all set! + +Note on privacy: when you validate transactions with your private viewkey, your viewkey is sent to (but not stored on) xmrchain.net over HTTPS. This could potentially allow an attacker to see your incoming, but not outgoing, transactions if they were to get his hands on your viewkey. Even if this were to happen, your funds would still be safe and it would be impossible for somebody to steal your money. For maximum privacy use your own `monero-wallet-rpc` instance. + +== Option 2: Using monero wallet rpc == + +The most secure way to accept Monero on your website. You'll need: + +* Root access to your webserver +* Latest [Monero-currency binaries](https://github.com/monero-project/monero/releases) + +After downloading (or compiling) the Monero binaries on your server, install the [systemd unit files](https://github.com/monero-integrations/monerowp/tree/master/assets/systemd-unit-files) or run `monerod` and `monero-wallet-rpc` with `screen` or `tmux`. You can skip running `monerod` by using a remote node with `monero-wallet-rpc` by adding `--daemon-address node.moneroworld.com:18089` to the `monero-wallet-rpc.service` file. + +Note on security: using this option, while the most secure, requires you to run the Monero wallet RPC program on your server. Best practice for this is to use a view-only wallet since otherwise your server would be running a hot-wallet and a security breach could allow hackers to empty your funds. == Remove plugin ==