Popped Image (Name) goes here
PegasusCart® Documentation Installation

Installation


Installation Overview

All PegasusCart® components are installed on your web pages via simple embeddable html. Most of this embedded html may simply be copied and pasted, making minor alterations from page to page as needed. It is assumed that you have the basic skills needed to edit your web page html source code and place the edited html on your web site.

Warning: As HTML and Javascript can be very syntax specific, please pay close attention to syntax. More often than not, when our Support group is contacted to solve an issue, it's a simple syntax problem resulting for a missing or added character.

Required Components

In order utilize PegasusCart® on your web page, three pieces of information will be required in your embedded html request.
1. The desired Presentation ID
2. Your Place Holder Location ID
3. Your PegasusCart® assigned Site ID

Presentation ID:
An I.D. you assign in the Presentation Manager, designating which presentation you would like to display on your web page. Presentations are created in the Inventory management, see Presentations

Place Holder Location ID:
The I.D. designator of a object on your web page that will contain and position your rendered presentation. Additionally, you must create and place this object on your web page. Most commonly, this is a simple <div> object with the specified ID.

Example: <div id='LoadPresHere'></div>

Merchant ID: PegasusCart® assigned ID. Can be referenced under "Code" within the account settings general tab.

The Step One

To deploy the PegasusCart® overlay and display your presentations, you must first embed the following script call in your HTML web page.

		
		
<script type="text/javascript" src="https://x.pegasuscart.com/js/pegasusStart.js"></script>
	
		
	

The above code is required and may be placed in the <head></head> section of your web page, or anywhere prior to embedding any other PegasusCart® features.

Note: This code will trigger the loading of some of our core technology as well as a current jQuery Javascript library. If you are like many and already utilize jQuery on your web page, you no longer need to make your call to the jQuery library, but should load the above reference into the <head> section of your web page.

Some users may elect to keep their jQuery library reference, or do not know they have a jQuery reference being loaded by some existing web site feature. As our jQuery references are updated regularly to the latest solid releases of jQuery, you may not wish to bother with making your own jQuery call.

In the event you do call jQuery in your html source prior to our call above, we will attempt to detect its presence to prevent jQuery from being loaded again. This most often does not effect performance or the PegasusCart® overlay, but in cases where your reference to jQuery is very old, it may cause some features to not function properly.

We advise you to not load jQuery on your own and allow our code above to handle things for you.

Warning: We have seen cases where users unknowingly call jQuery after our call and their second reference to the jQuery can cause difficult to diagnose issues. This is specifically why we recommend that our call be placed further down the page, but prior to any other calls to our features.

The Step Two

Place an html element in your web page for designating the location of the presentation to be displayed.

		
<div id="LOCATIONID"></div>
	 
	

Note: This is where the rendered presentation will land on your web page.

The Final Step

Note: Steps One and Two must be completed prior to this final step.

Copy and paste the following code into your web page html source, replacing values as follows:
1. PRESID - I.D. you assigned in the Presentation Manager of the presentation you wish to display.
2. LOCATIONID - The ID tag you placed on a place holder contained in your web page html source.
3. SITEID - Your PegasusCart® assigned Site ID.

		
<script type='text/javascript'>
	function LoadMyPres() {
		
			var MyPresId="PRESID";		 /* ID of the Presentation. */ 
			var MySpot="LOCATIONID";	 /* ID of the object on your page where the Presentation is to be displayed. */ 
			var MyPegasusMerchantId="SITEID"; /*  ID assigned to your PegasusCart Merchant Account. */ 
		

		GetPres( MyPresId, MySpot, MyPegasusMerchantId );	
	}

	$(document).ready(function () {
		LoadMyPres();
	});	
</script>
	 
	
Using the PegasusCart® Overlay without a Presentation being displayed

In the event you have a web page that will not have a presentation displayed, but you would like to have the PegasusCart® overlay and E-commerce engine loaded for your shoppers, use the following replacing LOCATIONID and SITEID accordingly.

		
<script type='text/javascript'>		
	function LoadMyPres() {
		
			var MyPresId="CORE";		 /* ID of the Presentation. Change to "CORE" to call the overlay alone. */ 
			var MySpot="LOCATIONID";	 /* ID of the object on your page where the Presentation is to be displayed. */ 
			var MyPegasusMerchantId="SITEID"; /*  ID assigned to your PegasusCart Merchant Account. */ 
		

		GetPres( MyPresId, MySpot, MyPegasusMerchantId );	
	}

	$(document).ready(function () {
		LoadMyPres();
	});	
</script>	
		
	
More Advanced Presentation Options

Customizing a presentation display on your web page can be accomplished in the following smaple. Embed the following javascript into your web page html source and make changes accordingly.

		

<script type="text/javascript" src="https://x.pegasuscart.com/js/pegasusStart.js"></script>
		
<div id="LOCATIONID"></div>
		
<script type='text/javascript'>	
	function LoadMyPres() {
		var MyPresId='PRESID';	/* ID of the presentation */
		var MySpot='LOCATIONID';	/* ID of the object on your page where the Presentation data is to be displayed */
		var MyPegasusMerchantId='SITEID'; /* ID assigned to your PegasusCart Merchant Account */
		var NoItemColumn='0';	/* Put a value of 1 here to turn off the Item number column in the Buy Box (default=0)*/
		var NoImageColumn='1';	/* Put a value of 1 here to turn off the Image column in the Buy Box (default=0) */
		var ShowBuyBarOnly='0';	/* Put a value of 1 here to display only the BuyBar, all other Presentation Data will be left out (default=0) */
		var NoBuyBarBorder='1';	/* Put a value of 1 here to remove the border around the BuyBar (default=0) */
		var BuyBarFontSize='1.5em';	/* Put any value in point value (7.5,8,10,13,18,20 etc), here to change the font size of text in the BuyBar (default='') */
		var BuyBarBackColor='';	/* Put any color value in (#ff0000, red, green, rgb(20, 24, 204) ) to change the background color of the BuyBar (default='') */
		var BuyBarFontFamily='"Open Sans", sans-serif';	/* Put any font family value in (verdana; etc... Separate multiple fonts by comma, ie: verdana,courier,garamond ), here to change the font family of the text in the BuyBar (default=0) */
		var PresTemplateOverride='';	/* Put any valid Template here, to change the template used for this presentation (default='') */
		var PresRating='0';	/* Replace 0 with 1 for Do Not Show Rating column, or 2 to show text only rating, for this presentation (default='0') */
		var NoBuyBarHeader='0';	/* Replace 0 with 1 for Do Not Show Buy Bar Headers (default='0') */
		var SingleItemOnly='0';	/* Replace 0 with 1 for Show Only Specified Item (default='0') */
		var NoBuyBarOnHand='1';	/* Replace 0 with 1 for hiding Quantity Onhand and ETA (default='0') */
		var BuyBarWidth='100%';	/* Replace 0 with numeric value of pixel width of BuyBar Box (default='0' auto width) */
		var BuyBarFontColor='';	/* Put any color value in (#ff0000, red, green rgb(20, 24,204) ), here to change the font color of the BuyBar (default='') */
		var FbActive='1'; /* Replace 0 with 1 to show a Facebook share link (default='0') */

		GetPres(MyPresId,MySpot,MyPegasusMerchantId,NoItemColumn,NoImageColumn,ShowBuyBarOnly,NoBuyBarBorder,BuyBarFontSize
,BuyBarBackColor,BuyBarFontFamily,PresTemplateOverride,PresRating,NoBuyBarHeader,SingleItemOnly,NoBuyBarOnHand,BuyBarWidth,BuyBarFontColor,FbActive);	
	}

	$(document).ready(function () {
		LoadMyPres();
	});			
</script>
		
	

Alternatively, you can use the shortened GetPres call under the Purchase Settings of a Presentation in order to keep the markup smaller. Customize the presentation as you like and embed the final appearance onto your HTML document.

		
		<script type="text/javascript" src="https://x.pegasuscart.com/js/pegasusStart.js"></script>
		
		<div id="LOCATIONID"></div>

		<script type='text/javascript'>	
			$(document).ready(function () {
				GetPres("PRESID","LOCATIONID","SITEID","0","0","0","0","","","","1","0","0","0","0","","","0");  /* The shortened version of the advanced presentation call above. */
			});	
		</script>			
		
	
Rating Engine

To call the PegasusCart® rating engine by itself, reference and embed the following script.

This script is a bit different in the variables that you work with but can be explained simply:

Part # or UPC: Present the Part # or UPC of the product you wish to present the reviews for. However, do not use both UPC and Part #.

Description: The text description you want displayed on your review engine here. Note: If the Part # or UPC is authentic, a description (if there is one) will automatically be retrieved for you.

RatingLocationID: The ID of the element you would like the rating engine to be displayed within, inside your HTML web page.

SiteID: The PegasusCart® assigned Merchant ID.

Review Count: The number of visible reviews on a page at one time. If no value is specified this will be left at Default settings for 5 reviews visible.

		
<script type="text/javascript" src="https://x.pegasuscart.com/js/pegasusRating.js"></script>		

<div id="RATINGLOCATIONID"></div>

<script type='text/javascript'>
	$(document).ready(function () {
		GetRating("PARTNUM or UPC", "DESCRIPTION", "RatingLocationID", "SiteID", "REVIEWCOUNT");
	});
</script>

	
		
	
Manually Tracking and Logging Web Site Traffic

To call PegasusCart®'s standalone traffic engine, simply embed the following in an HTML document.

		
		
<script type="text/javascript" src="https://x.pegasuscart.com/js/pegasusTrack.js"></script>

<script type='text/javascript'>
	$(document).ready(function () {
		LTraf("MERCHANTID");
	});
</script>
	
		
	
Promotion

Coming Soon!