Reference 

See example in 'tt_products/template/products_template.tmpl'

You can also specify a CODE and ERROR for error cases.

(siehe display mode)

Example:

plugin.tt_products.templateFile = EXT:tt_products/template/example_template_bill_de.tmpl

plugin.tt_products.templateFile.LIST = EXT:tt_products/template/products_template_dk.tmpl

The default code (see below) if the value is empty. By default it's not set and a help screen will appear. You should not set anything here.

Example:

plugin.tt_products.defaultCode = HELP

The default product uid number for the single display is used when the link to the script did not contain a 'tt_products[product]' parameter.

Set this default value when you get an error message like: “GET/POST var 'tt_products[product]' was missing.”

Lets you specify alternative subpart markers for the various main template designs in the shopping basket system.

This is the list of main subparts you can override: Properties:

TRACKING_WRONG_NUMBER

TRACKING_ENTER_NUMBER

BASKET_REQUIRED_INFO_MISSING

BASKET_TEMP

ITEM_SINGLE_DISPLAY_RECORDINSERT

ITEM_SINGLE_DISPLAY

ITEM_SEARCH

ITEM_LIST_TEMPLATE

ITEM_LIST_GIFTS_TEMPLATE

ITEM_SEARCH_EMPTY

BASKET_TEMPLATE

BASKET_INFO_TEMPLATE

BASKET_PAYMENT_TEMPLATE

BASKET_ORDERCONFIRMATION_TEMPLATE

EMAIL_PLAINTEXT_TEMPLATE

BILL_TEMPLATE

DELIVERY_TEMPLATE

/+ stdWrap

Example:

altMainMarkers.BASKET_TEMPLATE = BASKET_DESIGN2

altMainMarkers.BASKET_TEMPLATE.wrap = ### | ###

This example changes the main subpart marker for the regular basket display from the default ###BASKET_TEMPLATE### to the custom supplied design ###BASKET_DESIGN2### (found in the same template HTML-file)

Search fields

Default internal list is title,subtitle,note. You can specify your default fields here.

Max image items displayed. The maximum number of images for one item displayed on the list view.

Deprecated. See article/product configuration

Use this instead:

The maximum number of images for one item displayed on the single view.

Deprecated. See article/product configuration

Use this instead:

Deprecated. See article/product configuration

Use this instead:

type = foreigntable

table = tt_content

}

The image configuration in list display

listImage > listImage { altImgResource.import = uploads/media/ altImgResource.import.field = media altImgResource.import.listNum = 0

altText.data = field:title }

That way, attached images are not copied to and displayed from

/typo3temp/ (which gives trouble with transparant backgrounds) but directly linked from /uploads/pics/.

The line with altText leads to the drawing of an alternative text.

DAM only:

The image configuration in list display if there is a filter for a category on the page and this category has childs.

listImage > listImage { altImgResource.import = uploads/media/ altImgResource.import.field = media altImgResource.import.listNum = 0

altText.data = field:title }

see listImage

The image icon for the datasheet. Replaces ###ICON_DATASHEET###

If it is an array, then it consists of a file type and a file name.

Example :

plugin.tt_products.datasheetIcon {

10.fileext = pdf

10.file = fileadmin/img/pdf-icon.png

20.fileext = doc

20.file = fileadmin/img/msword-icon.png

}

Deprecated. See onlyChildsOfCurrent and rootChildsOfCurrent of the category configuration

If set, the submenues in the LISTCAT category list will only be listed for the current category.

The maximum integer value for the quantity of an item in the basket. 'inStock': Only the number of items which are currently in stock can be put into the basket.

'creditpoint': Items can only be put into the basket if the FE user has enough credit points.

Display Category Header in list

If this option is set, the category headers (page titles) will automatically be displayed in the product lists. This is not always convenient because you might have chosen a header-title for the "list" content element.

Display Category Header in basket.

If this option is set, the category headers (page titles) will automatically be displayed in the basket lists.

Define the HTML main tag for the display of the categories in the category list view.

Use the new plugin 'Categories: menu' instead of the former displayCatListType=ul.

Set the page title in single view

1 … product title

2 … product subtitle

12 … product title and subtitle

21 … product subtitle and title

3 … bread crumb

Deprecated. see table configuration: displayColumns

Number of columns for the LIST, SEARCH listing of items in a table. You have to adapt your template using special template markers. The ITEM_SINGLE_PRE_HTML and ITEM_SINGLE_POST_HTML must surround your <td>-</td> tags, so the table will be created correctly.

Example:

<!-- ###ITEM_SINGLE### begin--> ###ITEM_SINGLE_PRE_HTML### <td height="150" bgcolor="###GC1###" valign="bottom" align="center"> <!--###LINK_ITEM###--> ###GW1B###<b>###PRODUCT_TITLE###</b>###GW1E### <!--###LINK_ITEM###--> <br> ###PRODUCT_IMAGE### <br> ###GW1B### item count: ###GW1E### <INPUT size="3" maxlength="4" type="text" name="###FIELD_NAME###" value="###FIELD_QTY###"> <p> </td> ###ITEM_SINGLE_POST_HTML### <!-- ###ITEM_SINGLE### end -->

Every time a product is displayed be it in the basket, list or single view, the method getItemMarkerArray() in tx_ttproducts_marker is called. This function fills in and returns an array, so called markerArray(), with key/values for template substitution.

If you enter a valid function name here (see datatype 'function-name' for details!) that array will be passed to that function as the second parameter. The first parameter will be the TypoScript properties to itemMarkerArrayFunc.

Parent PHP-Object reference:

.parentObj property is hardcoded to be a reference to the calling user_products object (PHP).

Example:

(provided that a function or class is included!)

itemMarkerArrayFunc = user_addFieldsMarkerArr

itemMarkerArrayFunc.simpleOption = 1

PID for single item display.

If you want a certain page to be used for display of item details, please enter the PID (page-uid) here. If you set the type to sql, you can use conditions using several lines. The where string can contain the AND condition. The pid for the first fulfilled condition will be returned.

PIDitemDisplay {

10.type = sql 10.where = color=red 10.pid = 142 20.type = sql 20.where = color=white 20.pid = 143 }

If you set the type to pid then the pid of the record will be used.

PIDitemDisplay {

10.type = pid

}

PID for the item list display

Similar to PIDitemDisplay, however the category table is used here.

PID for search page.

If you want all product searches to go to a specific page, enter the PID it here! NOTE: If you set this PID, all searchqueries will (must) be handled with a list content element with the display mode "Products: search" on that page.

PID for the basket page.

If you want ever change the number of items anywhere to go to a specific page (eg. the shopping basket page), enter the PID here.

PID for store root.

This is the PID of the rootPage of the store. If not set the store will operate over all pages from the root of the site. But if the site has many pages, performance may improve.

You should better set pid_list instead of it.

The PID of a page with the general trading conditions (“AGB” in germany)

Only if this page id is set the AGB check will be active.

If this value is set, then each time a new order is created the order-number counter will be incremented with a random number between [first-integer] and [second integer] to cheat a little.

Example:

5,5 (This will increment the counter with 5 each time)

->parseFunc

not used with

'CSS styled content'

If the extension 'CSS styled content' has been installed, you have to make your settings in lib.parseFunc_RTE and not here.

The product details are parsed by these properties. So if e.g. you want ot allow HTML-tags to create a table in the Note field you have to set the parseFunc.allowTags or use the denyTags. To make RTE working with HTML you have to set the following into the root page template. Example:

keepNonMatchedTags = 1 RTE.default.proc.preserveTables = 1

Example:

Generates the category header.

Example:

categoryHeader = TEXT

categoryHeader.current = 1

Generates a breadcrumb line.

Example:

breadcrumb =

Sales TAX/VAT percentage.

Double value (!) (means, "use . as decimal point")

Example:

# Danish sales TAX is 25%:

TAXpercentage = 25.00

Set this, if TAX is included in the database prices! ( ... and of course: Clear this, if TAX is not included in the database prices and should be added in the display of items)

All profieldLinkcessing will take this flag into account and calculate prices accordingly.

tax mode

1: The net sums are added first. The tax is added on the final total net sum.

2: The gross price is calculated for every product. The total sum is calculated on the single gross prices.

Price Thousand point

Enter the thousand separator, if any.

Price number for reseller, which can only be 2 at the moment. The price2 will however only be taken when its value is greater than 0. Here is the way to get the price2 for a special user group:

Example:

[usergroup = 1]

priceNoReseller = 2

[global]

...

Percentage Thousand point

Enter the thousand separator, if any.

Currency symbol. Used in shop administration.

Example:

EUR

DKR

USD

$

Example:

requiredInfoFields = name,address,telephone,fax,email,company,city,zip,state,country

The subvalues 'billing' and 'delivery' are possible.

Example:

requiredInfoFields.delivery = name,address

Deprecated. See Article/Product configuration

Use this instead:

This defines additional confirmation emails containing suffixes, sender and receiver email addresses.

from ... 'shop' will fetch orderEmail_from, 'customer' will fetch the customer email address.

to ... email of the receiver

suffix ... suffix to the '###EMAIL_PLAINTEXT_TEMPLATE_###' subpart.

returnPath ... email address to use in the case of a failure to send the email

Example :

plugin.tt_products.orderEmail {

10.suffix = factory

10.from = shop

10.to = seller1@webshop-typo3.com

10.attachment = bill

20.suffix = logistic

20.from = customer

20.to = seller2@webshop-typo3.com

20.attachment = bill

}

It is possible to send confirmation emails to the email address stored in a foreign table and where a foreign key has been added to the table fe_users.

Example :

plugin.tt_products.orderEmail {

10000.suffix = shop

10000.from = customer

10000.to {

table = fe_users

field = key_field

foreign_table = my_table

foreign_field = my_table_key_field

foreign_email_field = my_table_email

}

}

A SQL comparison will be made to fetch the email address:

SELECT my_table_key_field FROM my_table WHERE my_table_key_field = $content_of_fe_users_key_field;

Comma separated list of recipients of the order email if a radio box has been selected. The number is the radio box and the second number is the selected value.

Example:

orderEmail_radio {

1.2 = inform@mytypo3site.de

}

Status codes used in the tracking module.

Numbers above 100 removes the order from the tracklist.

Number zero is the status of a non-finalized order (and non-finalized orders in the database may by time be regarded as garbage...)

Numbers of 50-59 is available for the customer to choose from.

Number 1 is reserved to be selected when an order goes from zero to 1 because it's confirmed. Number 1 cannot be selected by shop admin. These will be written into ###STATUS_OPTIONS### markers.

Example:

statusCodes {

1 = Order submitted by user

2 = Order is received and accepted by store

10 = Shop is awaiting goods from third-party

11 = Shop is awaiting customer payment

12 = Shop is awaiting material from customer

13 = Order has been payed

20 = Goods shipped to customer

21 = Gift certificates shipped to customer

30 = Other message from store

50 = Customer request for cancelling

51 = Message from customer to shop

60 = Send gift certificate message to receiver

100 = Order shipped and closed

101 = Order closed

200 = Order cancelled

}

The 'password' used by the administrator of the shop to go into the tracking system in the front end.

The password form field will appear if a BE_USER is logged in, but this password is still needed.

stdWrap for status date

Example:

statusDate_stdWrap.strftime = %d-%m-%Y %H:%M

stdWrap for the order date

Example:

orderDate_stdWrap.strftime = %d-%m-%Y

If set, certain settings are manipulated in order to let the script render a single item - the $cObj->data.

If this setting is set, the subpart marked ###ITEM_SINGLE_DISPLAY_RECORDINSERT### will be used instead of the regular subpart ###ITEM_SINGLE_DISPLAY### if it is found.

This cObject may be used to call a function which manipulates the shopping basket. This manipulation could be based on settings in an external order system. The output is included in the top of the order (HTML) on the basket-page.

This cObject is executed each time the main_products method of the user_products class in productsLib is called and it's executed before any of the main processing. See the class for details.

This cObject may be used to call a function which clears settings in an external order system. This is a sister to the above function and they should probably be used in conjunction somehow. This function is called immediately after the finalize-function has been called.

For instance this function would be suitable for clearing any external basket facilitated by the .externalProcessing cObject

Note: The output is NOT included anywhere.

Global Wrap 1. This will be splitted into the markers ###GW1B### and ###GW1E###. Don't change the input value by the settings, only wrap it in something.

Example:

wrap1.wrap = <b> |</b>

boolean

S

boolean

S

If set, then the output will be wrapped by

<!-- START: tt-products-code-uid --><div id="tt-products-code-uid">

|<text:bookmark text:name="line764"/></div><!-- END: tt-products-code-uid -->

. 'code' will be replaced by the code of the plugin. uid will be replaced by the field 'uid' of the table tt_products.

If true, the product data are kept in the article markers if they are not empty and if the product is merged with a corresponding article which fits in the variant fields.

Only used if useArticles = 3.

Deprecated. See Article/Product configuration

Use this instead:

formerly:

In the list view: The item note will be cut after max_note_length characters, and three dots are added...

This can be dangerous if you use html in your product notes, because a tag could stay open and the following items look ugly

If you set this and PIDuserFolder, for each customer that is not logged in and his email address is not listed as user already, a new frontend user will be created.

An email with the username (his e-mail address) and the password will be sent to him (see ###EMAIL_NEWUSER_TEMPLATE###)

Enable md5 password encryption.

Note: If set, passwords will be encrypted. Consider to install an extension like kb_md5fepw and the newloginbox.

If unset, then the price field is used as the base to calculate the discount:

discount = (price – price2) / price

where price contains no discounts

set to 1:

discount = (price2 – price) / price2

where price contains the discounts

This is only needed for setting the behavior of the price2 markers.

If set the discount field in the product and category table will be used to get a reducted price for a product. Modes:

1 ... the highest discount from product and categories will be used

2 ... use the product discount if set, otherwise use the highest hierarchical category discount which is set.

The directory on the server, where the XML files should be saved. This directory should not be accessible over http, because everyone can read your customers and their orders.

So don't put this directory unter fileadmin, or rename it to something cryptical at least.

The directory on the server, where the CSV files should be saved. This directory should not be accessible over http, because everyone can read your customers and their orders.

So don't put this directory unter fileadmin, or rename it to something cryptical at least.

If you set this to 1, all additional information (shipping, payment, address data, delivery note) will be appended to the first ordered item. This is good if you want to import this files somewhere.

If you leave this at 0, the file will be formatted for best view in programs like Excel.

See shipping.

Factor to multiply with a product which is bulkily

See shipping.

Tax fee in percent for shipping of bulkily

Some JavaScript which will be included for ###JAVASCRIPT_10### markers.

Example:

javaScript {

10.value = function addValues (a, b) { return a+b; }

20.value = function multiplyValues (a, b) { return a*b; }

}

Configuration of payment and shipping methods, their values and costs and additional calculation scripts and payment gateways.

See description below!