README

Integrate cryptocurrency payments seamlessly into your Wordpress store with the SpectroCoin Crypto Payment Plugin. This extension facilitates the acceptance of a variety of cryptocurrencies, enhancing payment options for your customers. Easily configure and implement secure transactions for a streamlined payment process on your Wordpress website.

Installation

Download plugin files from github.
Extract and upload plugin folder to your Wordpress /wp-content/plugins folder.
OR
in "Plugins" -> "Add New" -> "Upload Plugin". -> Upload spectrocoin.zip.
Go to "Plugins" -> "Installed Plugins" -> Locate installed plugin and click "Activate" -> Click "Settings".

Setting up

Sign up for a Spectroin Account.
Log in to your Spectroin account.
On the dashboard, locate the "Business" tab and click on it.
Click on "New project".
Fill in the project details and select desired settings (settings can be changed).
The Private and Public keys are obtained from your merchant project's settings page. Private key is only displayed once when the project is created, but can be newly generated by pressing on "Generate" button below your Public key field. Copy the newly generated private and public keys and store them in plugin settings.
Click "Submit" to save the project and then click "Close".
Select the option "All projects" and choose your project.
In plugin settings fill the merchant id and project id.

Make it work on localhost

In order to make the plugin work on localhost for testing purposes, change these 3 lines in SCMechantClient.php createOrder() function:

'callbackUrl' => $request->getCallbackUrl(), 'successUrl' => $request->getSuccessUrl(), 'failureUrl' => $request->getFailureUrl()

'callbackUrl' => 'http://localhost.com', 'successUrl' => 'http://localhost.com', 'failureUrl' => 'http://localhost.com'

Don't forget to change it back when migrating website to public.

Changelog

Version 1.0.0 MAJOR (07/31/2023):

Fixed: Corrected a typo in the plugin's description. Changed "aplugin" to "a plugin" for better clarity.

Added: Included a link to access SpectroCoin plugin settings directly from the plugin page. This enhancement provides users with easier access to the configuration options.

Updated: Implemented an "if" statement to handle compatibility with older PHP versions (PHP 8 and below) for the function openssl_free_key($public_key_pem). This change is necessary as PHP 8 deprecates openssl_free_key and now automatically destroys the key instance when it goes out of scope. (Source: https://stackoverflow.com/questions/69559775/php-openssl-free-key-deprecated)

Improved: In the WC_Gateway_Spectrocoin class, made changes to prevent deprecated messages related to the creation of dynamic properties. The properties (merchant_id, protected_id, private_key, and order_status) are now explicitly declared as protected, and getter functions are added to ensure better encapsulation. This update is particularly important for PHP version 8.2 and above.

Added: Specified a dependency on the WooCommerce plugin for the SpectroCoin plugin. The SpectroCoin plugin now requires WooCommerce to be installed and active on the site. If the user deletes or deactivates WooCommerce, a notice will be displayed, and the SpectroCoin plugin will be deactivated automatically.

Added: Enhanced the style of the admin's payment settings window to match the design of SpectroCoin.com, providing a more cohesive user experience.

Added: Introduced an informative message on the admin page, guiding users on how to obtain the mandatory credentials required for using the SpectroCoin plugin effectively. This addition helps users easily find the necessary information for setup and configuration.

Version 1.1.0 MINOR (07/31/2023):

Added: Included a new option in admin menu, to display or not the SpectroCoin logo during checkout.

Version 1.2.0 MINOR (09/10/2023):

Added: Implemented plugin string internationalization, for plugin translation to various languages.

Added: Included two additional links within admin window connecting to official wordpress.org website to easily rate, leave feedback and report bugs.

Tested: Tested and checked compatibility with Wordpress 6.3 and WooCommerce 8.0.1

Modified: Added style changes in settings window

For Developers: Added documentation with parameters and return variables before every function

Version 1.3.0 MINOR (10/04/2023):

Fixed: Replaced hardcoded order statuses in plugin settings.

Added: Custom order statuses created manually or using plugins will appear in SpectroCoin settings menu.

Added: During checkout, if error is occured, now client will see the error code and message instead of generic error message.

Added: Now plugin checks the FIAT currency, if it is not supported by SpectroCoin, payment will not be available.

Added: Added admin notice in admin plugin settings to notify that shop currency is not supported by SpectroCoin.

Information

This client has been developed by SpectroCoin.com If you need any further support regarding our services you can contact us via:

E-mail: merchant@spectrocoin.com
Skype: spectrocoin_merchant
Web
Twitter
Facebook

spectrocoin / woocommerce-merchant

Maintainers

Details