diff --git a/Documentation/ContentElements/Media/Index.rst b/Documentation/ContentElements/Media/Index.rst index cc8b05f3..19d81700 100644 --- a/Documentation/ContentElements/Media/Index.rst +++ b/Documentation/ContentElements/Media/Index.rst @@ -1,44 +1,54 @@ -.. include:: /Includes.rst.txt +.. include:: /Includes.rst.txt -.. _media: +.. _media: -========================= -Embedding video and audio -========================= +================ +Embedding Videos +================ .. image:: /Images/ManualScreenshots/ContentElements/TextAndMedia.png :alt: Content element Text and Media in the TYPO3 backend :class: img-thumbnail float-end ms-1 :width: 250 -Like images, it's best practice to add new video and audio files using the -:guilabel:`File > Filelist` module, which is covered in the :ref:`chapter about the file module `. This method -means files are stored centrally and any information or metadata you add to -the file is used wherever that media file is used on the site. +The content element "Text & Media" can be used in a similar fashion to the +`Text & Images `_ content +element introduced in the previous chapter. -When you use the :guilabel:`Select & upload files` button, the media file is -attached to the page and gets uploaded to the :guilabel:`user_uploads` folder in the :guilabel:`Filelist`. +It does however allow additional video and audio formats. -.. tip:: - By only using :guilabel:`Select & upload files`, your files pile up in the :guilabel:`user_uploads` folder pretty quickly. - Therefore you should rather upload and organize the files via the :guilabel:`Add Media` button or upload it with the :guilabel:`File > Filelist` - module directly, as described above. +It can also be used to embed video players for YouTube and or Vimeo. -.. _add-video-to-page: +Which formats are allowed depends on the set up of your site. The allowed +file extensions and pseudo formats (YouTube, Vimeo) are listed bellow the +element selector. + +This content element can also be used to embed images and audio files. + +.. tip:: + There is a large number of third party TYPO3 extensions to display a video + player or embed a video from an external source. If one of those is used + refer to the manual of the extension in use. + +.. _add-video-to-page: Add a video to a page ===================== -On the :guilabel:`Media` tab, click the :guilabel:`Add media file` button, then follow -the same process as you would to :ref:`add-image-to-page`. +If you want to embed a previously uploaded video or upload a new video use the +button :guilabel:`Add media file`. If you want to embed a video from an external +source like YouTube or Vimeo, use the button :guilabel:`Add media URL` instead. -.. include:: /Images/AutomaticScreenshots/EditContent/EditContentMediaTab.rst.txt +.. figure:: /Images/ManualScreenshots/ContentElements/Media.png + :alt: Tab media of the text and media content element in TYPO3 -Alternatively, you can click the :guilabel:`Add media by URL` button to paste -a link to a video or audio file from the web. +.. note:: + For security reasons the maximal upload size is limited. Images can have + large file sizes. If you cannot upload a video yourself, ask your + administrator to do it for you or upload it on an external plattform and + embed it. - -.. _Configure-the-video: +.. _Configure-the-video: Configure the video =================== @@ -50,4 +60,21 @@ You can configure various settings for media files (for example, adding a border, setting page position and behavior) just as you would to :ref:`configure an image`. -.. include:: /ContentElements/TipKeyboardCommands.rst.txt +.. _video-data-privacy: + +External video sources and data privacy +======================================= + +Using certain external video sources can have legal consequences concerning +data privacy laws in your country. + +Talk to your Data Protection Officer (DPO) or legal department. Ask your +integrator to install an extension that ensures you can use YouTube without +data privacy issues on your page. + +Extension :composer:`b13/twoclickmedia` enables you to use the +standard "Text & Media" content element while requiring consent from your +readers before any data is sent to YouTube. + +Other extensions like :composer:`t3brightside/youtubevideo` provide their own +content element. diff --git a/Documentation/Images/AutomaticScreenshots/EditContent/EditContentMediaTab.png b/Documentation/Images/AutomaticScreenshots/EditContent/EditContentMediaTab.png deleted file mode 100644 index e15283de..00000000 Binary files a/Documentation/Images/AutomaticScreenshots/EditContent/EditContentMediaTab.png and /dev/null differ diff --git a/Documentation/Images/AutomaticScreenshots/EditContent/EditContentMediaTab.rst.txt b/Documentation/Images/AutomaticScreenshots/EditContent/EditContentMediaTab.rst.txt deleted file mode 100644 index 2a3b557f..00000000 --- a/Documentation/Images/AutomaticScreenshots/EditContent/EditContentMediaTab.rst.txt +++ /dev/null @@ -1,6 +0,0 @@ -.. Automatic screenshot: Remove this line if you want to manually change this file - -.. figure:: /Images/AutomaticScreenshots/EditContent/EditContentMediaTab.png - :class: with-shadow - - The :guilabel:`Media` tab for a content element \ No newline at end of file diff --git a/Documentation/Images/ManualScreenshots/ContentElements/Media.png b/Documentation/Images/ManualScreenshots/ContentElements/Media.png new file mode 100644 index 00000000..ce24bef3 Binary files /dev/null and b/Documentation/Images/ManualScreenshots/ContentElements/Media.png differ