Addons by Reinos

Appearance

Add to Cart tag ​

The tag for adding items to the cart

The tag ​

{exp:reinos_store:add_to_cart}

Tag Parameters ​

Below are the Tag Parameters. Those parameters can be used in the tag described above

return_url ​

The return url, default to the current url

return_url=""

sku ​

The SKU for a product. If omitted, it allows you to add multiple lines of the same products in to your cart.

sku=""

entry_id ​

Set the entry_id of your product. This way we can reference the product to your entry.

entry_id=""

name ​

Set your product name

name=""

price ​

Set the price of the product.

price="0.00"

sale_price ​

Set the sales price of the product. This will be the price for the product and you can show this in your cart where for example you strike-through the {price}.

sale_price="0.00"

tax_rate ​

Set the tax.

This can either low or high and load the value that has been set in your settings

If omit the param, it will fallback on the default tax rate set in the settings.

tax_rate="low"

weight ​

Set the weight of the product. Mostly used when using the Shipping module

product_price="70" {!-- This set a weight of 70kg or 70lbs --}

clear_cart ​

When adding a product, your can clear the cart to have a cart with always one product.

clear_cart="no"

disable_shipping ​

If you have no shipping cost, you can disable it for a product

disable_shipping="no"

form_class ​

Set the form class

form_class=""

form_id ​

Set the form id

form_id=""

parent_order_item_id ​

Set the order Item Id that you want to reference as a parent item.

This is normally used when you reorder an item or renew for virtual products

parent_order_item_id="0"

custom_fields:[your-field-name] ​

Set custom fields

custom_fields:test="value"
custom_fields:or_an_other_value="value"

Input fields ​

qty ​

<input name="qty" value="1"/><br>

note ​

<input name="note" value=""/><br>

custom_fields ​

<input name="custom_fields[yet_another]" value="custom value"/><br>
<input name="custom_fields[and_another]" value="other custom value"/><br>

Tag Variables ​

error:invalid_price ​

Return the error when an invalid price is given.

{if error:invalid_price}
    <p style="color:red;">You have entered an invalid price</p>
{/if}

error:invalid_sale_price ​

Return the error when an invalid sales price is given.

{if error:invalid_sale_price}
    <p style="color:red;">You have entered an invalid sales price</p>
{/if}

Example ​

Below a small example how you can add a product to your cart

{exp:reinos_store:add_to_cart
  form_class="space-y-3"
  entry_id="{entry_id}"
  sku="{entry_id}"
  name="{title}"
  price="{product_price}"
  sale_price="{product_sale_price}"
  weight="{product_weight}"
  disable_shipping="{product_disable_shipping}"
  return_url="reinos_store/cart"
  tax="high"
  {!--Custom fields via prop --}
  custom_fields:test="test custom field"
}

  {if error:invalid_price}
    <p style="color:red;">You have entered an invalid price</p>
  {/if}

  {if error:invalid_sale_price}
    <p style="color:red;">You have entered an invalid sale price</p>
  {/if}
    
  {if error:out_of_stock}
    <p style="color:red;">There is not enough stock</p>
  {/if}

  <div class="flex flex-col space-y-1">
    <label class="font-medium">Custom Field</label>
    <input class="input" type="text" name="custom_fields[field_from_input]" placeholder="custom field"/>
  </div>

  <div class="flex flex-col space-y-1">
    <label class="font-medium" for="qty">Aantal</label>
    <input class="input" type="number" id="qty" name="qty" value="1"/><br>

    {!-- a simple note --}
    <label class="font-medium" for="note">Aantal</label>
    <input class="input" type="text" id="note" name="note" value=""/><br>

    {!-- You can also update a custom field for an cart item here --}
    {!-- "field_from_input" is here the name of the custom field --}
    <input class="border p-1 rounded" value="{exp:reinos_store:custom_cart_item_field_value cart_id="{cart:id}" field="field_from_input"}" name="custom_fields[{cart:id}][field_from_input]">
  </div>
    
  <input type="submit" class="button" value="Add to Cart"/>
{/exp:reinos_store:add_to_cart}