Tutorials, How-tos, and Recommendations for Shopp

Organized from Shopp installation to post-checkout and ideas in between.

An Explanation of Shopp Templates: Theme vs Content

by Lorenzo Orlando Caum on August 20, 2012

Today we’ll be explaining how Shopp templates work together.

Shopp 1.2.x uses theme and content templates. Theme templates can be considered the structure or layout whereas content templates provide the data or information on the page.

Theme templates: https://shopplugin.net/api/category/templates/theme-templates/ 

Content templates: https://shopplugin.net/api/category/templates/content-templates/

Theme Templates in Shopp

Shopp theme templates reside in the following location:


The image to the left is a screenshot of some files in the WordPress Twenty Eleven theme. We have highlighted the page.php and single.php which are examples of theme templates.

If you view a website running Twenty Eleven, then pages such as About and Contact Us will likely be using the page.php file. If you then browse to the Blog, then its likely that those pages will be using the single.php file.

How does this relate to Shopp?

If you want a layout that has a content area with a right sidebar, then you would duplicate that theme template that has that existing layout and rename it to shopp.php. From that point, Shopp will use that new layout across the store. Click here to continue reading →

Accept Variable Donations with Shopp

by Lorenzo Orlando Caum on August 15, 2012

One of the type of products that you can setup in Shopp is a donation product.

With this product, instead of the cost being fixed, it can vary. By default in Shopp 1.2.x, this will allow a customer to chose between different ranges.

While this is an improvement over fixed-pricing, the customer is still limited to a range.

We’ll show you how to setup a input box so that a customer can enter a specific value.

First be sure the donation product has “accept variable amounts” enabled in the pricing area. Also make sure that Shopp templates are active (Shopp setup >> Presentation) Click here to continue reading →

Reset Shopp Sessions

by Lorenzo Orlando Caum on August 13, 2012

Shopp keeps track of your shopping experience in something called a “session.”

The default end-time for a session is about two hours.

However if you are actively developing a site, you can reset a session by adding the following to the end of the store URL:


What does this look like on a live store?

Say you add a couple items to a cart. If you reset the session via the query described above, your session will be cleared (cart emptied). You can start a new session right away by just browsing the store.

Shopp e-commerce plugin

Another Round of Updates to our Shopp + Extensions

by Lorenzo Orlando Caum on July 26, 2012

This week we pushed another set of updates to all of our Shopp extensions.

We recommend updating right now.

The updates were primarily minor fixes and improvements with the added ability to extend them further.

List of changes:

  • Corrected html syntax
  • Corrected array(&$this
  • Improved explanations in the readme file
  • Updated WordPress admin page content and layout
  • Removed unnecessary CSS styling
  • Fixed CSS date format
  • Verified support for Shopp 1.2.3
  • Verified support for WordPress 3.4.1

We are now up to 11 plugins for Shopp! That is 6 email marketing integrations, 3 SMS integrations, 1 help desk integration, and 1 utility-based integration. Click here to continue reading →

Enable Multiple Merchant Email Notifications

by Lorenzo Orlando Caum on July 25, 2012

Do you run an online store that has multiple parties involved?

Here are some examples:

  • Business owner and drop shipper
  • Several business partners
  • Investor(s) and store owner

You can set Shopp to send merchant emails to all interested parties.

Here is how:

  1. Login to your WordPress admin
  2. Go to Shopp (Setup) –> Setup
  3. Locate the merchant email field
  4. Now start adding extra emails while adding a comma after each


email1@mybusiness.com, email2@mybusiness.com, email3@mybusiness.com


Add a Customer Message Box to your Checkout Page in Shopp

by Lorenzo Orlando Caum on July 13, 2012

In this tutorial, we’ll teach you how to add a message box to your checkout page.

A customer can add specific information about their order and that information will automatically appear on their receipt. Can you think of the many reasons where this could be beneficial to your online webshop?

We’ll be using this Shopp API call: shopp(‘checkout’,'order-data’)

Here is an example of the area where we will be adding this message box:

We want to minimize the distractions on the checkout page so we’ll add this box between the address area and payment area.

The code snippet that will handle this data is:

<?php shopp('checkout','order-data'); ?>

We’ll then change it to our store’s needs:

<?php shopp('checkout','order-data','name=Order Notes&type=textarea&rows=5&cols=35'); ?>

We’ve taken the original code and added a field name of Order Notes. We’ve also specified that we want an adjustable text area field with a certain sizing.

Now it is time to insert the code into our checkout.php file.

  • Open your preferred FTP client (a free client is FileZilla but we use Transmit)
  • Browse to your Shopp content templates folder
  • Locate the checkout.php and create a duplicate
  • Then rename the original file (a simple backup process)
  • Now open the other checkout.php file and insert the code snippet where you want the box to appear

You may need to adjust the location of the code snippet one or twice and add some extra code for styling.

Here is the result (we added a couple line breaks to adjust spacing):

Now a customer can enter information about their order if they so desire.

Not sure if your store checkout page can benefit from this? Here are some real-world examples:

  • You sell items that allow for customization
  • You sell items that can be substituted should one be out of stock
  • You enjoy receiving little notes of support from your customers

Notes: there are more options available so you should have a look at the link shared earlier to the API docs.

Setup Shopp eCommerce Plugin with zferral

by Lorenzo Orlando Caum on July 11, 2012

zferral is referral software that you can use with Shopp. If you want to increase sales in your online store, then you should definitely consider adding an affiliate program. We’ve written tutorials on setting up Shopp with ShareaSale and AffiliateRoyale. Your affiliates will boost your sales by driving traffic to your Shopp online store.

We’ll show you how to configure Shopp to work with zferral in under ten minutes.

zferral supports four methods of integration: IMG pixel, IMG pixel HTTPS, Javascript, and PHP pingback. In this tutorial we’ll discuss the IMG pixel HTTPS method.

The documentation for zferral states that a code snippet should placed on the “success” page. In Shopp, this is the confirmation or thanks page. There are a few variable values — only the first is required:

  1. $rev – the total value of the transaction
  2. $customerid – the customer id
  3. $uniqueid – unique order transaction id
  4. $info – other information about the order
  5. $coupon – affiliate coupon

Then there is one fixed value which is name of the login page (accountname). You can find yours by logging into your zferral account.

Here is an example ($info and $coupon are not used):

<img src="https://accountname.zferral.com/e/2?rev=24.00&customerId=hello@enzo12.com&uniqueId=2cll21ozne" style="border: none; display: none" alt=""/>
  • $rev = 24.00
  • $customerid = hello@enzo12.com
  • $uniqueid = 2cll21ozne

Click here to continue reading →

Generate Information About Your Shopp with Shopp + Ology

by Lorenzo Orlando Caum on July 7, 2012

We’ve created a plugin to help you with troubleshooting your Shopp. It is called Shopp + Ology. This plugin adds + Ology to your Shopp menu and generates information about your hosting environment.

Click here to download Shopp + Ology

At this time, it displays data on four areas:

  1. Server
  2. WordPress
  3. Shopp
  4. Your Computer

…and conveniently displays them in a report format. You can copy and paste the data and share with your Shopp consultant, web developer, or responding Shopp agent via the Help Desk.

This plugin cannot make any changes to your server, WordPress, Shopp, or computer. It simply retrieves the information and formats it for your viewing.

Notes: Shopp + Ology was developed with Shopp 1.2.x and WordPress 3.4.1; plugin is not compatible with Shopp 1.1.x or earlier.

Click here to download Shopp + Ology

Pro-tip: Want speedy support from the Shopp Help Desk? Be sure to share the following information to the best of your knowledge in your support ticket:

  • Provide helpful information upfront
    (What version of WordPress are you running? What version of Shopp? Any Shopp add-ons?)
  • Describe your issue in a clear and concise way
    (Link to a screenshot or two or even a video describing the issue)
  • Generate a temporary administrator username and password for the WP-admin

Override the Shopp Order Handling Fee

by Lorenzo Orlando Caum on July 2, 2012

Shopp allows you to set two types of order fees.

One is the storewide order handling fee which is set via WP-admin –> Shopp (Setup) –> Shipping. It looks like:

The other is the product extra fee which is set for each product via WP-admin –> Shopp (Catalog) –> Products –> Product. The option appears like this:

The order fees are simple. The storewide order handling fee will apply to each order and the product extra fee applies to only specific products in an order. Currently you can set these fees as a flat rate.

What if you want to apply a storewide order handling fee as a percentage? We’ll show you how to do just that using a Shopp filter. Click here to continue reading →

Video Walkthrough: Manually Upgrade Shopp

by Lorenzo Orlando Caum on June 27, 2012

Shopp 1.2.3 was released this week.

There is an important fix for multiple gateways in your store. Some other fixes include the rendering of product input and catalog promotion discounts.

For a more thorough list of fixes, you can checkout the release notes for Shopp 1.2.3.

If you are using Shopp 1.2.2 then you should be able to complete an automatic upgrade via the WordPress Plugins area. If you are using Shopp 1.2, 1.2.1 or earlier, then you may need to perform a manual upgrade.

Here are the steps for a sound manual upgrade:

  1. Backup your WordPress - http://codex.wordpress.org/WordPress_Backups / Another popular option is BackupBuddy
  2. Disable any security / caching plugins / Cloudflare or equivalent services (if applicable)
  3. Download the latest version of Shopp and any add-ons from your Shopp Store Account
  4. Login to your WordPress Admin Click here to continue reading →
Page 4 of 8« First...23456...Last »