Shopp Product Page Browser

Description

With this plugin installed you can supply your customers with previous/next buttons on the product pages of your Shopp webshop. They will no longer have to go back and forth between category/catalog pages and product pages when browsing a category. You can translate the plugin to your own language, .pot file is included. Dutch language files are already present.

The difference between this plugin’s output and the regular Shopp ‘next,previous’ output is, this plugin’s output will stay inside the chosen categorie. So if your customer is looking at a lamp, browsing the category ‘Yellow’, the next product will also be in the category ‘Yellow’ and not just another product in for example the category ‘Lamp’.

By use of the Shopp tag shopp('product','browser',"show=both&cat=$cat"), you set whether you want to display ‘previous’, ‘next’, or ‘both’. Take a look at the more detailed instructions below.

By use of the settings page, you specify

  • the phrases used for ‘Previous’ and ‘Next’
  • to use product thumbnails instead of ‘Previous’/’Next’
  • the size of the thumbnails
  • to use predefined Shopp image-setting
  • which categories to exclude (‘Previous’/’Next’-buttons will not appear on those Shopp product pages)
  • which products to exclude (‘Previous’/’Next’-buttons will not appear on those Shopp product pages)

Screenshots

  • The settings page (version 1.0 and version 1.2)

  • The settings page (version 1.3.x)

  • Where to put the code in product.php when using version 1.0.x

  • Where to put the code in product.php when using version 1.2.5

  • Where to put the code in product.php when using version 1.3.x

  • What it looks like on your product page

Installation

Install the plugin through your WordPress Admin Panel, or

  1. Download the right plugin zip-file.

* Version 1.0.2 for Shopp 1.1.x,
* Version 1.2.5 for Shopp 1.2.5,
* Version 1.3.x for Shopp 1.3.x
2. Unzip the zip-file.
3. Upload the folder to the /wp-content/plugins/ directory
4. The plugin is NOT going to change or edit your Shopp files, but just to be sure, back up your files and database.
5. Activate the plugin through the ‘Plugins’ menu in WordPress
6. For Shopp version 1.0.x put the following code in your Shopp product.php template file

      <?php shopp('product','browser','show=both'); ?>   

If you want just one button only, you can replace the last line of code with

or
.

For Shopp version 1.2.5 put the following code in your Shopp product.php template file.
If you want you can add the complete if-loop at the top, and the actually Shopp command anywhere you want.

      <?php if ($_GET["cat"]): ?>  
       <?php $cat = $_GET["cat"]; ?>  
      <?php else: ?>  
       <?php $cat = shopp('product', 'category', 'show=id&return=true'); ?>  
      <?php endif; ?>  
      <?php shopp('product', 'browser', "show=both&cat=$cat"); ?> 

For Shopp version 1.3.x put the following code in your Shopp product.php template file.
If you want you can add the complete if-loop at the top, and the actually Shopp command anywhere you want.

      <?php if ($_GET["cat"]): ?>  
      <?php $cat = $_GET["cat"]; ?>  
      <?php else: ?>  
      <?php $cat = shopp('product.get-category','show=id'); ?>  
      <?php endif; ?>  
      <?php shopp('product.browser', "show=both&cat=$cat"); ?>    

Alternatively, for version 1.2.5 as well as 1.3.x, if you only want one button you can replace the last line of code with

      <?php shopp('product.browser', "show=next&cat=$cat"); ?>  

or

ONLY FOR 1.3.x
If you just need the plain url of a button, you can add the ‘property’ option to the Shopp command like this

      <?php shopp('product.browser', "show=next&cat=$cat&property=url"); ?>  

or

  1. Adjust the settings on the settings page (Shopp Extra, Shopp sppb)
  2. If you run in any trouble please use the contact form on our own website. For some reason we do not get notified when you leave a message here at WordPress.org.
  3. Supply Feedback. We’d love to hear from you!

FAQ

Installation Instructions

Install the plugin through your WordPress Admin Panel, or

  1. Download the right plugin zip-file.

* Version 1.0.2 for Shopp 1.1.x,
* Version 1.2.5 for Shopp 1.2.5,
* Version 1.3.x for Shopp 1.3.x
2. Unzip the zip-file.
3. Upload the folder to the /wp-content/plugins/ directory
4. The plugin is NOT going to change or edit your Shopp files, but just to be sure, back up your files and database.
5. Activate the plugin through the ‘Plugins’ menu in WordPress
6. For Shopp version 1.0.x put the following code in your Shopp product.php template file

      <?php shopp('product','browser','show=both'); ?>   

If you want just one button only, you can replace the last line of code with

or
.

For Shopp version 1.2.5 put the following code in your Shopp product.php template file.
If you want you can add the complete if-loop at the top, and the actually Shopp command anywhere you want.

      <?php if ($_GET["cat"]): ?>  
       <?php $cat = $_GET["cat"]; ?>  
      <?php else: ?>  
       <?php $cat = shopp('product', 'category', 'show=id&return=true'); ?>  
      <?php endif; ?>  
      <?php shopp('product', 'browser', "show=both&cat=$cat"); ?> 

For Shopp version 1.3.x put the following code in your Shopp product.php template file.
If you want you can add the complete if-loop at the top, and the actually Shopp command anywhere you want.

      <?php if ($_GET["cat"]): ?>  
      <?php $cat = $_GET["cat"]; ?>  
      <?php else: ?>  
      <?php $cat = shopp('product.get-category','show=id'); ?>  
      <?php endif; ?>  
      <?php shopp('product.browser', "show=both&cat=$cat"); ?>    

Alternatively, for version 1.2.5 as well as 1.3.x, if you only want one button you can replace the last line of code with

      <?php shopp('product.browser', "show=next&cat=$cat"); ?>  

or

ONLY FOR 1.3.x
If you just need the plain url of a button, you can add the ‘property’ option to the Shopp command like this

      <?php shopp('product.browser', "show=next&cat=$cat&property=url"); ?>  

or

  1. Adjust the settings on the settings page (Shopp Extra, Shopp sppb)
  2. If you run in any trouble please use the contact form on our own website. For some reason we do not get notified when you leave a message here at WordPress.org.
  3. Supply Feedback. We’d love to hear from you!
Will the plugin work without Shopp installed?

No. Without Shopp installed, the plugin will be useless.

Will the plugin change or edit my Shopp pages or products?

No. You will have to add the tag mentioned in the installation instructions but that is it. The plugin will store the settings of the settings page in the database. No other data is written or saved anywhere.

Will it work without using categories?

No. You will need to create at least one category for your products.

Will it go to the next category once the last product is displayed?

No. We couldn’t come up with a scenario that needed that feature. If you do, let us know.
Right now the listing will go back to the first product after the last product has been displayed.

Can I change the settings for the CSS-classes used?

Sure. You can override them in your own stylesheet or change the settings in sppb.css. The file is present in the plugin folder.

Is there a translation available?

There is not much text in this plugin but a .pot file is included so you can translate the phrases to your needs.
The plugin is in English. Dutch language files are already present. Checkout the /languages folder.

What version of Shopp do I need?

This 1.3.3 version of the plugin has been tested with Shopp 1.3.x release. If you are using Shopp 1.1.x, please download version 1.0.2 of this plugin, for Shopp 1.2.x you will need version 1.2.5 of this plugin.

Reviews

Read all 1 review

Contributors & Developers

“Shopp Product Page Browser” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

1.3.3

WP version update
Fixed PHP warnings on non-existing variables
Minor code adjustments

1.3.2

Added the ‘property’ option to output, just the url (no markup) for easy custom formatting.

1.3.1

WordPress version update

1.3

-New version to work with Shopp 1.3.x.
-Restructured code and files to match our generally used plugin structure
-Converted code to match Shopp dot notation
-Added feature to use predefined Shopp image-setting

1.2.5

-New version to work with Shopp 1.2.5. No need to update if you are using Shopp 1.1.x
-Added the $cat variable due to a change in Shopp handling categories

1.2

-New version to work with Shopp 1.2r6 beta. No need to update if you are not using the 1.2 (beta) version of Shopp. Due to changes to the Shopp Menu (in Admin Panel) we have added the ‘Shopp Extra’ parent menu which will facilitate all our Shopp plugins.

1.0.1

-Corrected stylesheet loading.
-Quotes and Double Quotes can be used in ‘Previous’ and ‘Next’ input field.

1.0

-Added comments.
-First version on WordPress SVN.

0.2

-Optimized some of the code.

0.1

-First version. Ready to be tested.