|
| 1 | +# DashPayments for WooCommerce |
| 2 | + |
| 3 | +DashPayments for WooCommerce is a Wordpress plugin that enables WooCommerce merchants to accept [Dash](https://www.dash.org "Dash - Digital Cash") directly, without the need for a third-party payment processor. |
| 4 | + |
| 5 | +* Uses BIP32 extended public (xpub) keys for address generation. |
| 6 | +* Requires access to an [Insight-API-Dash](https://github.com/udjinm6/insight-api-dash) instance |
| 7 | + |
| 8 | +### Requirements: |
| 9 | + |
| 10 | +* An Electrum-Dash wallet for receiving payments |
| 11 | +* WordPress 4.4.2+ |
| 12 | +* WooCommerce 2.5.2+ |
| 13 | +* PHP 5.5+ with valid extensions: |
| 14 | + - gmp |
| 15 | + - bcmath |
| 16 | + - gd |
| 17 | + - mcrypt |
| 18 | + - openssl |
| 19 | + - curl |
| 20 | + - json |
| 21 | + |
| 22 | +### Developers: Building the plugin |
| 23 | + |
| 24 | +Install composer using your package manager, then use ```composer install``` to fetch all dependencies and place them into 'vendor/'. |
| 25 | + |
| 26 | +If desired, use 'zip' to package the directory into a zip file with the same name: |
| 27 | + |
| 28 | + cd .. && zip -r dashpay-woocommerce.zip dashpay-woocommerce/ |
| 29 | + |
| 30 | +### Installation and Activation |
| 31 | + |
| 32 | +Extract the .zip file and copy or FTP the dashpay-woocommerce directory to the WordPress 'plugins' directory. Activate the plugin in the WordPress-admin console. |
| 33 | + |
| 34 | +Navigate to WooCommerce -> Settings -> Checkout. Click the 'Dash' option at the top of the page. Paste your xpub key from Electrum-Dash into the box labeled "Dash BIP32 Extended Public Key", and click 'Save changes' at the bottom of the page. |
| 35 | + |
| 36 | +If you see a message stating "Dash payment gateway is operational", you should be ready to accept payment in Dash. |
| 37 | + |
| 38 | +### **HIGHLY RECOMMENDED (READ THIS SECTION)** |
| 39 | + |
| 40 | +It's highly recommended that you setup a cron job to handle background order processing. It's not technically required, but will catch things like if a user closes their browser before the payment gets processed. |
| 41 | + |
| 42 | +For manual cron jobs, add this line to your crontab (replace <yourdomain.com> with your own WordPress site URL): |
| 43 | + |
| 44 | + * * * * * curl -s http://<yourdomain.com>/wp-cron.php?doing_wp_cron > /dev/null 2>&1 |
| 45 | + |
| 46 | +For CPANEL, run the command below every minute (replace <yourdomain.com> with your own WordPress site URL): |
| 47 | + |
| 48 | + curl -s http://<yourdomain.com>/wp-cron.php?doing_wp_cron > /dev/null 2>&1 |
| 49 | + |
| 50 | +### Contributions/Bugs/Issues |
| 51 | + |
| 52 | +If you'd like to contribute to the project, please submit a pull request at this Github repository (please fork this project and submit a pull request using a feature-branch). |
| 53 | + |
| 54 | +If you think you've found a bug, please file an issue at this Github repo (start by clicking the issues tab above). |
| 55 | + |
| 56 | +### License |
| 57 | + |
| 58 | +DashPayments for WooCommerce is released under the terms of the MIT license. See http://opensource.org/licenses/MIT. |
0 commit comments