[DOC][FEATURE] Content elements based on Fluid 32/41932/15
authorPatrick Broens <patrick@patrickbroens.nl>
Fri, 24 Jul 2015 14:00:44 +0000 (16:00 +0200)
committerWouter Wolters <typo3@wouterwolters.nl>
Mon, 9 Nov 2015 18:03:49 +0000 (19:03 +0100)
Releases: master
Resolves: #68516
Related: #38732
Change-Id: Ic2d655e69d35d70863cc68f48a91e3f3e2df0ec5
Reviewed-on: https://review.typo3.org/41932
Reviewed-by: Martin Bless <m.bless@gmx.de>
Tested-by: Martin Bless <m.bless@gmx.de>
Reviewed-by: Josef Glatz <josef.glatz@typo3.org>
Tested-by: Josef Glatz <josef.glatz@typo3.org>
Reviewed-by: Daniel Goerz <ervaude@gmail.com>
Tested-by: Daniel Goerz <ervaude@gmail.com>
Reviewed-by: Wouter Wolters <typo3@wouterwolters.nl>
Tested-by: Wouter Wolters <typo3@wouterwolters.nl>
71 files changed:
typo3/sysext/fluid_styled_content/Documentation/AddingYourOwnContentElements/Index.rst [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/Configuration/ConstantEditor/Images/CategoryDropdown.png [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/Configuration/ConstantEditor/Images/DropDown.png [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/Configuration/ConstantEditor/Images/RootPage.png [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/Configuration/ConstantEditor/Images/WebTemplate.png [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/Configuration/ConstantEditor/Index.rst [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/Configuration/Index.rst [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/Configuration/OverridingFluidTemplates/Index.rst [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/Configuration/PageTsConfig/Index.rst [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/Configuration/TypoScript/Images/FileStructure.png [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/Configuration/TypoScript/Index.rst [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/ContentElements/Bullets/Images/BackendFieldBodytext.png [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/ContentElements/Bullets/Images/BackendTabAppearance.png [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/ContentElements/Bullets/Images/Frontend.png [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/ContentElements/Bullets/Index.rst [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/ContentElements/Div/Index.rst [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/ContentElements/Header/Images/BackendFields.png [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/ContentElements/Header/Images/Frontend.png [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/ContentElements/Header/Index.rst [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/ContentElements/Html/Images/BackendFieldsHtml.png [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/ContentElements/Html/Index.rst [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/ContentElements/Images/Access.png [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/ContentElements/Images/AppendWithLinkToTopOfPage.png [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/ContentElements/Images/FrontendToTop.png [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/ContentElements/Images/LinkedHeaderAndDate.png [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/ContentElements/Images/PaletteHeader.png [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/ContentElements/Images/ShowInSectionMenus.png [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/ContentElements/Index.rst [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/ContentElements/List/Images/BackendTabPlugin.png [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/ContentElements/List/Index.rst [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/ContentElements/Menu/Images/BackendFieldsMenuAndSitemap.png [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/ContentElements/Menu/Images/Frontend.png [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/ContentElements/Menu/Index.rst [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/ContentElements/Shortcut/Images/BackendFieldsRecords.png [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/ContentElements/Shortcut/Index.rst [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/ContentElements/Table/Images/BackendFieldsTable.png [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/ContentElements/Table/Images/BackendTabAppearance.png [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/ContentElements/Table/Images/Frontend.png [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/ContentElements/Table/Index.rst [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/ContentElements/TextMedia/Images/BackendFieldsRte.png [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/ContentElements/TextMedia/Images/BackendTabAppearance.png [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/ContentElements/TextMedia/Images/BackendTabMedia.png [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/ContentElements/TextMedia/Images/Frontend.png [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/ContentElements/TextMedia/Index.rst [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/ContentElements/Uploads/Images/BackendFieldsFiles.png [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/ContentElements/Uploads/Images/BackendTabAppearance.png [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/ContentElements/Uploads/Images/Frontend.png [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/ContentElements/Uploads/Index.rst [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/FrequentlyAskedQuestions/Index.rst [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/Includes.txt [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/Index.rst [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/Installation/ExtensionManager/Images/Configuration.png [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/Installation/ExtensionManager/Images/ConfigurationButton.png [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/Installation/ExtensionManager/Images/ExtensionManager.png [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/Installation/ExtensionManager/Index.rst [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/Installation/Index.rst [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/Installation/InsertingContentPageTemplate/Index.rst [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/Installation/Upgrading/Images/UpgradeWizard.png [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/Installation/Upgrading/Index.rst [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/Installation/UsingTheRenderingDefinitions/Images/DropDown.png [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/Installation/UsingTheRenderingDefinitions/Images/EditWholeTemplate.png [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/Installation/UsingTheRenderingDefinitions/Images/IncludesBoth.png [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/Installation/UsingTheRenderingDefinitions/Images/IncludesOne.png [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/Installation/UsingTheRenderingDefinitions/Images/RootPage.png [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/Installation/UsingTheRenderingDefinitions/Images/WebTemplate.png [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/Installation/UsingTheRenderingDefinitions/Index.rst [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/Introduction/Index.rst [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/Settings.cfg [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/Settings.yml [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/Sitemap.rst [new file with mode: 0644]
typo3/sysext/fluid_styled_content/Documentation/Targets.rst [new file with mode: 0644]

diff --git a/typo3/sysext/fluid_styled_content/Documentation/AddingYourOwnContentElements/Index.rst b/typo3/sysext/fluid_styled_content/Documentation/AddingYourOwnContentElements/Index.rst
new file mode 100644 (file)
index 0000000..0ec06e6
--- /dev/null
@@ -0,0 +1,318 @@
+.. include:: ../Includes.txt
+
+
+.. _adding-your-own-content-elements:
+
+================================
+Adding your own content elements
+================================
+
+.. note::
+
+   This part is written for developers!
+
+A content element can be based on already available fields in the `tt_content` table,
+or it might be that you need extra fields. This is done the same way as you do for
+your own extensions, extending TCA. Depending on the data in the `tt_content` table,
+you can send the data immediately to the Fluid template or use a data processor in
+front to do some data manipulation. The content elements in the extension "fluid_styled_content"
+are using both as well. A data processor is sometimes used to convert a string (like
+the `bodytext` field in content element "table") to an array, so Fluid does not
+have to deal with this manipulation or transformation.
+
+
+.. _AddingCE-use-an-extension:
+
+Use an extension
+================
+
+Advisable is to make your own extension. In our example we've used the extension key
+`your_extension_key`. If you have plans to publish your extension, do not forget to
+lookup for the availability of your desired key and register it at the
+`"extension keys" page <http://typo3.org/extensions/extension-keys/>`_. login in
+`typo3.org <http://typo3.org//>`_ is required.
+
+Since this part is written for developers, we will not explain in full detail how an
+extension works.
+
+.. _AddingCE-PageTSconfig:
+
+PageTSconfig
+------------
+First we need to add our new content element to the "New Content Element Wizard" and
+define its CType. We call it "yourextensionkey_newcontentelement".
+
+.. code-block:: typoscript
+
+   mod.wizards.newContentElement.wizardItems.common {
+      elements {
+         yourextensionkey_newcontentelement {
+            iconIdentifier = your-icon-identifier
+            title = LLL:EXT:your_extension_key/Resources/Private/Language/Tca.xlf:yourextensionkey_newcontentelement.wizard.title
+            description = LLL:EXT:your_extension_key/Resources/Private/Language/Tca.xlf:yourextensionkey_newcontentelement.wizard.description
+            tt_content_defValues {
+               CType = yourextensionkey_newcontentelement
+            }
+         }
+      }
+      show := addToList(yourextensionkey_newcontentelement)
+   }
+
+
+.. _AddingCE-ext-tables-php:
+
+ext\_tables.php
+---------------
+
+Then we need to add the content element to the "Type" dropdown, where you can select
+the type of content element:
+
+.. code-block:: php
+
+   // Adds the content element to the "Type" dropdown
+   \TYPO3\CMS\Core\Utility\ExtensionManagementUtility::addPlugin(
+      array(
+         'LLL:EXT:your_extension_key/Resources/Private/Language/Tca.xlf:yourextensionkey_newcontentelement',
+         'yourextensionkey_newcontentelement',
+         \TYPO3\CMS\Core\Utility\ExtensionManagementUtility::extRelPath($_EXTKEY)
+            . 'Resources/Public/Icons/ContentElements/yourextensionkey_newcontentelement.gif'
+      ),
+      'CType'
+   );
+
+Then we configure the backend fields for our new content element:
+
+.. code-block:: php
+
+   // Configure the default backend fields for the content element
+   $GLOBALS['TCA']['tt_content']['types']['yourextensionkey_newcontentelement'] = array(
+      'showitem' => '
+            --palette--;LLL:EXT:cms/locallang_ttc.xml:palette.general;general,
+            --palette--;LLL:EXT:cms/locallang_ttc.xml:palette.header;header,
+         --div--;LLL:EXT:cms/locallang_ttc.xml:tabs.appearance,
+            --palette--;LLL:EXT:cms/locallang_ttc.xml:palette.frames;frames,
+         --div--;LLL:EXT:cms/locallang_ttc.xml:tabs.access,
+            --palette--;LLL:EXT:cms/locallang_ttc.xml:palette.visibility;visibility,
+            --palette--;LLL:EXT:cms/locallang_ttc.xml:palette.access;access,
+         --div--;LLL:EXT:cms/locallang_ttc.xml:tabs.extended
+   ');
+
+Since we need to use TypoScript as well, we add an entry in the static template list
+found in sys_templates for static TS:
+
+.. code-block:: php
+
+   // Add an entry in the static template list found in sys_templates for static TS
+   \TYPO3\CMS\Core\Utility\ExtensionManagementUtility::addStaticFile(
+      $_EXTKEY,
+      'Configuration/TypoScript',
+      'Your description'
+   );
+
+
+.. _AddingCE-setup-txt:
+
+setup.txt
+---------
+
+As defined in `ext_tables.php`, this file is in the directory `Configuration/TypoScript`
+of our own extension. You can have two options in the TypoScript:
+
+- Send all the data from the tt\_content table for this particular content element
+  directly to a Fluid template
+
+  .. code-block:: typoscript
+
+     tt_content {
+        yourextensionkey_newcontentelement < lib.fluidContent
+        yourextensionkey_newcontentelement {
+           templateName = NewContentElement.html
+        }
+     }
+
+- Or use data processors in front of the view to do some data manipulation or other stuff
+  you would like to do before sending everything to the view. First tell the FLUIDTEMPLATE
+  content object what the name of the template is by using the parameter `templateName`,
+  then add the full class name for the data processor. You can send your own parameters
+  to the processor as well:
+
+.. code-block:: typoscript
+
+   tt_content {
+      yourextensionkey_newcontentelement < lib.fluidContent
+      yourextensionkey_newcontentelement {
+         templateName = NewContentElement.html
+         dataProcessing {
+            1 = Vendor\YourExtensionKey\DataProcessing\NewContentElementProcessor
+            1 {
+               useHere = theConfigurationOfTheDataProcessor
+            }
+         }
+      }
+   }
+
+You need to add the templateRootPath to your own extension as well, and if you are using
+it, partialRootPaths and layoutRootPaths:
+
+.. code-block:: typoscript
+
+   lib.fluidContent {
+      templateRootPaths {
+         200 = EXT:your_extension_key/Resources/Private/Templates/
+      }
+   }
+
+
+.. _AddingCE-Data-Processor:
+
+Data Processor
+--------------
+
+In our :ref:`AddingCE-setup-txt` example above, we put the data processor in the directory
+:file:`Classes/DataProcessing`. The file :file:`NewContentElementProcessor.php` could
+look like:
+
+.. code-block:: php
+
+   <?php
+   namespace Vendor\YourExtensionKey\DataProcessing;
+
+   /*
+    * This file is part of the TYPO3 CMS project.
+    *
+    * It is free software; you can redistribute it and/or modify it under
+    * the terms of the GNU General Public License, either version 2
+    * of the License, or any later version.
+    *
+    * For the full copyright and license information, please read the
+    * LICENSE.txt file that was distributed with this source code.
+    *
+    * The TYPO3 project - inspiring people to share!
+    */
+
+   use TYPO3\CMS\Frontend\ContentObject\ContentObjectRenderer;
+   use TYPO3\CMS\Frontend\ContentObject\DataProcessorInterface;
+
+   /**
+    * Class for data processing for the content element "My new content element"
+    */
+   class NewContentElementProcessor implements DataProcessorInterface
+   {
+
+      /**
+       * Process data for the content element "My new content element"
+       *
+       * @param ContentObjectRenderer $cObj The data of the content element or page
+       * @param array $contentObjectConfiguration The configuration of Content Object
+       * @param array $processorConfiguration The configuration of this processor
+       * @param array $processedData Key/value store of processed data (e.g. to be passed to a Fluid View)
+       * @return array the processed data as key/value store
+       */
+      public function process(
+         ContentObjectRenderer $cObj,
+         array $contentObjectConfiguration,
+         array $processorConfiguration,
+         array $processedData
+      )
+      {
+         $processedData['foo'] = 'This variable will be passed to Fluid';
+
+         return $processedData;
+      }
+   }
+
+
+.. _AddingCE-ext-localconf-php:
+
+ext\_localconf.php
+------------------
+
+If you want to generate a special preview in the backend "Web > Page" module, you can use
+a hook for this:
+
+.. code-block:: php
+
+   // Register for hook to show preview of tt_content element of CType="yourextensionkey_newcontentelement" in page module
+   $GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['cms/layout/class.tx_cms_layout.php']['tt_content_drawItem']['yourextensionkey_newcontentelement'] =
+      \Vendor\YourExtensionKey\Hooks\PageLayoutView\NewContentElementPreviewRenderer::class;
+
+
+.. _AddingCE-Content-Element-Preview-Renderer:
+
+Content Element Preview Renderer
+--------------------------------
+
+The preview renderer :file:`NewContentElementPreviewRenderer.php`, for the backend, has
+been put in the directory :file:`Classes/Hooks/PageLayoutView` and could look like this:
+
+.. code-block:: php
+
+   <?php
+   namespace Vendor\YourExtensionKey\Hooks\PageLayoutView;
+
+   /*
+    * This file is part of the TYPO3 CMS project.
+    *
+    * It is free software; you can redistribute it and/or modify it under
+    * the terms of the GNU General Public License, either version 2
+    * of the License, or any later version.
+    *
+    * For the full copyright and license information, please read the
+    * LICENSE.txt file that was distributed with this source code.
+    *
+    * The TYPO3 project - inspiring people to share!
+    */
+
+   use \TYPO3\CMS\Backend\View\PageLayoutViewDrawItemHookInterface;
+   use \TYPO3\CMS\Backend\View\PageLayoutView;
+
+   /**
+    * Contains a preview rendering for the page module of CType="yourextensionkey_newcontentelement"
+    */
+   class NewContentElementPreviewRenderer implements PageLayoutViewDrawItemHookInterface
+   {
+
+      /**
+       * Preprocesses the preview rendering of a content element of type "My new content element"
+       *
+       * @param \TYPO3\CMS\Backend\View\PageLayoutView $parentObject Calling parent object
+       * @param bool $drawItem Whether to draw the item using the default functionality
+       * @param string $headerContent Header content
+       * @param string $itemContent Item content
+       * @param array $row Record row of tt_content
+       *
+       * @return void
+       */
+      public function preProcess(
+         PageLayoutView &$parentObject,
+         &$drawItem,
+         &$headerContent,
+         &$itemContent,
+         array &$row
+      )
+      {
+         if ($row['CType'] === 'yourextensionkey_newcontentelement') {
+            $itemContent .= '<p>We can change our preview here!</p>';
+
+            $drawItem = false;
+         }
+      }
+   }
+
+
+.. _AddingCE-fluid-templates:
+
+Fluid templates
+---------------
+
+For the final rendering you need a Fluid template. This template will be located at the
+directory and file name which you have entered in :ref:`AddingCE-setup-txt` using the parameter
+`templateName`.
+
+Just to show the variable foo, like we defined at :ref:`AddingCE-data-processor`,
+we can use the following markup:
+
+.. code-block:: html
+
+   <h1>{foo}</h1>
+
diff --git a/typo3/sysext/fluid_styled_content/Documentation/Configuration/ConstantEditor/Images/CategoryDropdown.png b/typo3/sysext/fluid_styled_content/Documentation/Configuration/ConstantEditor/Images/CategoryDropdown.png
new file mode 100644 (file)
index 0000000..8057492
Binary files /dev/null and b/typo3/sysext/fluid_styled_content/Documentation/Configuration/ConstantEditor/Images/CategoryDropdown.png differ
diff --git a/typo3/sysext/fluid_styled_content/Documentation/Configuration/ConstantEditor/Images/DropDown.png b/typo3/sysext/fluid_styled_content/Documentation/Configuration/ConstantEditor/Images/DropDown.png
new file mode 100644 (file)
index 0000000..1bc939c
Binary files /dev/null and b/typo3/sysext/fluid_styled_content/Documentation/Configuration/ConstantEditor/Images/DropDown.png differ
diff --git a/typo3/sysext/fluid_styled_content/Documentation/Configuration/ConstantEditor/Images/RootPage.png b/typo3/sysext/fluid_styled_content/Documentation/Configuration/ConstantEditor/Images/RootPage.png
new file mode 100644 (file)
index 0000000..f924e0c
Binary files /dev/null and b/typo3/sysext/fluid_styled_content/Documentation/Configuration/ConstantEditor/Images/RootPage.png differ
diff --git a/typo3/sysext/fluid_styled_content/Documentation/Configuration/ConstantEditor/Images/WebTemplate.png b/typo3/sysext/fluid_styled_content/Documentation/Configuration/ConstantEditor/Images/WebTemplate.png
new file mode 100644 (file)
index 0000000..0942972
Binary files /dev/null and b/typo3/sysext/fluid_styled_content/Documentation/Configuration/ConstantEditor/Images/WebTemplate.png differ
diff --git a/typo3/sysext/fluid_styled_content/Documentation/Configuration/ConstantEditor/Index.rst b/typo3/sysext/fluid_styled_content/Documentation/Configuration/ConstantEditor/Index.rst
new file mode 100644 (file)
index 0000000..517827f
--- /dev/null
@@ -0,0 +1,47 @@
+.. include:: ../../Includes.txt
+
+
+.. _constant-editor:
+
+===============
+Constant Editor
+===============
+
+The Constant Editor can be found in the module "Web > Template".
+
+.. figure:: Images/WebTemplate.png
+   :alt: Location of the Template module
+
+   Web > Template
+
+Select the page in the page tree which contains the root template of your website. This is
+mostly the root page of your website as well.
+
+.. figure:: Images/RootPage.png
+   :alt: Location of the Root Page in the page tree
+
+   The Root Page in the page tree
+
+Select "Constant Editor" in the dropdown at the top of the "Web > Template" module. This
+should show the root template of your website if it is available below the sentence
+"Edit constants for template".
+
+.. figure:: Images/DropDown.png
+   :alt: Location of the dropdown in the Template module
+
+   The dropdown in the template module
+
+In the dropdown list "Category" select the category "Content".
+
+.. figure:: Images/CategoryDropdown.png
+   :alt: Location of the category dropdown in the Template module
+
+   The category dropdown in the template module
+
+This will give you a list with all the constants of this extension. All constants are
+described and can be edited by clicking the pencil in front of the current value or by
+editing the available field.
+
+Don't forget to save the new values afterwards by using the appropriate button at the top
+of the module. The new values will be stored in the "Constants" field of the root template
+of your website.
diff --git a/typo3/sysext/fluid_styled_content/Documentation/Configuration/Index.rst b/typo3/sysext/fluid_styled_content/Documentation/Configuration/Index.rst
new file mode 100644 (file)
index 0000000..40e8507
--- /dev/null
@@ -0,0 +1,32 @@
+.. include:: ../Includes.txt
+
+.. _configuration:
+
+=============
+Configuration
+=============
+
+Configuring content elements can be done for the frontend and for the backend.
+
+The easiest way to change the appearance of content elements in the frontend is by using
+the "Constant Editor". These settings are global, which means they are not configurable in
+a single content element. Constants are predefined.
+
+TYPO3 CMS is using TypoScript as a configuration language and is used by the frontend
+rendering. By overriding TypoScript you can influence the rendering of most of the
+frontend.
+
+For the backend, fields can be shown or hidden, depending on the fields you are using or
+the fields an editor is allowed to use. Configuration like this is done using
+"Page TSconfig" or "User TSconfig".
+
+.. toctree::
+   :maxdepth: 5
+   :titlesonly:
+   :glob:
+
+   ConstantEditor/Index
+   TypoScript/Index
+   PageTsConfig/Index
+   OverridingFluidTemplates/Index
+
diff --git a/typo3/sysext/fluid_styled_content/Documentation/Configuration/OverridingFluidTemplates/Index.rst b/typo3/sysext/fluid_styled_content/Documentation/Configuration/OverridingFluidTemplates/Index.rst
new file mode 100644 (file)
index 0000000..8f0d586
--- /dev/null
@@ -0,0 +1,48 @@
+.. include:: ../../Includes.txt
+
+.. _overriding-fluid-templates:
+
+==============================
+Overriding the FLUID templates
+==============================
+
+At :ref:`typoscript` we have described the way content elements are rendered.
+
+By default these settings are done in the file :file:`setup.txt` which can be found in the
+folder :file:`EXT:fluid_styled_content/Configuration/TypoScript/Static/`.
+
+
+.. _overriding-fluid-templates-using-lib-fluidcontent:
+
+Using lib.fluidContent
+======================
+
+This option gives you the possibility to add another `templateRootPath` and can be defined
+the same as `partialRootPaths` and `layoutRootPaths`:
+
+.. code-block:: typoscript
+
+   lib.fluidContent {
+      templateRootPaths {
+         200 = EXT:your_extension_key/Resources/Private/Templates/
+      }
+      partialRootPaths {
+         200 = EXT:your_extension_key/Resources/Private/Partials/
+      }
+      layoutRootPaths {
+         200 = EXT:your_extension_key/Resources/Private/Layouts/
+      }
+   }
+
+A content element is using a `templateName`, which is defined in :file:`setup.txt`. You
+can override this value, but the template from the extension "fluid_styled_content" will
+not be loaded then, since its name is still the default value.
+
+.. code-block:: typoscript
+
+   tt_content {
+      bullets {
+         templateName = ChangedName.html
+      }
+   }
+
diff --git a/typo3/sysext/fluid_styled_content/Documentation/Configuration/PageTsConfig/Index.rst b/typo3/sysext/fluid_styled_content/Documentation/Configuration/PageTsConfig/Index.rst
new file mode 100644 (file)
index 0000000..2656b60
--- /dev/null
@@ -0,0 +1,11 @@
+.. include:: ../../Includes.txt
+
+.. _page-ts-config:
+
+=============
+Page TSconfig
+=============
+
+Page TSconfig can be found in the directory
+:file:`EXT:fluid_styled_content/Configuration/PageTSconfig/`. The file :file:`NewContentElementWizard.ts`
+is included. It contains the configuration of the "New Content Element Wizard".
diff --git a/typo3/sysext/fluid_styled_content/Documentation/Configuration/TypoScript/Images/FileStructure.png b/typo3/sysext/fluid_styled_content/Documentation/Configuration/TypoScript/Images/FileStructure.png
new file mode 100644 (file)
index 0000000..39d43b3
Binary files /dev/null and b/typo3/sysext/fluid_styled_content/Documentation/Configuration/TypoScript/Images/FileStructure.png differ
diff --git a/typo3/sysext/fluid_styled_content/Documentation/Configuration/TypoScript/Index.rst b/typo3/sysext/fluid_styled_content/Documentation/Configuration/TypoScript/Index.rst
new file mode 100644 (file)
index 0000000..fe3565e
--- /dev/null
@@ -0,0 +1,49 @@
+.. include:: ../../Includes.txt
+
+.. _typoscript:
+
+==========
+TypoScript
+==========
+
+At the section :ref:`using-the-rendering-definitions` you've already added the static
+templates. Static templates are a collection of TypoScript files. These files are located
+in the directory :file:`EXT:fluid_styled_content/Configuration/TypoScript/Static/`.
+
+.. figure:: Images/FileStructure.png
+   :alt: Structure of the TypoScript files
+
+   Structure of the TypoScript files
+
+In this folder there are two files:
+
+- :file:`constants.txt` - The file with the default constants. The "Constant Editor", as
+  described above, is using this file for its default settings.
+
+- :file:`setup.txt` - This file will first include some other files which are located in
+  the "Setup" folder in the same directory. More about these files later. Secondly the
+  rendering definitions of all the content elements, which belong to this extension, are
+  declared. Since we move away from TypoScript as much as possible, these rendering
+  definitions only declare the following:
+
+  - Can FLUIDTEMPLATE be used immediately or do we need data processing first?
+    A processor is sometimes used to do some data manipulation before all the data is sent
+    to the Fluid template.
+
+  - Assigning the Fluid template file for each type of content element separately.
+
+  - The configuration of the edit panel and the edit buttons for frontend editing. You
+    need to activate the extension "Frontend Editing (feedit)" in the Extension Manager to
+    see this in action.
+
+In the folder :file:`Setup` there are files which are included by the file
+:file:`setup.txt` as mentioned above. These are:
+
+- :file:`lib.parseFunc.ts` - Creates persistent ParseFunc setup for non-HTML content
+
+- :file:`lib.stdheader.ts` - Copies the "Header only" content element into the `lib.stdheader`.
+
+- :file:`styles.content.get.ts` - Defines `styles.content.get` as a `CONTENT` object for `colPos = 0`.
+
+- :file:`lib.fluidContent.ts` - Default configuration for content elements using
+  FLUIDTEMPLATE
diff --git a/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Bullets/Images/BackendFieldBodytext.png b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Bullets/Images/BackendFieldBodytext.png
new file mode 100644 (file)
index 0000000..593dbd6
Binary files /dev/null and b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Bullets/Images/BackendFieldBodytext.png differ
diff --git a/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Bullets/Images/BackendTabAppearance.png b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Bullets/Images/BackendTabAppearance.png
new file mode 100644 (file)
index 0000000..e0c8ec3
Binary files /dev/null and b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Bullets/Images/BackendTabAppearance.png differ
diff --git a/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Bullets/Images/Frontend.png b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Bullets/Images/Frontend.png
new file mode 100644 (file)
index 0000000..8eb91cc
Binary files /dev/null and b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Bullets/Images/Frontend.png differ
diff --git a/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Bullets/Index.rst b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Bullets/Index.rst
new file mode 100644 (file)
index 0000000..a967536
--- /dev/null
@@ -0,0 +1,45 @@
+.. include:: ../../Includes.txt
+
+.. _content-element-bullets:
+
+===========
+Bullet list
+===========
+
+.. figure:: Images/BackendFieldBodytext.png
+   :alt: Backend display of the field for the Bullet list in the General tab
+
+   The field "Bullet list" in the "General" tab
+
+With this content element you can provide unordered and ordered bullet lists, but also a
+definition list, in the frontend.
+
+The content is added in the field "Bullet list", where each new line is a new bullet.
+
+.. code-block:: none
+
+   Bullet 1
+   Bullet 2
+   Bullet 3
+
+For definition lists you use one line for a single definition which starts with the term,
+followed by the description, separated by a vertical bar "|".
+
+.. code-block:: none
+
+   Term 1|Description 1
+   Term 2|Description 2
+   Term 3|Description 3
+
+.. figure:: Images/BackendTabAppearance.png
+   :alt: Backend display of the Appearance tab
+
+   The "Appearance" tab
+
+The type of list can be defined with the field "Type of bullets", available in the
+"Appearance" tab.
+
+.. figure:: Images/Frontend.png
+   :alt: Frontend rendering of the content element Bullet list
+
+   Frontend output, showing all three types of bullet lists.
diff --git a/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Div/Index.rst b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Div/Index.rst
new file mode 100644 (file)
index 0000000..982c37f
--- /dev/null
@@ -0,0 +1,10 @@
+.. include:: ../../Includes.txt
+
+
+.. _content-element-div:
+
+=======
+Divider
+=======
+
+Nothing more than a horizontal rule.
diff --git a/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Header/Images/BackendFields.png b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Header/Images/BackendFields.png
new file mode 100644 (file)
index 0000000..eef5f3b
Binary files /dev/null and b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Header/Images/BackendFields.png differ
diff --git a/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Header/Images/Frontend.png b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Header/Images/Frontend.png
new file mode 100644 (file)
index 0000000..bae260e
Binary files /dev/null and b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Header/Images/Frontend.png differ
diff --git a/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Header/Index.rst b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Header/Index.rst
new file mode 100644 (file)
index 0000000..0f9c173
--- /dev/null
@@ -0,0 +1,23 @@
+.. include:: ../../Includes.txt
+
+.. _content-element-header:
+
+======
+Header
+======
+
+.. figure:: Images/BackendFields.png
+   :alt: Backend display of the fields to configure the content element Header
+
+   The backend fields
+
+The content element "Header" will render a header, which can be linked. There is the
+possibility to add a subheader and a date. The fields used for this content elements are
+the same as :ref:`content-elements-general-header`, but with a field for the subheader.
+
+.. figure:: Images/Frontend.png
+   :alt: Frontend rendering of the content element header, with a subheader and date
+         grouped together
+
+   Frontend rendering of the content element header, with a subheader and date
+
diff --git a/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Html/Images/BackendFieldsHtml.png b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Html/Images/BackendFieldsHtml.png
new file mode 100644 (file)
index 0000000..a88d516
Binary files /dev/null and b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Html/Images/BackendFieldsHtml.png differ
diff --git a/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Html/Index.rst b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Html/Index.rst
new file mode 100644 (file)
index 0000000..dcd3031
--- /dev/null
@@ -0,0 +1,15 @@
+.. include:: ../../Includes.txt
+
+.. _content-element-html:
+
+====
+HTML
+====
+
+.. figure:: Images/BackendFieldsHtml.png
+   :alt: Backend display of the fields for the HTML content element in the General tab
+
+   The fields for "HTML" in the "General" tab.
+
+Insert HTML directly using this content element.
+
diff --git a/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Images/Access.png b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Images/Access.png
new file mode 100644 (file)
index 0000000..7e68418
Binary files /dev/null and b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Images/Access.png differ
diff --git a/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Images/AppendWithLinkToTopOfPage.png b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Images/AppendWithLinkToTopOfPage.png
new file mode 100644 (file)
index 0000000..aee6cd5
Binary files /dev/null and b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Images/AppendWithLinkToTopOfPage.png differ
diff --git a/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Images/FrontendToTop.png b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Images/FrontendToTop.png
new file mode 100644 (file)
index 0000000..32f56fe
Binary files /dev/null and b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Images/FrontendToTop.png differ
diff --git a/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Images/LinkedHeaderAndDate.png b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Images/LinkedHeaderAndDate.png
new file mode 100644 (file)
index 0000000..cad40b9
Binary files /dev/null and b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Images/LinkedHeaderAndDate.png differ
diff --git a/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Images/PaletteHeader.png b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Images/PaletteHeader.png
new file mode 100644 (file)
index 0000000..c337218
Binary files /dev/null and b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Images/PaletteHeader.png differ
diff --git a/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Images/ShowInSectionMenus.png b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Images/ShowInSectionMenus.png
new file mode 100644 (file)
index 0000000..0f646f0
Binary files /dev/null and b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Images/ShowInSectionMenus.png differ
diff --git a/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Index.rst b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Index.rst
new file mode 100644 (file)
index 0000000..11822b1
--- /dev/null
@@ -0,0 +1,142 @@
+.. include:: ../Includes.txt
+
+.. _content-elements:
+
+====================
+The content elements
+====================
+
+This chapter will describe the basic set of content elements provided by the TYPO3 CMS
+core. It will show you a description, screenshots of the backend fields and a screenshot
+of the frontend rendering, only styled with the basic styling provided by the static
+template "Content Elements CSS (optional) (fluid_styled_content)" described in chapter
+:ref:`using-the-rendering-definitions`.
+
+The screenshots of the fields are made with the extension configuration option
+"Show only a minimum set of editing fields" SET TO OFF as described in chapter
+:ref:`extension-manager-configuration`.
+
+
+.. _content-elements-general:
+
+General fields
+==============
+
+These are fields which are used by (almost) every content element.
+
+
+.. _content-elements-general-header:
+
+Header
+------
+
+.. figure:: Images/PaletteHeader.png
+   :alt: The header fields in the backend
+
+   The header fields
+
+Almost every content element can contain a header, which consists of the following parts:
+
+Header
+   The text of the header
+
+Type
+   The type of heading (heading 1, heading 2, heading 3 ... or if the header is hidden).
+   When not choosing an option, the default heading will be used, which can be configured
+   at :ref:`constant-editor`.
+
+Date
+   Have the possibility to group the header with a date
+
+Link
+   Link wrapping the header text. This can be a TYPO3 CMS page, an external page, an email
+   address or a link to a file.
+
+The header fields can be found in the "General" tab of a content element.
+
+.. figure:: Images/LinkedHeaderAndDate.png
+   :alt: Frontend rendering of a linked header with a date
+
+   Frontend rendering of a linked header with a date
+
+
+.. _content-elements-general-show-in-section-menus:
+
+Show in section menu's
+----------------------
+
+Using this option will only be visible when using menu's based on sections. This will be
+described in the chapter :ref:`content-element-menu`.
+
+This field can be found in the *Appearance* tab.
+
+.. figure:: Images/ShowInSectionMenus.png
+   :alt: Backend display of the field to show the content element in section menu's
+
+   The field "Show In Section Menu's"
+
+
+.. _content-elements-general-link-to-top:
+
+Append with Link to Top of Page
+-------------------------------
+
+.. figure:: Images/AppendWithLinkToTopOfPage.png
+   :alt: Backend display of the field to show a link to the top of the page
+
+   The field "Append with link to top of page"
+
+When checked, this will render a link below the content element to bring the visitor the
+top of the page. This will be very convenient for your visitors when having long pages.
+
+.. figure:: Images/FrontendToTop.png
+   :alt: Frontend rendering of the To Top link
+
+   Frontend rendering of the To Top link
+
+
+.. _content-elements-general-access:
+
+Access
+------
+
+.. figure:: Images/Access.png
+   :alt: Backend display of the Access tab
+
+   The Access tab with all its fields
+
+These fields define if and when a visitor has access to this content element. The access
+fields all reside in the *Access* tab:
+
+Visibility of content element
+   By checking this option the content element will not be visible to any visitor.
+
+Publish Date
+   The date on which the content has to be published, which means making visible at a
+   certain date.
+
+Expiration Date
+   The date on which the content will be expired, which means the content will be hidden
+   on a certain date
+
+Usergroup Access Rights
+   Here you can select whether the content element only is available to a certain
+   frontend user group, if it has to be visible only when the visitor is logged in or if
+   it has to be hidden at a login.
+
+.. toctree::
+   :maxdepth: 5
+   :titlesonly:
+   :glob:
+
+   Header/Index
+   TextMedia/Index
+   Bullets/Index
+   Table/Index
+   Uploads/Index
+   Menu/Index
+   Shortcut/Index
+   List/Index
+   Div/Index
+   Html/Index
+
diff --git a/typo3/sysext/fluid_styled_content/Documentation/ContentElements/List/Images/BackendTabPlugin.png b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/List/Images/BackendTabPlugin.png
new file mode 100644 (file)
index 0000000..3ce5a7e
Binary files /dev/null and b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/List/Images/BackendTabPlugin.png differ
diff --git a/typo3/sysext/fluid_styled_content/Documentation/ContentElements/List/Index.rst b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/List/Index.rst
new file mode 100644 (file)
index 0000000..4d54a67
--- /dev/null
@@ -0,0 +1,19 @@
+.. include:: ../../Includes.txt
+
+.. _content-element-list:
+
+=============
+Insert plugin
+=============
+
+.. figure:: Images/BackendTabPlugin.png
+   :alt: Backend display of the fields for the Insert Plugin content element in the
+         Plugin tab
+
+   The fields for "Insert Plugin" in the "Plugin" tab. This can be different for selected
+   plugins.
+
+Extensions sometimes provide plugins to render frontend output, but basically they are the
+same as content elements. When an extension depends on a plugin, select the plugin in this
+content element. The fields might change depending on the plugin.
+
diff --git a/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Menu/Images/BackendFieldsMenuAndSitemap.png b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Menu/Images/BackendFieldsMenuAndSitemap.png
new file mode 100644 (file)
index 0000000..72ca07b
Binary files /dev/null and b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Menu/Images/BackendFieldsMenuAndSitemap.png differ
diff --git a/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Menu/Images/Frontend.png b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Menu/Images/Frontend.png
new file mode 100644 (file)
index 0000000..f52fc39
Binary files /dev/null and b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Menu/Images/Frontend.png differ
diff --git a/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Menu/Index.rst b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Menu/Index.rst
new file mode 100644 (file)
index 0000000..0635824
--- /dev/null
@@ -0,0 +1,75 @@
+.. include:: ../../Includes.txt
+
+.. _content-element-menu:
+
+=============
+Special menus
+=============
+
+In websites menus are often created outside the content element scope, because they have
+to reappear within every page. These could be the main menu, a sub menu, a bread crumb or
+a language menu. However, there are situations where you would like to create a menu
+specifically on one page. This content element will give you some options to render a
+menu. These options are:
+
+Menu of selected pages
+   The menu consists of links to the selected pages in the TYPO3 CMS backend.
+
+Menu of subpages of selected pages
+   The menu consists of links to the subpages of the selected pages in the TYPO3 CMS
+   backend.
+
+Menu of subpages of selected pages including abstracts
+   The same as above, but showing the abstract of these pages as well, when not empty.
+
+Menu of subpages of selected pages including sections
+   This will render a menu of the subpages of the selected pages. Below each subpage an
+   extra menu will be showing the titles of content elements which belong to that certain
+   subpage, which have the option "Show in Section Menus" in the Appearance tab enabled.
+   This makes it possible for the website visitor to jump to the selected content element,
+   within that page, immediately.
+
+Sitemap
+   Render a full sitemap of the website, starting at the root page.
+
+Sitemaps of selected pages
+   Render one or more sitemaps at once. The starting point of each site map will be a
+   single selected page.
+
+Section index (page content marked for section menus)
+   Menu of content elements within the selected page, which have the option "Show in
+   Section Menus" in the Appearance tab enabled. This makes it possible for the website
+   visitor to jump to the selected content element, within that page, immediately.
+
+Recently updated pages
+   Shows a list of pages which are updated in the last 7 days. Updated does only mean a
+   change in the page properties, not the content on the page.
+
+Related pages (based on keywords)
+   Shows a list of the selected page and all other pages, which have one or more keywords,
+   entered in the page properties, in common.
+
+Pages for selected categories
+   Displays a menu of all pages which have been assigned one or more of the selected
+   categories.
+
+Content elements for selected categories
+   Displays a menu of all content elements which have been assigned one or more of the
+   selected categories.
+
+The availability of links in each type of menu will depend on access rights. If a website
+visitor has no access to a certain part (with a frontend login), the link will not be
+shown.
+
+.. figure:: Images/BackendFieldsMenuAndSitemap.png
+   :alt: Backend display of the fields for the Menu in the General tab
+
+   The fields for "Menu and Sitemap" in the "General" tab
+
+In case no pages are selected (in most options), the menu will be rendered from the
+current page where the menu is put on.
+
+.. figure:: Images/Frontend.png
+   :alt: Frontend example of a menu with type 'Menu of subpages of selected pages including sections'
+
+   Example of the frontend output of a menu
diff --git a/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Shortcut/Images/BackendFieldsRecords.png b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Shortcut/Images/BackendFieldsRecords.png
new file mode 100644 (file)
index 0000000..0bc4f1d
Binary files /dev/null and b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Shortcut/Images/BackendFieldsRecords.png differ
diff --git a/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Shortcut/Index.rst b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Shortcut/Index.rst
new file mode 100644 (file)
index 0000000..2a696f2
--- /dev/null
@@ -0,0 +1,30 @@
+.. include:: ../../Includes.txt
+
+.. _content-element-shortcut:
+
+==============
+Insert Records
+==============
+
+Ever have content on one page that you want on another one? But you don't want to have to
+maintain both, keeping them in sync? And you don't want to show the whole content from one
+page on another. Using insert records you can add one content element from a page or all
+the content elements from a page. You can also add content element from several pages.
+
+.. figure:: Images/BackendFieldsRecords.png
+   :alt: Backend display of the fields for the Insert Records content element in the General tab
+
+   The fields for "Insert Records" in the "General" tab
+
+Just select the content elements you want to display and if necessary, put them in the
+right order.
+
+In the frontend the referenced content elements will show up the same as the original one
+(if the styling is not different for that page)
+
+.. note::
+
+   This is the only content element still using a bit of TypoScript in the rendering
+   process. This is done because you can add different rendering for records from
+   different tables. Take a look at :ts:`tt_content.shortcut.20`.
+
diff --git a/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Table/Images/BackendFieldsTable.png b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Table/Images/BackendFieldsTable.png
new file mode 100644 (file)
index 0000000..27f58f8
Binary files /dev/null and b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Table/Images/BackendFieldsTable.png differ
diff --git a/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Table/Images/BackendTabAppearance.png b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Table/Images/BackendTabAppearance.png
new file mode 100644 (file)
index 0000000..59c396e
Binary files /dev/null and b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Table/Images/BackendTabAppearance.png differ
diff --git a/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Table/Images/Frontend.png b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Table/Images/Frontend.png
new file mode 100644 (file)
index 0000000..8be46aa
Binary files /dev/null and b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Table/Images/Frontend.png differ
diff --git a/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Table/Index.rst b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Table/Index.rst
new file mode 100644 (file)
index 0000000..3653862
--- /dev/null
@@ -0,0 +1,58 @@
+.. include:: ../../Includes.txt
+
+.. _content-element-table:
+
+=====
+Table
+=====
+
+The "Table" content element allows to provide data as "comma separated values (CSV)", a
+plain text form of storing tabular data (numbers and text). This form is often used to
+move tabular data between two programs that natively operate on incompatible (often
+proprietary and/or undocumented) formats, like Microsoft Office Excel. These programs
+often provide CSV as an export method.
+
+.. figure:: Images/BackendFieldsTable.png
+   :alt: Backend display of the fields for the Table in the General tab
+
+   The "General" table settings
+
+Each line in the field *Table content* represents a row in the table. Columns are
+separated by a *field delimiter*, which can be configured with the corresponding field.
+Columns can be enclosed by a character, configured in the field
+*Text enclosure*. This is especially helpful when you want to have newlines within a
+column. By default the *Field delimiter* is a vertical bar "|", the *Text enclosure* set
+to **none**.
+
+.. code-block:: none
+
+   row 1 column 1|row 1 column 2|row 1 column 3
+   row 2 column 1|row 2 column 2|row 2 column 3
+   row 3 column 1|row 3 column 2|row 3 column 3
+
+A *Table caption* can be provided as a heading for the table.
+
+.. figure:: Images/BackendTabAppearance.png
+   :alt: Backend display of the Appearance tab
+
+   The "Appearance" tab
+
+Also some appearance options are available for the table. These can be found in the
+*Appearance* tab:
+
+Columns
+   The maximum amount of columns. Even when more columns are defined in the
+   *Table content* field, the table will only show the maximum amount of columns.
+
+Table header position
+   The first row or the first column can be used as a table header.
+
+Use table footer
+   The last row will be used to group the table’s footer area (which may be a summary, an
+   addition of column values, or some call to action based on the preceding content).
+
+.. figure:: Images/Frontend.png
+   :alt: Frontend rendering of two tables, one with a header position on top, the other one on the left
+
+   Frontend output, showing the different options of "Table header position"
+
diff --git a/typo3/sysext/fluid_styled_content/Documentation/ContentElements/TextMedia/Images/BackendFieldsRte.png b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/TextMedia/Images/BackendFieldsRte.png
new file mode 100644 (file)
index 0000000..e29e6af
Binary files /dev/null and b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/TextMedia/Images/BackendFieldsRte.png differ
diff --git a/typo3/sysext/fluid_styled_content/Documentation/ContentElements/TextMedia/Images/BackendTabAppearance.png b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/TextMedia/Images/BackendTabAppearance.png
new file mode 100644 (file)
index 0000000..87141a2
Binary files /dev/null and b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/TextMedia/Images/BackendTabAppearance.png differ
diff --git a/typo3/sysext/fluid_styled_content/Documentation/ContentElements/TextMedia/Images/BackendTabMedia.png b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/TextMedia/Images/BackendTabMedia.png
new file mode 100644 (file)
index 0000000..a32fd95
Binary files /dev/null and b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/TextMedia/Images/BackendTabMedia.png differ
diff --git a/typo3/sysext/fluid_styled_content/Documentation/ContentElements/TextMedia/Images/Frontend.png b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/TextMedia/Images/Frontend.png
new file mode 100644 (file)
index 0000000..1bab12d
Binary files /dev/null and b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/TextMedia/Images/Frontend.png differ
diff --git a/typo3/sysext/fluid_styled_content/Documentation/ContentElements/TextMedia/Index.rst b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/TextMedia/Index.rst
new file mode 100644 (file)
index 0000000..af64eaf
--- /dev/null
@@ -0,0 +1,43 @@
+.. include:: ../../Includes.txt
+
+.. _content-element-textmedia:
+
+============
+Text & Media
+============
+
+This content element allows to combine text and media elements, like images and/or movies.
+
+The text can be entered in the Rich Text Editor (RTE) on the "General" tab.
+
+.. figure:: Images/BackendFieldsRte.png
+   :alt: Backend display of the fields for the Rich Text Editor in the General tab
+
+   The Rich Text Editor (RTE) in the "General" tab
+
+The media elements can be added in the "Media" tab. In this tab there is also the option
+to turn the "enlarge on click" behaviour on for images.
+
+.. figure:: Images/BackendTabMedia.png
+   :alt: Backend display of the Media tab
+
+   The "Media" tab
+
+Multiple images and movies are combined as a gallery, which can be configured using the
+"Appearance" tab. Options there are specific width or height for each element, if a border
+should be shown around each element, the position of the gallery in relation to the text
+and the amount of columns which should be used for the gallery.
+
+.. figure:: Images/BackendTabAppearance.png
+   :alt: Backend display of the Appearance tab
+
+   The "Appearance" tab
+
+The maximum width of the gallery can be different when the gallery is on top or bottom of
+the text, or inside the text. This can be set using the :ref:`constant-editor`:
+
+.. figure:: Images/Frontend.png
+   :alt: Frontend rendering of the content element Text & Media
+
+   Frontend output, using one image aligned left of the text. The text is wrapping the
+   image.
diff --git a/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Uploads/Images/BackendFieldsFiles.png b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Uploads/Images/BackendFieldsFiles.png
new file mode 100644 (file)
index 0000000..f0a3623
Binary files /dev/null and b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Uploads/Images/BackendFieldsFiles.png differ
diff --git a/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Uploads/Images/BackendTabAppearance.png b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Uploads/Images/BackendTabAppearance.png
new file mode 100644 (file)
index 0000000..4d7b8af
Binary files /dev/null and b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Uploads/Images/BackendTabAppearance.png differ
diff --git a/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Uploads/Images/Frontend.png b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Uploads/Images/Frontend.png
new file mode 100644 (file)
index 0000000..2c6658e
Binary files /dev/null and b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Uploads/Images/Frontend.png differ
diff --git a/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Uploads/Index.rst b/typo3/sysext/fluid_styled_content/Documentation/ContentElements/Uploads/Index.rst
new file mode 100644 (file)
index 0000000..f1a74c2
--- /dev/null
@@ -0,0 +1,50 @@
+.. include:: ../../Includes.txt
+
+.. _content-element-uploads:
+
+==========
+File links
+==========
+
+This content element gives you the opportunity to offer downloadable files to the visitors
+of your website.
+
+.. figure:: Images/BackendFieldsFiles.png
+   :alt: Backend display of the fields for the File links in the General tab
+
+   The "General" file links fields
+
+You can add or select single files but also use a file collection. A file collection can
+be one of the following:
+
+- A static selection of files
+- A folder within a storage, holding the files
+- A file selection by category
+
+When combining both methods, single files and file collections, all files from these
+methods will be presented to the website visitor.
+
+.. figure:: Images/BackendTabAppearance.png
+   :alt: Backend display of the Appearance tab for the File links
+
+   The "Appearance" settings for file links
+
+In the "Appearance" tab you will find several options how the files will be presented:
+
+Display file/icon/thumbnail
+   In this dropdown you can select if you only want to show the file name, the file name
+   and a corresponding icon, based on the file extension, or the file name with a
+   thumbnail, if it is possible for TYPO3 CMS to generate a thumbnail from the file.
+
+Display file size information
+   Will show the file size calculated from the amount of bytes and presented as a human
+   readable string with the proper unit (B, KB, MB ...).
+
+Display description
+   Will display the description of each file, if available.
+
+.. figure:: Images/Frontend.png
+   :alt: Frontend rendering of a file, with thumbnail, description and file size set
+
+   Frontend output of a file, with thumbnail, description and file size set
+
diff --git a/typo3/sysext/fluid_styled_content/Documentation/FrequentlyAskedQuestions/Index.rst b/typo3/sysext/fluid_styled_content/Documentation/FrequentlyAskedQuestions/Index.rst
new file mode 100644 (file)
index 0000000..20e6763
--- /dev/null
@@ -0,0 +1,26 @@
+.. include:: ../Includes.txt
+
+.. _frequently-asked-questions:
+
+==========================
+Frequently Asked Questions
+==========================
+
+- **Q**: I don't see all the backend fields I can use for the configuration of a content
+  element.
+
+  **A**: Compared to *css_styled_content*, there is a difference
+  in the availability of fields, but also in the ordering and placement in tabs. We have
+  removed some fields which are not suitable for an editor or should be handled by by CSS.
+
+- **Q**: The "New Content Element" Wizards does not show the general content elements.
+
+  **A**: The PageTsconfig of "fluid_styled_config" needs to be loaded on the page to make
+  the content elements appear in the wizard. You can include it globally by checking
+  the designated checkbox in the extension configuration. See :ref:`extension-manager` for
+  more information.
+
+  If you want to include it only in a specific page tree open the page properties of the
+  topmost page in the tree and head to the "Resources" tab. Here you find the field
+  **Include Page TSConfig (from extensions):** where you can add the prepared PageTSconfig
+  "Fluid-based Content Elements (fluid_styled_content)"
diff --git a/typo3/sysext/fluid_styled_content/Documentation/Includes.txt b/typo3/sysext/fluid_styled_content/Documentation/Includes.txt
new file mode 100644 (file)
index 0000000..fe4c96a
--- /dev/null
@@ -0,0 +1,13 @@
+.. This is 'Includes.txt'. It is included at the very top of each and
+.. every ReST source file in this documentation project (= manual).
+
+.. role::   typoscript(code)
+
+.. role::   ts(typoscript)
+   :class:  typoscript
+
+.. role::   php(code)
+
+.. highlight:: php
+
+.. default-role:: code
diff --git a/typo3/sysext/fluid_styled_content/Documentation/Index.rst b/typo3/sysext/fluid_styled_content/Documentation/Index.rst
new file mode 100644 (file)
index 0000000..17154c2
--- /dev/null
@@ -0,0 +1,59 @@
+.. include:: Includes.txt
+
+
+.. _start:
+
+===============================
+Content Elements based on Fluid
+===============================
+
+:Extension key:
+      fluid_styled_content
+
+:Version:
+      |release|
+
+:Language:
+      en
+
+:Description:
+      Frontend rendering for TYPO3 CMS.
+
+:Keywords:
+      frontend, content, fluid
+
+:Copyright:
+      2000-2015
+
+:Author:
+      TYPO3 CMS Core Development Team
+
+:License:
+      Open Content License available from http://www.opencontent.org/opl.shtml
+
+:Rendered:
+      |today|
+
+The content of this document is related to TYPO3,
+a GNU/GPL CMS/Framework available from http://typo3.org
+
+.. only:: html
+
+   .. tip::
+
+      :ref:`Sitemap`
+
+**Table of Contents**
+
+.. toctree::
+   :maxdepth: 5
+   :titlesonly:
+   :glob:
+
+   Introduction/Index
+   Installation/Index
+   Configuration/Index
+   ContentElements/Index
+   AddingYourOwnContentElements/Index
+   FrequentlyAskedQuestions/Index
+   Targets
diff --git a/typo3/sysext/fluid_styled_content/Documentation/Installation/ExtensionManager/Images/Configuration.png b/typo3/sysext/fluid_styled_content/Documentation/Installation/ExtensionManager/Images/Configuration.png
new file mode 100644 (file)
index 0000000..b013980
Binary files /dev/null and b/typo3/sysext/fluid_styled_content/Documentation/Installation/ExtensionManager/Images/Configuration.png differ
diff --git a/typo3/sysext/fluid_styled_content/Documentation/Installation/ExtensionManager/Images/ConfigurationButton.png b/typo3/sysext/fluid_styled_content/Documentation/Installation/ExtensionManager/Images/ConfigurationButton.png
new file mode 100644 (file)
index 0000000..b9c4028
Binary files /dev/null and b/typo3/sysext/fluid_styled_content/Documentation/Installation/ExtensionManager/Images/ConfigurationButton.png differ
diff --git a/typo3/sysext/fluid_styled_content/Documentation/Installation/ExtensionManager/Images/ExtensionManager.png b/typo3/sysext/fluid_styled_content/Documentation/Installation/ExtensionManager/Images/ExtensionManager.png
new file mode 100644 (file)
index 0000000..f30a13d
Binary files /dev/null and b/typo3/sysext/fluid_styled_content/Documentation/Installation/ExtensionManager/Images/ExtensionManager.png differ
diff --git a/typo3/sysext/fluid_styled_content/Documentation/Installation/ExtensionManager/Index.rst b/typo3/sysext/fluid_styled_content/Documentation/Installation/ExtensionManager/Index.rst
new file mode 100644 (file)
index 0000000..78c8c66
--- /dev/null
@@ -0,0 +1,45 @@
+.. include:: ../../Includes.txt
+
+.. _extension-manager:
+
+=================
+Extension Manager
+=================
+
+The extension is a system extension and is installed by default.
+
+.. figure:: Images/ExtensionManager.png
+   :alt: fluid_styled_content in the Extension Manager
+
+   "fluid_styled_content" is installed by default in the Extension Manager
+
+
+.. _extension-manager-configuration:
+
+Configuration
+=============
+
+In the extension manager you have the possibility to configure the extension. Click on the
+name of the extension or click the "cogwheel" icon under "Actions" behind the extension
+name.
+
+.. figure:: Images/ConfigurationButton.png
+   :alt: Location of the configuration button in the Extension Manager
+
+   The location of the "cogwheel" icon under "Actions"
+
+At the configuration screen you will find the next configuration options:
+
+- **Load Page TSconfig with "New Content Element Wizard" definitions. The definitions can also**
+  **be loaded manually by including it in a page.** - When this option is selected, the PageTSconfig
+  of the extension is automatically included and does not need to be included manually. Use this
+  if you have a TYPO3 installation that uses `fluid_styled_content` everywhere without exception.
+
+.. figure:: Images/Configuration.png
+   :alt: The configuration options in the Extension Manager
+
+   The configuration options in the Extension manager
+
+When you are done configuring the extension, you can store your preferences by clicking
+the "Save" (you will stay at the configuration screen) or "Save and Close" button (you
+will be redirected to the extension list).
diff --git a/typo3/sysext/fluid_styled_content/Documentation/Installation/Index.rst b/typo3/sysext/fluid_styled_content/Documentation/Installation/Index.rst
new file mode 100644 (file)
index 0000000..4924f03
--- /dev/null
@@ -0,0 +1,19 @@
+.. include:: ../Includes.txt
+
+.. _installation:
+
+============
+Installation
+============
+
+This chapter describes the installation process.
+
+.. toctree::
+   :maxdepth: 5
+   :titlesonly:
+   :glob:
+
+   ExtensionManager/Index
+   Upgrading/Index
+   UsingTheRenderingDefinitions/Index
+   InsertingContentPageTemplate/Index
diff --git a/typo3/sysext/fluid_styled_content/Documentation/Installation/InsertingContentPageTemplate/Index.rst b/typo3/sysext/fluid_styled_content/Documentation/Installation/InsertingContentPageTemplate/Index.rst
new file mode 100644 (file)
index 0000000..ccd5568
--- /dev/null
@@ -0,0 +1,71 @@
+.. include:: ../../Includes.txt
+
+.. _inserting-content-page-template:
+
+=======================================
+Inserting content in your page template
+=======================================
+
+To get the different columns from the backend displayed in the frontend you can use
+predefined CONTENT objects. Depending on the page templating you are using you would do
+something in your TypoScript template like the following examples.
+
+
+.. _inserting-content-page-template-template:
+
+Based on the TEMPLATE content object (cObj)
+===========================================
+
+.. code-block:: typoscript
+
+   page = PAGE
+   page {
+      10 = TEMPLATE
+      10 {
+         file = your/html/template.html
+         subparts {
+            MAIN_CONTENT = CONTENT
+            MAIN_CONTENT {
+               table = tt_content
+               select {
+                  orderBy = sorting
+                  where = colPos=0
+                  languageField = sys_language_uid
+               }
+            }
+         }
+      }
+   }
+
+
+.. _inserting-content-page-template-fluidtemplate:
+
+Based on the FLUIDTEMPLATE content object (cObj)
+================================================
+
+.. code-block:: typoscript
+
+   page = PAGE
+   page {
+      10 = FLUIDTEMPLATE
+      10 {
+         file = your/html/template.html
+         variables {
+            content = CONTENT
+            content {
+               table = tt_content
+               select {
+                  orderBy = sorting
+                  where = colPos=0
+                  languageField = sys_language_uid
+               }
+            }
+         }
+      }
+   }
+
+.. seealso::
+
+   See the note about the removal of the predefined CONTENT objects like
+   :typoscript:`styles.content.get` at :ref:`upgrading`.
+
diff --git a/typo3/sysext/fluid_styled_content/Documentation/Installation/Upgrading/Images/UpgradeWizard.png b/typo3/sysext/fluid_styled_content/Documentation/Installation/Upgrading/Images/UpgradeWizard.png
new file mode 100644 (file)
index 0000000..c7a226c
Binary files /dev/null and b/typo3/sysext/fluid_styled_content/Documentation/Installation/Upgrading/Images/UpgradeWizard.png differ
diff --git a/typo3/sysext/fluid_styled_content/Documentation/Installation/Upgrading/Index.rst b/typo3/sysext/fluid_styled_content/Documentation/Installation/Upgrading/Index.rst
new file mode 100644 (file)
index 0000000..7528324
--- /dev/null
@@ -0,0 +1,63 @@
+.. include:: ../../Includes.txt
+
+.. _upgrading:
+
+=========
+Upgrading
+=========
+
+If you upgrade your TYPO3 CMS installation from one major version to another (for example
+6.2 to 7.6), it is advised to run the Upgrade Wizards. They guide you through the
+necessary steps to upgrade your database records or explicitly install extensions that
+ship with the latest TYPO3 CMS version.
+
+Coming from an older version it might be that the basic content elements, provided by
+the core of TYPO3 CMS were rendered by the extension "CSS Styled Content
+(css_styled_content)". Some changes have been made since moving the rendering to the
+extension "fluid_styled_content". Some database fields of the table tt_content are no longer
+used, the fields of FlexForms have been moved to proper database fields and the content
+elements "Text" and "Text & Images" have been merged into a new content element "textmedia".
+To make sure you do not lose any information or the content elements look differently on
+your upgraded website run these Upgrade Wizards.
+
+The upgrade wizards can be found in the Install tool.
+
+.. figure:: Images/UpgradeWizard.png
+   :alt: Location of the Upgrade Wizard in the Install Tool
+
+   Upgrade Wizard
+
+.. attention::
+
+   The predefined CONTENT objects :ts:`styles.content.getLeft`,
+   :ts:`styles.content.getRight` and :ts:`styles.content.getBorder` are not
+   provided anymore. :ts:`styles.content.get` still exists for your convenience. Most of
+   the current websites are using "backend layouts", where the predefined numbering of the
+   columns does not make sense.
+
+
+.. tip::
+
+   If you are still using the predefined CONTENT objects, you can use the following
+   TypoScript:
+
+   .. code-block:: typoscript
+
+      styles.content {
+
+         # get content, left
+         getLeft < styles.content.get
+         getLeft.select.where = colPos=1
+
+         # get content, right
+         getRight < styles.content.get
+         getRight.select.where = colPos=2
+
+         # get content, border
+         getBorder < styles.content.get
+         getBorder.select.where = colPos=3
+
+         # get news
+         getNews < styles.content.get
+         getNews.select.pidInList = {$styles.content.getNews.newsPid}
+      }
diff --git a/typo3/sysext/fluid_styled_content/Documentation/Installation/UsingTheRenderingDefinitions/Images/DropDown.png b/typo3/sysext/fluid_styled_content/Documentation/Installation/UsingTheRenderingDefinitions/Images/DropDown.png
new file mode 100644 (file)
index 0000000..e8d7157
Binary files /dev/null and b/typo3/sysext/fluid_styled_content/Documentation/Installation/UsingTheRenderingDefinitions/Images/DropDown.png differ
diff --git a/typo3/sysext/fluid_styled_content/Documentation/Installation/UsingTheRenderingDefinitions/Images/EditWholeTemplate.png b/typo3/sysext/fluid_styled_content/Documentation/Installation/UsingTheRenderingDefinitions/Images/EditWholeTemplate.png
new file mode 100644 (file)
index 0000000..fa68d1b
Binary files /dev/null and b/typo3/sysext/fluid_styled_content/Documentation/Installation/UsingTheRenderingDefinitions/Images/EditWholeTemplate.png differ
diff --git a/typo3/sysext/fluid_styled_content/Documentation/Installation/UsingTheRenderingDefinitions/Images/IncludesBoth.png b/typo3/sysext/fluid_styled_content/Documentation/Installation/UsingTheRenderingDefinitions/Images/IncludesBoth.png
new file mode 100644 (file)
index 0000000..4a2bb6d
Binary files /dev/null and b/typo3/sysext/fluid_styled_content/Documentation/Installation/UsingTheRenderingDefinitions/Images/IncludesBoth.png differ
diff --git a/typo3/sysext/fluid_styled_content/Documentation/Installation/UsingTheRenderingDefinitions/Images/IncludesOne.png b/typo3/sysext/fluid_styled_content/Documentation/Installation/UsingTheRenderingDefinitions/Images/IncludesOne.png
new file mode 100644 (file)
index 0000000..32a6022
Binary files /dev/null and b/typo3/sysext/fluid_styled_content/Documentation/Installation/UsingTheRenderingDefinitions/Images/IncludesOne.png differ
diff --git a/typo3/sysext/fluid_styled_content/Documentation/Installation/UsingTheRenderingDefinitions/Images/RootPage.png b/typo3/sysext/fluid_styled_content/Documentation/Installation/UsingTheRenderingDefinitions/Images/RootPage.png
new file mode 100644 (file)
index 0000000..f924e0c
Binary files /dev/null and b/typo3/sysext/fluid_styled_content/Documentation/Installation/UsingTheRenderingDefinitions/Images/RootPage.png differ
diff --git a/typo3/sysext/fluid_styled_content/Documentation/Installation/UsingTheRenderingDefinitions/Images/WebTemplate.png b/typo3/sysext/fluid_styled_content/Documentation/Installation/UsingTheRenderingDefinitions/Images/WebTemplate.png
new file mode 100644 (file)
index 0000000..0942972
Binary files /dev/null and b/typo3/sysext/fluid_styled_content/Documentation/Installation/UsingTheRenderingDefinitions/Images/WebTemplate.png differ
diff --git a/typo3/sysext/fluid_styled_content/Documentation/Installation/UsingTheRenderingDefinitions/Index.rst b/typo3/sysext/fluid_styled_content/Documentation/Installation/UsingTheRenderingDefinitions/Index.rst
new file mode 100644 (file)
index 0000000..e280792
--- /dev/null
@@ -0,0 +1,65 @@
+.. include:: ../../Includes.txt
+
+.. _using-the-rendering-definitions:
+
+===============================
+Using the rendering definitions
+===============================
+
+To use the default rendering definitions "fluid_styled_content" provides, you have to add
+the static template to your TypoScript template. Go to the module "Web > Template":
+
+.. figure:: Images/WebTemplate.png
+   :alt: Location of the Template module
+
+   Web > Template
+
+In the page tree select the page which contains the root template of your website. This is
+mostly the root page of your website as well:
+
+.. figure:: Images/RootPage.png
+   :alt: Location of the Root Page in the page tree
+
+   The Root Page in the page tree
+
+Select "Info/Modify" in the dropdown at the top of the "Web > Template" module. This
+should show you the root template of your website if it is available:
+
+.. figure:: Images/DropDown.png
+   :alt: Location of the dropdown in the Template module
+
+   The dropdown in the template module
+
+Select ``Edit the whole template record`` at the bottom. This will open all the settings
+of the root template:
+
+.. figure:: Images/EditWholeTemplate.png
+   :alt: Location of the link to edit the whole template in the Template module
+
+   Edit the whole template record
+
+Click on the tab "Includes" and select "Content Elements (fluid_styled_content)" in the part
+"Available items" under "Include static (from extensions)". The selection will move to the
+"Selected items":
+
+.. figure:: Images/IncludesOne.png
+   :alt: The Include tab and the available items in Include Static
+
+   Including a static template from an extension
+
+TYPO3 CMS is now using the rendering definitions of "fluid_styled_content" for the basic set of
+content elements. This is basically unstyled HTML5 markup.
+
+Unless you know what you are doing also include "Content Elements CSS (optional)
+(fluid_styled_content)". Some CSS styling will be added to the output of your page to make sure all
+the parts of a content elements have basic styling, like alignment and position. The
+styling will not add any colors, do font changes or similar which should be related to
+your website styles. This static include is optional, because some integrators want to
+override even the basic styling.
+
+.. figure:: Images/IncludesBoth.png
+   :alt: Inclusion of both static templates from the extension frontend
+
+   Including the static template for CSS styling
+
+Save the template by using the appropriate button at the top of the module.
diff --git a/typo3/sysext/fluid_styled_content/Documentation/Introduction/Index.rst b/typo3/sysext/fluid_styled_content/Documentation/Introduction/Index.rst
new file mode 100644 (file)
index 0000000..d833cb4
--- /dev/null
@@ -0,0 +1,73 @@
+.. include:: ../Includes.txt
+
+.. _introduction:
+
+============
+Introduction
+============
+
+.. _what-does-it-do:
+
+What does it do?
+================
+
+The extension "fluid_styled_content" handles the rendering of the default set of content elements
+shipped with the core by using the template engine "fluid".
+
+"fluid_styled_content" provides a basic set of content elements which you can use for your
+website. These can be used out-of-the-box, but can be adapted to your or your client
+needs. You are not bound to using only these content elements. For custom made
+functionality it is possible to add extra content elements to the basic set. How to adapt,
+enhance or add content elements will be described in this document.
+
+The rendering of the provided set of content elements is based on HTML5. Nowadays most of
+the websites are built with this core technology markup language used for
+structuring and presenting content in the World Wide Web. If your website is using
+another markup, like HTML4 or XHTML, it is easy to exchange the provided templates with
+your own.
+
+
+.. _history:
+
+A little bit of history
+=======================
+
+At the beginning of TYPO3 CMS content elements were rendered by the static template called
+*content (default)*. This was mainly based on font-tags for styling and tables for
+positioning which was needed to achieve the visual constructions in old versions of web
+browsers.
+
+Some time later the extension "css_styled_content" was introduced, which focused on
+reducing the amount of TypoScript and providing XHTML/HTML5 markup which could be styled
+by Cascading Style Sheets (CSS), a style sheet language used for describing the look and
+formatting of a document written in a markup language. Still this extension was heavily
+based on TypoScript and did allow custom modifications up to some point.
+
+Since the introduction of the templating engine Fluid, more websites are using this for
+page templating. Newer TYPO3 CMS packages (extensions) are also using Fluid as their base
+templating engine. The content elements which were provided with TYPO3 CMS by default were
+still using TypoScript and partly PHP code.
+
+Since TYPO3 CMS version 7.5 the default content elements have been moved to this
+extension **fluid_styled_content**, also using Fluid as their templating engine. The benefits are that
+hardly any knowledge of TypoScript is needed to make changes. Integrators can easily
+exchange the base content element Fluid templates with their own. In Fluid more complex
+functionality that exceed the simple output of values has to be implemented with
+ViewHelpers. Every ViewHelper has its own PHP class. Several basic ViewHelpers are
+provided by Fluid. When using your own Fluid templates, developers can add extra
+functionality with their own ViewHelpers, extending the possibilities of the content
+elements.
+
+
+.. _support:
+
+Support
+=======
+
+Please see/report problems on TYPO3 Forge
+`https://forge.typo3.org/projects/typo3cms-core/issues
+<https://forge.typo3.org/projects/typo3cms-core/issues>`_
+under category content rendering.
+
+You may get support in the use of this extension by subscribing to
+`https://forum.typo3.org/index.php/f/41/ <https://forum.typo3.org/index.php/f/41/>`_ .
diff --git a/typo3/sysext/fluid_styled_content/Documentation/Settings.cfg b/typo3/sysext/fluid_styled_content/Documentation/Settings.cfg
new file mode 100644 (file)
index 0000000..693f278
--- /dev/null
@@ -0,0 +1,54 @@
+[general]
+
+; endless list of all of the general simple settings
+; you can use in 'conf.py'
+
+project     = Content Elements based on Fluid (fluid_styled_content)
+version     = latest
+release     = latest
+t3author    = ((Authors to be named)), TYPO3 Documentation Team
+copyright   = since 1997
+
+description = This documentation is about TYPO3's system extension
+      "fluid_styled_content" which provides content elements and uses Fluid to render
+      frontend output.
+
+[html_theme_options]
+
+; for theme t3SphinxThemeRtd
+
+github_branch        =
+github_repository    =
+github_revision_msg  =
+github_sphinx_locale =
+project_contact      =
+project_discussions  = http://lists.typo3.org/cgi-bin/mailman/listinfo/typo3-project-content-rendering
+project_home         = https://forge.typo3.org/projects/typo3cms-core
+project_issues       = https://forge.typo3.org/projects/typo3cms-core/issues
+project_repository   = https://git.typo3.org/Packages/TYPO3.CMS.git
+use_opensearch       =
+
+
+[intersphinx_mapping]
+
+# These are common mappings. Uncomment only what you really use!
+
+# t3api         = https://typo3.org/api/typo3cms/
+# t3cgl         = https://docs.typo3.org/typo3cms/CodingGuidelinesReference/
+# t3coreapi     = https://docs.typo3.org/typo3cms/CoreApiReference/
+# t3editors     = https://docs.typo3.org/typo3cms/EditorsTutorial/
+# t3extbasebook = https://docs.typo3.org/typo3cms/ExtbaseFluidBook/
+# t3fal         = https://docs.typo3.org/typo3cms/FileAbstractionLayerReference/
+# t3inside      = https://docs.typo3.org/typo3cms/InsideTypo3Reference/
+# t3install     = https://docs.typo3.org/typo3cms/InstallationGuide/
+# t3l10n        = https://docs.typo3.org/typo3cms/FrontendLocalizationGuide/
+# t3security    = https://docs.typo3.org/typo3cms/SecurityGuide/
+# t3services    = https://docs.typo3.org/typo3cms/Typo3ServicesReference/
+# t3skinning    = https://docs.typo3.org/typo3cms/SkinningReference/
+# t3start       = https://docs.typo3.org/typo3cms/GettingStartedTutorial/
+# t3tca         = https://docs.typo3.org/typo3cms/TCAReference/
+# t3templating  = https://docs.typo3.org/typo3cms/TemplatingTutorial/
+# t3ts45        = https://docs.typo3.org/typo3cms/TyposcriptIn45MinutesTutorial/
+# t3tsconfig    = https://docs.typo3.org/typo3cms/TSconfigReference/
+# t3tsref       = https://docs.typo3.org/typo3cms/TyposcriptReference/
+# t3tssyntax    = https://docs.typo3.org/typo3cms/TyposcriptSyntaxReference/
\ No newline at end of file
diff --git a/typo3/sysext/fluid_styled_content/Documentation/Settings.yml b/typo3/sysext/fluid_styled_content/Documentation/Settings.yml
new file mode 100644 (file)
index 0000000..99c1c40
--- /dev/null
@@ -0,0 +1,15 @@
+# This is the project specific Settings.yml file.
+# Place Sphinx specific build information here.
+# Settings given here will replace the settings of 'conf.py'.
+
+---
+conf.py:
+  copyright: 1997-2015
+  project: Frontend
+  version: 7
+  release: 7
+  latex_elements:
+    papersize: a4paper
+    pointsize: 10pt
+    preamble: \usepackage{typo3}
+...
diff --git a/typo3/sysext/fluid_styled_content/Documentation/Sitemap.rst b/typo3/sysext/fluid_styled_content/Documentation/Sitemap.rst
new file mode 100644 (file)
index 0000000..0a870d8
--- /dev/null
@@ -0,0 +1,14 @@
+:orphan:
+
+.. include:: Includes.txt
+
+.. only:: html
+
+   .. _Sitemap:
+
+   Sitemap
+   =======
+
+   .. toctree::
+
+      Index
diff --git a/typo3/sysext/fluid_styled_content/Documentation/Targets.rst b/typo3/sysext/fluid_styled_content/Documentation/Targets.rst
new file mode 100644 (file)
index 0000000..21ea54b
--- /dev/null
@@ -0,0 +1,10 @@
+.. include:: Includes.txt
+
+.. _labels-for-crossreferencing:
+
+============================
+Labels for cross-referencing
+============================
+
+.. ref-targets-list::
+