EXT: Cart Books

Classification: cart
Package name: extcode/cart-books
Version: main
Language: en
Author: Daniel Gohlke & Contributors
License: This document is published under the Open Publication License.
Rendered: Thu, 26 Mar 2026 14:47:50 +0000

Cart Products needs to be used together with EXT:cart.

EXT:cart itself is only the base for a webshop.
EXT:cart_books provides products which can be created in the TYPO3 backend.
- Those products fit many use cases for books, magazines and journals.
- The books, magazines and journals can be displayed on the website with a list view and a detail view.
- As said does it extend EXT:cart so those products can be purchased with the cart of EXT:cart.

Introduction

Cart is a small but powerful extension which "solely" adds a shopping cart to your TYPO3 installation. Cart Books provides an own data storage for books, magazines and journals. Books can be offered via a list and detail view and can be purchased via cart function of the Cart extension.

Support

Slack

There is an own channel at the TYPO3 Slack. Please use this cannel to contact us.

The URL is: https://typo3.slack.com/messages/ext-cart/

Note

Not registered on Slack? You can join here: http://forger.typo3.org/slack.

Support

If you need further support, please contact me.

Be aware that this support might not be free!

Sponsoring

If there is a feature that has not yet been implemented in Cart or Cart Books, you can contact me at any time.

There is also the possibility to support the further development independently of new functions.

Ask for an invoice.
GitHub Sponsors
PayPal.Me

For Administrators

Installation

Installation using Composer

The recommended way to install the extension is by using Composer. In your Composer based TYPO3 project root, just do

composer require extcode/cart-books.

Installation from TYPO3 Extension Repository (TER)

Download and install the extension with the extension manager module.

Latest version from git

You can get the latest version from git by using the git command:

git clone git@github.com:extcode/cart_books.git

Preparation: Include static TypoScript

The extension ships some TypoScript code which needs to be included.

Switch to the root page of your site.
Switch to the Template module and select Info/Modify.
Press the link Edit the whole template record and switch to the tab Includes.
Select Shopping Cart - Cart Books at the field Include static (from extensions):

Configuration

EXT:cart-books/Configuration/TypoScript/setup.typoscript

plugin.tx_cartbooks {
    settings {
        cart {
            pid = {$plugin.tx_cart.settings.cart.pid}
            isNetCart = {$plugin.tx_cart.settings.cart.isNetCart}
        }

        order {
            pid = {$plugin.tx_cart.settings.order.pid}
        }

        format.currency < plugin.tx_cart.settings.format.currency

        addToCartByAjax = {$plugin.tx_cart.settings.addToCartByAjax}
    }
}

Property: plugin.tx_cartbooks.settings.format.currency
Data type: array
Description: Configures how prices should be formated in frontend. The ExtcodeCartViewHelpersFormatCurrencyViewHelper use this global setting.
Default: The TypoScript template copy the setting from settings of the cart extension.

Property: plugin.tx_cartbooks.settings.addToCartByAjax
Data type: int
Description: Activates the option to add books via AJAX action. There is no forwarding to the shopping cart page. The response can used to display messages or update the MiniCart-Plugin.
Default: The TypoScript template use the setting defined by the constant of the cart extension.

ChangeLog

6.0 Changes

Table of contents

5.0 Changes

Table of contents

4.0 Changes

Table of contents

Breaking Changes

Features

Breaking: #52 - Move Fluid Pagination to Controller

See forge#52

Description

In TYPO3 v11 <f:paginate> has been removed and is implemented via the controller.

Affected Installations

All installations are affected by this change.

Migration

If the templates for the lists of books in the frontend has been overwritten, then these templates must also be adapted. If pagination is not desired, a custom template must be used for the book list.

Breaking: #52 - Add Pagination to Controller

See forge#52

Description

Because in TYPO3 v11 no pagination in the frontend is possible without an own ViewHelper or an extension, the list action in the BookController was extended by the pagination. Via TypoScript it can be defined how many books should be displayed per page.

Integration

An example was implemented in the list action template.

3.0 Changes

This is the initial release of cart_books for TYPO3 v10.4.

Table of contents

Breaking Changes

Breaking: #48 - Remove Switchable Controller Actions

See forge#48

Description

Switchable controller actions have been marked as deprecated in TYPO3 Core and will be removed in one of the next major versions of TYPO3, probably version 11.0 or 12.0.

There is no need to retain the switchable controller actions, so they have already been removed from the extension.

Impact

Plugins that are using switchable controller actions need to be split into multiple different plugins.

Migration

Unfortunately, an automatic migration is not possible. As switchable controller actions allowed to override the whole configuration of allowed controllers and actions, the only way to migrate is to create dedicated plugins for each former switchable controller actions configuration entry.

2.0 Changes

The version 2.0.0 is a release for TYPO3 v9.5 only. This version is compatible to Cart v6.0+.

Important

If upgrading from cart version 4.8.1 or earlier: Please read the documentation very carefully! Please make a backup of your filesystem and database! If possible test the update in a test copy of your TYPO3 instance.

1.0 Changes

The version 1.0.0 is a release for TYPO3 v8.7 only and skipped for TYPO3 v9.5. This version is compatible to Cart v5.0+.