FastSpring WordPress Plugin

Last modified October 22, 2018

This article applies to Contextual Commerce. (Looking for Classic Commerce documentation?)


Click here to visit the plugin page on WordPress and download the plugin

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.

Note

To use the FastSpring WordPress Plugin, you must have a FastSpring account and Store. You can sign up for an account for free at https://fastspring.com/sign-up/.

Tip

If you would like to provide feedback or suggestions regarding the FastSpring WordPress Plugin, please email  support@fastspring.com and include the phrase "WordPress Plugin" in the subject of your message.


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.

Example of a WordPress page using the FastSpring plugin

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.

Example of a WordPress page using the FastSpring plugin, with labels added to show the various data pulled dynamically from the Store

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.

Note

In this example, a few minor CSS style changes have been applied manually via the Text tab.


Example of the Text tab of the WordPress Edit Page dialog

Note

If your WordPress page is open in your browser while you make changes in the Dashboard or via the API, you may need to refresh the page in order to see the effect of your changes.

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.

Buy Buttons

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.

  Click here for an illustrated example
Example of a WordPress page with a FastSpring Add to Cart button using class fastspring_btn fastspring_btn-success


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.

  Click here for an illustrated example
Example of the shopping cart with an Apply coupon button using class fastspring_btn fastspring_btn-success



Checkout Buttons

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.

  Click here for an illustrated example
Example of the shopping cart with a checkout button using class fastspring_btn fastspring_btn-success



Cross-Sell Buttons

"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.

  Click here for an illustrated example
Example of the shopping cart with a cross-sell offer whose button uses class fastspring_btn fastspring_btn-success



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.

  Click here for an illustrated example
Example of the shopping cart with an EDS button using class fastspring_btn fastspring_btn-success



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.

  Click here for an illustrated example


Up-Sell Buttons

"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.

  Click here for an illustrated example
Example of the shopping cart with an Up-sell button using class fastspring_btn fastspring_btn-success



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.

  Click here for an illustrated example