diff --git a/Documentation/Concepts/Backend/PageModule/Index.rst b/Documentation/Concepts/Backend/PageModule/Index.rst index 44a09853..a7f46c52 100644 --- a/Documentation/Concepts/Backend/PageModule/Index.rst +++ b/Documentation/Concepts/Backend/PageModule/Index.rst @@ -1,72 +1,99 @@ +:navigation-title: Page module .. include:: /Includes.rst.txt .. _page-content: -============ -Pages module -============ +============================== +"Page" backend module in TYPO3 +============================== -Site content can be structured in many ways. +The :guilabel:`Web > Page` module is used by the editors of the site to add +and modify content elements on the page. -A good place to start exploring different ways content -can be arranged is the "Content Examples" section. +The Editors Guide, chapter :ref:`Content Elements `, +covers practical topics on how to work with content. -.. rst-class:: bignums +.. contents:: Topics related to the page module -1. Expand the page "Content Examples" +.. _page-layout: - In the backend, click on the arrow next to the "Content Examples" title - to open the subtree. +Page layout / backend layout +============================ - .. include:: /Images/AutomaticScreenshots/PageTree/PageContent1.rst.txt +Within the Page module there can be one or more areas (also called columns) +in which content can be added. The columns to be displayed in the backend +are defined via page TSconfig in a so-called backend layout, sometimes also +called page layout. The site package tutorial describes how page layouts +can be configured and used: :ref:`Page layouts with page +TSconfig `. -2. Next, do the same for the "Text" page, and then click on "Text in Columns" +The topic is also covered in-depth in the TSconfig Reference, +chapter :ref:`Backend layouts `. -3. Use the context menu to show the "Text in Columns" page in the frontend. +.. _page-new-content: - Select :guilabel:`"Show"` +The "New Page Content" wizard +============================= -Let's now compare both views. +.. figure:: /Images/ManualScreenshots/Backend/NewPageContentWizard.png + :alt: Screenshot of a "New page content" wizard in a standard TYPO3 installation -**Frontend:** + The "New page content" wizard -.. figure:: /Images/ManualScreenshots/Frontend/TextInColumnsFrontend.png - :alt: Page content seen from the frontend - :class: with-shadow +When an editor adds a new content element to the page the "New Page Content" +wizard is displayed. Available :ref:`content elements ` and +:ref:`plugins ` are ordered into groups. - Page content as seen in the frontend +You can use the page TSconfig setting +:ref:`mod.wizard.newContentElement.wizardItems ` +to hide or edit content elements displayed here. For example you can hide the +"HTML" content element supplied by :composer:`typo3/cms-fluid-styled-content`: +.. code-block:: typoscript + :ref:`EXT:site_package/Configuration/page.tsconfig` -**Backend:** + mod.wizards.newContentElement.wizardItems { + special.removeItems := addToList(html) + } -For now we want to be in "Columns" mode. If that is not the case when you -got to the Page module, please use the menu in the docheader to switch mode. +.. _page-content-elements: -.. include:: /Images/AutomaticScreenshots/PageModule/TextInColumnsBackend.rst.txt +Content elements +================ -The order of the content elements on the web page is the -same as the order of the elements in the backend. The content elements -are stored in columns, content that is in the right -column in the backend is in the right column on your page, etc. Each -content element on your page can be of a different type (like text or -text & images) giving you a lot of flexibility. +You can use the community extension :composer:`friendsoftypo3/content-blocks` to +define additional content elements. Many third party extensions like +:composer:`bk2k/bootstrap-package` offer pre-defined content elements or, like +:composer:`georgringer/news` :ref:`plugins `. -.. todo: Mention backend_layouts here? +New content elements can also be created without relying on third party +extensions. You need basic knowledge on :ref:`tca`, :ref:`typoscript`, and +:ref:`templating with Fluid `. You have to use PHP for some +basic configurations but need no in-depth knowledge of programming. -The Page module shows a preview of each content element, together -with some action icons. Here is a quick overview: +See :ref:`Create a custom content element type ` -.. include:: /Images/AutomaticScreenshots/PageModule/ContentElementBackend.rst.txt +.. _page-plugins: +Plugins +======= -#. **Insert** a new content element above the current one -#. An **icon** representing the type of content element - (hovering over it will show its id) -#. **Edit** the content element -#. **Hide/show** the content element -#. **Delete** content element -#. A **preview** of the element's content (will vary depending on the type) -#. **Insert** a new content element below the current one +A plugin is a special kind of content element. It typically provides dynamic or +interactive functionality. Many third party extensions offer ready to use +plugins for a wide range of functionality. For example plugins to display news: +:composer:`georgringer/news`, plugins to perform searches: +:composer:`apache-solr-for-typo3/solr`, to display Open Street maps: +:composer:`wsr/myleaflet`, event management with registration: +:composer:`derhansen/sf-event-mgt-contentelements` and many more. +Chapter :ref:`how-to-find-extensions` covers searching for suitable extensions. -Modifying existing content or adding new content is covered in the -:ref:`Editors Tutorial `. +Usually a PHP class called a "controller" manages +the functionality and display of the plugin. To create a custom plugin you +need some experience in PHP programming, dealing with databases etc. + +.. note:: + In TYPO3 a plugin is a special type of content element that can be added to + a page to provide complex functionality. + + Other content management systems like wordpress use the word "plugin" to + describe what we call an :ref:`extension ` in TYPO3. diff --git a/Documentation/Images/AutomaticScreenshots/PageModule/ContentElementBackend.png b/Documentation/Images/AutomaticScreenshots/PageModule/ContentElementBackend.png deleted file mode 100644 index a5fbe9de..00000000 Binary files a/Documentation/Images/AutomaticScreenshots/PageModule/ContentElementBackend.png and /dev/null differ diff --git a/Documentation/Images/AutomaticScreenshots/PageModule/ContentElementBackend.rst.txt b/Documentation/Images/AutomaticScreenshots/PageModule/ContentElementBackend.rst.txt deleted file mode 100644 index a85e50f5..00000000 --- a/Documentation/Images/AutomaticScreenshots/PageModule/ContentElementBackend.rst.txt +++ /dev/null @@ -1,6 +0,0 @@ -.. Automatic screenshot: Remove this line if you want to manually change this file - -.. figure:: /Images/AutomaticScreenshots/PageModule/ContentElementBackend.png - :class: with-shadow - - Content element preview and action icons \ No newline at end of file diff --git a/Documentation/Images/AutomaticScreenshots/PageModule/TextInColumnsBackend.png b/Documentation/Images/AutomaticScreenshots/PageModule/TextInColumnsBackend.png deleted file mode 100644 index fa5b6ad8..00000000 Binary files a/Documentation/Images/AutomaticScreenshots/PageModule/TextInColumnsBackend.png and /dev/null differ diff --git a/Documentation/Images/AutomaticScreenshots/PageModule/TextInColumnsBackend.rst.txt b/Documentation/Images/AutomaticScreenshots/PageModule/TextInColumnsBackend.rst.txt deleted file mode 100644 index 4aa6d5bc..00000000 --- a/Documentation/Images/AutomaticScreenshots/PageModule/TextInColumnsBackend.rst.txt +++ /dev/null @@ -1,6 +0,0 @@ -.. Automatic screenshot: Remove this line if you want to manually change this file - -.. figure:: /Images/AutomaticScreenshots/PageModule/TextInColumnsBackend.png - :class: with-shadow - - Page module in the "columns" mode \ No newline at end of file diff --git a/Documentation/Images/AutomaticScreenshots/PageTree/PageContent1.png b/Documentation/Images/AutomaticScreenshots/PageTree/PageContent1.png deleted file mode 100644 index c3f76370..00000000 Binary files a/Documentation/Images/AutomaticScreenshots/PageTree/PageContent1.png and /dev/null differ diff --git a/Documentation/Images/AutomaticScreenshots/PageTree/PageContent1.rst.txt b/Documentation/Images/AutomaticScreenshots/PageTree/PageContent1.rst.txt deleted file mode 100644 index 4d66d0c7..00000000 --- a/Documentation/Images/AutomaticScreenshots/PageTree/PageContent1.rst.txt +++ /dev/null @@ -1,4 +0,0 @@ -.. Automatic screenshot: Remove this line if you want to manually change this file - -.. figure:: /Images/AutomaticScreenshots/PageTree/PageContent1.png - :class: with-shadow \ No newline at end of file diff --git a/Documentation/Images/ManualScreenshots/Backend/NewPageContentWizard.png b/Documentation/Images/ManualScreenshots/Backend/NewPageContentWizard.png new file mode 100644 index 00000000..d8fb0af9 Binary files /dev/null and b/Documentation/Images/ManualScreenshots/Backend/NewPageContentWizard.png differ diff --git a/Documentation/Images/ManualScreenshots/Frontend/TextInColumnsFrontend.png b/Documentation/Images/ManualScreenshots/Frontend/TextInColumnsFrontend.png deleted file mode 100644 index 59190d38..00000000 Binary files a/Documentation/Images/ManualScreenshots/Frontend/TextInColumnsFrontend.png and /dev/null differ