Frequently Asked Questions
Which coins are currently available?
Using the built-in coin adapter you can connect to a Bitcoin core full node.
You can connect to any Bitcoin-like full node that you manage yourself using the Bitcoin and Altcoin Wallets: Full Node Multi Coin Adapter. This would include coins such as Litecoin, Dogecoin, etc.
Is it secure?
The Bitcoin and Altcoin Wallets plugin is only as secure as your WordPress installation. Regardless of whether you choose to install this plugin, you should have already taken steps to secure your WordPress installation. At a minimum you should do the following:
- Install a security plugin such as Wordfence.
- Read the Codex resources on Hardening WordPress.
- If you are connecting to an RPC API on a different machine than that of your WordPress server over an untrusted network, make sure to tunnel your connection via
stunnel. See here.
I am encountering some problem with the Bitcoin and Altcoin Wallets plugin
You should first have a look at the Troubleshooting section of the documentation. Go to the dashed-slug downloads area and grab the bundle package of the plugin. This includes the documentation in PDF form. Scroll to the troubleshooting section and see if your problem is listed. If not, read the Contact section for ways in which you can ask for support. Some additional info about how to ask for support is found here.
I am encountering some problem with an Extension to the Bitcoin and Altcoin Wallets plugin
You should first have a look at the extension’s page on dashed-slug.net. If your solution is not found there, you can also scan the appropriate subsection of the support forums. You can also post your own question. Please use the appropriate forum and post a new thread for each distinct issue.
Do I really need to run a full node? bitcoind is too resource-hungry for my server.
Running a full node requires you to set up the daemon on a VPS or other machine that you own and administer. Normally the full blockchain needs to be downloaded, so you need to make sure that your server can handle the disk and network requirements.
Instead, you can choose to install one of the available coin adapters that are backed by cloud wallet services. These currently are:
Study the services and their terms of service including what fees they charge before choosing to use them.
From version 1.1.0 onward, this plugin is compatible with the bittiraha-walletd wallet. From the project’s description on GitHub:
Lightweight Bitcoin RPC compatible HD wallet This project is meant as a drop-in replacement for bitcoind for use in lightweight servers.
This is a wallet based on
bitcoinj and does not store the blockchain locally. You will have to install this on a VPS or other server via the shell.
A downside is that the
walletnotify mechanism and the
listtransactions command are not implemented. This means that there is no easy way for the plugin to be notified of deposits. Deposits will not be recorded in the transactions table. Users will not be emailed when they perform deposits and they will not be able to see their deposits in the
[wallets_transactions] UI. Deposits will correctly affect users’ balances. You have been warned.
Can you install/configure the plugin for me? / I am having trouble with the bitcoin.conf file
I am available to answer any specific questions if you attempt to install the plugin and you face some problem. Unfortunately I do not undertake installation and configuration of the plugin.
Keep in mind that no software is set-and-forget. Once you install software, it then needs to be maintained. If you find that you are having trouble installing the plugin or connecting it to a wallet, even with help, this is a good indication that you should not be running a wallet with people’s money on it.
Remember that you have two options: stand-alone wallets or web wallets. Running a web wallet is considerably easier than a stand-alone wallet, as it does not require system administration skills. As a general rule, if you have trouble using Linux from the command line, you will be better off installing a web wallet.
I am setting up a Bitcoin full node. In my .conf file I have provided the rpcuser and rpcpassword parameters. Instead, the plugin recommends the rpcauth parameter.
You should either use
rpcpassword to specify login credentials to the RPC API, or
rpcauth, but not both. The
rpcauth parameter is simply a way to specify a hashed/salted version of the username and password, rather than the plaintext values. The plugin recommends a hash that contains the username and password you have provided in the coin adapter settings. It uses the algorithm from
How can I integrate the plugin with my site?
Just insert the shortcodes anywhere to create forms to let a logged in user:
- deposit funds:
- withdraw funds:
- transfer funds to other users:
- view their balance:
- view past transactions:
These shortcodes render knockout.js-enabled forms. Read the shortcodes documentation for more details.
You can enter the same UI elements into your theme’s widget area. Simply go to Appearance → Widgets and use the provided front-end widgets.
You can also use a special menu item to display the user balances as part of a nav menu. See the Frontend section of the documentation for details.
I don’t like the built-in forms. Can I change them or provide my own?
First of all, the forms can be styled with CSS. They have convenient HTML classes that you can use.
If you wish to translate the form texts to a different language, see the Localization section of this manual.
If you wish to change the texts to something else, you may use the
If you wish to create forms with completely different markup, you can provide your own views for these shortcodes. Use the
wallets_views_dirfilter to override the directory where the views are stored (the default is
wallets/includes/views). Most people will not need to do this.
Read the Frontend → Alternative knockout templates section of the user manual for more details.
The provided built-in forms talk to a JSON API that is available to logged in users. If you choose to build your own front-end UI, you can do your AJAX calls directly to the JSON API.
Refer to the JSON API documentation for details.
I want to do transactions from the PHP code of my theme or plugin.
You can use the PHP API directly.
Refer to the PHP API documentation for details.
I want to replace an adapter with another one.
You can only have one coin adapter enabled per each coin. The plugin will warn you about this. To replace the adapter for a coin with a new adapter:
- Deactivate the old adapter.
- Install and configure the new adapter.
- Enable the new adapter.
- Got to Wallets → Adapters. Under the new adapter, select Renew deposit addresses. This will renew any user deposit addresses, as well as the cold storage deposit address for that coin.
Can you add XYZ coin for me?
Unfortunately no. I can no longer cater to requests to add new coin adapters. I can only provide assistance by answering specific questions to coin adapter developers.
If your coin’s wallet has a standard RPC API that is a direct fork of Bitcoin core, then you should be able to use the Full Node Multi Coin Adapter extension.
If your coin is an ERC-20 token then there is no support for that at the moment.
Are you available for custom development work?
Unfortunately I do not undertake custom projects. If you have an idea about a cool extension then please let me know about it. If it is a good fit for the project, it will be added to the backlog. When implemented, It will be available either to all users for free, or for dashed-slug premium members.
Can I use an exchange to facilitate cryptocurrency trading on top of this plugin?
I want to do a token sale. Can I use WooCommerce to do so?
It is not recommended that you use WooCommerce and the WooCommerce payment gateway extension to sell tokens or other coins.
Instead, consider using the Exchange extension to provide a way for your users to buy or sell your token. This requires that you have a working coin adapter for your coin or token.
In the adapters list view, why is the Hot Wallet Balance not equal to the Sum of User Balances?
The Hot Wallet Balance and the Users Balances are not the same thing. The difference is explained in the Glossary section of the documentation.
Reasons why the two amounts would diverge:
- As users pay fees for transactions, their total balances decrease but the wallet balance stays the same.
- If you have used the cold storage feature, or alternatively if you have deposited/withdrawn directly from the wallet and not via the plugin, then the balances will not match. See the Cold Storage section in the documentation for more.
My site was hacked and some funds were stolen. Can you help?
I regret that I cannot help you. As you may know, cryptocurrency transactions are non-reversible. This is why the security disclaimer is there – you, as an administrator, are solely responsible for the security of your site. There is no way I could assume responsibility for lost funds. I do not hold private keys to any of your or your users’ funds.
If you have evidence that your funds were stolen you should go to the police. In some situations it may be possible to track down the thieves.
I want to pay for premium membership but cannot or do not want to pay via PayPal.
I plan to build a plugin extension that will allow you to pay for membership via cryptocurrencies. When ready, this extension will also be made available as a dashed-slug premium extension. In the meantime, you may contact me directly at email@example.com if you wish to send a Bitcoin payment and I will activate your membership manually.
I want to do changes to the plugin’s code. Where can I find X function/variable/command/etc?
The plugin and its extensions are yours to edit and you are free to hack them as much as you like. However, you are generally discouraged from doing so:
Firstly, I cannot provide support to modified versions of the plugin. Editing code can have unintended consequences.
But more importantly, if you do any modifications to the code, any subsequent update will overwrite your changes. Therefore, it is not recommended to simply fire away your favorite editor and hack away themes or plugins.
Here’s what you should do instead: If possible, use an existing hook (action or filter) to modify the behavior of the plugin. Then, add your code to a child theme or in separate plugin file (any PHP file with the right headers is a valid plugin file).
If you can’t find a hook that allows you to do the modifications you need, contact me to discuss about your need and I might be able to add a hook to the next patch of the plugin.
Additionally, if the change you intend to do is helpful to other users, I might be able to add it to the plugin code.
How can I get support or submit feedback?
Please use the support forum on WordPress.org for all issues and inquiries regarding the plugin.
To get support on the provided extensions, subscribe to dashed-slug and go to the support forums.
For all other communication, please contact firstname.lastname@example.org.
Updated on 2019-06-04T12:27:24+00:00, by .