Glossary Item Box

Squirrelcart v6.1.0

v5.5.0

Overview

This page has been written as a guide to aid you in upgrading your site to v5.5.0 and after. Please read this page in its entirety before attempting to upgrade.

Lighthouse Development (the makers of Squirrelcart) offer upgrade services. Please see this page for more information:

https://www.squirrelcart.com/upgrade-service

 

Our standard upgrade service does not include updating custom theme templates. If you are interested in pricing to update your custom theme for version 5 please contact us:

https://www.squirrelcart.com/contact

Photo Gallery Module

A new Photo Gallery module was released alongside Squirrelcart version 5.5.0. It is included with Squirrelcart Pro. You can read about it here:

https://www.squirrelcart.com/shopping-cart-modules/photo-gallery

 

Theme and Template Changes

If you are using a custom version of any of the below template files, make the changes outlined for the custom version of that file inside your custom theme folder (Example: squirrelcart/themes/YOURTHEMENAME). If you are not using a custom version of that file you do not need to make any changes. This section is a guide only. If a v5.5.0 template file has a lot of changes, you are probably better off reverting to the default version by removing your custom version of the same file. 

How to revert a template

If you have a custom version of a template listed below and do not wish to update it, you can revert it. Reverting a template causes the master version of that template to be used. To revert a template that is in your custom theme folder, rename or delete it. Template changes begin below:

 

store_content.tpl.php

  1. Find this:

    <?php print sc_breadcrumb_nav() ?>
  2. Change to:
    <?php if (!isset($_GET['print_order'])) print sc_breadcrumb_nav(); ?>

ship_notify_email_text.tpl.php

  1. Find this (last line of the file):

    <?php endif; ?>
  2. Add this before that line:
    <?php elseif($Tracking_URL):?>
    To track your package, visit this URL: <?php print $Tracking_URL?>

ship_notify_email_html.tpl.php

  1. Find this (last line of the file):

    <?php endif; ?>
  2. Add this before that line:
    <?php elseif($Tracking_URL):?>
     <p>To track your package, visit this URL: <a href="<?php print $Tracking_URL?>"><?php print $Tracking_URL?></a></p>


 

 

Templates you should revert

 

 

 

style_main.css.php

With the release of Squirrelcart version 4.0 in October of 2013, it became no longer necessary to modify style_main.css.php. We strongly discouraged modification of this file in all documentation released since that date.

The correct way to customize your CSS for Squirrelcart is by extending our built-in CSS using a file named style_custom.css.php which only contains the changes you wish to make. See this page for more info.

 

If you have a customized version of style_main.css.php:

  1. Make a copy of your custom theme so you can work on it without disturbing the default theme. See the Copying a Theme for Testing topic for instructions. After copying your custom theme using those instructions, make sure it is set as your user account's current theme.
  2. Read our documentation explaining how to extend our CSS
  3. Using those instructions, create a style_custom.css.php file inside your new custom theme folder.
  4. Rename the style_main.css.php file in your new custom theme folder to style_main.css.OLD.php to disable it.
  5. If any of these files are present in your new custom theme folder, rename them to disable them:
    style_variant2_800.css.php
    style_variant2_1024.css.php
    style_variant2_1280.css.php
    style_variant2_fluid.css.php
  6. With these files disabled, you have disabled all of your custom CSS. You should now see more options to choose from for this new theme when setting your current theme. If you would like to change the appearance to be responsive, change the Width theme setting to responsive. Change the other theme options as you wish until you have something close to what you want. Then, continue below to add your custom CSS back in.
  7. Using a comparison tool like Diff Now (free, online) or Beyond Compare, compare your style_main.css.OLD.php file with the style_main.css.php file in the squirrelcart/themes/squirrelcart/ folder from the version you are upgrading from.

    For example, if you are upgrading from v4.5.4 you will be comparing your file to the style_main.css.php file in squirrelcart/themes/squirrelcart from your file backup of v4.5.4. This will show you every line you changed as compared to the original style_main.css.php file from the version you are upgrading from.
  8. Copy only the changes that you made to the style_custom.css.php file. You'll have to have some knowledge of CSS to do this. You can view your changes in the storefront to see their effect.
  9. When done, set your new custom theme as the store's default theme

 

 

Need help?

Lighthouse Development (the makers of Squirrelcart) offer upgrade services. Please see this page for more information:

https://www.squirrelcart.com/upgrade-service

 

Our standard upgrade service does not include updating custom theme templates. If you are interested in pricing to update your custom theme for version 5 please contact us:

https://www.squirrelcart.com/contact

 

 

 


© 2001-2017 Lighthouse Development. All Rights Reserved.