.. include:: ../Includes.txt


.. _introduction:

============
Introduction
============

Preface
=======

This extension started as a distribution and is now a template serving as a base foundation for new websites.
The former distribution part became to be a new distribution called `pizpalue_distribution` and can be downloaded from
`the TYPO3 extension repository <https://extensions.typo3.org/extension/pizpalue_distribution>`__.

What does it do?
================

The extension builds upon the extension `bootstrap_package from Benjamin Kott <https://extensions.typo3.org/extension/bootstrap_package>`__
and serves as a base template for the creation of websites or
`distributions <https://docs.typo3.org/m/typo3/reference-coreapi/master/en-us/ExtensionArchitecture/CreateNewDistribution/Index.html>`__
using the `bootstrap framework <https://getbootstrap.com/>`__. As an example the distribution
`pizpalue_distribution <https://extensions.typo3.org/extension/pizpalue_distribution>`__ uses this extension. A demo
site can be visited `here <http://pizpalue.buechler.pro/das-plus/>`__.

The extension extends and configures TYPO3 and selected extensions to provide better structured and attracting content
while maintaining or improving speed and seo performance.

It provides the following main features:

Arranging content
-----------------

- Page layouts allowing to add content in side columns with a menu
- Support for structure elements provided by `pp_gridelements <https://extensions.typo3.org/extension/pp_gridelements>`__,
  `flux_elements <https://extensions.typo3.org/extension/flux_elements>`__ or
  `container_elements <https://extensions.typo3.org/extension/container_elements>`__. Example structure elements are:
  columns, accordion, tabs, card and tile unit

Enhancing content
-----------------

- A content element to create modal dialogs
- A content element to create a list of categorized content elements
- A content element to create structured content (JSON-LD data, see :ref:`user-contentElements-schema`)
- A layout for media content elements to emphasize media
- Support for automatic image scaling in structure elements (see :ref:`integration_templating`)
- Content element fields to optimize image scaling dependent on the screen size.
- Content element fields to assign custom classes, styles and attributes

Animating content
-----------------

- Animation effects provided `animate.css <https://github.com/animate-css/animate.css>`__
- Scroll animation effects provided by `Twikito/onscroll-effect <https://github.com/Twikito/onscroll-effect>`__,
  `Josh.js <https://github.com/mamunhpath/josh.js>`__ or `AOS <https://github.com/michalsnik/aos>`__
- A feature to reveal the footer

Extending extensions
--------------------

- A form finisher to send emails to a system
- A teaser and map view from addresses provided by the extension `tt_address <https://extensions.typo3.org/extension/tt_address>`__
- Configurations for the extensions
   - `indexed_search <https://docs.typo3.org/c/typo3/cms-indexed-search/master/en-us/>`__
   - `slickcarousel <https://extensions.typo3.org/extension/slickcarousel>`__
   - `ws_flexslider <https://extensions.typo3.org/extension/ws_flexslider>`__
   - `news <https://extensions.typo3.org/extension/news>`__
   - `eventnews <https://extensions.typo3.org/extension/eventnews>`__
   - `tt_address <https://extensions.typo3.org/extension/tt_address>`__
   - `timelog <https://extensions.typo3.org/extension/timelog>`__

Various
-------

- A menu to be fixed on the side (fastmenu)

Discover more regarding the features on the `demo site <http://pizpalue.buechler.pro/das-plus/>`__.

Screenshots
===========

The following screen shots were taken from a website created with the distribution
`pizpalue_distribution <https://extensions.typo3.org/extension/pizpalue_distribution>`__.

Structure elements
------------------

`See example <https://pizpalue.buechler.pro/das-plus/strukturemente>`__

.. figure:: ../Images/Introduction/StructureElements.jpg
   :width: 500px
   :alt: Page embedding contents covering entire page width

   Page embedding contents covering entire page width

Scroll animation
----------------

`See example <https://pizpalue.buechler.pro/das-plus/inhaltselemente/animation>`__

.. figure:: ../Images/Introduction/ScrollAnimationPage.jpg
   :width: 500px
   :alt: Page embedding scroll animated content

   Page embedding scroll animated content

Modal dialog
------------

See as well `demo site <https://pizpalue.buechler.pro/das-plus/inhaltselemente/modaler-dialog>`__.

.. figure:: ../Images/Introduction/ModalDialog.jpg
   :width: 500px
   :alt: Modal dialog

News
----

`See example <https://pizpalue.buechler.pro/das-plus/news/>`__

.. figure:: ../Images/Introduction/NewsPage.jpg
   :width: 500px
   :alt: Page embedding news

   Page embedding news

News events
-----------

`See example <https://pizpalue.buechler.pro/das-plus/eventnews/>`__

.. figure:: ../Images/Introduction/Eventnews.jpg
   :width: 500px
   :alt: Calendar view from events

   Calendar view from events

Credits
=======

This extension can be provided thanks to outstanding work from TYPO3 community members. A big thanks goes to:

- Benjamin Kott, extension `bootstrap_package <https://extensions.typo3.org/extension/bootstrap_package>`__
- B13 GmbH, extension `container <https://extensions.typo3.org/extension/container>`__
- Grid Elements Team, extension `gridelements <https://extensions.typo3.org/extension/gridelements>`__
- FluidTYPO3 Team, extensions `vhs <https://extensions.typo3.org/extension/vhs>`__,
  `flux <https://extensions.typo3.org/extension/flux>`__
- Georg Ringer, extensions `news <https://extensions.typo3.org/extension/news>`__,
  `eventnews <https://extensions.typo3.org/extension/eventnews>`__
- tt_address Development Team, extension `tt_address <https://extensions.typo3.org/extension/tt_address>`__
- Boris Schauer, extension `slickcarousel <https://extensions.typo3.org/extension/slickcarousel>`__
- Sven Wappler, extension `ws_flexslider <https://extensions.typo3.org/extension/ws_flexslider>`__