CyberStore Ecommerce 2023 Documentation
Site Configuration
User's Guide > The Management Console > Site Manager > Site Configuration
In This Topic

The first tab in the "Site Manager" is the Site Configuration tab.

This tab allows you to set Site-level preferences. You can access the various options through the sub tabs on the left side of the screen. These include:

Website Path Logging Email SMS Database Site Scripts Integrations Maintenance Mode

The Website Tab

Use the Website tab to control the key settings required to operate your website.

 

 

The Websitetab contains the following settings:

Website Information
Local Currency The default currency as established in SYSPRO.
Site URLs

The Site URLs button will appear can be found at the top right of the screen and it is used to configure various site names addresses.

If there are no URLs currently configured for the selected Site, the text will appear in red text.

 

When the button is clicked by the user, the Site URL grid will appear in a modal pop-up listing all of the current URLs defined for the site. The primary URL will be identified by displaying the entire row with bold text and the Primary check box will be checked. As a reminder, by definition, the primary URL is used to determine the default site to load when a URL does not match one in your list. In addition, only one URL can be designated as primary across all sites, and if there is only a single URL it must be the primary. There must be at least one URL per site as well.

The name of the Site currently in scope will be displayed in the pop-up header followed by the word URLs, for example the "Default Site" will display as shown in the screen below.

URLs can be added using the Add button in the header or the New option in the right-click context menu. When adding the first URL for a Site, it will automatically be saved as the primary URL.

Clicking the Edit button (or right-click context menu option) allows for modifying the selected URL, and Delete (button or right-click option) will permanently remove the URL. If you are editing a URL that is not primary, and select to make it primary, then the previous primary URL will be demoted and updated to no longer be the primary. When there is only a single URL, it cannot be changed from the primary URL and cannot be deleted.

Company Logo

Upload a copy of your company logo and it will be saved to the server, and then used throughout the site's theme wherever logo.png is referenced.

To upload, click the Select a logo... button and then browse your file system to find the image file, or simply drag and drop the image from your system onto the logo box on the screen.

Default Account The Account that users run under before they log in, otherwise called the Anonymous User. This Account uses the "Default Customer." An Account set as the Default Account cannot be deleted from CyberStore.
Default Customer The SYSPRO Customer used for all B2C Accounts. Pricing for B2C Accounts is based on this user's settings in SYSPRO. Pricing yielded by the Default Customer is also used as the Default Price (often referred to as "List Price") for Customers with different pricing. Visibility of Items is based on the View List for the Customer Class linked to the Default Customer.
Registration

The section that determines how users are able to register for an Account.

The Registration type provides three options for registration: "Allow B2B and B2C Registration," "Allow Only B2B Registration," or "Allow Only B2C Registration."

When allowing B2B registrations, visitors are able to link their Account with a Customer already On-File. The other options in this section determine which data must be entered by the visitor during B2B registration in order to complete this linking action. These B2B verification fields use SYSPRO Customer data and consist of: 

  • Customer Number
  • Customer's On-File Phone
  • Customer's Contact On-File
  • Customer's Userfield1
  • Customer's Salespersion3
  • Customer's BuyingGroup5

All fields except for the Customer Number are optional.

Template Customer The SYSPRO Customer used as a template when creating new Customers in SYSPRO. This customer's settings are cloned to establish the general properties of the new Customer record.
Session Timeout

The number of minutes of inactivity that may pass before a CyberStore visitor's web session expires. When a session expires, the user is logged out and any Items in their Shopping Cart are cleared.

Closing a browser automatically terminates a session even if it occurs before the Session Timeout. 
Company Name The name of the Company in SYSPRO. This value must match the name of the Company in your CyberStore license.
Ecommerce URL The website URL for the CyberStore's e-commerce application (e.g., http://www.yourDomain.com/ecommerce).
Website Address The full Domain address of your CyberStore website (e.g., http://www.yourDomain.com).
MyAccount URL The full web address of your CyberStore's "My Account" page (e.g., /ecommerce/CustomerMyAccount.aspx).
Default Country The default Country to be assumed for the Site.

Important Note:

Changes made in the Site Manager take effect immediately and are saved as soon as you leave a field, check a box, or make a drop-down selection.

The change confirmation mark  appears next to the field you are editing and disappears upon saving.


The Path Tab

Use the Path tab to set key system folder locations and names for the Site. 

 

 

The Pathtab contains the following settings:

Path Information
Require SSL

This option controls whether the entire CyberStore Site will default to SSL encrypted connections via HTTPS. To enable this, set the value to "true."

If set to "false," registration and checkout pages will still utilize HTTPS, but catalog and content pages will default to non-encrypted HTTP connections.

Theme File Location The path to where your Site's theme file is saved.
Content File Location The path to where your Site's content file is saved.
Item Images File Location The path to where your Site's Item images folder is saved.
Item Detail Folder Name The name of the folder in which your Item Details are stored.
Category Images Folder Location The path to where your Category images folder is saved.
Thumbnails Folder Name The name of the folder in which your Site's thumbnails are stored.
HTML Editor File Upload Location The path to where your HTML Editor file is saved.
Hot Spot Diagram Upload Location The path to where your Hot Spot Diagrams are saved.
Hot Spot Diagram Folder Path The path to where your your Site's Hot Spot Diagram folder is saved.
Characteristic Image Location The path to where your Characteristic images are saved.
Default CSS File Location The path to where your Site's CSS files are automatically saved.
Site Configuration The filename of your Site's configuration file (typically SitePages.config).
Custom Control Folder Path The path to your Site's custom Control folder.
Custom Widget Folder Path The path to your Site's custom Widgets folder.
Custom Pages Folder Path The path to your Site's custom Pages folder.
Custom Xml Folder Path The path to your Site's custom xml folder.
Custom Xslt Folder Path The path to your Site's custom xslt folder.
Disable Custom Controls

Turns off any custom controls and forces the system to revert to default controls. 

Warning:

It is not recommended that this feature be enabled in production environments.

Disable Custom Widgets

Turns off any custom widgets and forces the system to revert to default widgets. 

Warning:

It is not recommended that this feature be enabled in production environments.

Disable Custom XSLT Templates

Turns off any custom XSLT transformation files and forces the system to revert to default XSLT files.

Warning:

It is not recommended that this feature be enabled in production environments.

Disable Custom ASPX Pages

Turns off any custom ASPX pages and forces the system to revert to default pages.

Warning:

It is not recommended that this feature be enabled in production environments.


Important Note:

Changes made in the Site Manager take effect immediately and are saved as soon as you leave a field, check a box, or make a drop-down selection.

The change confirmation mark  appears next to the field you are editing and disappears upon saving.


The Logging Tab

Use the Logging tab to set the Site's log location and advanced troubleshooting features.

 

 

The Logging tab contains the following options:

Logging Information
Front End-Error Message When you enter text in this section, it is displayed as the front-end Site error message if an uncaught exception occurs. This text appears whether or not you select the "Enable Front End Stack Trace" option.
Error Display Image Location

The URL for an image that can be included in the Front End Error message.

Click the Preview Error Display button to see how an error message with text and image will appear on the front-end of the Site.

Front-End Stack Trace

This section contains detailed technical information about any uncaught exception in the CyberStore application. By default, this information does not appear, but you can use this option to enable its appearance.

Warning:

It is not recommended that this feature be enabled in production environments.

Enable Troubleshooting Mode

Turns on troubleshooting services such as external call logging, verbose errors and front-end debug messaging.

This option must be enabled to write any external call logs.

Warning:

It is not recommended that this feature be enabled in production environments.

External Call Log Location The physical location of the file system folder to where log files are saved when enabled for the Site.
External Call Log Mode Allows for the ability to log all external calls including those that are cached in memory.
External Call Debugging Logs

You may choose which functional areas you would like to log. Select which external calls to be logged. Select/Deselect All by toggling the top checkbox.

The calls are grouped by module and have a short description of their function. The toolbar buttons allow selection by CyberStore components. i.e Items, Customers, Pricing, Quotations, Punchout, Checkout, RMA and Utility. And the search box in the grid allows you to type characters of an object name or description and filter the list down to ease finding the desired objects to log.

As a security measure, payment transaction requests and responses omit personal credit card numbers from the files generated.  

Troubleshooting Mode must be enabled for any logging to write to the log directory, even when functional areas are selected.

Warning:

It is not recommended that this feature be enabled in production environments.


Important Note:

Changes made in the Site Manager take effect immediately and are saved as soon as you leave a field, check a box, or make a drop-down selection.

The change confirmation mark  appears next to the field you are editing and disappears upon saving.


The Email Tab

Use the Email tab to manage CyberStore application's email server and general function settings. You can specify the connection information required by the SMTP server that will be used to send email from the CyberStore application. You can also specify global settings for CyberStore emails. 

 

 

The Email tab contains the following settings:

Email Information
Email Options                

"Global Message":
Text that can be included in any email body with the "[global]" replacement tag. This is ideal for disclaimers or marketing messages you would like to appear on each email.

"System Generated Order Receipt":
A box that, when checked, sets the Site to send email receipts to shoppers after placing orders.

"System Generated Order Notification":
A box that, when checked, sets the Site to send email alerts internally after placing orders.

"Send Notifications to Customer's Default Email":
Drop-down of options for determining if CyberStore should also send Customer Notifications when certain system emails are sent. Options include "Never" (default), "Always", and "When Logged in as All Customer Account" which when selected will only send Customer Notifications when the logged in shopper's Account is set as an All Customer Account.

"SYSPRO CFF Name for Salesperson Email Address":
The location where CyberStore can find the salesperson's email address in SYSPRO. Be sure to complete this field if you use Order Email Alerts for salespersons.

Where did Email Server settings go?

Beginning with the 2023 release, email server settings preiously found here have been migrated to Tools > Application Settings screen in the Communications Settings tab as they are application wide settings and not adjustable by Site.


Important Note:

Changes made in the Site Manager take effect immediately and are saved as soon as you leave a field, check a box, or make a drop-down selection.

The change confirmation mark  appears next to the field you are editing and disappears upon saving.


The SMS Tab

Use the SMS tab to view and configure information about SMS Text capabilities provided thorugh integration with the TeleSign SMS provider.

The SMS tag contains the following section:

TeleSign SMS Gateway
Customer ID The Customer ID for your TeleSign account. Requires additional subscription and incurs additional third-party fees. See www.TeleSign.com for more information
API Key The API Key for your TeleSign account integration.

Important Note:

Changes made in the Site Manager take effect immediately and are saved as soon as you leave a field, check a box, or make a drop-down selection.

The change confirmation mark  appears next to the field you are editing and disappears upon saving.


The Database Tab

Use the Database tab to view information about the Microsoft SQL Server information for the CyberStore application. The database connection cannot be changed using the Site Configuration Manager.

 

 

The Databasetab contains the following sections:

Database Information
Server The name of the website's SQL Server. This must be a valid name of a machine on the network, or '(local)', if the website and SQL server are on the same computer (not recommended for production environments).
Database Name The name of the database.
Full Text Search Indicator

To the right of the database name, a visual icon and message indicates whether the installed SQL Server instance supports Full Text Catalog Searching. When enabled, the Full Text and "Fuzzy" Search options are available for use.

See the Website tab above for more information.

Connection String The data source connection string used by the application to access the database.

The Site Script Tab

Use the Site Script tab to manage Google Analytics tracking. CyberStore can automatically render web pages compatible with the popular Google Analytics platform, and you can include appropriate Google Analytics scripts within the pages of the Site. 

Also, use this tab to inject specific HTML, JavaScript or Style code into the <HEAD> section of every page in the Site.

 

 

Site Scripts Information
Script Library Configuration

Enable the use of jQuery and DevExtreme libraries. (Recommended)

jQuery Version: Select the version of the jQuery library to use from the list of supported versions.

DevExtreme Library Location: Set a custom path for the source location of the DevExtreme library files (such as a CDN).

Page <HEAD> Script and Code Editor

Section in which you can insert any custom scripts, tags, or styles that will appear on every page of your Site.

When code is saved a file called sitescript.txt is saved to the Site folder which contains the code for archival and mobility. Whenever the editor is loaded the system will check to confirm that the script in the database is the same as that saved to the Site folder for the site. If it is not the same, a warning is presented allowing one to load the content from the Site folder and update the database if desired.

 purposes.

Above the script editor box, there are tools to upload a site script into the editor, or download the current script to your local device.

Note:
Changes made in the Site Scripts editor will be saved only after you click the Save Code button at the bottom of the editor screen.

Where are Google Analytics and reCAPTCHA Settings?

The configurations for Google Analytics and Google reCAPTCHA have been moved within the Site Manager from the Site Configuration screen's Site Scripts tab where they were found in previous versions, and added to the new Site Configuration > Integrations tab which is documented below.

The Integrations Tab

Use the Integrations tab to enable, configure and setup third-party integrations loaded into the site page engine.

The Integrations tab contains the following sections:

Integrations
Google Analytics Tracking

Settings to configure Goolgle Analytics for the site

Google Site Tracker ID: The unique Site Tracker ID provided to you after you set up a Google Analytics Account for your Site. Once you save this value, Google Analytics will begin to receive your page view data.

Version: The version of Google Analytics used for the site.

Send orders to Google Ecommerce: A box that, when checked, allows CyberStore to send order transaction and Item information to Google Ecommerce if your Google Analytics configuration can accept e-commerce data.

reCAPTCHA Configuration

Settings to configure reCAPTCHA for use on the site. If using the feature, the fields marked as Required must have values for the feature to function.

Site Key: The public key for your site's reCAPTCHA from Google. (Required)

Secret Key: The private key for your site's reCAPTCHA from Google. (Required)

API URL: The address for the reCAPTCHA API from Google. (Required)

Proxy URL: The address for a proxy server. (optional)

Theme: The selected standard reCAPTCHA theme to use (Light or Dark)

Mailchimp Integrated Marketing

Settings to enable and configure Intuit's Mailchimp integration.

API Key: Your integration API key found in your MailChimp account.

Store ID: A unique identifier for your store as an ID, whatever you choose, but don't change it after your site is in production use.

Store Name: A name to give this site for setting up the Store in MailChimp. Name it whatever you like, but don't change it after it is in production use.

List ID: The MailChimp ID for your list segment, found in your MailChimp account.

Default List Status: Determines the initial opt-in status for your shoppers when linked to MailChimp. When the value is Opt-Out shoppers are not considered subscribers in Mailchimp and you will only be able to see their data for analytics purposes.

Photo to Use: Set which featured item photo will be used when referencing product images from Mailchimp.

The Sync MailChimp Customers button will cause the UpdateMailChimpCustomers operation to be scheduled and results in synchronizing all CyberStore accounts to MailChimp customers and list members. Each shopper's record in MailChimp will also be tagged based on the Customer Class to which they belong.

Implementer's Note:

For full Mailchimp integration, it is important that any currency used by CyberStore is properly configured with a Country to ensure that the proper ISO 4217 Currency Code is associated with the customer's currency. (See Setup > Currency in the Management Console)


Important Note:

Changes made in the Site Manager take effect immediately and are saved as soon as you leave a field, check a box, or make a drop-down selection.

The change confirmation mark  appears next to the field you are editing and disappears upon saving.


The Maintenance Mode Tab

Use the Maintenance Mode tab to choose the Maintenance HTML Page location and Whitelist specific IP Addresses.

 

The Maintenance Modetab contains the following sections:

Maintenance Mode Information
Maintenance Page URL

A form for inputting the relative URL for the location of the Maintenance HTML Page.

IP Address Whitelist Section in which you can create a list of IP Adresses whose clients will ignore Maintenance Mode.

 

See Also