⚠ NOTICE:
These installation instructions are for Bitcoin and Altcoin Wallets versions before 6.0.0
.
Since 6.0.0
, installation instructions are found in the built-in documentation.
In your WordPress admin screens, navigate to: Wallets Admin Docs → wallets → Installation instructions → Install a Bitcoin core wallet.
If you have not yet installed the plugin, you can view the instructions on github.
Overview
This howto guide will help you to install the Bitcoin and Altcoin Wallets WordPress plugin with a Bitcoin core full node back-end. This will typically require SSH access to your wallet machine, and some basic knowledge of UNIX/Linux.
If you are interested in installing the plugin and connecting it to a web wallet (easier), please see this guide instead.
Installation instructions
The installation instructions for the Bitcoin and Altcoin Wallets WordPress plugin itself are the same as for any WordPress plugin.
Additionally, you will have to install and maintain a Bitcoin daemon on your server.
- Make sure that you have at least WordPress version 3.8 installed, and that you are running on at least PHP 5.5. For security reasons, you are strongly recommended to use the latest version of WordPress.
- Install a Bitcoin full node on your server. Detailed instructions are available here. Read and follow the instructions carefully.Take note of the memory, disk, and bandwidth requirements and check against the resources available on your server.
- You will need to edit your
~/.bitcoin/bitcoin.conf
file. At a minimum, set a username and password:rpcuser=<<<SOME USERNAME>>>
rpcpassword=<<<A STRONG PASSWORD>>>
- If you want to run the daemon on a different server to that of your webserver, or to listen on a TCP port other than the default, add the following lines and edit as appropriate.
rpcport=8332
rpcconnect=127.0.0.1
rpcallowip=127.0.0.1
For more information on the bitcoin daemon configuration, consult the relevant wiki page. - Install and activate the Wallets plugin. For general information on installing WordPress plugins, you can consult the relevant WordPress documentation.
- Navigate to Wallets → Bitcoin (BTC) in your WordPress admin area.At a minimum you need to enter the location and credentials to your Bitcoin daemon RPC API.You will need to set the following:
IP
,Port
,User
,Password
,Path
. - Start the bitcoin daemon on your server. You will need to specify the parameters
-walletnotify
and-blocknotify
. This enables the daemon to notify your WordPress installation of any incoming deposits.The plugin will give you the exact command that you need to start the daemon with.Here’s what the command might look like:bitcoind -walletnotify='curl -s http://www.example.com/wallets/notify/BTC/wallet/%s >/dev/null' -blocknotify='curl -s http://www.example.com/wallets/notify/BTC/block/%s >/dev/null'
Check the paths to make sure they match the location of your WordPress installation.
You should now be ready to use the Bitcoin and Altcoin Wallets WordPress plugin. On the Wallets menu, check the Adapter Status for Bitcoin. If all is well, it should read Responding.
Support
Don’t forget that support is available on the WordPress.org forums.