In order to customize any of the design elements that make up a theme, you will need to create your own custom theme. This topic explains how to create a new theme. The advanced section of the documentation explains how to modify template and image files for your custom theme.
- Choose a Name
Choose a name for your theme. This will be the name used in the Theme drop down box in the Account Options section of your storefront. For this example, we will use the name sunrise
- Create Theme Folder
You will need to create a folder within the squirrelcart/themes folder to contain the theme elements that you will customize. We recommend that you name it similar to the name you chose, but using all lowercase characters. Also, be sure to avoid spaces and special characters. Use your FTP client to create your custom theme folder, and leave it open for the next step.
 |
As of version 5, there is an sc_custom theme folder you can use for this. If you'd like to use this folder just rename it to something unique. |
- Create Theme Images Folder
Inside the folder you just created, create a folder named images, which will be used to store any images specific to this theme:
- Assign Permissions
In order for Squirrelcart to be able to work with your theme's images folder, you *may* need to assign it permissions. PHP is going to need access to write to the folder you created in step #3 in order for you to upload theme images via the control panel. Your web host can tell you for sure whether or not setting permissions is needed. If it is, you will need to use your FTP client, and assign the images folder you created in setp 3 above permissions of 777 (or 775, or 755 depending on your server). Use the "Installation : Setting File Permissions" topic as a guide.
 |
DO NOT alter the default permissions that are associated with the custom theme folder you created in step #2 (shown in the example above as sunrise). |
- Upload Logo
Create a file named store_logo.png (or store_logo.gif, or store_logo.png). Upload that file to the images folder you just created in step 3, using your FTP client.
- Create Stylesheet (optional)
If you want to be able to add your own CSS to customize the appearance of the store, create a blank text file named style_custom.css.php and upload it to the theme folder you created in step 2. If this file is present, Squirrelcart will automatically include it after including the default stylesheets from the master Squirrelcart theme folder. If you need to customize our CSS, you can add any CSS you like to this file. See the CSS Stylesheets topic for more info.
- Create Javascript File (optional)
If you need to add any Javascript to your theme, you can create a file named theme.js and upload it to the theme folder you created in step 2. If this file is present, Squirrelcart will automatically include it after including the default JavaScript from the master Squirrelcart theme folder.
- View Themes in Control Panel
- Check for new themes
Click
- Confirm Theme Install
Your theme folder will be detected. Click the button to confirm theme installation.
- Complete
You should see a message similar to this, showing that theme was installed:
- Change theme to your custom theme
In order to see the changes you will be making to your custom theme, you will need to change to it. If you wish to use your new theme as the default theme, you will need to set it as default by following the "Changing the Default Theme" topic.
If you want to use the theme only while logged in as store admin, follow the instructions in the "Changing Your Current Theme" topic of the documentation.
Please keep in mind that you will see no changes in the appearance of your store when you first create your new theme, with the exception of your logo appearing.
© 2001-2017 Lighthouse Development. All Rights Reserved.