RSECommerce

RSECommerce is a basic e-commerce/shopping cart plugin for WordPress designed to meet the needs of a simple web store. If you just have a few products to sell and don’t need complicated checkout options, this is the plugin for you.

RSECommerce supports the Authorize.Net and Sage payment gateways, with plans to add more payment solutions in the future.

Installation and Setup

  1. Download RSECommerce from the WordPress Plugin Repository
  2. Unzip the plugin and upload to your /wp-content/plugins/ directory
  3. Activate the plugin through the “Plugins” page in WordPress (http://example.com/wp/wp-admin/plugins.php)
  4. Create two blank pages. Name one of them “Cart” and the other “Checkout”. (You can use other names, but “Cart” and “Checkout” seem pretty descriptive for our purposes.)
  5. Go to the RSECommerce settings page (http://example.com/wp-admin/admin.php?page=rsecommerce)
  6. Under “General Settings”, set the cart page and the checkout page to the corresponding pages you created earlier
  7. Select your payment gateway and configure any other settings as appropriate
  8. Visit the “Gateway Settings” page (http://example.com/wp-admin/admin.php?page=rsec_gateway) and provide the appropriate information for your gateway account

Creating Products

  1. Create a post or a page (collectively referred to as “posts”, henceforth) describing your product
  2. In the right sidebar, find a box labeled “Product Details”
  3. Check the box to use that post as a product
  4. Give the product a name, price, tax amount, and shipping amount (any of these can be $0 if you wish)
  5. Save the post

When you view the post, you’ll see an “Add to Cart” button automatically added after the body. If you want it to appear earlier in the post, simply add the [add_to_cart] shortcode anywhere in the body. The button will appear there, and not at the end of the post.

If you’d like to include the button on a different post, you’ll need to specify which product to add, based on the ID of the product’s post. E.g., if you have a product post with an ID of 40, you can include its “Add to Cart” button on any other post by include the shortcode [add_to_cart 40] in the other post’s body.

Extending RSECommerce

You can extend RSECommerce by adding new payment handlers as separate WordPress plugins. Your plugin should include a class that extends the RSECommercePaymentHandler class, found in class.RSECommercePaymentHandler.php in the RSEcommerce directory.

At a minimum, your class must implement the following functions:

  • settings_page: returns the HTML of the settings page for your payment handler
  • save_settings_page: saves changes made to the above form
  • process_payment: this function will receive the order information, and is expected to process the payment, returning TRUE if the payment was successfully processed

Additionally, your class should give unique values to the $token and $name class variables, by which RSECommerce will refer to the payment handler.

Contributing

First and foremost, we welcome any code you’d like to contribute to the plugin, be it a bug fix, a new feature, or a new payment handler. Contact us at support@adeliedesign.com, and we’ll be happy to look over the code and, if all goes well, add it in. RSECommerce is licensed under the MIT license, so we would hope that any code you contribute can be licensed similarly.

Financial support is, of course, also welcome. We take donations to support RSECommerce through PayPal. All donations translate directly into time we can spend developing the plugin.

Technical Support

If you have any questions, problems, or feature requests, send us an email at support@adeliedesign.com. We’re happy to help with minor issues. We’ll take new feature requests under consideration and develop them as time permits. We’re also available for hire if you have a pressing need that you like to see incorporated into the plugin.