Skip to content

Commit

Permalink
[DOCS] add some FAQs related to #276
Browse files Browse the repository at this point in the history
  • Loading branch information
krausandre committed Dec 2, 2024
1 parent 0e12f73 commit 2ef27ba
Showing 1 changed file with 65 additions and 0 deletions.
65 changes: 65 additions & 0 deletions Documentation/FAQ/Index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -46,3 +46,68 @@ Answers to frequently asked questions.

If you really need to override a Content Block, you can always fall back
to traditional methods like :ref:`TCA Overrides <cb_extendTca>`.

.. accordion-item:: How can I extend an existing Content Block?
:name: yaml
:header-level: 2

Same as before: This is not possible by default. Nevertheless, you can
always extend the TypoScript the old way and use e.g. partials from your
sitepackage or libraries from outside. But this way you are on your own.

.. accordion-item:: Can I add PHP code to my content blocks?
:name: yaml
:header-level: 2

The Content Blocks API does support PHP files at all. If you want to add
some PHP logic to your content blocks, you have to use the old common
ways.

.. accordion-item:: Can I use twig engine with Content Blocks?
:name: yaml
:header-level: 2

Not out of the box. As the main rendering engine for TYPO3 is fluid, you
have to do some custom work to get twig working with Content Blocks.

.. accordion-item:: Can I use headless with Content Blocks?
:name: yaml
:header-level: 2

Content Blocks generating the TYPO3 core things under the hood (TCA,
TypoScript, tsConfig), so you have to prepare your headless setup like
you have to do with the core content elements.

.. accordion-item:: Are the Content Blocks assets (JS and CSS) compressed by the the core?
:name: yaml
:header-level: 2

Content Blocks using the core asset collector, so the assets not get
merged together. Since they get registered only if the content block is
used on the page, each file is included separate.

.. accordion-item:: Can I add Content Blocks assets (JS and CSS) to my build process?
:name: yaml
:header-level: 2

This is not a specific Content Blocks question. You can add your assets
to the build process like you do with any other assets. E.G. you can add
your Content Block CSS to your main CSS file, and remove the CSS
registration in the Content Block.

.. accordion-item:: Can I add Content Blocks assets (JS and CSS) to my build process?
:name: yaml
:header-level: 2

This is not a specific Content Blocks question. You can add your assets
to the build process like you do with any other assets. E.G. you can add
your Content Block CSS to your main CSS file, and remove the CSS
registration in the Content Block.

.. accordion-item:: Will there be a GUI (Graphical User Interface) for Content Blocks?
:name: yaml
:header-level: 2

Yes, the Content Types Team is working on a GUI for Content Blocks. The
first steps are already done, and we are looking forward to the first
beta phase in 2025.

0 comments on commit 2ef27ba

Please sign in to comment.