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


======================
EXT: com\_defaultstock
======================

:Author:
      Kasper Skårhøj

:Created:
      2002-11-01T00:32:00

:Changed by:
      Ingo Schmitt

:Changed:
      2007-08-28T15:42:08

:Author:
      Jörg Sprung

:Email:
      typo3@marketing-factory.de

:Info 3:


:Info 4:


.. _EXT-com-defaultstock:

EXT: com\_defaultstock
======================

Extension Key:  **com\_defaultstock**

Copyright 2007 - , Jörg Sprung, <typo3@marketing-factory.de>

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: com\_defaultstock 1**

**Introduction 1**

What does it do? 1

**Installation 1**

**Configuration 1**

**Screenshots 2**

**To-Do list 2**

**Changelog 2**


.. _Introduction:

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


.. _What-does-it-do:

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

This is a default stockhandlingservice for commerce. You can use this
out of the box, or to build your own individual stockhandlingservice
for your purpose. This extension adds a stockfield to the article,
where you can register your stockamount. In normal shop-workflow this
value is used at different positions to manipulate the pageoutput or
stops orderprocess if article is out of stock.


.. _Installation:

Installation
------------

You have to install commerce first, before trying to install this
service.

If you installed this no further direct activities within this service
is affordable, but you have to do some changes in commerce to make
this work like you want.


.. _Configuration:

Configuration
-------------

Things to do in commerce to make stockhandling work:

- Turn on useStockHandling in Constants of commerce. You can also turn
  it on for each FE\_plugin for your special needs

- please change the following TSParts for your needs with stdWrap, these
  parts are copied in listView, singleView and listViewTop. so it's
  possible to manipulate the design of products and articles with
  stdWrap
  
  - products.nostock < lib.tx\_commerce.products
  
  - articles.nostock < lib.tx\_commerce.articles

- in plugin.tx\_commerce\_pi1 you can turn on or off showing products or
  articles with no Stock with following Parameters
  
  - products.showWithNoStock = 1
  
  - articles.showWithNoStock = 1

- In your template you `have
  <http://dict.leo.org/ende?lp=ende&p=/gQPU.&search=have>`_ `the
  <http://dict.leo.org/ende?lp=ende&p=/gQPU.&search=the>`_ `ability
  <http://dict.leo.org/ende?lp=ende&p=/gQPU.&search=ability>`_ to
  specify special subparts for showing products and aticles with no
  stock. Please have a look at the default template and search for
  subpartmarker with \_NOSTOCK at the end of their name.

- In TypoScript plugin.tx\_commerce\_pi2 you can turn on or of checking
  amount of added articles against amount in stock. checkStock = 1

- If the user added an article wich ist just out of stock a massage is
  rendered into ###NO\_STOCK\_MESSAGE### into basket from locallang.xml

- In TypoScript plugin.tx\_commerce\_pi3 you can turn on or of checking
  amount of articles against amount in stock in finishing method, so a
  order is not possible if articles are in basket wich are no longer at
  stock. checkStock = 1

- In the above case, you also have to definethenoStockBackPID for the
  generating the backpid in usermessages which is defined in
  locallang.xml

- Another parameter in pi3 is the clearCacheAfterFinishWithStock list of
  PIDs which shopuld ne cleard cache after finishing order. If you do
  not so, your productcatalog using stockhandling is maybe rendered out
  of cache with old stockvalues.


.. _Screenshots:

Screenshots
-----------

|img-1|


.. _To-Do-list:

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


.. _Changelog:

Changelog
---------

|img-2| EXT: com\_defaultstock - 2


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

.. |img-1| image:: img-1.png
.. :align: left
.. :border: 0
.. :height: 148
.. :id: Grafik1
.. :name: Grafik1
.. :width: 390

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