Initial commit - Typo3 11.5.41

typo3conf/ext/pw_teaser/Documentation/FirstSteps/Index.rst

@@ -0,0 +1,61 @@
+.. include:: ../Includes.txt
+
+.. _firstSteps:
+
+
+First steps
+===========
+
+Create the first teaser
+-----------------------
+
+Go to any page you want to add a teaser list of pages, and **add a new page teaser plugin**:
+
+.. image:: Images/add-plugin.png
+   :alt: pw_teaser in new content element wizard in TYPO3 backend
+
+On tab "Plugin" you see all settings pw_teaser has:
+
+.. image:: Images/plugin-sheet-general.png
+   :alt: General preferences of pw_teaser plugin
+
+
+Define data source
+------------------
+
+First, we define which pages we want to display. We can choose between those **teaser sources**:
+
+- Childpages of current page
+- Childpages of current page (recursively)
+- Selected pages
+- Childpages of selected pages
+- Childpages of selected pages (recursively)
+
+When you change the source to "selected pages", a new field **Custom pages** appears after reloading:
+
+.. image:: Images/custom-pages.png
+   :alt: Define custom pages when pw_teaser source is "selected pages"
+
+Here you select page(s) from the page tree which should be used as the source for your teaser list.
+
+
+Make further options
+--------------------
+
+In visibility options, you can filter or change the ordering of pages in the result.
+Under tab "Template" you can choose from some template presets.
+
+
+See the teaser in frontend
+--------------------------
+
+**That's it!** Congratulations, you've configured your first page teaser!
+
+In frontend you get a list with pages:
+
+.. image:: Images/default-frontend-output.png
+   :alt: Default frontend output of pw_teaser
+   :width: 50%
+   :class: with-border
+
+Checkout :ref:`templates` for info about how to provide your own templates.