Selectable Payment / Shipping / Handling Items 

title

title
Type
string

Title of item, eg. “Master card” or “Ground mail” The title will be cloned, if markers like ###STATIC_COUNTRIES_CN_ISO_3### are used together with where.static_countries.

type

type
Type
string
  • pick_store: pick it up from a store. The delivery address is filled from a selected store (see UIDstore)
  • nocopy: bill address will not be copied into the delivery address even if it has been left empty in the entry form.

mode

mode
Type
string

Possible payment options:

  • bank_transfer ... payment via account
  • credit_card
  • cash
  • PayPal
  • Saferpay
  • iPayment
  • Payone
  • ClickandBuy
  • vrepay
  • Authorize.net

image

image
Type
IMAGE cObject

Logo image for the item

price

price
Type
double or array of integers see below for additional parameters

Price of item, including or excluding VAT, depends on TAXincluded. You use integers to specify the minimal number of items for which the price is valid. 6 items and more will cost 5.8 in this example.

Example:

use the subtitle for translations
30.price.type = count
30.price.1 = 4
30.price.6 = 5.8
Copied!

replaceTAXpercentage

replaceTAXpercentage
Type
double of integers

If set as double, the general TAXpercentage will be overridden by this value. You can alternatively use it as an array. You give the tax to replace on the left side, and the new tax value on the right side. This will replace all taxes of items of zero tax by a tax of 8% and it will replace all items of 14% with a tax of 2,5% instead. Use this to set different taxes for different countries.

Example:

replaceTAXpercentage depending on sum
30.replaceTAXpercentage {
   0 = 8
   14 = 2.5
}
Copied!

priceFactWeight

priceFactWeight
Type
double

Will be added to price. The weight is multiplied with this factor to increase the shipping price.

priceFactCount

priceFactCount
Type
double

Will be added to price. The product's count is multiplied with this factor to increase the shipping price.

percentOfGoodstotal

percentOfGoodstotal
Type
double

Price of item, calculated from a percentage of the total amount before payment/shipping

percentOfTotalShipping

percentOfTotalShipping
Type
double

If set the payment costs are calculated in the percentage of the total product tax price inclusive the shipping tax price.

creditcards

creditcards
Type
string

Comma separated list of allowed uids for the creditcards. See file localland_db.xml about the values. sys_products_cards.cc_type.I

  • 0: American Express
  • 1 ... Diners Club
  • 2 ... Mastercard
  • 3 ... Visa

creditcardSelect

creditcardSelect
Type
array of form elements

If set, the month and year for the credit card are selectable from select boxes. Subvalues: mm (month) and yy (year)

Example:

replaceTAXpercentage depending on sum
creditcardSelect {
      mm {
        label = Month
        valueArray {
          10.label = 1
          10.value = 1
          20.label = 2
          20.value = 2
          30.label = 3
          30.value = 3
          40.label = 4
          40.value = 4
          50.label = 5
          50.value = 5
          60.label = 6
          60.value = 6
          70.label = 7
          70.value = 7
          80.label = 8
          80.value = 8
          90.label = 9
          90.value = 9
          100.label = 10
          100.value = 10
          110.label = 11
          110.value = 11
          120.label = 12
          120.value = 12
        }
      }

      yy {
        label = Year
        type = recs[creditcard][endtime_yy]=select
        valueArray {
          10.label = 2010
          10.value = 2010
          20.label = 2011
          20.value = 2011
          30.label = 2012
          30.value = 2012
          40.label = 2013
          40.value = 2013
      }
 }
Copied!

accounts

accounts
Type
boolean

If set the payment with booking from the entered bank account will be allowed.

useAsterisk

useAsterisk
Type
int+
Default
1

If set then the account and credit data is replaced with asterisks after having been entered..

bulkilyAddition

bulkilyAddition
Type
int+
Default
1

Factor to multiply with a product which is bulkily

bulkilyFeeTax

bulkilyFeeTax
Type
int+

Tax fee in percent for shipping of bulkily

calculationScript

calculationScript
Type
resource

PHP script which is included in a “blank” function and it should be written to manipulate amounts in the internal arrays. This script could be used to calculate a special fee regarding a payment/shipping item. It is not recommended to use this feature. Write your own TYPO3 extension instead which is based on hooks. Properties of the calculation script is passed to the function as $confScript array. The resulting prices need to be written into the variables $priceShippingTax and $priceShippingNoTax.

handleScript

handleScript
Type
resource

PHP script which is included in a “blank” method called from products_basket() in user_products class when the order is finalized. This function must take care of displaying templates during the payment process with a payment gateway as well as finalizing the order afterwards. See payment_DIBS.php in addons_tt_products for an example. A HTML-template file follows. Properties of the handle script is passed to the function as $conf array. The content of the variable $content is returned as content.

handleLib

handleLib
Type
string / array

Name of the TYPO3 library to handle the Payment. Currently you can set only 'transactor' here to use the Payment Transactor Library Extension.

array values: extName: name of the specific Payment Library (SPL) extension paymentMethod: method of the SPL (e.g. paymentlib_transcentral_cc_mastercard) currency: currency to use templateFile: template file for the display of the payment * gatewaymode: mode of the gateway (form / request)

Example:

transactor for Mastercard
40.title = Mastercard
40.handleLib = transactor
40.image.file = EXT:tt_products/res/icons/fe/mastercard.gif
40.handleLib {
  extName = transcentral
  paymentMethod = paymentlib_transcentral_cc_mastercard
  Currency = $
  templateFile = EXT:tt_products/template/paymentlib.tmpl
  gatewaymode = form
}
Copied!

handleURL

handleURL
Type
string

If set, this handleURL is called instead of the THANKS-url (by PIDthanks) in order to let eg. a handleScript process the information if payment by credit card or so.

handleTarget

handleTarget
Type
string

Alternative target for the form.

excludePayment

excludePayment
Type
string

This is a list of payment method keys (their numbers) which are not available given a certain delivery form. For instance if people pick up goods in the store, you don't want them to transfer money or pay online but just order the goods. So you can exclude those payment methods.

Example:

excludePayment for pickup in store
40.title = Pick up in store
40.excludePayment = 10,40
Copied!

excludeHandling

excludeHandling
Type
string

This is a list of handling method keys (their numbers) which are not available given a certain delivery form. For instance if people pick up goods in the store, you don't need a packaging for transport. So you can exclude those handling methods

Example:

excludePayment for pickup in store
40.title = Pick up in store
40.excludeHandling = 20,70
Copied!

replacePayment

replacePayment
Type
list of integers

This is a list of payment settings which will be overridden if this shipping method has been selected.

Example: .. code-block:: typoscript :caption: excludePayment for pickup in store

40.title = China 40.replacePayment.10.title = Payment with China 40.replacePayment.10.price = 100

. _configuration-payment-shipping-handling-show:

show

show
Type
boolean
Required

true

Default
1

If set, the item is shown in the list.

. _configuration-payment-shipping-handling-show-limit:

showLimit

showLimit
Type
double
Required

true

Default
0

If set, then this item will only get shown when there is at least this number of products in the basket. * 0: always show this item

. _configuration-payment-shipping-handling-type:

type

type
Type
string
Required

true

  • fe_users: the payment can be configured via the fe_users table

. _configuration-payment-shipping-handling-visible-for-group-id:

visibleForGroupID

visibleForGroupID
Type
string
Required

true

This payment method is only available, if a user is logged in and member of this frontend user group

. _configuration-payment-shipping-handling-add-required-info-fields:

addRequiredInfoFields

addRequiredInfoFields
Type
string

Additional required fields in the INFO page, if this payment method is selected. Useful for credit card payment.

. _configuration-payment-shipping-handling-where-static-countries:

where_static_countries

where_static_countries
Type
string
Required

true

Set a SQL WHERE condition to follow for the selected country in the static_countries table of the static_info_tables extension.

Example: .. code-block:: typoscript :caption: excludePayment for pickup in store

plugin.tt_products.shipping {
10.title = Parcel Germany 10.where.static_countries = cn_short_local = 'Deutschland' 10.price = 5.9 20.title = Parcel EU ###STATICCOUNTRIES_CN_SHORT_EN### 20.where.static_countries = cn_eu_member = 1 AND cn_short_local != 'Deutschland' 20.price = 8.9 30.title = Outside EU ###STATICCOUNTRIES_CN_SHORT_EN### 30.where.static_countries = cn_eu_member <> 1 30.price = 15

}