setlineitem
Modify an existing line item in an order file
[setlineitem Parameters]values[/setlineitem]
To change a line item in a visitor's shopping cart, put a [setlineitem] context into a template. Whenever WebDNA encounters a [setlineitem] context, it opens the shopping cart file and changes values in a line item (identified by its index). The item's quantity, textA-Z, and cart header fields are all changeable.
Example:
Shopping cart file "5678" opens, and line item 3's quantity changes to 4 and textA changes to "Blue" (as specified in the context above).
Here are the parameters to the [setlineitem] context:
To change a line item in a visitor's shopping cart, put a [setlineitem] context into a template. Whenever WebDNA encounters a [setlineitem] context, it opens the shopping cart file and changes values in a line item (identified by its index). The item's quantity, textA-Z, and cart header fields are all changeable.
Example:
[setlineitem cart=5678&db=catalog.db]quantity=4&textA=Blue[/setlineitem]
Shopping cart file "5678" opens, and line item 3's quantity changes to 4 and textA changes to "Blue" (as specified in the context above).
Here are the parameters to the [setlineitem] context:
Parameter | Description |
---|---|
db | Product database containing the SKU, price, and other information. |
index | Uniquely identifies which line item should be modified. |
cart | Affected shopping cart file (from ShoppingCarts folder). |
file | (alternative to cart) Affected shopping cart file (from any folder). Unlike cart, this file can be in any folder. Specify the file URL-relative to the template. |
Context value | Description (these values go inside the context) |
password | (Optional) In order to change the price (see below) you must provide the line item change password, which can be set in the preferences. |
price | Optional) Sometimes you may need to change the price of a product after it has already been added to the cart. Normally you use a formula to vary pricing, but since formulas only apply when a product is initially added to the cart, this alternate technique may be needed. Remember to put the line item change password (see above) into the parameters. |
Lineitem Field | Any line item field. See order file for the list of available line item fields. Values set in the context will override values pulled from the product database. |
Header Field | Any header field may also be modified at this time. See order file for the list of available header fields. |