wownerowp/README.md
cryptochangements34 ba65a4452a Update to include instructions for using password
Updates README to include instructions for using server authentication with the wallet rpc
2017-07-23 21:11:10 -05:00

3.2 KiB

MoneroWP

A WooCommerce extension for accepting Monero

Dependancies

This plugin is rather simple but there are a few things that need to be set up before hand.

  • A web server! Ideally with the most recent versions of PHP and mysql

  • The Monero wallet-cli and Monero wallet-rpc tools found here

  • WordPress Wordpress is the backend tool that is needed to use WooCommerce and this Monero plugin

  • WooCommerce This Monero plugin is an extension of WooCommerce, which works with WordPress

Step 1: Activating the plugin

  • Downloading: First of all, you will need to download the plugin. This can be done with the command git clone https://github.com/monero-integrations/monerowp.git or can be downloaded as a zip file from the GitHub web page.

  • Put the plugin in the correct directory: You will need to put the folder named monero from this repo into the wordpress plugins directory. This can be found at path/to/wordpress/folder/wp-content/plugins

  • Activate the plugin from the WordPress admin panel: Once you login to the admin panel in WordPress, click on "Installed Plugins" under "Plugins". Then simply click "Activate" where it says "Monero - WooCommerce Gateway"

Step 2: Setup the Monero Wallet RPC

  • Setup a monero wallet using the monero-wallet-cli tool. If you do not know how to do this you can learn about it at getmonero.org

  • Start the monero daemon on your server and leave it running in the background. This can be accomplished by running ./monerod inside your monero downloads folder.

  • Start the Wallet RPC and leave it running in the background. This can be accomplished by running monero-wallet-rpc --rpc-bind-port 18081 --rpc-login username:password --wallet-file /path/walletfile where "username:password" is the username and password that you want to use, seperated by a colon and "/path/walletfile" is your actual wallet file.

Step 3: Setup Monero Gateway in WooCommerce

  • Navigate to the "settings" panel in the WooCommerce widget in the WordPress admin panel.

  • Click on "Checkout"

  • Select "Monero GateWay"

  • Check the box labeled "Enable this payment gateway"

  • Enter your monero wallet address in the box labled "Monero Address". If you do not know your address, you can run the address commmand in your monero wallet

  • Enter the IP address of your server in the box labeled "Daemon Host/IP"

  • Enter the port number of the Wallet RPC in the box labeled "Daemon PORT" (will be 18081 if you used the above example).

  • Enter the username and password that you want to use in their respective feilds

  • Click on "Save changes"

Info on server authentication

It is reccommended that you specify a username/password with your wallet rpc. This can be done by starting your wallet rpc with monero-wallet-rpc --rpc-bind-port 18081 --rpc-login username:password --wallet-file /path/walletfile where "username:password" is the username and password that you want to use, seperated by a colon. Alternatively, you can use the --restricted-rpc flag with the wallet rpc like so ./monero-wallet-rpc --testnet --rpc-bind-port 2808 --restricted-rpc --wallet-file testnetWallet.