DEPRECATION WARNING

This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.

EXT: TYPO3 Commerce ordernumber¶

Author:	Kasper Skårhøj
Created:	2002-11-01T00:32:00
Changed by:	Ingo Schmitt
Changed:	2007-08-10T18:16:32
Author:	Ingo Schmitt
Email:	is@marketing-factory.de
Info 3:
Info 4:

EXT: TYPO3 Commerce ordernumber¶

Extension Key: com_ordernumber

This document is published under the Open Content License

available from http://www.opencontent.org/opl.shtml

The content of this document is related to TYPO3

- a GNU/GPL CMS/Framework available from www.typo3.com

Table of Contents¶

EXT: TYPO3 Commerce ordernumber 1

Introduction 1

What does it do? 1

Screenshots 1

Users manual 1

Adminstration 1

Configuration 2

TypoScript Reference 2

Known problems 2

To-Do list 2

Changelog 2

Introduction¶

What does it do?¶

This extension creates human readable order numbers for TYPO3 Commerce instead of the default uinqueID Numbers

Screenshots¶

- Screenshots are very much welcome for a visual impression.

- This section will have a link in the EM, so therefore it's very important that it conveys this message.

- Target group: Mostly Developers and administrators, but should be a non-technical and visual presentation.

- This section is required and in some cases it basically tells it all.

Users manual¶

This uses the TYPO3 Commerce hook for creating the order number. You can configure the layout of the number to your needs by setting a individual starting number and a order number prefix.

Adminstration¶

After the install of this extension you could configure the number- layout by a new TypoScript object in the tx_commerce_pi3 section. A new order number will be created by the given TypoScript definition. To have a order number only used once on a webserver, the new order number is stored in a file, assuming the OS takes care of file locking to this file. If the file is not present, the last order number in the database would be used to generate the next order number.

Configuration¶

This extension creates a new object in tx_commerce_pi3: tx_com_ordernumber

TypoScript Reference¶

- tx_com_ordernumber

startingAt¶

Property

startingAt

Data type

integer

Description

Number to start for generating the order number

Default

endingAt¶

Property

endingAt

Data type

integer

Description

Number to end for generating the order number, keep this number high, to have enough “space” for new orders

Default

interval¶

Property

interval

Data type

integer

Description

Interval to increase the order number for each order

Default

[tsref:(cObject).TEST]

((generated))¶

Example¶

Add this code to you TypoScript for the checkout page.

plugin.tx_commerce_pi3 {
   tx_com_ordernumber.startingAt = 21000000
   tx_com_ordernumber.endingAt   = 21999999
   tx_com_ordernumber.interval = 1
}

Known problems¶

- The order number is stored in a temporary file under a temporarily path, mainly /tmp/ under unix. This could cause problems with some windows versions.

To-Do list¶

Find a way to get the path of the TYPO3TEMP directory, to place the actual ordernumber below this path, instead of /tmo under unix
add checkout page uid to tmp file name, to have different files for different shops in one TYPO3 instance.

Changelog¶

10.08.2008, Version 1.0.0, initial upload in TER

EXT: TYPO3 Commerce ordernumber - 2