DEPRECATION WARNING

This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.

Upgrade to version 9.0

Introduction

The goal from this distribution is to facilitate a robust foundation using as view extensions as possible. Using less extensions reduces the footprint and improves the upgrade experience.

With release 9 the distribution has been adapted to bootstrap_package 10 supporting TYPO3 9LTS. The major changes include:

TYPO3:

  • Speaking URLs Out of the Box
  • Search Engine Optimization (SEO)
  • Site Management
  • Major Backend Changes
  • System Maintenance Area
  • Conditional Variants for Form Elements
  • General Data Protection Regulation (GDPR)

bootstrap_package:

  • Bootstrap 4 using scss
  • Cookie consent
  • Content elements
  • Background images for content elements

As a result the distribution needed to be refactored and adapted significantly:

  • Apply latest naming conventions
  • Switch CSS preprocessing from Less to Scss
  • Adapt to content rendering
  • Remove dependency to extensions realurl, dd_googlesitemap, url_forwarding, bootstrap_grids, sr_language_menu, brt_videourlreplace, static_info_tables

Upgrading the distribution from earlier versions (e.g. the PP_8-6 branch) includes the tasks preparation, upgrading and reviewing.

Preparation

  • Consider using the gridelements from the distribution instead of the ones provided by the extension bootstrap_grids. The distribution won’t support the extension bootstrap_grids in the near future any more.
  • Backup the data (files and data base)

Upgrading

Basic upgrade procedure (using Bootstrap 3.x (LESS))

  • If the extension user_customer is present uninstall it and remove the dependencies to extension pizpalue and bootstrap_package in the file typo3conf/ext/user_customer/ext_emconf.php (to avoid recursive calls during installing the extension pizpalue)
  • Uninstall the extension pizpalue
  • Update extension bootstrap_package (10.x.x), vhs, news, ws_flexslider
  • Update extensions gridelements, slickcarousel according TYPO3 version
  • Install the distribution pizpalue (version 9.x.x)
  • Add static templates “Bootstrap Package: Full Package”, “Bootstrap Package: Bootstrap 3.x (LESS)”
  • Add static templates “Pizpalue - Main”, “Pizpalue - Upgrade9”, “Pizpalue - Bootstrap 3.x (LESS)”, “Pizpalue - Gridelements CEs”, “Pizpalue - news”, “Pizpalue - slickcarousel”, “Pizpalue - Gridelements rendering”
  • In case extension user_customer was used add static template “Customer”
  • On the root page (Properties - Resources) include TSConfig “Pizpalue - Content elements”, “Pizpalue - Extension gridelements”, “Pizpalue - Extension news”
  • Delete unused extensions

Note

The correct order for the static templates is:
  1. Bottstrap Package related templates
  2. Extension related templates
  3. Pizpalue related templates starting with “Pizpalue - Main”
  4. Customization related templates (e.g. from user_customer)
  5. Pizpalue - Gridelements rendering

Upgrade bootstrap (using Bootstrap 4.x (SCSS))

Upgrading bootstrap isn’t required. To use bootstrap 4 follow these steps:

Reviewing

Page layouts / Content elements

The bootstrap_package introduced a new way of content rendering allowing content element containers to span the entire page width. Assigning colors and images to the background from the content element container leads to the page being grouped in horizontal sections.

The new way of content rendering had an impact on the page layouts as well as the content elements hence they need to be reviewed.

Social network

The social network feature has been replaced by the one provided by the bootstrap_package. To update the social network embedding follow these steps:

  1. Remove the block mark ###SocialNetwork### in the content element.
  2. Add a “Social Links” content element from the “Social Media” tab.
  3. Configure the content through the constant editor, category “PIZPALUE: CUSTOMER SOCIAL”

Various

  • Review the constants “PIZPALUE” in the constants editor.