Terracoin for WP e-Commerce

A Terracoin payment method for the WP e-Commerce shopping cart for WordPress.

Version: @@terracoin-wp-e-commerce-version@@

Features

• Generates a new terracoin address for every order
• Provides payment address to customer on site at checkout, plus in a subsequent email
• Configurable timeout after which unpaid transactions will be canceled automatically
• Configurable number of Terracoin network confirmations after which an order is considered paid
• HTTP or HTTPS access to terracoind

Requirements

Base requirements

• WP e-Commerce 3.7.7 or greater
• WordPress 3.0 or greater (may work on 2.8+, untested)

PHP requirements:

• PHP5
• cURL support
• SSL support (if you're using HTTPS to talk to terracoind)

Limitations

• It is assumed that Terracoin is the only currency accepted.
• All prices are assumed to be in Terracoins, and no currency conversions are performed.
• Checks for payment receipt are performed via WordPress cron, at least until terracoind allows attaching a JSON-RPC callback to an address.
• No notification is sent to the customer or shop administrator if a transaction expires without payment.
• Expired transactions are marked with a status code of "5" in the database, which doesn't correspond to a human-readable status code provided by WP e-Commerce.
• No localization support.

Installation

• Install WordPress http://codex.wordpress.org/Installing_WordPress.
• Log into your WordPress installation as an administrator.
• Install WP e-Commerce via Plugins->Add New in the WordPress dashboard.
• Transfer the contents of the distribution archive to the wp-content/plugins/wp-e-commerce directory of your WordPress installation.

Configuration

• Navigate to Store->Settings->Payment Options.
• Under "General Settings", check "Terracoin" and uncheck everything else.
• Click "Update"
• At right, Select the Terracoin payment gateway.
• Configure your terracoind server information.
• If you are using HTTPS to talk to terracoind and would like to validate the connection using terracoind's own SSL certificate, enter the absolute path to the certificate file (server.cert) you've uploaded to the server.
• Configure your payment timeout and number of transaction confirmations required.
• Adjust the checkout message template as required.
• Click "Update".
• Click "General" at the top and set the currency type to "Terracoin".
• Set the remaining parameters as you wish and click "Update".

Donate

• Terracoin payments: 1FzdruHpffAeW2ZBctDLwR8P4APVpATu2j
• Gifts via other methods: http://www.nostate.com/support-nostatecom/

Authors

• Mike Gogulski - http://www.nostate.com/ http://www.gogulski.com/

Credits

Terracoin for WP e-Commerce incorporates code from:

• XML-RPC for PHP by Edd Dumbill (for JSON-RPC support)
• [bitcoin-php][bitcoin-php] by Mike Gogulski (Bitcoin support library)

License

Terracoin for WP e-Commerce is free and unencumbered public domain software. For more information, see http://unlicense.org/ or the accompanying UNLICENSE file.