Glossary Item Box

Squirrelcart v6.1.0

Theme Images

Overview
Theme images are used for buttons, headers, etc... Product and Category images are not considered theme images, and are stored in a different place.
 
In order to use your own theme images, you must have a custom theme and it must be set as the store's default theme (or set as your theme ). You can find out what theme you are currently using by what is selected in the Theme Options section of the Account Details page in your storefront.
 
You can use gif, png or jpg files for any of your theme images.
How Squirrelcart Determines Which Image to Use

When Squirrelcart needs a theme image, it looks for it inside your current theme's images folder. Example:

squirrelcart/themes/sunrise/images

If the image is found there (in gif, png, or jpg format), that image is served to the customer's browser. If the image is not found in your current theme's images folder, Squirrelcart will then pull the image from the master Squirrelcart theme's images folder:

squirrelcart/themes/squirrelcart/images

 

Squirrelcart is intentionally designed so that you do not need to keep a copy of every theme image file inside your current theme's images folder. You should only put images in your current theme's images folder that differ from the master Squirrelcart theme.

 

Changing Theme Images

By default, all theme images are pulled from the master Squirrelcart theme as explained in the section above. If you would like to change a theme image to an image file you've created (gif, png, or jpg), follow the instructions in this section.

Preparation

  1. In order to change a theme image, you must have a theme other than squirrelcart selected. If you don't have a custom theme installed and selected, you will first need to create a custom theme.
  2. After creating a custom theme, you need to switch to it. If you want all customers that visit your store to see that theme, set it as your store's default theme. Alternatively, if you only want the theme to take effect when you are logged in, set it as your current theme.
  3. Your theme needs to have a folder named images inside it:
    squirrelcart/themes/your_theme/images

    If that folder is not present, you will need to create it using FTP or your web hosting control panel's file manager.
  4. Determine which image you want to change. You can do this in most browsers by finding the image on your storefront page, and right clicking to view properties. You'll need to know the name of the image currently being used. You might want to keep a copy of Squirrelcart's "squirrelcart/themes/squirrelcart/images" folder on your computer. You can then easily view the image names in that folder on your computer to find the one you are looking to modify.

 

There are 2 ways you can change a theme image. If you are familiar with using FTP, the recommend approach is explained below under "Changing a Theme Image Using FTP". If you are not familiar with FTP, the recommended approach is explained below under "Changing a Theme Image Using Squirrelcart's Control Panel".

 

Changing a Theme Image Using Squirrelcart's Control Panel

In order for this to work, Squirrelcart must be able to write to the images folder described in the Preparation section above. If you receive a permission error when attempting the steps below, it is because Squirrelcart cannot write to your theme's images folder. On most servers, that requires setting permissions on that folder to 777 using an FTP client. Some servers only require permissions of 755 or 775. Some Windows servers will automatically be able to write to your theme's images folder. If you are not familiar with setting permissions, your web host should be able to set them for you. We may be able to set permissions for you as well if you open a helpdesk ticket. You can find more information on requesting support on our support page:

http://www.squirrelcart.com/support.php

  1. Determine which image you want to change. (See Preparation above)
  2. Click the Themes link in your control panel:
    themes link
  3. Click the link labeled Images. For this example, the theme name is YOUR THEME:
    theme images
    If when you hover over the link it reads Images for 'Squirrelcart' theme, you need to change your theme. You can't modify images for the master Squirrelcart theme.
  4. Locate the row for the image you wish to change, and click anywhere on that row to open the image's record
  5. Select the image using the Image field - your image must have the same name as the original image, with any valid image extension. For example, if you are replacing "store_logo.png", your image must be named "store_logo.png", "store_logo.jpg", or "store_logo.gif".
  6. Click Save Changes 

Changing a Theme Image Using FTP

  1. Create a file with the same name as the image you want to replace. You can save it in gif, png, or jpg format. For example, if you want to replace the theme image btn_add_to_cart.png with a GIF that you created, save your file as btn_add_to_cart.gif
  2. Upload your image to your custom theme's images folder:
    squirrelcart/themes/your_theme/images

    Your image must have the same name as the original image, with any valid image extension. For example, if you are replacing "store_logo.png", your image must be named "store_logo.png", "store_logo.jpg", or "store_logo.gif".
  3. Check your storefront page to make sure the image changed. Squirrelcart should automatically use your image if it is named properly.

 

 

 


© 2001-2017 Lighthouse Development. All Rights Reserved.