Commerce

Cleaning up

As you can see in the screen shot there is an ugly marker '###NO_STOCK###'. You can get rid of this marker by removing it from your product.tmpl template. You can also see that the 'add to basket' button reads 'abschicken' by default. You need to change this hard coded string in the product.tmpl on line 65, 80, 109, 124, 152, 169, 208 and 225.

Configuration

Using your Own Mail templates

You can use your own Mailtemplates for the Admin and User mail. The first line of the template is the subject of the Mail send. Hint: The usage of page2tmpl extension can save you a lot of time, especially in a multi-language setup.

RealUrl configuration

Copy the contents of the textbox below to your realurl configuration in /typo3conf/localconf.php. For detailed information about the configuration of this extension see the realUrl manual.

Warning

Only use the configuration below if you have only one domain (or one rootpage) in your realurl setup. If you have more starting-points, be careful, this configuration might break up your get parameter.

<PHP> :

 // . . . using just products (without articles). cHash and BasketHash remain as ordinary GETVars.
 
 // product categories
 'cat' => array(
 	array(
 		'GETvar' => 'tx_commerce_pi1[catUid]',
 		'lookUpTable' => array(
 			'table' => 'tx_commerce_categories',
 			'id_field' => 'uid',
 			'alias_field' => 'title',
 			'addWhereClause' => ' AND NOT deleted',
                         'enable404forInvalidAlias' => '1',
 			'useUniqueCache' => 1,
 			'useUniqueCache_conf' => array(
 				'strtolower' => 1,
 				'spaceCharacter' => '-',
 			),
 		),
 	),
 ),
 // product
 'pr' => array(
 	array(
 		'GETvar' => 'tx_commerce_pi1[showUid]',
 		'lookUpTable' => array(
 			'table' => 'tx_commerce_products',
 			'id_field' => 'uid',
 			'alias_field' => 'title',
 			'addWhereClause' => ' AND NOT deleted',
                         'enable404forInvalidAlias' => '1',
 			'useUniqueCache' => 1,
 			'useUniqueCache_conf' => array(
 				'strtolower' => 1,
 				'spaceCharacter' => '-',
 			),
 		),
 	),
 ),

CoolUri configuration

<PHP> :

  <uriparts>
    <part>
      <parameter>tx_ttnews[tt_news]</parameter>
      <lookindb>
        <to>SELECT title FROM tt_news WHERE uid=$1</to>
        <translatetoif>
          <match>^[0-9]+$</match>
        </translatetoif>
        <t3conv>1</t3conv>
      </lookindb>
    </part>
    <part>
      <parameter>tx_commerce_pi1[catUid]</parameter>
      <lookindb>
        <to>SELECT title FROM tx_commerce_categories WHERE uid=$1</to>
        <translatetoif>
          <match>^[0-9]+$</match>
        </translatetoif>
        <t3conv>1</t3conv>
      </lookindb>
    </part>
       <part>
      <parameter>tx_commerce_pi1[showUid]</parameter>
      <lookindb>
        <to>SELECT title FROM tx_commerce_products WHERE uid=$1</to>
        <translatetoif>
          <match>^[0-9]+$</match>
        </translatetoif>
        <t3conv>1</t3conv>
      </lookindb>
    </part>
  </uriparts>
 

Search

You can search for articles using Search In Tables (fesearchintable) (contact: ccho). The description says it is a:

"Front End Search tool to help find items within any table and/or tables."

So I decided to try that and discovered that it indeed works. I am interested in expanding on the TS to get it to show teaser images etc. in the result listing.

The important bits are the pidList which you should set to the ID of your commerce folder and the typolink parameter which you should set to the ID of your 'singleview' page:

<TS> :

plugin.tx_fesearchintable_pi1 {
	searchTables {
		tx_commerce_products.pidList = 260
		tx_commerce_products.listItem {
			30.typolink.parameter = 277
		}
	}
}

Here is the complete TS:

<TS> :

plugin.tx_fesearchintable_pi1 {
	searchTables {
		tt_news >
		tx_commerce_products = 1
		tx_commerce_products.name = Products
		tx_commerce_products.fields = title,description,teaser,subtitle,keywords
		tx_commerce_products.selectAdditionalParams = AND 1=1
		tx_commerce_products.pidList = 260
		tx_commerce_products.recursive = 1
 
		tx_commerce_products.listHeader = COA
		tx_commerce_products.listHeader {
			10 = TEXT
			10.value = Produkten
			10.wrap = <h3 style="background-color:#FFCC66; color:white; padding: 4px">|</h3>
		}
 
		tx_commerce_products.listItem = COA
		tx_commerce_products.listItem {
			stdWrap.wrap = <li>|</li>
			10 = TEXT
			10.field = title
			10.wrap = <strong>Produkt: </strong><strong style='color:#006699;'>|</strong><br>
			20 = TEXT
			20.field = teaser//description
			20.crop = 120|...&nbsp;
			30 = TEXT
			30.value = lees meer  &raquo;
			30.typolink.parameter = 277
			30.typolink.wrap = <em>|</em>
			30.typolink.ATagBeforeWrap = 1
			30.typolink.additionalParams.dataWrap = &tx_commerce_pi1[showUid]={field:uid}
		}
		tx_commerce_products.listStdWrap.wrap = <ol style="margin-top:-10px">|</ol>
 
		tx_commerce_products.singleView < plugin.tx_commerce_products
		tx_commerce_products.singleView.code >
		tx_commerce_products.singleView.code = SINGLE
	}
}

Extending

Hooks

The following sh snippet will help you to find the hooks in commerce. Cd to your commerce extension dir and run this script. It will spit out a hooks.txt file which contains all the entries of which the script thinks they are hooks hooks (some are not actually hooks ;-).

<shellScript> :

 #!/bin/sh
 if [ -e hooks.txt ]
 then
   rm hooks.txt
 fi
 for f in `grep -rl EXTCONF \`find . \( -type f -name "*php" -and \! -name "ext_emconf.php" \)\``;
   do echo "" >> hooks.txt;
   echo $f >> hooks.txt;
   grep -nh EXTCONF $f | grep -v foreach | grep -v getUserObj >> hooks.txt;
 done;

You can also try the nc_commerce_hookinspector extension. This extension hooks into the commerce hooks and then outputs debug() statements so you can seen when what hooks are actually called. You get the best results if you use it in combination with cc_debug (remember to set config.debug to 1 in your TypoScritp Setup and optionally give your devIPMask in the install tool a proper list of IP's).

list of existing extensions to commerce

• dam_commerce - Commerce DAM connector, dam_commerce
• paypal2commerce - Paypal Express-Checkout for commerce, paypal2commerce manual
• wt_commerce_import - Product import for commerce Extension, wt_commerce_import
• dam_commerce - Extends the commerce extension with the possibility to use DAM for images, dam_commerce
• com_defaultstock - Default stockhandling for commerce, com_defaultstock
• com_ordernumber - Commerce Ordernumber, com_ordernumber
• nc_commerce_hookinspector - Commerce Hook inspector, nc_commerce_hookinspector
• commerce__germantax - Commerce German tax rates, commerce__germantax
• wt_individualshippingcost - Enter different delivery classes per product, wt_individualshippingcost
• wt_commerce_preview - Shows one of the last X tx_commerce products via random function, wt_commerce_preview
• wt_commerce_tipafriend - Tipafriend link within commerce product view, wt_commerce_tipafriend
• wt_commerce2ebay - List your commerce article in ebay via API, wt_commerce2ebay

currently in the works

• coupons/vouchers extension, snapshots from SVN available at http://typo3xdev.sourceforge.net/
• comments / reviews (through Dmitri's generic comments extension)

Integrating payment methods

• Integrating payment methods (de)
• Integrating payment methods (en) translated by a fish
• etc.

Tutorials

• Creating an extension that switches the delivery methods based on basket sum

Translating

Commerce can be translated by TYPO3 translators on: http://translation.typo3.org/translation/typo3/. If your language lacks a translation, go bug your chief translator about it.

FAQ

Known problems

• bad documentation :-)

If you find problems, that are not listed here, please post them at the bugtracker (http://bugs.typo3.org) project tx_commerce or in the commerce newsgroup (news://news.netfielders.de/typo3.projects.commerce )

TODO

• Add some more documentation

If you have a feature request. please post it at the bugtracker (http://bugs.typo3.org) project tx_commerce.

Changelog

Version 0.9.0

• First release in TER
• Updated documentation