Private Labeling Interspire Shopping Cart
Contents
- Introduction
- Removing or Changing the "Powered by" on Your Store
- Changing the Product Name
- Changing the Control Panel Title
- Changing the Control Panel "Powered By"
- Changing the Control Panel Logo
- Control Panel Dashboard
- Removing the License Key Field
- Disabling Interspire Email Marketer Integration
- Disabling Interspire Knowledge Manager Integration
- Customizing Addon Downloading
- Customizing Store Design Downloading
Introduction
Interspire Shopping Cart can be fully private labeled which allows the Interspire branding to be removed or replaced. This documentation serves as a guide to completing this process.
A limited amount of technical knowledge is required for this guide and manual file editing is required however the process is quite easy to complete.
All of the private labeling for Interspire Shopping Cart is performed in the /admin/includes/whitelabel.php file. This file should be opened in a text editor, changes made and then the modified version uploaded to your installation. The file is heavily commented to explain what each section in the file is used for.
Removing or Changing the "Powered by" on Your Store
It's possible to remove the "Powered by" line that's shown on the footer of your store by simply editing on of the files in the template that the store is using. You can also change this to something else if you like too.
To change or remove the "Powered by" line, open up templates/[the name of the template you're using]/Panels/Footer.html in a text editor. Alternatively you can use the built in template editor from the control panel by clicking Store Design » Browse Template Files and selecting Footer.html in the list of files.
The line will look different depending on the template you're using on your store, but it's as simple as removing the line (or changing it) that links back to Interspire:
Powered by <a href="http://www.interspire.com/shoppingcart/" target="_blank" class="PoweredBy">Interspire Shopping Cart</a>
Changing the Product Name
To change the name “Interspire Shopping Cart” that’s used in several places of the control panel, you can adjust the value of $GLOBALS['ISC_CFG']['ProductName'].
Examples include:
$GLOBALS['ISC_CFG']['ProductName'] = "Shopping Cart"; $GLOBALS['ISC_CFG']['ProductName'] = "Online Store";
Changing the Control Panel Title
To change the page title used within the Interspire Shopping Cart control panel (shown in your web browser), adjust the value of $GLOBALS['ISC_CFG']['ControlPanelTitle']. To show the edition name of Interspire Shopping Cart, %%EDITION%% can be used.
Examples include:
$GLOBALS['ISC_CFG']['ControlPanelTitle'] = "Store Control Panel"; $GLOBALS['ISC_CFG']['ControlPanelTitle'] = "Store Manager (%%EDITION%% Edition)";
Changing the Control Panel "Powered by"
The bottom of each page of the Interspire Shopping Cart Control Panel contains a “Powered by Interspire Shopping Cart” and Interspire copyright line. To customize this line, adjust the value of $GLOBALS['ISC_CFG']['AdminCopyright']. To show the edition name of Interspire Shopping Cart, %%EDITION%% can be used.
Examples include:
$GLOBALS['ISC_CFG']['AdminCopyright'] = '';
$GLOBALS['ISC_CFG']['AdminCopyright'] = '© '.date('Y').' Example Company';
$GLOBALS['ISC_CFG']['AdminCopyright'] = 'Powered by Store Manager %%EDITION%% Edition';
Changing the Control Panel Logo
There are two ways to change the logo shown in the Interspire Shopping Cart Control Panel. The default logo exists in the admin/images directory as logo.gif. This image may simply be replaced with another image.
Alternatively, it’s possible to change the HTML that’s used to draw the logo in the whitelabel.php file. This is possible by adjusting the value of $GLOBALS['ISC_CFG']['AdminLogo']. Example values include:
$GLOBALS['ISC_CFG']['AdminLogo'] = 'Our Store'; $GLOBALS['ISC_CFG']['AdminLogo'] = ''; $GLOBALS['ISC_CFG']['AdminLogo'] = ' ';
Control Panel Dashboard
Customizing the Popular Help Articles
It’s possible to completely disable or customize address of the RSS feed that’s used to show the popular help articles on the control panel of the home page.
To change the address of the RSS feed used to pull articles, the value of $GLOBALS['ISC_CFG']['HelpRSS']. This variable should point to the URL of a valid RSS feed.
Examples include:
$GLOBALS['ISC_CFG']['HelpRSS'] = "http://www.example.com/helpRss.xml";
It’s also possible to completely disable the popular help articles by changing the value of $GLOBALS['ISC_CFG']['LoadPopularHelpArticles'] to false. Example:
$GLOBALS['ISC_CFG']['LoadPopularHelpArticles'] = false;
Customizing the "Did You Know?" Box
The “Did You Know?” box on the control panel shows random tips for Interspire Shopping Cart. These random tips can be customized or the feature completely disabled.
To change the facts shown, the contents of the $GLOBALS['ISC_CFG']['DidYouKnowFacts'] array in the white label file can be customized.
An example of this:
$GLOBALS['ISC_CFG']['DidYouKnowFacts'] = array( 'Fact 1', 'Fact 2' );
To disable the “Did You Know?” feature completely, change the value of $GLOBALS['ISC_CFG']['ShowDidYouKnow'] to false. Example:
$GLOBALS['ISC_CFG']['ShowDidYouKnow'] = false;
Customizing the Version Check
The “Version Check” message on the dashboard can be customized or completely disabled via the white label file.
To customize the messages that are shown depending on whether or not there is a new version of Interspire Shopping Cart available, adjust the values of $GLOBALS['ISC_LANG']['VersionIsOutOfDate'] and $GLOBALS['ISC_LANG']['VersionNumber'].
Examples include:
$GLOBALS['ISC_LANG']['VersionIsOutOfDate'] = "You are currently running v%s. %s has been released. Please contact your administrator to install it."; $GLOBALS['ISC_LANG']['VersionNumber'] = "You are currently running v%s. This is the latest version.";
To completely disable the version checking, change the value of $GLOBALS['ISC_CFG']['DisableVersionCheck'] to true. Example:
$GLOBALS['ISC_CFG']['DisableVersionCheck'] = true;
Disabling the "Upgrade Today" Starter Edition Message
If the store is running the Starter edition of Interspire Shopping Cart, a notice is shown on the control panel dashboard outlining the advantages of upgrading to a higher edition (additional features, ability to add additional products and users). This message can be customized or completely disabled.
To disable the upgrade message, adjust the value of $GLOBALS['ISC_CFG']['DisableUpgradeToday'] to true. Example:
$GLOBALS['ISC_CFG']['DisableUpgradeToday'] = true;
Removing the License Key Field
The license key field on the store settings page can also be removed. This is particularly useful if the owner of the store should not be able to adjust the value. To remove the license key field, change the value of $GLOBALS['ISC_CFG']['DisableLicenseKeyField'] to true. Example:
$GLOBALS['ISC_CFG']['DisableLicenseKeyField'] = true;
Disabling Interspire Email Marketer Integration
Interspire Shopping Cart contains integration with Interspire Email Marketer to provide powerful email marketing capabilities in Interspire Shopping Cart. This integration can be disabled in the white label file.
To disable the ability to integrate Interspire Email Marketer, adjust the value of $GLOBALS['ISC_CFG']['DisableSendStudoIntegration'] to true. Example:
$GLOBALS['ISC_CFG']['DisableSendStudoIntegration'] = true;
Disabling Interspire Knowledge Manager Integration
Interspire Knowledge Manager can be integrated within Interspire Shopping Cart to have a fully featured knowledge base and integrated Active-Response based contact forms in the store.
To disable the ability to integrate Interspire Knowledge Manager, change the value of $GLOBALS['ISC_CFG']['DisableKnowledgeManagerIntegration'] to true. Example:
$GLOBALS['ISC_CFG']['DisableKnowledgeManagerIntegration'] = true;
Customizing Addon Downloading
Interspire Shopping Cart has the ability to download and install addons via the control panel. This functionality can be disabled.
To disable the ability to download and install addons from the Interspire Shopping Cart control panel, change the value of $GLOBALS['ISC_CFG']['DisableAddonDownloading'] to true. Example:
$GLOBALS['ISC_CFG']['DisableAddonDownloading'] = true;
Customizing Store Design Downloading
Interspire Shopping Cart has the ability to download and install new store designs (templates) provided by Interspire. It’s possible to disable this functionality.
To disable the ability to download store designs from the Interspire Shopping Cart control panel, change the value of $GLOBALS['ISC_CFG']['DisableTemplateDownloading'] to true. Example:
$GLOBALS['ISC_CFG']['DisableTemplateDownloading'] = true;
