The installation process of the 1ShoppingCart Plugin consists of three steps:
1] Upload and activate the plugin
- Login to your WordPress dashboard.
- Click on the Add New link under Plugins.
- Click on the Upload link once on the Plugins page.
- Upload the zip file you received after making your purchase of our plugin.
2] Configure the plugin
- Expand the Settings section and click on the 1SC Settings link.
- Enter the plugin configuration elements on the Settings page. The Settings page will look like the screenshot below:
Product Caching
This plugin retrieves product details from 1ShoppingCart and stores those details locally. This setting determines how frequently the product details are retrieved. Only products that were created or modified since the last retrieval will be added or updated in local tables.
Options:
Do Not Cache – The product information is never cached from 1ShoppingCart. This option should only be used for testing purposes since it forces constant communication with the 1ShoppingCart.com servers.
Cache at most 5 minutes – The 1ShoppingCart servers are queried every 5 minutes for changes to your product details. This setting is ideal for those product catalogs that are changing constantly.
Cache at most Hourly – The 1ShoppingCart servers are queried every 60 minutes for changes to your product details.
Cache at most Daily – – The 1ShoppingCart servers are queried once every day for changes to your product details.
Merchant ID
Your 1ShoppingCart.com Merchant ID. 1ShoppingCart.com displays your Merchant ID in the upper left side of their site after login just below their logo.
Merchant Key
Your 1ShoppingCart.com Merchant Key. Your key can be found under My Account | API Settings. Click here if you do not know where to find your Merchant Key.
MID
Your 1ShoppingCart.com MID value is the intelligent string that 1ShoppingCart uses to identify your account. Your MID can be found in the 1ShoppingCart.com admin panel. Click on the Site Links item under the Setup menu.
Look at the Add to Cart link. You will notice ?mid= followed by a string of characters and numbers. That is your mid. Copy this string and paste it in the plugin’s configuration page.
API URI
Your 1ShoppingCart.com API URI. You can leave this as https://www.mcssl.com.
Currency Code (3 Letter):
Your currency code in three-letter ISO 4217 format.
No Image URL
The plugin will retrieve the images that you have associated with your products in the 1ShoppingCart catalog. In the event that an image is not associated, this image will be used. You can use the default image that comes with the plugin or you can create your own. If you create and upload your own image, enter the URL to that image here.
The default image looks like 
Add to Cart Image URL (custom format)
If you are using a custom format that includes a image for the ‘add to cart’ button, you need to specify the location of the add to cart image. This plugin comes with black, white, red, blue, orange, green and purple add to cart images. They are located at http://{YOUR-DOWMAIN}/wp-content/plugins/es1sc/images/add-to-cart-COLOR.png. Just replace COLOR with the actual color you would like to use in lowercase, such as: http://{YOUR-DOWMAIN}/wp-content/plugins/es1sc/images/add-to-cart-red.png
Buy Now URL
Enter your 1ShoppingCart.com URL above. The URL usually looks something like ->>
http://www.1shoppingcart.com/SecureCart/SecureCart.aspx?mid=12345A12-1234-12AB-AB12-12345A1ABC12. If you are unsure, leave this field blank and be sure to enter your MID in the above field and this value will be automatically completed.
Show prices in whole numbers
By default the prices will display as $999.99. If you check this box, they will display as $999 (without decimal places).
Quick View via WordPress Default Window
When this feature is enabled, the Quick View link will open a popup window that displays your product details using the WordPress default modal.
Quick View via Easy FancyBox Plugin Window
When this feature is enabled, the Quick View link will open a popup window that displays your product details using the Easy FancyBox Plugin. You must have the plugin Easy FancyBox plugin installed for this to work. You can find more information about this plugin at https://wordpress.org/plugins/easy-fancybox/.
Product Detail Modal Window Width
The width of the product detail modal window.
Product Detail Modal Window Height
The height of the product detail modal window.
Product Detail Format Selection
Select the built-in format for the Product Details or provide your own custom format.
Detail 00 (00) is the default Product Detail Format can be viewed here.
Custom (custom) – If you select CUSTOM, a textarea will display where you must provide a format in the field labeled Product Detail Format.
Product List Item Selection
Select a built-in format for the Product Lists or provide your own custom format.
Grid 00 (00) – Click here to view an example of Grid 00.
Grid 01 (01) – Click here to view an example of Grid 01.
Grid 02 (02) – Click here to view an example of Grid 02.
Grid 03 (03) – Click here to view an example of Grid 03.
Grid 04 (04) – Click here to view an example of Grid 04.
Custom (custom) – If you select CUSTOM, you must provide a format in the field labeled Product List Item Format below.
Colors (all require hex values)
3] Build the local product table
Once you enter all the configuration details on the plugin settings page, click on the button at the very top of the screen labeled “Build/Rebuid Product Table.” The plugin will now retrieve your product catalog from the 1ShoppingCart.com servers. Depending upon how large your catalog is – this process can take a few seconds or a few minutes.
Custom Product Detail Format
Enter the formatting you would like to use for your product details. The following format generates the screenshot below.
<div class="product" itemscope itemtype="http://schema.org/Product"> #if(usesaleprice|<div class='saleitem'></div>) #if(isfeaturedproduct|<div class='featureitem'></div>) #ProductImage <div class="product_details"> <h3 itemprop="name">#ProductName</h3> <p class="description">#ShortDescription</p> <p class="sku">SKU: #ProductSku</p> <p itemprop="offers" itemscope itemtype="http://schema.org/Offer"> <span itemprop="price">#ProductPrice</span> <link itemprop="availability" href="http://schema.org/InStock" />In stock </p> <span class="buy-now">#BuyNow</span> </div> <h3 style="clear:both;">Full Description</h3> <p itemprop="description">#LongDescription</p> </div>
If you use the default formatting with the suggested CSS, the layout will look like the screen shot below –
The above display does require a couple items that you need to add to your stylesheet:
.product {
position:relative;
}
.product .featureitem {
background: url("images/feature-ribbon.png") no-repeat transparent;
height: 30px;
position: absolute;
left: 0px;
top: 0px;
width: 99px;
z-index: 1;
}
.product .saleitem {
background: url("images/sale-ribbon.png") no-repeat transparent;
height: 30px;
position: absolute;
left: 0px;
top: 0px;
width: 69px;
z-index: 1;
}
Custom Product List Item Format
Enter the formatting you would like to use for your product listings. The following format renders the list as shown in the screenshot below.
<div class="product_cell" itemscope itemtype="http://schema.org/Product">
#if(usesaleprice|<div class='saleitem'></div>)#if(isfeaturedproduct|<div class='featureitem'></div>)
<a href="/store/#ProductHyphenName">#ProductImage</a><br />
<span class="product_name" itemprop="name"><a href="/store/#ProductHyphenName">#ProductName</a></span>
<span class="product_details">
<span class="description" itemprop="description">#ShortDescription</span>
<span class="sku">#ProductSku</span>
<span class="price" itemprop="offers" itemscope itemtype="http://schema.org/Offer">
<span itemprop="price">#ProductPrice</span>
<link class="regular" itemprop="availability" href="http://schema.org/InStock" />In stock
</span>
<span class="buy-now">#BuyNow</span>
#TBMoreInfo
</span>
<div class="clear"> </div>
</div>
If you use the default formatting with the suggested CSS, the layout will look like the screen shot below –
The above display requires a few items added to your stylesheet:
.product_cell {
width: 285px;
float: left;
vertical-align:center;
height: 420px;
padding: 5px;
border-right: 1px dotted #FF9900;
border-bottom: 1px dotted #FF9900;
position:relative;
}
.product_cell img {
max-width: 290px;
max-height: 200px;
}
.product_cell .featureitem {
background: url("images/feature-ribbon.png") no-repeat transparent;
height: 30px;
position: absolute;
left: 0px;
top: 0px;
width: 99px;
z-index: 1;
}
.prodlist .product_cell .saleitem {
background: url("images/sale-ribbon.png") no-repeat transparent;
height: 30px;
position: absolute;
left: 0px;
top: 0px;
width: 69px;
z-index: 1;
}
Want to use our ribbons? Right click on the image you want to save.
Version 1.9 Options
How do I configure 1ShoppingCart for Domain Masking?
Login to 1ShoppingCart.com; mouseover Setup and select Domain Masking.
Display product details using thickbox modal window
When this feature is enabled, the product image becomes hyperlinked to a popup window that displays your product details. Additionally, you can insert a “More Information” link that displays this same popup window using the placeholder #TBMoreInfo in the Product List Item Format below.
Use this plugin’s version of ThickBox javascript
We have found that some plugins that use the thickbox functionality load their own version of the script rather than the one provided by WordPress. These other versions of the plugin cause problems with the popup windows. Enable this feature if you encounter problems with the popup window.
Product Detail Modal Window Width
The width of the product detail modal window.
Product Detail Modal Window Height
The height of the product detail modal window.