This article applies to Contextual Commerce. (Looking for Classic Commerce documentation?)
This article describes the FastSpring plugin for WordPress.
For information about configuring the plugin, please see Configuring the FastSpring WordPress Plugin.
For instructions on how to use the plugin, please see Using the FastSpring WordPress Plugin.
Introduction to the FastSpring WordPress Plugin
The FastSpring WordPress Plugin is a tool that lets you integrate your FastSpring Store with your WordPress website. Using the plugin, you can dynamically display product information and a full shopping cart, and collect customers' payments right on your site via your FastSpring Popup Storefront. The plugin lets you do all of this and more without having to manually create any code.
The plugin accomplishes this by providing you with an easy-to-use interface for FastSpring's Store Builder Library (SBL). No technical expertise is required, but familiarity with WordPress and CSS are helpful when using the plugin. Users with basic knowledge of HTML and CSS will be able to further customize their solutions on the Text tab of their WordPress pages.
What Can I Add to My WordPress Page Using the Plugin?
The plugin makes it easy for you to add the following:
- Detailed, dynamic product information from your FastSpring Store including product images, titles, descriptions, and prices
- A complete shopping cart with a quantity field, a subtotal, and an optional coupon / promotion code entry field
- A modal checkout dialog via your Popup Storefront
- Various buttons that your customers will use to interact with your FastSpring Store
Displaying Product Information via the Plugin
You can use the plugin to dynamically display product details from your FastSpring Store on your WordPress pages. Once you have used the plugin to add product details to your page, if you update a product's attributes via the Dashboard or the FastSpring API, the details displayed on your page will be updated automatically. The following images illustrate just a few examples of the product data that can be added to your WordPress pages.
In this image, you can see an example of a rendered WordPress page that includes various details of a specific product from the FastSpring Store, including the product image, product name, product price, and product summary.
This image illustrates which parts of the page content are pulled in dynamically from the FastSpring Store. This includes essentially all of the page's content.
Finally, here's an example of the Text tab of the Edit Page interface for the same page, where the plugin has inserted Store Builder Library code (and some custom code) using simple command buttons.
Store Buttons You Can Add to Your Page
Here are some details about the different types of buttons that can be created on your page and / or are included in the shopping cart when you use the plugin. For instructions on configuring the default properties of these buttons, please see Configuring the FastSpring WordPress Plugin.
A "buy" button has two separate functions. The button's primary (and initial) function is to add one specific product to the shopping cart. You can configure a "buy" button to immediately open the shopping cart, or to simply add the product without opening the cart. This setting, and the specific product from your FastSpring Store to be added when the button is clicked, are configured via the FastSpring Buy Buttons command.
Once the button has been clicked by your customer and the product is in the cart, the button automatically switches to its secondary function. Keep in mind that the button may not be visible if the cart is open, depending on your placement of the button on your WordPress page. The button's secondary function can either be to remove the item from the cart or to re-open / view the shopping cart. This option is controlled via the Secondary Button Function setting in the FastSpring Buy Buttons command.
Apply Coupon Buttons
This special button type is only present in the shopping cart. The purpose of an "apply coupon" button is to submit the coupon or promotion code that the customer has pasted or entered into the coupon entry field, thus adding the code (and a corresponding discount) to the order. In case an incorrect or invalid code has been entered, an error message will be displayed and the coupon entry field will automatically be cleared after a brief delay.
A "checkout" button opens your FastSpring Popup Storefront when clicked. Customers are presented with a secure dialog to enter their payment details and complete a purchase of whatever products were in the cart at the time the button was clicked.
"Cross-sell" buttons are similar to "buy" buttons, except they only appear inside the shopping cart. When the cart includes a product with one or more cross-sell offers, the "cross-sell" button can be clicked to accept an offer and add the cross-sell item to the cart.
EDS Buy Buttons
"EDS buy" buttons are similar to "buy" buttons, except the only appear inside the shopping cart. When the cart includes a product with the optional Extended Download Service available but not currently selected / in the cart, the "EDS buy" button can be clicked to add EDS to the order.
Remove from Cart Buttons
A "remove from cart" button removes a specific product from the shopping cart when clicked by your customer. This type of button can appear on your main WordPress page, as the optional secondary function of a "buy" button that has already been clicked by your customer. A smaller variation of this button, consisting only of an icon, also appears in the shopping cart itself next to each product that has been added.
"Up-sell" buttons are similar to "buy" buttons, except they only appear inside the shopping cart. When the cart includes a product with one or more upsell offers, the "up-sell" button can be clicked to accept an offer and replace the item in the cart with the upsell item.
View Cart Buttons
A "view cart" button opens the shopping cart built into your WordPress page. The location of the cart on your page is controlled by the Shopping Cart Location field on the General tab of FastSpring Settings. This type of button can appear as the optional secondary function of a "buy" button that has already been clicked by your customer. It can also be added to your WordPress page directly using the FastSpring View Cart Buttons command.