Quick start

Watch the video and/or read the instructions to get a (minimal) working shop setup.

Instructions

1. Install this extension:

   See Installation → Install the extension.

2. Include the TypoScript of this extension:

   See Installation → Include TypoScript.

3. Install a product database extension

   You need to install at least one more extension to get a working shop setup. This other extension will offer the products itself. This can be one of the existing extensions or a custom extension.

   See Other cart extensions.

   The next steps of this quick start use EXT:cart_products. Include the TypoScript of this second extension as described above or as described in the corresponding documentation.

4. Create the needed pages and directories in the TYPO3 backend.

   

   1. Create a page for cart. Here it's named Cart.

   2. Create a page for a list of products. Here it's named Products.

   3. Create a page for the detail view of a product. Here it's named Detail.

   4. Create a page of type "directory" where the products will be stored. Here it's named Products Storage.

   5. Create a page of type "directory" where the orders will be stored. Here it's named Orders.

   Tip

   You can create multiple, even nested, directories to organize your products in the backend.

   In this case you can even have multiple pages for lists and detail views.

5. Create Plugin for the cart

   

   On the page Cart:

   • Create a record of type plugin Cart: Cart.

6. Create Plugin for the list view

   

   On the page Products:

   • Create a record of type plugin Cart: Products and make the following settings:

     • Choose "Display Type" = "List (and Show) View".

     • In Product Detail Page choose the page Detail.

     • In Record Storage Page choose the page Products Storage.

7. Create Plugin for the detail view

   

   On the page Detail:

   • Create a record of type plugin Cart: Products.

     • Choose "Display Type" = "Show View".

8. Set TypoScript constants

   The following can be done in the TYPO3 backend in the TypoScript Module (as shown in the video) or better in your own sitepackage (which is preferred because it is under source control).

   See also Base Configuration.

   EXT:sitepackage/Configuration/TypoScript/constants.typoscript

   plugin.tx_cart.settings {
       cart {
           pid = # The PID of the page "Cart".
           isNetCart = # 0 or 1, depending on your needs.
       }
       order.pid = # The PID of the page "Orders".
   }
   

9. Set needed TypoScript setup

   You should set in your sitepackage/Configuration/TypoScript/setup.typoscript fitting values for:

   • email

   • payments

   • shippings

   • currencies (only needed when not only using €),

10. Link for consent checkboxes in the cart

    EXT:sitepackage/Configuration/TypoScript/constants.typoscript

    plugin.tx_cart.settings.cart {
        acceptTermsAndConditions.pid = # The PID of your terms and conditions page.
        acceptRevocationInstruction.pid = # The PID of your revocation instructions page.
        acceptPrivacyPolicy.pid = # The PID of your privacy policy page
    }
    

11. Create a product

    
    

    • Go to the page Product Storage, switch to the backend module "List".

    • Click on + Create a new record → Product for a product which is given from the database extension (which is EXT:cart_products in this quick start).

    • Fill in necessary product data and save.

12. Done

    You should now be able to see the product in the frontend and make an order.