Translations
Info
All page names need to be in English.
en da  de  fr  it  ja  km  nl  ru  zh

Tt products

From TYPO3Wiki
Jump to: navigation, search

<< Back to Extension manuals page

[edit]



Draft Change the {{draft}} marker to {{review}} when you need a reviewer for text and TypoScript. info


The future of tt_products

This page serves as a central point to discuss the addons and corrections to tt_products. The general conversation is done in the [1] Mailing List and on the TYPO3 forum. You can also write an email to Franz Holzinger.

The extension tt_products is Open Source. Every programmer is invited to contribute his piece of code to the shop extension or to a separate extension with additional features which is based on hooks of tt_products. Nobody should create or use a fork.

You can get the latest version of tt_products and a much improved mbi_products_categories extensions including hooks for mm-categories (DAM extension) in the shop of http://ttproducts.de. This sponsoring is needed to get the bugs fixed and new features implemented and well tested. This development work cannot continue without regularily received payments. This is a fundraising where the contributors and sponsors will get the code in advance. The currently developed extension code will be published on the TYPO3 TER under GPL as free after some years of funds collection.

Info sites:
German tt_products.de site
tt products Tutorial

Books:
Der TYPO3-Webshop
TYPO3 4.2 E-Commerce


Video: adding & editing products with tt_products

Franz Holzinger is the maintainer of tt_products since version 2.0.0.

News

17th October 2014: Upload of version 2.7.12 into the TYPO3 TER. Ready for TYPO3 6.2 and PHP 5.5.

8th September 2012: Upload of version 2.7.4 into the TYPO3 TER. Bug fix: add missing method getSingleExcludeList

10th June 2012: Upload of version 2.7.3 into the TYPO3 TER. This version works with TYPO3 4.7.x. Support for hierarchy tiers to filter products in the products list. It contains a workaround to set the page title in the products single view. It needs sr_feuser_register 2.5.x if you want to use the date of birth.

15th August 2011: Upload of version 2.7.2 into the TYPO3 TER. This version works with TYPO3 4.5.x. The TYPO3 backend can be configured in a way that only some fields of the tt_products tables are visible and used.

21th Mach 2011: Upload of version 2.7.1 into the TYPO3 TER. This add tax rate markers to the price sums.

20th December 2010: Upload of version 2.7.0 into the TYPO3 TER. This contains the possibility to have dynamicly changed prices on the display if another product variant is selected.

31th March 2009: Better English and new French and Spanish translations for the example marker template.

29th December 2008: The extension addons_tt_products has been published in TER. It contains the example shop templates and icons. The multiple language shop template contains only markers which are substituted by the texts from the file marker/locallang.xml (tt_products 2.8.0) or from TypoScript setup. Join this team to develop a common shop template usable for all languages.


The next things that have already been implemented into tt_products 2.8.0 are

  • change of all product attributes on the display with the change of a variant select box

In tt_products 2.8.0 you will have

  • Graduated prices which can be entered individually for each product
  • Multiple variants can be entered on the article side.
  • You can assign articles chosen from a group box to products . Each article can be assigned to more than one product even with an additional price. Support for IRRE.
  • Multi language text markers for the shop template (addons_tt_products)
  • Demo shops at http://demo.ttproducts.de and http://www.ttproducts.net .

Send me any error messages per email or to the forum at http://jambage.com .

Wanted

You are welcome to join the team to implement your features of tt_products. (see the tt_products news list. If you have already a working shop and want to be sure that it will remain compatible to future versions of TYPO3, help us to achieve this: Give us a full copy of your TYPO3 tt_products implementation. This is necessary to test it during the development process.

Download

TER: tt_products

You will find the tt_products 2.7.0 sources with the Extension Manager. The official sources with small corrections (maybe not working) are downloadable from https://svn.typo3.org/TYPO3v4/Extensions/tt_products

Forge tt_products HOWTO configure SVN You must install subversion 1.3 to be able to check these files out.

svn co https://svn.typo3.org/TYPO3v4/Extensions/tt_products/trunk tt_products

A tt_products version will only be uploaded into TER with the same version number, if a sponsor will pay for this. Otherwise only the latest code of a branch may be uploaded into TER.
If you have used the former tt_products 1.2.7 you have to do the follwing changes:

  • In ###BASKET_TEMPLATE### you must create a line
<input type="hidden" name="mode_update" value="1">

in front of your version of

<input type="Submit" name="products_update" value="Basket/Warenkorb aktualisieren">

Watch the error feedback on this page. zk_products users must set the "$TYPO3_CONF_VARS['EXTCONF']['tt_products']['pageAsCategory'] = 1" in LocalConfiguration.php.
attention:

  • You must fill in the product's 'In Stock (pcs)' field, or no article will be shown if set to 0.
  • If you use a shopping price calculation you have to set
10.priceTax.type = count
  • You have to adapt all former calculation scripts. $itemArray and $calculatedArray have to be used instead of the former CalculatedBasketArray and CalculatedSums tt_products member variables.
  • You have to use ###FIELD_NAME_BASKET### now in your basket template!

Templates

See the extension addons_tt_products for example shop template files.

Documentation

Marker

see tt_products Marker

Installation Instructions

Remove your tt_products extension from the Extension Manager, download the file above and copy its contents to the local folder typo3conf/ext/tt_products or the global typo3/ext/tt_products on your server.
Then use the Extension Manager's "Available extensions to install" and add the Shop system again.

Recommendations

Put your recommendations here. Send error messages directly to the author.

  • Recommendation 1:

If you use PIDthanks then you have to use also the BASKET_ORDERTHANKS_TEMPLATE used for displaying a thanks page.


  • Recommendation 2:

I had the problem, that when choosing a variant of a product and the marker ###ARTICLE_NOTE### was used in conjunction with id="###ARTICLE_NOTE_ID###" all german special characters showed up as "?". Setting ['t3lib_cs_convMethod'] = 'recode' and ['t3lib_cs_utils'] = 'recode' solved the problem. It seems to me that the standard conversion methods used in TYPO3 (used version was 4.2.8) screwed up a little bit here.

Hooks

It's much easier to upgrade from one shop-version to the current one, when addons are added using hooks. When a hook exists what is not listed here, then just add it to this page! --Daniel Brüßler 09:45, 21 April 2007 (CEST)

getLinkParams

example usage: I need to add certain parameter to the "back to list" links

documentation@2007-03-17 - available in the next version (suppose 2.5.3):
PHP script:
$hookObj->getLinkParams($this,$queryString,$excludeList,$addQueryString,$bUsePrefix,$bUseBackPid,$piVarCat);

You can define your method with the $addQueryString as a reference. Then you can change the contents.

PHP script:
function getLinkParams($excludeList='',&$addQueryString, ...) {
  ...
  $queryString['backPID'] = 0815;
}

addGlobalMarkers

example usage: I need to add "global" content what comes from the FlexForm or what is defined by TypoScript

documentation@2007-04-21 - available since version 2.5.2:

You define the method in an extra class:

PHP script:
class tx_ttproducts_markeradd {
   function addGlobalMarkers(&$markerArray)     {
     $markerArray['###EXT_PRODUCT_YOURNEWMARKER###'] = 'YOURNEWMARKER-content';
     return;
   }
}
 
if (defined('TYPO3_MODE') && $TYPO3_CONF_VARS[TYPO3_MODE]['XCLASS']['ext/YOUREXTENSIONKEY/marker/class.tx_ttproducts_markeradd.php']) {
  include_once($TYPO3_CONF_VARS[TYPO3_MODE]['XCLASS']['ext/YOUREXTENSIONKEY/marker/class.tx_ttproducts_markeradd.php']);
}
 
if (defined('TYPO3_MODE')) {
  $TYPO3_CONF_VARS['EXTCONF'][TT_PRODUCTS_EXTkey]['addGlobalMarkers'][] =
    'EXT:ext/YOUREXTENSIONKEY/marker/class.tx_ttproducts_markeradd.php:&tx_ttproducts_markeradd';
}

and load it in the main class class.tx_ttproducts_pi1 using require_once.

getItemMarkerArray

You can use the hook at function getItemMarkerArray in model/class.tx_ttproducts_article_base.php to add markers on a product/article base.

Wishlist

newly implemented

  • credit card payment via Paypal: Paypal extension can be used together with the Payment Library and tt_products

Add your wishes here

what should be implemented in the next step.

  • integration with other backend shop data, for example stock, shipping services like Hermes, CRM
  • using rg_slideshow for product pictures would be nice
  • it would be nice if it was possibly to select autorotation of highlights and offers. I.e. two 'offers' or 'highlights' displayed on the front page – each time the page is updated, the next (or random) two 'offers'/'highlights' are displayed. I know 'ke_showproducts' have this feature, but it do not allow you to use al the fields of tt_products (only 'image' and 'title').
  • XML product feeds, to import products from supplier XML DB.
  • category support by page. Select category when you create an article or product and save all products and acticles in one sysfolder. Create new page, insert shop, selct list, chose category that is to be displayed, or select all
  • it would be nice if multiple price discount percentage user groups could be added. Ie. admin adds a user COMPANY 3 to user group 1 and this user group has 10% off price (configureable) and prices are automatically cut off 10% when he logs in, or even better - under the price his discount is displayed as: Your discount: 10%. Then, 10% is deducted from total in his basket or total sum. This way it could enable nice reseller purchasements or wholesale. It would be absolutely GREAT if additionally products or products groups could have different discount rates. Ie. Prod group 1 for user group 1 discount: 8%.
  • Always check if the amount of products is on the stock before making an order possible.
  • Create a price value where shipping costs nothing
  • Ratings : rate popularity of the product
  • opinions/feedback left by others(registered users) who used the product.
  • Possibilitie to have a Main product and from there a link to accessoires which you also can buy if you want.
  • Backend module for order processing, product and user administration
  • Possibility to use 4 decimals (0,0231) for wholesale items.
  • Possibility to sell downloadable items, e.g. pictures or software.
  • display error message for wrong entries on the entry page
  • make TMENU usable with the products sysfolder
  • possibility to save automatically if the customer is male or female.
  • More options when showing the variants in single view ex. use radio buttons instead of droplist; show variant price next to option. ex. SIZE - PRICE
  • would be nice to have this module using Flex and Templavoila, instead of traditional TS templating
  • Resize images to a exact size (ex: 150px x 120px) even if they are horizontal or vertical sized

Implemented Shops

Here you can enter the URLs of the shops you have implemented with tt_products.
Please, keep the alphabetical sorting by the URLs.
air-soft.gun-evasion.com
ARTRIKAT - Das Kunstportal - The Art Portal
bumbaumel Bio Babyshop
carljung.cz
Shop für Segelschiffchen
Minishop modified list/put in basket
Implementierung tt_products für Catering- & Party-Service
Fressexpress - Hundefutter
Garten Bronder Utting
Uitgeverij Gideon : Dutch Christian bookshop
Hells Devil Parts
OERLIKON Industriegeschichte(n)
Shop des Jaguar-Online-Club
Shopbereich der Kitecity Sportreisen
KRAMSKI Putter Golfausrüstung
Landjugendverlag t-Shirts and much more
Leasing-World.com
Little Luna - Der etwas andere Kindershop
Macland
Shop für Puppenmanufaktur Marie-Mischell
meer wijn - wijnwinkel
MOTO-SHOP-GROßHANS
Schallplatten und CDs in Frankfurt
my-twinparts - V-Twin Motorradzubehoer
Traditionelle Weihnachtskunst aus dem Erzgebirge
Pferdegutallesgut.de
Taucher-Shop
Buchshop, KNV Integration und Import/Export zu MOS Choice
qualitaetsstruempfe.de
Indie-Label, Vertrieb von Tonträgern
Das erfolgreiche österreichische Weingut Salomon Undhof

Schimonski's Kulturkaufhaus
Shoppen in Diessen
Shop für Sonnenschutzfolien
Onlineshop für Teamsportartikel
tt_products shop
WerkZeugs - Merchandising von Autoren & Illustratoren
Westernstore
Shop für den Orgelbau

BVDOnline.de - Zeiterfassung und mehr... - inkl. Shop für Zeiterfassungskomponenten
Das Vitamin Reich - Obst, Gemüse und mehr

Code

How shall the code be improved in the future? Please send me your recommendations. You can also put a link to a patch file here which you want to be added to the code. Please also add an info to which version in svn you have written your patch.

  • The function headers shall be completed.

--Franz Holzinger 09:20, 12 October 2008 (CEST)