.. Bitcoin for WooCommerce documentation master file, created by sphinx-quickstart on Sat Jun 13 12:03:49 2015. You can adapt this file completely to your liking, but it should at least contain the root `toctree` directive. Bitcoin for WooCommerce =================================================== Bitcoin for WooCommerce is a Wordpress plugin adding support for Bitcoin payment into your WooCommerce store. It encompasses a handful of features that gives it a notable competitive advantage. To name a few, it generates a unique Bitcoin address for each order to monitor payments and automatically mark order with relevant statuses; it generates a QR code that your customers may scan; it automatically perform conversions to bitcoin and support all currencies from popular like USD, EUR, GBP, CAD, AUD, JPY to less common like NGN. Table of Contents ----------------- .. contents:: Installation ------------- .. note:: Because we've been performing major changes in version 3.0.1, we will suggest you disable and delete the previous version before installing this version and latest. Server Requirements ^^^^^^^^^^^^^^^^^^^^^^^ The plugin has a few requirements which are automatically satisfied if you have latest versions of Wordpress and WooCommerce installed. * Wordpress 4.0 and above * WooCommerce 2.0 and above Installing "Bitcoin for WooCommerce" ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ There are two ways you can bring the plugin into your WooCommerce store: Wordpress admin section and FTP client. In either case, you first need to download the plugin zip file to your computer. **Via Wordpress Admin** This is the easiest method because it leverages the existing facility Wordpress provides to import plugins. To proceed follow the steps below: 1. Go to your Wordpress site and login as an admin or any other user having the permission to manage plugins. Most of the time the url to Wordpress admin looks like ``http://your-domain-name.com/path-to-wordpress-if-any/wp-admin/`` 2. Open the pages to the plugins list (See Plugins menu) 3. From Plugins menu (under Appearance), go to Plugins > Add New > Upload Plugin 4. Upload the "Bitcoin for WooCommerce" zip file you received. 5. After successful import Wordpress will show a link to activate the plugin right away, you can proceed! **Via FTP Client** This method has a few requirements: #. FTP client installed on your machine. If you don't have one yet get FileZilla Client at https://filezilla-project.org/download.php?type=client #. Credentials to access the FTP server of your store (Ask your host provider if your don't know them). These informations are: Hostname or IP address, Username and Password #. Exact path to the Wordpress files of your store. Once you're set with these requirements follow this procedure: #. Launch your FTP client and connect to your FTP server #. Go to your Wordpress installation directory and inside locate the folder ``wp-content/plugins`` #. Extract "Bitcoin for WooCommerce" plugin zip file and upload the content to the previous directory #. Open your browser to your Wordpress admin and see in Plugins page if "Bitcoin for WooCommerce" is in the list of installed plugins. **Activation** If the plugin was not previously activated which might be the case if you use the FTP way then go to Plugins page in Wordpress admin and activate the plugin there. **Verification** Go to *WooCommerce > Settings > Checkout* and check if "Bitcoin" can be seen in section list below tabs. If yes, then you're set! Configuration ------------- To update settings go to *WooCommerce > Settings > Checkout > Bitcoin* Most importantly, you need to set your Bitcoin Address and tick the Enable option to make the plugin available for use in frontend. Basic Configuration ^^^^^^^^^^^^^^^^^^^^^^^ The default settings with Instant Payment option enabled is what most WooCommerce managers might need to provide the Bitcoin payment option during checkout process. You can also, customize the different messages and notices as well as a few other options to kinda "brand" the integration. Enforcing transaction confirmation ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Bitcoin protocol recommends waiting for 6 confirmations to consider a transaction as being verified. The reason is to prevent what is called double spending where a user may "fake" sending bitcoins. Each confirmation taking around 10 minutes, waiting for 6 confirmations mean waiting for 1 hour which is not practical today where time is crucial. And because the double spending is not an easy thing the average joe can perform most people are satisfied with only 1 or 2 confirmations which is the reason of the Instant Payment option. With this option enabled, your customer order is validated as soon as we have a signal of sent payment. If however you need to change this and have more control on it, un-check the Instant Payment option and set your confirmations threshold. Simple customization ^^^^^^^^^^^^^^^^^^^^^^^ Starting from version 3.0.1 we're providing a means for user to customize the styling for the plugin on WooCommerce checkout page. To do this, add and save your CSS rules to "Custom CSS" textarea. If you know some CSS you might need to check the files ``assets/css/main.css`` and ``includes/gateways/includes/views/html-gateway-bitcoin-checkout.php`` Additional customization ^^^^^^^^^^^^^^^^^^^^^^^^^^ In addition to the above simple customizations if you want to go further, you can create a new file called ``html-gateway-bitcoin-checkout.php`` in your Wordpress theme or any child theme. Inside your theme folder you can also put this file in a dedicated folder like ``bitcoin-for-woocommerce/html-gateway-bitcoin-checkout.php`` this file will contain your own HTML markup that will be used. Demo ------------- To simply get a quick idea of the plugin go to http://demo.elitecoderlab.com/bitcoin-for-woocommerce. Note that the demo instances data last only a few hours. .. note:: When using the plugin remember the minimum supported transaction size is 0.0005 BTC ~ $0.12USD Troubleshooting ---------------- If you notice something wrong during the use of the plugin before sending us a request please open your Wordpress admin area, go to *WooCommerce > System Status > Logs* and open the plugin logs for insights. These logs might be helpful to understand any problem. Support ------------- We're available to provide support through the plugin page http://lp.elitecoderlab.com/bitcoin-for-wordpress/ or our dedicated support page http://support.elitecoderlab.com/bitcoin-for-wordpress/ Feel free to contact us and we'll be happy to assist you. We're also available to provide any customization even beyond Wordpress/WooCommerce platform. Release Notes ------------- Indices and tables ================== * :ref:`genindex` * :ref:`modindex` * :ref:`search`