71.163.185.8 at 02:54, 26 February 2009

2009-02-26T02:54:24Z

71.163.185.8: New page: == Description == eV::orderGetShipArray($itemTotal=NULL,$toZip=NULL,$totalWeight=NULL) retrieves an array of shipping options that can be offered to visitors for an order. The shipping opt...

2009-02-26T02:53:41Z

New page: == Description == eV::orderGetShipArray($itemTotal=NULL,$toZip=NULL,$totalWeight=NULL) retrieves an array of shipping options that can be offered to visitors for an order. The shipping opt...

New page

== Description ==
eV::orderGetShipArray($itemTotal=NULL,$toZip=NULL,$totalWeight=NULL) retrieves an array of shipping options that can be offered to visitors for an order. The shipping options will be calculated based on the attributes sent in combinations with the shipping settings set up in [[Settings]] > eCommerce and [[Shipping]].

== Syntax ==
$array = eV::orderGetShipArray([$itemTotal],[$toZip],[$totalWeight]);

== Paramaters ==
''NOTE: either $itemTotal (for shipping level tables) OR $toZip+$totalWeight (for Fedex calculations) are required''
*$itemTotal FLOAT OPTIONAL
:: The order dollar value to be used for pulling shipping options / prices from the [[Shipping]] level tables.
*$toZip INT OPTIONAL
:: The shipping zip code that the order will be sent to. Used to retrieve shipping options / prices from the Fedex zone shipping tables.
*$totalWeight FLOAT OPTIONAL
:: The total weight to be considered when retrieving shipping options / prices from the Fedex zone shipping tables.
== Return Values ==
Returns a multidimensional array of shipping options and their details. The first dimension is the index of the shipping options. The second dimension contains the keys for each of the shipping option's data elements.

The returned array is as follows:

<pre>
Array
(
[0] => Array
(
[type] => String
[typeCode] => String
[shipAmount] => Float
// the following 2 fields are only included if the shipping data is from the level tables
[charge] => Float
[percent] => Float
[minAmount] => Float
)
[1] => Array...
( .. same as above ..)
)
</pre>

== Examples ==
;Using Fedex Tables (be sure fedex shipping option is setup and configured via [[Settings]]
<source lang="php">
// lets get the weight and target zip code
$orderArr = eV::orderGetCompleteArray();

// extract data from orderArr that will be passed to orderGetShipArray function
$weight = $orderArr['order']['weightTotal'];
$toZip = $orderArr['items'][0]['zipCode'];

// extract data from orderArr for current shipping option/prices selected
$currentShipTypeCode = $orderArr['items'][0]['shipTypeCode'];

// extract addressId for form select
$sale_addressId = $orderArr['items'][0]['sale_addressId']

// get shipping options
// note we are using the 2nd ($toZip) and 3rd ($weight) attributes because this is a Fedex shipping query
$shipArr = eV::orderGetShipArray(NULL,$toZip,$weight);

// output shipping options as a form allowing customer to select and commit to the cart
echo "<form action=\"index.php\" method=\"post\">";
echo "<select name=\"shipping4addressId" . $sale_addressId . "\">";
foreach($shipArr as $ship) {
echo "<option value=\"" . htmlspecialchars($ship['typeCode']) . "\";
if($currentShipTypeCode == $ship['typeCode']) echo " selected ";
echo ">" . htmlspecialchars($ship['shipType']) . ": " . eV::dollarFormat($ship['shipAmount']) . "</option>";
};
echo "</select>";
// lets put zipCode in this form since its required to get the shipping total
echo " Enter Zip Code: <input type=\"text\" name=\"zipCode\" value=\"" . htmlspecialchars($toZip) . "\" size=\"12\" maxlength=\"10\">";
echo " <input type=\"submit\" value=\"Submit\"> ";
echo " <input type=\"hidden\" name=\"fa\" value=\"ORDER.cartUpdate\"> ";
echo "</form>";
</source>

;Using Shipping Price Levels (requires setup in [[Settings]] > eCommerce AND levels created in [[Shipping]])
<source lang="php">
// lets get the weight and target zip code
$orderArr = eV::orderGetCompleteArray();

// extract data from orderArr that will be passed to orderGetShipArray function
$itemTotal = $orderArr['order']['itemTotal'];

// extract data from orderArr for current shipping option/prices selected
$currentShipTypeCode = $orderArr['items'][0]['shipTypeCode'];

// extract addressId for form select
$sale_addressId = $orderArr['items'][0]['sale_addressId']

// get shipping options
// note we are using only the 1st ($itemTotal) attribute because this is a Shipping level table query
$shipArr = eV::orderGetShipArray($itemTotal);

// output shipping options as a form allowing customer to select and commit to the cart
echo "<form action=\"index.php\" method=\"post\">";
echo "<select name=\"shipping4addressId" . $sale_addressId . "\">";
foreach($shipArr as $ship) {
echo "<option value=\"" . htmlspecialchars($ship['typeCode']) . "\";
if($currentShipTypeCode == $ship['typeCode']) echo " selected ";
echo ">" . htmlspecialchars($ship['shipType']) . ": " . eV::dollarFormat($ship['shipAmount']) . "</option>";
};
echo "</select>";
echo " <input type=\"submit\" value=\"Submit\"> ";
echo " <input type=\"hidden\" name=\"fa\" value=\"ORDER.cartUpdate\"> ";
echo "</form>";
</source>

@@ Line 13: / Line 13: @@
 *$totalWeight FLOAT OPTIONAL
 :: The total weight to be considered when retrieving shipping options / prices from the Fedex zone shipping tables.
 == Return Values ==
 Returns a multidimensional array of shipping options and their details. The first dimension is the index of the shipping options. The second dimension contains the keys for each of the shipping option's data elements.
@@ Line 27: / Line 28: @@
              [typeCode] => String
              [shipAmount] => Float
-             // the following 2 fields are only included if the shipping data is from the level tables
+             // the following 3 fields are only included if the shipping data is from the level tables
              [charge] => Float
              [percent] => Float

Functions:orderGetShipArray - Revision history

71.163.185.8 at 02:54, 26 February 2009

71.163.185.8: New page: == Description == eV::orderGetShipArray($itemTotal=NULL,$toZip=NULL,$totalWeight=NULL) retrieves an array of shipping options that can be offered to visitors for an order. The shipping opt...