Troubleshoot Connection Errors

This troubleshooting guide is designed to explain and give troubleshooting steps to the Network Communication errors that can occur using the EasyCart administrative console software. In part, we hope to explain why this error occurs, and then how to take some simple troubleshooting steps to help get past it.

EasyCart Shortcode is Easy!

Looking to develop custom product pages with EasyCart Functionality?

Many customers have asked about creating new products and designs on their WordPress pages and then simply inject or add EasyCart add to cart behavior or products on those custom pages.  It is a common workflow, and while EasyCart develops an entire catalog system for you and your products, customizing ones pages to fit your specific needs is often a requirement.

With EasyCart shortcode, it is easy to develop your own product pages and add only specific parts of EasyCart to your system.  Here are a few good examples, but be sure to experiment with our shortcode to see all of the capabilities it has to offer.

 

Scenario 1:  Create your own pages, but want ‘Add to Cart’ button on your pages

This is very popular scenario, you have a few products, so you want to create highly customized WordPress pages and JUST use EasyCart add to cart behavior.

  1.  Create your page in WordPress how you like it, then access the EasyCart shortcode by clicking the ‘shopping cart’ icon on the toolbar.shortcode-toolbar
  2. Select the ‘Add to  Cart’ shortcode button.  There are lots of options here for shortcode, so worth time to explore and see the possibilities of each shortcode section.shortcode
  3. Once you select ‘Add to Cart’, you are asked which product would you like this add to cart button to represent, select which product from the dropdown.addtocart
  4. Select ‘Add shortcode’ and it will inject the shortcode into your wordpress page.  You can use the default editor OR some themes have custom page builders, which also work if they represent shortcode in them.

shortcodeaddition

Here you can see shortcode in the default editor, but you can also add it to your theme if it has a page builder system and will represent shortcode appropriately.

customlayout

5.  Now you can view your page, and if your product has option sets, those are also shown with your add to cart shortcode.  Notice how this is a completely custom page built in WordPress, and ONLY the EasyCart product options and add to cart behavior are shown.  This allows you to really extend EasyCart and WordPress by design and development on your own pages.  (Of course EasyCart can do all this for you by using our regular catalog and product details pages that are created automatically, but for those wanting custom designs and complete control, this is a helpful feature.)

customlayout2

Scenario 2:  A table of products with titles, pricing and view more options

Many customers have asked for a way to build a table of products.  We have an awesome shortcode for store table of products which allows you to quickly select groups of products, categories, and individual products and put into a quick shortcode table.  Of course you could use CSS to custom design colors afterwards, but this shortcode really helps speed up the process of building a product table.

  1.  Select shortcode as in previous scenario and select ‘Store Table’ shortcode.producttable
  2. Select all the categories and columns that you would like to insert with this shortcode.  Once finished, insert the shortcode into your page or custom page builder.tableshortcode
  3. Save your page and viewing shows the table of products along with a button to view the product in detail.producttable2

More Shortcode to explore!

We have more shortcode which allow extensive control over your product displays and setup.  You can display custom product categories on a WordPress page, very popular to do.  You can also display custom cart and account shortcode, place single items or selected items on a page, even create a page for manufacturers and place those designed manufacturer products on a page.

Subscriptions?

We offer membership content shortcode as well, so if you sell membership content such as video, downloads, or access to a members area of your website, simply use this shortcode and design ‘Member Content/Non-Member Content’ on a single WordPress page.  IF the user is logged in AND has purchased a membership, then they can view that content, otherwise, show the user directions to purchase OR login.

For more information on shortcode, you can also visit our online documentation:  http://wpeasycart.com/docs/3.0.0/themes/shortcodes.php

WordPress 4.3 Upgrade Procedures

WordPress has recently released version 4.3, and there are thousands of plugins that are still working to become compatible with this latest release.

WP EasyCart has released a 4.3 compatible version, but it is critical that you update the plugin before you update WordPress.

  1. First, update plugins to 4.3 compatible versions. (plugins will say if they are 4.3 compatible in plugin update section)
  2. Second, update themes to 4.3 compatible versions. (check with your theme developer if theme is compatible)
  3. Lastly, update WordPress to 4.3 and process should go smoothly.

 

 

What to do if you get a white screen?

If your website automatically upgraded to 4.3, then it may break due to plugins or EasyCart not being updated prior to this core WordPress update.  You may experience a white screen, or a PHP error notice saying it is having trouble loading.

1.  First, you will need to log into your website through FTP and disable the plugin, for exampe /wp-content/plugins/wp-easycart folder should be renamed to /wp-easycart-old.

2.  Second, you can log into wordpress admin  now and see that under ‘plugins’ that the conflicting plugin has been deactivated…  in this case WP EasyCart.

3.  Third, go back to FTP and rename the plugin back to wp-easycart.

4.  Fourth, go ahead and upgrade the plugin in question to a 4.3 compatible version.

5.  Fifth, you can activate the new upgraded plugin.

6.  Now you should be able to continue using WordPress as usual

 

 

Are there a list of other plugins that might not be 4.3 compatible?

Unfortunately yes, there is a huge list of plugins that this is known to have an issue with, and with automatic updater for WordPress running on many websites, this could accumulate into a huge issue.  We encourage everyone to turn off automatic updates if you do not want this type of unexpected update behavior to occur on your website.

Here is a list from GitHub of plugins still needing to be upgraded:  https://gist.github.com/chriscct7/d7d077afb01011b1839d

Leveraging MyMail Newsletter Email System

WP EasyCart integrated with the MyMail newsletter plugin some time ago, and we are huge fans of its usability and ease of use.  We have several months under our belts using this plugin with our own customers and feel we can show you some tips on how to utilize its features and give some guidance on best practices.

mymail

http://codecanyon.net/item/mymail-email-newsletter-plugin-for-wordpress/3078294?ref=wpeasycart

New to MyMail?

For those who have never use a subscriber newsletter system or sent out email campaigns from their WordPress site, it can be intimidating, but rest assured, its as easy as it can get with MyMail.  For a low cost of $39 dollars for the plugin, you can send out professional emails to customers with news about your business, online store, tutorials, special promotions, even send out autoresponders after a user action has occurred for an automated system.

Getting Started

First, MyMail is already integrated with WP  EasyCart, all you need to do is have both plugins installed, and then EasyCart will put users into your system as a subscriber when they checkout from an order and click ‘signup for newsletter’, create a new account and click ‘signup for newsletter’, or if you turn on the newsletter widget and they signup.

It’s that easy, nothing really to do, but makes a great way to get your subscribers into MyMail from EasyCart.  We even offer a quick import if you have EasyCart customers and want to quickly import all the users into MyMail for the first time.

Professional Email Templates

You can certainly build your own email newsletters, but why not go to ThemeForest and search for ‘MyMail Templates’ and purchase professional email templates that are mobile responsive and cost less than $20 dollars.  Most templates allow you to do a multitude of variations and build your newsletter in a modular approach, yet consistent look for your customers and subscribers.

http://themeforest.net/collections/728172-mymail-newsletter-templates?sort_by=sales_count&type_id=728172&utm_campaign=shorturl&utm_source=rxa.li&utm_medium=link&ref=wpeasycart

Email Sending Services

MyMail can connect to a variety of email sending services, and are a great approach to sending email campaigns without taxing your web hosting email limits.  We especially like the use of Mandrillapp.com, which allows us to connect MyMail and send email campaigns through the Mandrill system with a 12,000 email limit each month for free! Want to send more, it is extremely cheap to get extra emails!  As in .10 cents per 1,000 emails!

mandrill

http://www.mandrillapp.com

We also like that MyMail connects to these external sending systems and keeps your spam and black listing to a minimum. Mandrillapp.com even lets you know your sending reputation, bounce rates, open rates, click through rates, and more via their dashboard.

EasyCart has extended our integration with Mandrillapp.com by allowing you to use their email services for customer confirmation emails as well, allowing you to see them being sent, resend them, and see if the emails were open.

Strategies for Newsletters

There are countless articles on the interwebs that discuss how and what to send to your customers.  We find a good comprehensive approach is important and with MyMail, we can automate some of these newsletters while still customizing others.

Standard Newsletters – It’s a good idea to send a general newsletter about your business, what you are selling, what is new, and what in general is happening with your business once a month or even twice a month to all subscribers.  Keep the content fresh and keep it relevant.  It’s harder than it sounds once a month!

Order Confirmation Emails – While this is automated from EasyCart, it is usually the most read email by your users.  It might be nice to get some custom information on there, perhaps even a special email that includes custom coupon codes for future or returning customers.  You can easily customize the confirmation email by going into EasyCart Admin -> Language Editor and editing phrases.

Autoresponders – We really enjoy leveraging this in MyMail, because you can setup an autoresponder email to go out to users after a preset defined time.  Maybe after someone orders, you want to send an email out to the user with special coupons, extension products, or other products they may like.  It’s also nice to ask for reviews or other specialty articles related to their order.  MyMail allows you to setup autoresponders quickly, easily, and professionally using their newsletter campaign builder.

Custom Subscriber Lists

This is where things get even more interesting…  MyMail allows for subscriber lists, and you can custom code the automation of users into those lists based on products they purchase by simply creating a child layout file of our confirmation email and coding in a few lines of code to inject users who buy specific products into specific email lists.  That is targeted email!

lists

So a scenario may go like this; a customer orders from you and buys product XYZ.  They will receive a confirmation email that the order was successful, you could add a small bit of coding and put this customer into not only an ‘Customer List’ for future emailing campaigns, but you could also setup an autoresponder to email this customer 2 weeks after purchase to please come back and review their experience, rate your shopping experience etc.  You can also add this user to a ‘Product XYZ List’ so that you can later email anyone who purchased Product XYZ, or also send automated responders to them, such as special instruction emails, etc.

WP EasyCart Extensions

While our Mandrill extension is not required for MyMail to work, it is helpful to also use for all EasyCart confirmation emails and transactional emails in conjunction with MyMail.  This way all of your communications go through a secure dedicated professional grade email system that lets you insure deliver and takes away these extra tasks from your web hosting server.

 

 

Version 3.1 Released!

We have been working hard and are proud to continue to push new updates and features in WP EasyCart.  The platform is growing quickly and people seem to really be taking to the EasyCart shopping cart and eCommerce system with it’s low cost $80 dollar fee and huge list of features.

With version 3.1, we are continuing to make usability and speed our main goal.  We have a large list of fixes and features in this release, including some major new features that many will come to like.

Speed Improvements for Everyone!

We found several key areas we could improve speed, particularly with our database indexing and within our PHP session handling.  We found that some servers increased their speed by up to 400% with these new fixes and should help many customers, particularly godaddy hosted individuals.

One thing we have found critical to customers speed is to stay current on your WordPress and plugin updates.  Also be sure to eliminate any old plugins that you do not use, and try to keep the plugins to a minimum if you can.  Adding each new plugin to WordPress can cause large slow-downs in performance and download times for customers.

New Backorder System!

With the new backorder system, you can edit each individual product and enable the option.  Customers can continue purchasing products even if the quantity runs out, and it will show an estimated delivery date IF you enter it for each product.  This makes it great to continue selling goods and offering defined custom dates so they are aware of up-coming estimated delivery dates.

backordernew

Once you receive your new stock, simply update the quantity in EasyCart and the ‘Backorder’ system is turned off and the product goes back into ‘Add to Cart’ functionality.

Canadian Tax System Improvements

We have vastly revamped the Canadian tax system in our advanced options setup.  Now you can turn on Canadian taxes per province and it will display GST, HST, PST based on your specific needs.  The display of these taxes follows through to the receipts and order panels as well, for a more accurate and proper way to handle taxes.

If you ship to the U.S., and also need tax setups, you can simultaneously run TaxCloud’s free api to get current state and county taxes right next to your canadian tax structure.  As tax systems continue to evolve and get more complex in structure, it’s nice to know that we are working hard to make it as accurate and seamless as possible in EasyCart!

canadataxes

New Dimensional Option Sets

We have added a couple new option sets to our already extensive list, including the ability to add dimensions to a product and calculate square footage.  Two types of dimensional options are available (with or without sub-inch measurements) giving your customers a chance to enter height/width combinations and EasyCart will calculate the square footage and add it to their cart.

This makes it great for selling tile, flooring, cabinetry, posters or other types of square footage material.  Just enter a price for your product per foot and let EasyCart do the rest.

Authorize.net & Beanstream Integrations

You can now refund authorize.net transactions directly from inside the EasyCart admin consoles.  This includes full or partial refunds and makes order management easier than ever.

We have also integrated with Beanstream, a popular payment gateway, which now increases our payment gateway reach.  Beanstream is a popular Canadian and US gateway provider and offers low 2.65% per transaction fees.  Learn more at http://www.beanstream.com/ 

 

As EasyCart continues to improve, we always look for more input from users.  It doesn’t always mean we will get it in our software, but if you have ideas or need something added to EasyCart, just send us a support ticket and let us know.  We have some great new things planned for version 4.0, so stay tuned as we continue to develop!

WP EasyCart – Guide to Marketing 101

In this marketing 101 tutorial, we want to discuss all the various options EasyCart can offer you as a business owner to market your website.  It’s not easy, but with a lot of work and patience, you can attack each of these methods and gain more traction in the online retail world.

Marketing Basic Concepts

Social Media – Sites such as Facebook, Twitter, Digg, MySpace, Instagram, and others that allow you to post up links, pictures, and other pieces of information about things you like.  Others, who are associated to you in that social media, can then see your links, pictures, and information and view them.  Makes for a great marketing platform to have your products go viral.

Coupons – We refer to coupons as something the customer has to bring to your store.  Typically a paper coupon in a retail store, but on websites, coupons are often shopping codes that the customer enters during checkout to get an extra discount.  Coupons do not apply to everyone, only those who receive it, making it a ‘special’ offer for some.

Promotions – We refer to promotions as something that run on your website and EVERYONE receives the discount.  Perhaps you have a fall sale, or a special weekend sale that everyone will get on your store because it is set for a time period or specific set of products.  No entry of a coupon code is needed to redeem.

Cross-Sell –  Showing one product, and then showing some related products that allow you to cross sell to another product. typically a ‘You may also like’ or ‘alternative products’ sections on a site.

Up-Sell – Taking an existing product, and then adding some extra value to it to get the customer to purchase a little bit more.  Typically in the form of options, add-ons, etc.

Affiliate Marketing – Paying other people to promote your site and selling your goods.  Affiliates will often link to your website with a special code, and in return, if customers come from that link and purchase goods, you will pay the affiliate a specific cut of the profit.

Volume Pricing – Offering pricing based on quantity purchased.  Typically if you buy more, you can get each individual purchase at a cheaper price, especially useful tool for selling in bulk.

Customer Reviews – Ratings & customer reviews have become increasingly popular with a variety of retail goods.  Give a bit of confidence to customers by offering other peoples opinions on the product.

SEO and AdWord Marketing – specifically target market to the search engines, so the will index you and you can benefit from organic searches from the search giants.  You can even pay to advertise on giants like google to increase your search presence and attain higher placement on searches.

[divider]

1.  Social Media

There are a lot of misconceptions about social media, but it is really like any other market place.  If you are there a lot, spend the time, you can attract people, but it takes a lot of time, effort, and socializing to do so.  Facebook and Twitter are the highly regarded giants in this area, and you should always offer at least a page for your business to share it’s latest releases and updates.  It’s fairly easy to do and posting once a week or every couple weeks is easy to do.

You can recommend your friends like the page to begin with and it will slowly gain traction.  One good tip we have regarding social media is to ‘Boost’ an important post or sale you display on Facebook for a small fee.  This can get your small ad in front of thousands, get more likes, and in return more visitors and often will lead to a couple conversions on your store.

On EasyCart’s side, we offer sharable buttons for every product, so customers who visit your EasyCart products can click and share links to them.  No need to install another social sharing plugin into WordPress, it’s all automatic with EasyCart.

shareicons

 

[divider]

2.  Coupons & Promotions

A great feature of EasyCart is you can create both Coupons & Promotions for products.   Create a coupon and specify whether the coupon offers free shipping, or dollar/percentage discount.  You can even specify the coupon will only apply to a specific product, all the products in your store, or to a specific manufacturer group.

Once you create coupons, it is entirely up to you how customers will receive that special code.  You can develop custom email newsletter campaigns that distribute that code to specific targets, or you can post it on social media so only those folks see your coupon code.  You can even run public local ads that only local newspaper or visitors will see and use.

Promotions are very similar, but you can establish time periods in which the promotion will run.  Here is an example of a promotion that will offer free shipping to any order over $100 dollars.

freeshippingpromo

The best part about promotions is they apply automatically based on your specific date selection, product selection and type of promotion to run.  All your customers benefit from the promotion and no coupon code is necessary to enter.  So based on your specific needs and how you want to marketing, coupons OR promotions can be used in a beneficial manner.

We recommend that you run a banner on your home page or other pages that display what type of promotion is running, and even share on social media that you have a current promotion running.  Email campaigns are another great way to spread the word and get visitors returning to your site.

promo-applied

[divider]

3.  Up-Selling, Cross-Selling, Reviews, & Volume Pricing

EasyCart offers a vast option system that allows you to create options that change pricing for products.  This makes a great way to display a product and then offer up-selling options to a customer as they add to the cart.  These added value options often give the customer a sense of ‘why not’ at the product level and they are more likely to convert and add the extra options at this point rather than as separate products.

upselling

 

EasyCart also offers an easy way to attach like products that a customer may want to purchase.  You as the business owner know best what customers may like, so offering some featured items or a ‘You May Also Like These’ section is a great way to suggest to a customer online what they may also like and keep more visitors shopping without having to restart the navigation process.

crossselling

 

Customer reviews are another great marketing strategy to involve customers and get them to leave content on your website.  EasyCart offers a full 5 star review system and review commenting section for you as a store owner to activate per product.  Using this on a highly commented retail site is a great way to build confidence in customer decisions.  Of course it may not fit in every businesses product line, but if you sell one or two goods and receiving a lot of praise from customers, offer a coupon code to anyone who leaves good positive feedback for you on social media, on your website review system, or other website.

reviews

Volume pricing is a great strategy if your products fit into this type of bulk distribution.  Give customers an incentive to buying in bulk by using the EasyCart tiered volume pricing system.  Just establish a set price, then offer what each product will cost at various intervals of quantity, it’s easy and a great way to market a few more items.

tiered-pricing

[divider]

4.  Affiliate Marketing (new)

EasyCart just announced a new integration with AffiliateWP and we are continuing to develop this system further with the company.  The beautify of the system is you can offer affiliates a way to signup and register using AffiliateWP on your website, then affiliates use their custom link to promote your site.  The more they promote, the more they make, and the more you make.  As each customer  purchases, AffiliateWP software keeps track of the totals and even allows an easy one click bulk pay to the affiliates at the end of the month or other payout period of your choosing.

Affiliate marketing is a great way for you to leverage other people as marketers and to only pay them if successful.  Affiliates will spread the word about your products in channels of friends, social media, emailers, and websites that you would never reach, and yet you get complete control over how much affiliates take in proportion to your sales.

EasyCart even built in custom rules so that you can offer each product or each affiliate custom rates based on your specific needs.  We are working closely with AffiliateWP staff on this integration and it may change shortly to accommodate even more options.

affiliatewp

[divider]

5.  SEO & AdWord Marketing

One of the leading ways to market is via good old fashioned organic searches in Google, Yahoo, and Bing.  Of course, you must realize you are now competing in a global marketplace and that your small retail store may have a million competitors in the search engine market, so here are a few strategies we recommend when focusing on search engine placements.

1.  Don’t spend thousands of dollars on SEO companies to ‘Get you on page 1’.  If you believe they have the answer to get you to page 1, we have some property on the moon to sell you as well!

2.  Spend money on AdWords, not a lot, but some reasonable marketing money on google AdWords.  Setup a small ad, and enter a few keywords that you really expect visitors to enter into a search to find you.

3.  Keep your key words focused and unique.  Don’t waste time on thousands of keywords, but really focus on a small handful of words that will bring in 90% of the customers.

4.  Write content that matters.  Your website must have actual words that people could read, blogs, stories, how-to’s, something…  don’t expect visitors through search engines if you don’t keep relevant content on your site that is continually updating.  Search engines even get bored if they see the same content each scan, so take time to write.

5.  EasyCart allows you to enter each product with keywords and SEO text.  Write descriptive descriptions and specifications if you can.  The more unique text you write, the more relevant the products will be in searches.

6.  Submit your EasyCart products to Google merchant feed.  While this may not be appropriate for all businesses, nor worth the time, if you have a bunch of retail goods, get them on the shopping section of Google merchant with our merchant feed system.

7.  Track visitors.  If you don’t use Google analytics, get it on your website.  You can see where visitors come from, what they search for, what pages they visit, and with EasyCart, you can enter your Google analytics code in our basic settings and track eCommerce sales data.  How can you expect to market a site if you can’t track what is successful or what is not?  Data is the only way to see what content is working, what changes are working, and where/why visitors come to your site.  It’s powerful, free, and only requires a bit of knowledge and research on your part.

 

Conclusion

marketing an online site is a lot of work, and if anyone felt they were going to make millions selling online without doing anything, they may be misguided…  In fact, we always felt it takes more time selling online than in retail shops because of the amount of descriptive work that goes into displaying and selling a product.  But do not let this discourage you, there is a lot of potential if you use the right tools, that you can get for the right price, and not eat away at your profit margins to much.  Utilizing a bit of your own time, researching your own content, finding your niche, and then following a plan can make you a marketing genius and help catapult your business into the black.

At Level Four Development, creators of the WP EasyCart, our mission has always been to provide tools that WE would want to use, at a low affordable cost to the mass marketplaces that want to sell online… and our software success is starting to show this.

Become an EasyCart Affiliate and Earn Cash

affiliate-program

Now you can market and promote WP EasyCart and earn 10% for each referral you make.  We have integrated with AffiliateWP and are tracking affiliate referrals so you can easily earn commission, and get paid for your recommendations.

Theme developers will be glad to know you can earn extra revenue by posting that your theme is WP EasyCart compatible and link to our website.  Earn 10% for each referral who purchases our standard or lite version plugins.

Web designers, now you can become an affiliate and have your customers purchase a license directly from us, while still retaining 10% profit.

It’s easy, just Click Here to Sign Up and then you will receive a unique URL to promote on social media, your website, or email and referrals are automatically tracked with your account.

 

Selling eBooks with Print Option

One of the most common product types that WP EasyCart users like to sell are eBooks. When selling eBooks, many want to offer their customers the choice to buy the eBook, the print version, or both and want to do so without creating three different products. Thanks to our latest product options this is easily possible with the WP EasyCart! In just a few steps, we will show you here how to create the option set needed to attach to your eBook/print product and get selling right away!

Creating the Option Set

All of these instructions will occur in the EasyCart Admin -> Store Admin -> Products -> Manage Option Sets. Please navigate there to begin.

  1. Create your option set that will be used with all your eBook/print products, select the advanced combo box type.
    ebook-option-set
  2. Navigate to the area to add new option items, Edit Option Set Items -> Create New Option Item for each item 3, 4, and 5.
  3. Add your eBook only option, be sure to allow the product download and disable the product shipping. We will also only adjust the pricing for print and both, assuming the lowest cost will be for the eBook only option and the main price of the product.
    ebook-only-optionitem
  4. Add your print only option, be sure to uncheck the box to allow product download and leave the disable product shipping unchecked. We assume the price for a print book will be more than the download and will do a basic price adjustment to account for this.
    ebook-print-only-optionitem
  5. Add your eBook and print delivery option, be sure to check the allow product download and do not check the disable product shipping. We also assume the price for both items is a larger price adjustment and will use a basic price adjustment to account for this.
    ebook-both-optionitem

Setup Your Product

While setting up your product that will sell eBooks and print versions. You should start by creating a download product type and then select the following options to complete the setup:

  1. Set the weight and product dimensions to that of your print version that will ship when purchased.
  2. In the Set Advanced Listing Options area, select to ship the product.
  3. Go to the option sets section and select advanced option sets and attach your delivery method option set.
  4. Go to the downloads section and upload your eBook copy.
  5. Be sure to setup all other necessary options (title, description, price, images, etc…).
  6. Insert this product.

That should do it! You have setup a product that allows the customer to purchase an eBook, print version, or both all in one product! If the customer selects an option with the print version, they will be charged the appropriate shipping price. If the customer selects an option to purchase an eBook, they will be given the appropriate links to download after the purchase is complete.

Custom Store Post Template

The WP EasyCart can leverage the WordPress option “custom post types” to help with the linking of your products, categories, menus, and manufacturers. Using this feature, we are able to create links like http://yoursite.com/store/mens-beanie, rather than http://yoursite.com/store/?model_number=abc123. This option is enabled in the EasyCart system by going to your WordPress Admin -> EasyCart Admin -> Store Setup -> Advanced Options and turn “On” the option “Use Custom Post Type Linking”. Once this is functioning, your links will now go to a more search engine friendly URL, but there is a downside. WordPress uses your default post template in your theme called “single.php”. If this file does not look how you like or looks very different from your page template, it will cause a disconnect from product list page to product details page. Fortunately there is a solution! Directions will be provided here, but you can read more about this setup in WordPress’s codex here: http://codex.wordpress.org/Post_Type_Templates.

Setting Up Custom Post Template

  1. Copy your single.php file in your theme and rename it to single-ec_store.php.
  2. Make changes to this file as is needed. Many times it is best to use the layout and info from your page.php file.
  3. Go to your WordPress Admin -> EasyCart Admin -> Store Setup -> Advanced Options and turn “On” the option “Use Theme Custom Post Template for Store “.

This will allow your store to use a custom design for the product details, categories, menus, and manufacturers.

Custom Payment Gateway Integration

We have had a huge demand for adding a custom payment integration to your own EasyCart install and it is finally here. Starting with the release of version 3.0.19, you can add a live payment gateway that is customized by you, the programmer! Fair warning to those who are not familiar with PHP, this may be a little difficult to manage and is meant for those with a good understanding of programming.

The highest demand for this service is for those companies that use an Authorize.net emulator. This type of custom gateway is by far the easiest and will the first example provided here.

To start, lets explain how the custom payment gateway option is integrated in general, minus the programming details of customizing the class for your own payment gateway.

[divider]

Basic Custom Payment Gateway Class Setup

1. Start by going to your WordPress admin -> EasyCart Admin -> Store Setup -> Payment Setup and in the Live Payment Gateways section, and select the last option “custom payment gateway”.

2. The system is now looking to include your new payment gateway file, so lets copy an existing payment gateway file into place and rename it so that it is included in the load of the plugin. Do this by copying the file “plugins/wp-easycart/inc/classes/gateway/ec_authorize.php” to “plugins/wp-easycart-data/ec_authorize.php” and rename the file here to “plugins/wp-easycart-data/ec_customgateway.php”.

3. The system is also looking for a class named “ec_customgateway” so lets fix this up. Open the newly copied ec_customgateway.php file and rename the class to read on the first line:

class ec_customgateway extends ec_gateway{

4. At this point you have a custom gateway setup, but need to customize this to function as a custom class to your system. Please read the next section about editing the class to work as an Authorize.net gateway emulator.

[divider]

Authorize.net Emulator Class Setup

If you have not completed the “Basic Custom Payment Gateway Class Setup”, please complete that section first. There are many companies that use the Authorize.net API as their method for collecting payment from their merchants. The reason they do this is that Authorize.net is one of the most popular, if not the most popular integration in the e-commerce industry and by leveraging their API, they can quickly integrate with any platform. Their system requires you to change the endpoint (the server that receives the transaction information) to point to their own payment servers. The following steps will help you alter the newly created payment class:

1. The first thing to do is enter your custom settings and there are two ways to do this. The easiest way is to first return to WordPress admin -> EasyCart Admin -> Store Setup -> Payment Setup and in the Live Payment Gateways section and change back to Authorize.net as your payment gateway. Enter your login id, transaction key, test mode off, and your currency code, then click save. At this point the authorize values are saved to your system, no matter what gateway you select from this point on. So you can now open the live payment gateway section again once the page reloads and switch it back to the custom payment gateway option. The other option here is to replace the following code:

$authorize_login_id = get_option( ‘ec_option_authorize_login_id’ );
$authorize_trans_key = get_option( ‘ec_option_authorize_trans_key’ );
$authorize_test_mode = get_option( ‘ec_option_authorize_test_mode’ );
$authorize_currency_code = get_option( ‘ec_option_authorize_currency_code’ );

TO:

$authorize_login_id = “YOURLOGINID”;
$authorize_trans_key = “YOURTRANSKEY”;
$authorize_test_mode = false;
$authorize_currency_code = “USD”;

2. Edit the get_gateway_url method to use the emulator endpoint instead of the authorize endpoint. The edit will change:

$is_developer_account = get_option( ‘ec_option_authorize_developer_account’ );

if( $is_developer_account )
return “https://test.authorize.net/gateway/transact.dll”;
else
return “https://secure.authorize.net/gateway/transact.dll”;

TO:

return “https://yourendpoint.com/endpoint”;

3. At this point you should be able to upload your custom gateway and run it successfully. We have noticed some errors occur in that the response may not be returned in the “body” as Authorize.net does. If this is the case, you will need to investigate the format of the response and is easily done by changing:

function handle_gateway_response( $response ){

TO:

function handle_gateway_response( $response ){

print_r( $response ); die( );

which will print the response to the screen and stop once printed. Use this to point yourself to the right response information to process and remove it when you are happy with your understanding of the response data.

[divider]

Custom Payment Gateway Company

We also know there may be some of you out there that have a company you would like to integrate with that does not follow closely to any other payment gateway. We will do our best here to describe our process for custom integration with payment gateways.

1. We recommend using the ec_securenet.php payment gateway class as a starting point. The reason for this is that it covers many of the most common requirements for custom gateway integration.

2. Typically there are two types of data format that are sent to your payment gateway, an array or XML string. The ec_securenet.php shows gateway data in the format of an array, use this is a starting point if you are going that route. If you are using a gateway that accepts XML data, look into the ec_securepay.php file instead.

3. Notice that ec_securenet.php does not use the method “get_gateway_data” as this is not necessary when you need to use a custom CURL call (ec_securenet.php does this). Some gateways work great with the default call and in this case, follow the format of returning the data through the “get_gateway_data” method. This is a technical option based on the requirements of the payment gateway. Following the ec_securenet method is the easiest way to avoid technical difficulties.

4. Some gateways require an authorization header and ec_securenet as an example of this. If your gateway does not require this, you can remove the line that adds this to the header array.

5. Once you are able to build and send your gateway data, the next, and most difficult, part is to process the response.  We always send the response data to the “handle_gateway_response” method for processing. Please notice that if you are viewing the securenet version, the response from them is in JSON formatting and is why we process it through the json_decode function first, but many gateways return their data as an array in the $response[‘body’] array element. Our recommendation is to start by sending the whole response into the “handle_gateway_response” method and use a print out to determine where to go from there. Once you send the data to the response function, we should start by adding “print_r( $response ); die( );” to the top of the “handle_gateway_response” method. This will show you the path to getting the response messages out of the data and applying them to the correct class data elements.

6. The first processing step is determining the attribute that signifies a successful payment, typically an “APPROVED” or “SUCCESS” value and may be accessed through $response[‘body’]->result or $response[‘result’]. If XML is returned, you may need to first run the $response data through:

$response_body = $response[“body”];
$xml = new SimpleXMLElement($response_body);

and access the value by $xml->result or something similar. This is the most difficult task because it requires you to have a complete knowledge of the type of response and if it is formatted as an array, object, xml, JSON, etc… Once you are able to access and check for success, set the $this->is_success to true or false.

7. We also ask that if there is an error, try to set $this->error_message = $xml->response_message; or whatever your response error message is.

8. The last thing to do is insert the response to the database for later access and troubleshooting. This is done by editing the following line to fit your needs:

$this->mysqli->insert_response( $this->order_id, !$this->is_success, “Gateway NAME”, print_r( $response, true ) );

If you are able to get through all of this, get a response from your gateway, process the return data successfully, and set the success value to true or false, then you are done. The EasyCart will insert and process the order based on your success value and requires nothing else once you get your gateway setup to process the credit card through your own gateway.

[divider]

Successful Custom Payment Integration

If and when you complete your custom payment integration, you are welcome to send to us for review and to add the gateway as a default option in the cart. Having us add new gateways to the cart is especially useful for developers that reuse the EasyCart for multiple projects and want the same gateway to be available quickly. We are always open to adding new gateways, so please contact us in the event that you would like your gateway in the cart by default!