|


Streamlined Checkout™ Version 2.0.5.1

User
Guide
 Streamlined Checkout™
can be installed in minutes on any LaGarde
StoreFront™ shopping cart-based online
store. Merchants can install Streamlined Checkout™
themselves or take advantage of our
installation and advanced configuration
services.

Overview Streamlined
Checkout™ turns the standard StoreFront™
checkout process into two simple,
streamlined steps. The design of Streamlined
Checkout™ is based on one goal . Make it as
quick and easy as possible for a shopper to
complete his/her purchase. To that
end, Streamlined Checkout™ implements the
following business logic and functionality:
Streamlined
Checkout does not require the shopper to
sign in.
If
the shopper is new and does not have an
account Streamlined Checkout™ automatically
creates the shopper's account after the Continue
button has been clicked.
The
username (email address) and password for
the new account is emailed to the shopper
automatically.
If
the shopper already has an account but has
not signed in, Streamlined Checkout™ signs
her in automatically when the Continue button is
clicked.
If
the shopper is already signed in, or signs
in during checkout:
The
address books are populated, and the address
fields are populated with his/her original
billing and/or shipping address information.
Streamlined Checkout™ can be optionally
configured to require sign-in for new and/or
existing shoppers.
Billing
information, shipping information, shipping
methods, and payment methods are all
neatly displayed on the same page.
Shipping
methods include every configured choice
(including premium shipping), all in one
radio-button list, sorted by price.
For
carrier-based rates, every configured choice
from every configured carrier is visible,
all in
one radio-button list, along with at least one
Check Shipping Rates button. When clicked,
the
rates of all the corresponding shipping carriers
and choices will be appended to the right of
each choice respectively and sorted by price.
The
Check Shipping Rates buttons only require
that a minimum of city, state, postal code,
and
country be provided.
The
shopper can view rates for different
delivery areas by changing the city, state,
zip, and
country, and then clicking the .Refresh Shipping
Rates. button.
If
the shopper does not care to know the cost
of his/her shipping choice, he/she can
continue
without clicking the Check Shipping Rates button.
The cost of his/her choice will
automatically be retrieved.
If
the carrier rate servers cannot be reached,
the backup shipping choices will be
displayed.
Payment
methods include every configured payment
choice and option, all in one radio-button
list.
Streamlined
Checkout™ does not require the shopper to
enter a shipping address. If no
shipping address is entered, it is assumed to be
the same as the billing address. Also, if
the
shopping cart contains no shippable items, only
the billing information will be displayed.
The
Address ID field is optionally not required.
If the shopper does not provide an address
ID, an appropriate ID is automatically created for
her. Also, Address ID is the last field to
be
filled in, allowing the shopper to begin with his
first name to minimize confusion when
filling
in the form.
Help
hyperlinks are displayed for items that
shoppers may have questions about, such as
the
Address Book, Address ID fields, etc. The help
hyperlinks display pop-up windows containing
the appropriate help content.
Streamlined
Checkout™ validates required fields at the
client via JavaScript, so that the
shopper does not have to wait for the page to
reload to discover his mistake.
Redundant
validation occurs at the server to guard
against spoofing the store.

Installation See
the Streamlined Checkout™
Installation Guide for details.
Configuration
Tips
These questions frequently come up
when configuring Streamlined Checkout™ for
the first time.
Ship From Address for Carrier
Based Shipping
If you are configuring StoreFront™
for use with using
carrier-based shipping, do not forget to
specify the Ship From Address. Carrier-based
rates will fail if no Ship-From address is
specified.
Products with Zero Weight
Carrier based rates will not be returned
for items with zero (0) weight. Make sure
that all of your product weights are defined
if you are using carrier based shipping.
No Shippable Products
If the shopping cart contains no
shippable items, the shopper will not be
prompted for any shipping related
information. If no shipping information is
displayed for a particular product, check to
make sure that that product has been defined
as shippable within the Products/Fulfillment
section of Merchant Tools.
Free Shipping Configuration
If you have specified the Free_Ship_By_Product="True"
parameter (see Parameter
Definitions below) then regardless of the configured ship method,
if a product's ship price is defined as 0
(zero), that product
will be treated as a Free Shipping product.
This gives you the ability to run free
shipping promotions on an individual product
basis.
Free Shipping Coupons
Streamlined Checkout™ automatically
supports the use of free shipping coupons.
To take advantage
of this feature, simply create a coupon
within StoreFront™ Merchant Tools as
follows:
i) Coupon Description: Free Shipping
(1) The description must contain the phrase
Free Shipping (not case sensitive)
ii) Amount: 0
(1) You can specify a discount amount other
than 0 (zero) if you chose, but it will
discount
the order by the specified amount
and apply free shipping to the order.
iii) Note: The term Free Shipping should
be in the coupon description, not the coupon
name.
StoreFront™ does not allow spaces in coupon
names. The coupon may appear to work,
but it will be lost during the checkout process.
This happens regardless of
Streamlined Checkout™ being installed
on a SF site.
Parameter Definitions
To change the default settings used for
Streamlined Checkout,™ edit following
parameters can be added to the <PENDX:SC> tag located in
the root/ssl/shipping.aspx file. The values
specified below represent the default values
that will be used if the parameters are not
specified.
1) Containing_Page_Name="Shipping.aspx"
This specifies the name of the page that
contains Streamlined Checkout™. Any name
other
than the default would require
modifications to other StoreFront™ files in
order for
Streamlined Checkout to work.
2) Help_PopUp_Path="PopUpHelp/"
This specifies the path
to the help pop-up files. This value will be
prefixed with the secure url
of your website, e.g.
https://www.yourstore/ssl/.
3) Address_ID_Required="false"
Specifies whether or not the Address ID
fields will be treated as required fields
during
validation. If set to "true", the Address ID fields
will be displayed with the red required
field
asterisks (*).
4) Email_Password="true"
Specifies whether or not a Welcome
notification email will be sent to new
shoppers.
5) Default_State="Not Applicable"
Specifies which state will automatically
be selected in the State/Province dropdown
lists.
This value must match (case sensitive) a
state within the SelectState table of the
StoreFront™
database. To disable this option,
set the value to 'none.'
6) Default_Country="United States"
Specifies which country will
automatically be selected in the Country
dropdown lists.
This value must match (case sensitive) a
country within the SelectCountry table of
the
StoreFront™ database. To disable this option, set the value to
'none.'
7) Standard_Shipping_Label="Best-Way
Ground"
Specifies the label that
will be used for non carrier-based standard
product-based or value-
based shipping.
8) Free_Shipping_Label="Free"
Specifies the label that will be used
when a shopper's cart qualifies for
free-shipping.
9) UPS_Residential = "true"
This parameter applies to StoreFront™ versions
6.1.1 and higher, and it specifies whether
UPS
will calculate residential rates rather
than commercial rates.
10) Adjust_Weights="false"
FEDEX rate servers
will not return a rate for cart items that
have a total weight (item
quantity) of less than 1 pound.
When Adjust_Weights="true", Streamlined
Checkout™ will automatically adjust the
weight of
individual cart items weighing less than 1
pound, so that the total weight (item quantity)
= 1 pound. If you do not have FEDEX enabled, or
you have no products in your database
that weigh less than 1 pound,
set Adjust_Weights="false", and this step
will be skipped.
Note: Regardless of the value of
Adjust_Weights, this step will not be
performed for UPS
rates because UPS handles
this automatically.
This will also work with any other rate
server that will not handle weights less than
1 pound.
Item weights are not permanently changed.
This is only for purposes of acquiring ship
rates.
11) PayMethod_List_Columns="2"
Specifies the number of columns that will
be displayed in the Payment Methods radio
button
list. This is for aesthetic purposes and is up
to your discretion.
12) Show_Email_Subscription="true"
This specifies whether or not the email
subscription box will be displayed.
13) Show_Email_Disclaimer="false"
This specifies whether or not the email
subscription disclaimer will be displayed.
This option is dependant upon the value
of Show_Email_Subscription.
The email disclaimer contains a pop-up
hyperlink link that points to
https://www.yourstore/ssl/. PrivacyPopUp.htm. PrivacyPopUp.htm, with
empty content,
is included in the
SC2_x_x.zip file.
14) Subscription_Info_Field_Name=""
This is used to specify the field name
that can be appended to the Customers table
for
purposes of tracking extended
subscription information.
Modifying this value requires that
Optional Features for saving Email
subscriptions below be
completed in
order for Streamlined Checkout to work.
15) Shipping_Base_Rate=""
This applies to carrier-based rates, and
it allows you to specify a base carrier rate
that must
always be present. The rate specified must be identical
(case sensitive) to a value that is
marked
as active in the Shipping table.
If the carrier results do not include the
value specified in Shipping_Base_Rate,
backup
shipping will be added to the list of
carrier results. The idea being . what if
the carrier results
only contain expensive,
air shipping choices. This is possible if
your active shipping methods
were UPS
Ground, FEDEX 2day, FEDEX Express Saver, and
FEDEX Overnight. If the UPS
server were down, your only choices would be the
expensive FEDEX Air choices.
Use caution with this parameter. If Shipping_Base_Rate="UPS Ground" and your
shopper lives
in Hawaii, UPS Ground will not
be returned, because you cannot ship ground
to Hawaii. In this
scenario, you would not
want backup (ground) shipping to be added to
the carrier results.
16) Email_Errors="true"
This option allows any Streamlined
Checkout™ errors that occur (fatal or
non-fatal) to be
emailed to Streamlined Checkout™ support in real time. This allows
Streamlined Checkout™
support
to proactively address unforeseen problems
and distribute the appropriate patches
and updates. In case of an error, the following
information will be sent:
i) Your Store Name and URL.
ii) The URL of the page that immediately
precedes the error.
iii) The error description.
We recommend
you keep this option set to "true",
as it is a valuable debugging tool. If
you have privacy concerns regarding this option,
please email us at
support@streamlinedcheckout.com.
We employ strong measures to protect the
privacy of our
customers.
17) Base_Carrier_Rates="03;1010;Parcel;FDXGD92"
This specifies
which carrier rates will not be displayed if
the order qualifies for free shipping.
Values separated by
semi-colons represent entries in the
Shipping Table of the StoreFront™
database (use the value found in the Code field). The default values specify
all of ground
carrier methods. Therefore, if the order qualifies for free
shipping, only the expedited carrier
methods
will be displayed along with the free
shipping option.
18) Base_Custom_Rates="1"
This option only applies if Custom_Ship="true".
This specifies which custom rates will
not be displayed if the order qualifies for
free shipping.
The values separated by
semi-colons represent entries in the PENDX_ShipMethods Table of
the StoreFront™
database (use the value found in the keyID
field). The default
value
specifies first entry in the table.
19) Incremental_Premium="[Premium
Shipping amt specified in Merchant
Tools]"
This applies to the Premium Shipping
option, which is available if you are using
Product or
Value based shipping (as defined
in Merchant Tools).
The incremental
rate is applied when multiple quantities of
the same item are added to the
cart. The Premium amount will
be applied to the first item, and the amount
specified for
Incremental_Premium will be
added for each additional quantity of the
same item.
20) Premium_Calc="order"
This applies to the Premium Shipping
option, which is available if you are using
Product or
Value based shipping (as defined
in Merchant Tools).
The Premium amount can be calculated per
order or per cart item. Valid values for the
parameter are:
i) "order" (default)
ii) "item"
21) Require_SignIn="none"
This allows you to force shoppers to sign
in prior to completing the checkout. Valid
values for
this parameter are:
i) "none" (default)
(1) No sign-in is required.
ii) "new"
(1) Only new shoppers are required to
sign-in.
iii) "old"
(1) Only existing shoppers are required to
sign-in.
iv) "both"
(1) All shoppers are required to sign-in.
22) Disable_AddressBook="false"
Setting this parameter to "true" will
disable the Address Book feature.
23) SF_Standard_Constraint="N" and
SF_Premium_Constraint="N"
This applies to geographical shipping
constraints (see Optional Features section
4).
If you have setup the PENDX_LocationConstraints table in your
StoreFront™ database, then
you can specify
the following values for this parameter:
i) N = (None) no geographical constraints
apply (default)
ii) I = (Include) only allow shipping to
locations that are specified in the
PENDX_LocationConstraints
table.
iii) E = (Exclude) do not allow shipping to
locations that are specified in the
PENDX_LocationConstraints table.
24) SF_Standard_Constraint_Type="2" and
SF_Premium_Constraint_Type="2"
This applies to geographical shipping
constraints (see Optional Features section
4).
If you have setup the PENDX_LocationConstraints table in your
StoreFront™ database, then
you can specify
the following values for this parameter,
which specifies which value will be
used to
check the constraint:
i) "1" Postal Code
ii) "2" State (default)
iii) "3" Country
25) Free_Ship_By_Product="false"
Setting this parameter to "true" allows
you to specify free shipping per individual
product by
setting the Ship Price of the
respective product(s) to zero (0) within the
Products/Fulfillment
section of Merchant
Tools.
26) Custom_Ship="false"
Set this value to
"true" to enable Streamlined Checkout™ Custom
Shipping methods (see
Optional Features below).
27) Sort_By_Price="true"
This applies to StoreFront™ carrier
shipping rates and Streamlined Checkout™
custom
shipping rates. When Check Rates button is clicked within the
Order Information page and
rates are acquired, shipping methods are sorted by
price lowest to highest. If
Sort_By_Price="false"
then the rates will not be resorted by
price, rather they will remain in
the same
sort order as specified in Streamlined Checkout™ Admin page and/or the
PENDX_ShipMethods table.
28) SF_Standard_Carrier="" and
SF_Premium_Carrier=""
These parameters allow you to associate
carriers with the non-carrier StoreFront™
shipping
methods.
29) Hide_PayMethods="false"
If this parameter is set to true, the
payment method radio-button list will be
hidden from the
shopper and the first item
in the list will be automatically selected.
You can adjust the sort
order of the payment
methods list from Streamlined Checkout™
Admin page.
30) AlterXcarrierResults="false"
Setting this parameter to true allows you
to alter the extended carrier results that
are
returned by the USPS International and FreightQuote carrier
methods. Optional Features
section below must be completed prior
to activating this feature.
31) Backup_Shipping_Message
This parameter allows you to change the
message that is displayed when backup
shipping
methods are displayed.
32) GeoConstraint_Message
This parameter allows you to change the
message that is displayed when shipping
method is
geographically constrained (see
Optional Features below).
33) ShipCalcA_Minimum
This parameter allows you to change the
minimum product ship-price that must be
exceeded
prior to the product ship price
being added to the value-based rate, when
using custom
shipping calculation method A
(see Optional Features below). The
default is the shipping
minimum as specified
in StoreFront™ Merchant Tools.
34) Show_SFCarrierBackup="true"
Setting this parameter to false will
prevent the standard StoreFront™ backup
shipping
methods from being displayed to the
shopper. You must first define custom backup
shipping
methods to replace the standard
StoreFront™ methods (see Optional Features
section 3).
35) FaxNumber="false"
Specifies whether or not to prompt the
shopper for a fax number.
36) CartPageName="shoppingcart.aspx"
Specifies the name of the cart summary
page. The referring page is the cart summary
page
then Streamlined Checkout™ will
re-examine the cart contents.
37) SignInPage="CustSignInCheckout.aspx"
Specifies the customer sign-in page.
38) PaymentPage="Payment.aspx"
Specifies the final checkout page.
39) PayPaluid="6"
Specifies the uid of the PayPal payment
methods within the StoreFront™
PaymentMethods
database table. The uid will
be 6 for most StoreFront™ installations, but
this property allows
you to specify a
different uid in case you have customized
the values within the
PaymentMethods
database table.
40) RequirePhone ="true"
Specifies whether or not the phone number
field should be required.
Optional Features
Geographic Constraints
Geo, or location
constraints can be defined for Streamlined
Checkout™ custom
shipping methods as well as StoreFront™.s
standard Product, Value or Carrier based
shipping methods. To activate this feature,
complete the following steps:
a) Add the PENDX_LocationConstraints table
to your StoreFront™ database as follows:
i) MS Access:
(1) Open your database in Microsoft Access.
and click on .Tables. in the left navigation
bar.
(2) Right click in the white space of the
Microsoft Access. window and select .Import.
from
the
pop-up menu.
(3) Browse to the location of the unzipped
Streamlined Checkout. files and select the
CustomShip.mdb database.
(4) Select the PENDX_LocationConstraints
table and click the OK button. The
PENDX_LocationConstraints table has now been
added to your database.
ii) MS SQL Server
(1) Connect to your database with SQL Server
Enterprise manger or the SQL query tool of
your
choice.
(2) Execute the SQL script contained in the
PENDX_LocationConstraints.sql file, which
was
unzipped with Streamlined Checkout™ files.
The PENDX_LocationConstraints table has
now
been added to your database.
b) From within Streamlined Checkout™ Admin
page, add new records as necessary
to the PENDX_LocationConstraints table as follows:
(note: the
PENDX_LocationConstraints table
is pre-populated with the data necessary to
constrain the standard StoreFront™ Product
and Value based shipping methods to
the
continental US. This is most often used for
constraining free shipping and
backup shipping methods.)
i) ShipMethodID
(1) This is the record key for the shipping
method to which the constraint
applies.
(a) PENDX Custom Shipping Methods:
(i) ShipMethodID must correspond to a value
in the keyID field of
the custom Shipping
table.
(b) StoreFront™ Product or Value based
shipping:
(i) ShipMethodID must be one of the
following values:
1. ValueBased = Value based shipping
2. ProdBased = Product based shipping
(c) StoreFront™ Carrier-based shipping:
(i) ShipMethodID must correspond to a value
in the MethodID field
of the carrier methods
table.
ii) Abbreviation
(1) This value represents the constrained
value, which should correspond to
the
Constraint Type as follows:
(a) 5 digit postal code
(b) State abbreviation (must correspond to a
state abbreviation within
the SelectState
table of the
StoreFront™ database).
(c) Country abbreviation (must correspond to
a country abbreviation
within the SelectCountry table of the StoreFront™
database).
iii) Country
(1) This value represents the country to
which the constraint is applied. Use a
valid
StoreFront™
country abbreviation.
(a) Note: If the constraint type of the ship
method is set to Country (3),
this value is
redundant
because it is already specified in the
Abbreviation field. However, it still must be
specified.
USPS International Shipping
This feature, called Alter Extended
Carrier Results, allows you to alter the
extended carrier results that are returned
by the StoreFront™ USPS International and FreightQuote carrier methods. You can alter
the price and descriptions, or you can
eliminate one or more results from the list
of shipping methods presented to the
shopper.
To activate this feature, complete
the following steps:
a) Add the AlterXcarrierResults table to
your StoreFront™ database as follows:
i) MS Access:
(1) Open your database in Microsoft Access.
and click on .Tables. in the left
navigation
bar.
(2) Right click in the white space of the
Microsoft Access. window and
select .Import. from the
pop-up menu.
(3) Browse to the location of the unzipped
Streamlined Checkout. files and select
the CustomShip.mdb database.
(4) Select the AlterXcarrierResults table
and click the OK button. The
AlterXcarrierResults table has
now been added to your database.
ii) MS SQL Server
(1) Connect to your database with SQL Server
Enterprise manger or the SQL query
tool of
your
choice.
(2) Execute the SQL script contained in the
AlterXcarrierResults.sql file, which was
unzipped with
Streamlined Checkout™ files. The
AlterXcarrierResults table has
now been
added to your
database.
b) Add new records as necessary to the
AlterXcarrierResults table as follows:
i) CarrierResult
(1) This is the description of the extended
result that you want to alter. This value
must exactly match (case sensitive) the
result as returned in the Shipping
Methods
list in the Order Information page
(excluding the price preceded by one
space).
The best way to ensure an exact match is to
copy the description from
the HTML source by
clicking the .View Source. menu item from
within your web
browser.
(a) When the Check Rates button is clicked
from within the Order Information
page, the
price
preceded by one space is appended to the
respective
descriptions. When copying the
shipping
method description from your
browser's HTML
source view, remember to exclude the price
and the one
space that precedes the price.
ii) DisplayName
(1) This value is optional and allows you to
change the description that is displayed
to the shopper. If you do not wish to change
the description, leave this value
blank or
null.
iii) AdjustType
(1) This value defines how the result should
be altered as follows:
(a) P
(i) Adjust the rate by adding the specified
percentage. For example: if
the returned
rate were
$20 and you specified 20 in the AdjustAmount
column (column iv below), the price
displayed would be $24 (20 + (20
*(20/100)).
Specifying a negative value in the AdjustAmount column
(column iv below) will
subtract the percentage.
(b) D
(i) Adjust the rate by adding the specified
dollar amount. For Example:
if the returned
rate were $20 and you specified 5 in the
AdjustAmount column (column iv below), the
price displayed is $25.
Specifying a
negative value in the AdjustAmount column
(column iv
below) will subtract the dollar
amount.
(c) X
(i) Exclude the result from the list of
shipping methods displayed to the
shopper.
iv) AdjustAmount
(1) The decimal amount to adjust the rate
by. This value represents either a
percentage or a dollar
amount depending on the value of AdjustType
as
defined above.
c) Add the following parameter to SC tag on
the shipping.aspx page:
AlterXcarrierResults="true" (case
sensitive).

Define Custom Shipping Methods
Streamlined Checkout™ allows you to
optionally define an unlimited number of
custom shipping methods that can stand alone
or co-exist with the StoreFront™ carrier-based
shipping methods.
Any or all of the custom shipping methods,
when combined with StoreFront™ carrier-based
shipping, can be used to increase (or
replace) the number and type of backup
shipping options available to the shopper
when carrier rates cannot be retrieved. To
specify that a particular custom shipping
method should only be available as a backup
choice, include the keyword [BACKUP]
(including the brackets) in the description.
To configure custom shipping methods,
complete the following steps:
a) Add the PENDX_ShipMethods table to your
StoreFront™ database as follows:
i) MS Access:
(1) Open your database in Microsoft Access.
and click on .Tables. in the left
navigation
bar.
(2) Right click in the white space of the
Microsoft Access. window and select .Import.
from the
pop-up menu.
(3) Browse to the location of the unzipped
Streamlined Checkout. files and select the
CustomShip.mdb database.
(4) Select the PENDX_ShipMethods table and
click the OK button. The
PENDX_ShipMethods
table
has now been added to your database.
ii) MS SQL Server
(1) Connect to your database with SQL Server
Enterprise manger or the SQL query
tool of
your
choice.
(2) Execute the SQL script contained in the
PENDX_ShipMethods.sql file, which was
unzipped with
Streamlined Checkout™ files. The
PENDX_ShipMethods table has
now been added
to your
database.
iii) From within Streamlined Checkout™ Admin
page, add new records to the
PENDX_ShipMethods table as follows:
iv) Description
(1) This is the description of the custom
shipping method, e.g. .Custom Ground..
(a) To specify that a particular custom
shipping method should only be
available as
a backup
choice, include the keyword [BACKUP]
(including the
brackets) in the description
as follows:
(i) Custom Ground[BACKUP]
(b) To completely replace the standard
StoreFront™ backup shipping methods
set
Show_SFCarrierBackup="false" in the <PENDX:SC>
tag (see
Parameter Definitions
above).
v) SFCarrierCode
(1) This field is optional and allows you to
associate a StoreFront™ carrier code
with the custom
shipping method. Association with a valid
StoreFront™ carrier
allows the order
tracking feature to
work with the custom method.
vi) Type
(1) This specifies how the shipping rate
should be calculated as follows:
(a) F = Fixed rate per item
(b) O = Flat rate per order
(c) P = Product based (the value specified
for Ship Price in the
Products/Fulfillment
section of Merchant Tools)
(d) V = Value based (as specified in the
value-based shipping table within
Shipping/Value Shipping of Merchant Tools).
(e) A = Value + Product based
(i) This calculation begins with value-based
and then adds the
respective product(s) ship
price to the value-based amount, as
long as
the respective product(s) ship price exceeds
a
certain
minimum.
1. The minimum can be defined with the
ShipCalcA_Minimum
parameter. The default
is the shipping minimum as
specified in
StoreFront™ Merchant Tools.
(f) W = Fixed Rate for the first item
(i) This calculation charges a fixed rate
for the first item in the cart and
then adds
the
incremental rate for all additional items in
the cart.
vii) Rate
(1) This is the rate for the shipping
method.
(a) For Types P, V and A, this value is
added to the product or value rate
specified
in the shipping
section of Merchant Tools.
viii) IncrementalRate
(1) This value is used for quantities
greater than 1 of an individual product.
(a) Example: If you wanted the first product
to be $10 and each additional
quantity of
the same
product to be $2, you would specify Rate and
IncrementalRate as follows:
(i) Rate = 10
(ii) IncrementalRate = 2
(b) For calculation type P (Product based),
setting the incremental rate to
-1 will
cause the
incremental rate to equal the product ship
price.
ix) LocationConstraint
(1) This specifies the type of location
constraint applied to this shipping method
as follows (see Define Geographic
Constraints above):
(a) N = (None) no geographical constraints
apply (default)
(b) I = (Include) only allow shipping to
locations that are specified in the
PENDX_LocationConstraints table.
(c) E = (Exclude) do not allow shipping to
locations that are specified in
the PENDX_LocationConstraints table.
x) ConstraintType
(1) This specifies which value will be used
to check the location constraint (see
Define
Geographic
Constraints above) as follows:
(a) 1 = Postal Code
(b) 2 = State (default)
(c) 3 = Country
xi) IsActive
(1) This specifies whether or not the method
is active.
(a) MS Access
(i) True = active, False = inactive
(b) SQL Server
(i) 1 = active, 0 = inactive
xii) SortOrder
(1) A value from 0 to 255 that specifies the
order of the shipping method within
the
shipping methods list displayed to the
shopper. The default vale is 255.
(a) You must set Sort_By_Price="false" in
the <PENDX:SC> tag (See
Parameter
Definitions above) in order to persist this value.
Otherwise
the choices will be automatically
re-sorted
by price from lowest to
highest.
(b) Set Custom_Ship="true" in the <PENDX:SC>
tag (See Parameter
Definitions
above).
Track Email Opt-In Subscription Choice
The email subscription box has
three choices by default: Any of Our Stores,
[StoreName] Only, and None. Any choice other
than .None. will sign the shopper up to
receive promotional email, but by default no
other information is tracked. The shopper is
either subscribed or not.
a) To track which choice the shopper made,
do the following:
i) Make the following modifications to the
Customers table within your StoreFront™ 6
database:
(1) Add a new column named .SubscriptionType.
to the end of the table as follows:
(a) Data type:
(i) MS Access = Text
(ii) MS SQL Server = nvarchar
(b) Length = 20 (or larger as needed)
ii) Set the Subscription_Info_Field_Name
parameter, in the <PENDX:SC> tag as
follows:
(1) Subscription_Info_Field_Name="SubscriptionType"
b) To customize the
subscription choices, make modifications to
the following table-cell
located in the PENDX_SC.ascx file:
<td id="celMailingListOptions"
class="Content" runat="server">
<p style="margin-top: 0; margin-bottom: 0">
<input type="radio" name="inpMailingListOptions"
value="Any-1" class="Content"
checked
runat="server">Any of Our Stores</p>
<p style="margin-top: 0; margin-bottom: 0">
<input type="radio" name="inpMailingListOptions"
value="Only-1" class="Content"
runat="server"><% GetStoreName() %> only</p>
<p style="margin-top: 0; margin-bottom: 0">
<input type="radio" name="inpMailingListOptions"
value="None-0" class="Content"
runat="server">None</p>
</td>
i) You can add as many choices as you want,
or remove a choice. The important
elements are as follows:
(1) The value of .name. must be "inpMailingListOptions".
(2) The value of .value. represents two
elements of data delimited by a dash (-), as
follows:
(a) The value to the left of the dash (Any,
Only, or None) will be stored in
the newly created
SubscriptionType filed. This value can be
anything
you wish, provided it does not
exceed the
SubscriptionType field length.
(b) The value to the right of the dash can
only be 0 or 1.
(i) 1 = the shopper wants to subscribe.
(ii) 0 = the shopper does not want to
subscribe.
(3) One of the options must be marked as
checked.
(4) The text following the <input> tag and
preceding the </p> tag can be anything
you
wish.
(5) Do not modify the <td> tag.
Create a Custom Shipping.aspx Page
a) Create a StoreFront™ 6 template (or
ProductBot) page by selecting .New Template
Page.
from the StoreFront™ 6 menu.
i) Note: You can also use your own custom
StoreFront™ 6 template page if you have
created one.
b) Copy and paste the following tag
registration at the top of the template
page, on a
separate line, among the other
tag registrations:
i) <%@ Register TagPrefix="PENDX" TagName="SC"
Src="Controls/PENDX_SC.ascx" %>
c) Remove the following tag:
i) <%@ Register TagPrefix="uc1" TagName="VolumePricing"
Src="Controls/VolumePricing.ascx" %>
d) Replace the existing .title. tag, which
reads .<title>ProductBotDetail</title>.,
with the
following tag:
i) <title>Order Info <% writeTitle()
%></title>
e) Copy and paste the following tag into the
.Content. table-cell (id="tdContent")
replacing
the existing text, which reads
Insert Bot Here:
i) <PENDX:SC id="scOrderInfo" runat="server"
/>
f) Save your new template page as root/ssl/shipping.aspx.
g) Note to FrontPage users:
i) FrontPage automatically inserts
into empty table-cells. This can cause the
top,
sub, and bottom banner cells of the
template page to appear taller than the rest
of the
out-of-the-box StoreFront™ pages. To
resolve this, remove any lone
statements
from the template page using a
text editor.
Digital Beach

Digital
Beach provides advanced Ecommerce and
Internet Marketing services to a wide range
of companies from small merchants to medium
and large corporate clients.
 Digital Beach has been delivering Streamlined Checkout™
with the StoreFront™ cart as part of an overall
eCommerce solution to online merchants since
both products appeared on the market some three
years ago. Nearly two years ago, we
decided we liked
the product so much, we bought
the company.
More about Digital
Beach
 |
|