Frequently Asked Questions
How can I integrate the plugin with my site?
Just insert the shortcodes anywhere to create forms to let a logged in user.
These are the most important shortcodes; consult the documentation for a complete list.
- 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.
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.
Dashed-Slug does not offer a full node adapter for ERC-20 tokens, but you can check this third-party solution.
How secure is it?
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 want to run a full node but 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. Here’s some advice on how to run a bitcoind wallet in a low memory environment. If you are concerned about your available disk space, you may run a pruned node. The same instructions will apply to many wallets that are Bitcoin forks.
If running a full node is not important for you, you can choose to install the CoinPayments Adapter extension
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
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.
Once you install this 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 will find it hard to maintain it. In that case perhaps you should not be running a wallet with people’s money.
Remember that you have two options: stand-alone wallets or third-party 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 third-party wallet.
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. Please see the documentation under Frontend → Style the frontend UIs with CSS.
- If you wish to translate the form texts to a different language, see the documentation under Localization.
- If you wish to change the texts to something else, you may use the
wallets_ui_text_*WordPress filters. See the documentation uder Frontend → Template Modifications → Modifying text.
- If you wish to create forms with completely different markup, you can modify the provided template files in your theme or child theme. Please see the documentation under Frontend → Template Modifications → Modifying Markup. Theme developers can use this to provide customized templates for this plugin.
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.
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.
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 template, 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.
Does the plugin support multisite network installations?
The plugin supports network installations in two modes, depending on whether the plugin is network-activated or not:
If you activate the plugin individually per each site, users will maintain separate balances on each site on your network. You will find the Wallets menu under the network admin menu. The
manage_wallets capability will be assigned to the network super-admin. In case you need to trigger the cron jobs manually, use the distinct URL given in each case.
If you network activate the plugin, users will see the same balances on each site on your network. The
manage_wallets capability must be assigned to each site’s admin. If you need to trigger the cron jobs manually, use the URL given in the network admin pages. It will trigger cron jobs for all sites.
If you network-activate the parent plugin, make sure to also network-activate all the app extensions and coin adapters. If you activate the plugin separately on each subsite of your network, do the same with all the app extensions and coin adapters.
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.
You may contact me directly at email@example.com if you wish to pay by Bitcoin, Litecoin or Dogecoin.
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.
I am encountering some problem with the Bitcoin and Altcoin Wallets plugin
First check 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 try to use the appropriate forum, and to post a new thread for each distinct issue.
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.
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.
Updated on 2020-04-24T10:22:12+00:00, by .