.. You may want to use the usual include line. Uncomment and adjust the path. 
.. include:: ../Includes.txt


===========================
EXT: Commerce DAM connector
===========================

:Author:
      Rupert Germann

:Created:
      2004-07-31T12:12:38

:Changed by:
      Juraj Sulek

:Changed:
      2008-08-11T21:19:01

:Email:
      juraj@sulek.sk

:Info 2:


:Info 3:


:Info 4:


.. _EXT-Commerce-DAM-connector:

EXT: Commerce DAM connector
===========================

Extension Key:  **dam\_commerce**

Copyright 2007, juraj@sulek.sk, <juraj@sulek.sk>

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:

Table of Contents
-----------------

**EXT: Commerce DAM connector 1**

**Introduction 1**

What does it do? 1

**Users manual 2**

Installation 2

Configuration 2

**To-Do list 3**

**Changelog 4**


.. _Introduction:

Introduction
------------


.. _What-does-it-do:

What does it do?
^^^^^^^^^^^^^^^^

Extends the commerce extension with the possibility to use DAM for
images.

Yet the frontend rendering works only for category and product.

I have implemented article images, supplier logo and manufacturer logo
too, but because it is yet not possible to show this in the original
commerce extension there doesn't exists markers. So you must add this
markers to your template if you want to use this features:

In subparts <!-- ###ARTICLE\_VIEW### --> <!-- ###ARTICLE\_VIEW### -->
you can add this markers:

###ARTICLE\_IMAGES### and ###ARTICLE\_SUPPLIERLOGO###

And in all products subparts(<!-- ###PRODUCT\_VIEW\_DETAIL(\*)###
begin-->,<!-- ###CATEGORY\_ITEMS\_LISTVIEW\_(\*)### end -->) you can
add this marker: ###PRODUCT\_MANUFACTURERLOGO###


.. _Users-manual:

Users manual
------------


.. _Installation:

Installation
^^^^^^^^^^^^

Just install the extension, go to template editor and add “DAM
COMMERCE” to “Include static (from extensions):“ section.


.. _Configuration:

Configuration
^^^^^^^^^^^^^

This is the actually typoscript configuration:

::

   plugin.tx_commerce_pi1{
           defaultDamImageSetting{
                   stdWrap.wrap=|
                   disable=0
                   title.field=title
                   alt.field=alt_text
                   caption=0
                   caption.field=caption
                   caption.layout=<div class="captionLayout"><span class="image">###IMAGE###</span><span class="caption">###CAPTION###</span></div>
           }
           categoryListView.categories.fields{
                   DAM_images < plugin.tx_commerce_pi1.defaultDamImageSetting
                   DAM_images.file.maxW = 150
           }
           listView.products.fields{
                   DAM_images < plugin.tx_commerce_pi1.defaultDamImageSetting
                   DAM_images.file.maxW = 150
                   
                   DAM_teaserimages < plugin.tx_commerce_pi1.defaultDamImageSetting
                   DAM_teaserimages.file.maxW = 150
           }
           listView.articles.fields{
                   DAM_images < plugin.tx_commerce_pi1.defaultDamImageSetting
                   DAM_images.file.maxW = 150
           }
           listView.suppliers.fields{
                   DAM_logo < plugin.tx_commerce_pi1.defaultDamImageSetting
                   DAM_logo.file.maxW = 50
           }
           listView.manufacturers.fields{
                   DAM_logo < plugin.tx_commerce_pi1.defaultDamImageSetting
                   DAM_logo.file.maxW = 50
           }
   }

The DAM\_\* elements are have the type IMAGE therefore at end this
typoscript will be used:

::

   DAM_images=IMAGE
   DAM_images{
           file=....here come the file from DAM ....
           file.maxW=150
           stdWrap.wrap=|
   }

With option disable you can disable the FE rendering for things that
you don't use and so save performance.

You can use this configuration options for each image:

::

   title.field=...here come the field where the title is stored...
   alt.field=...here come the field where the alt is stored...
   caption=...if you want use the caption function for the image set this value to 1...
   caption.field=...here come the field where the caption is stored...
   caption.layout=...here you can set the caption layout...

You can change the default configuration the only thing you can't do
is to specify DAM\_images.file=... because this is set by PHP.


.. _To-Do-list:

To-Do list
----------

-

- finish this manual

- finish the frontend rendering for all images.


.. _Changelog:

Changelog
---------

**dam\_commerce 0.1.0**

alt-text, title-text and caption added

**dam\_commerce 0.0.5**

Bug #8867 reparied

**dam\_commerce 0.0.4**

Marker for teaser images changed. From now the marker
###PRODUCT\_TEASERIMAGES### is used instead of ###PRODUCT\_TEASER###.
Plz. update your templates.

**dam\_commerce 0.0.3**

- Marker ###PRODUCT\_MANUFACTURERLOGO### added

- doNotRender option added

- Bug repaired by supplier and article images

**dam\_commerce 0.0.2**

- Markers ###ARTICLE\_SUPPLIERLOGO### and ###ARTICLE\_IMAGES### added

- some PHP changes

**dam\_commerce 0.0.1**

First release

|img-1| EXT: Commerce DAM connector - 4


.. ######CUTTER_MARK_IMAGES######

.. |img-1| image:: img-1.png
.. :align: left
.. :border: 0
.. :height: 32
.. :id: Graphic1
.. :name: Graphic1
.. :width: 102