Should we pre-configure src/AppBundle?

[contao]

Should we pre-configure src/AppBundle?

[aschempp]

Why should we do that? And what would it contain?

[leofeyer]

It would not contain anything but an empty container for the end-user to customize the application. You wanted me to add this FIXME, therefore I figured you'd have something in mind?

[aschempp]

I don’t think we should add an AppBundle. AppBundle is for «real developers», similar as if you would create a new system/module in Contao 3. The app/Resources are for customization, similar to langconfig.php and initconfig.php

We still need to support AppBundle though as it is the new system/modules/z_custom.

[leofeyer]

How do we support it if we don't add it?

[aschempp]

What do you mean? We’re supporting translations in app/Resources but also do not ship any?

[leofeyer]

I see. By the way, I think I can remove the FIXME entry, because its related to Contao templates only and these either lie in a bundle, in a legacy module or in /templates but never in src/AppBundle, right?

[aschempp]

There sure is, in src/AppBundle/Resources/contao/templates …

[leofeyer]

No, because following the Symfony standards, customized templates go into app/Resources and not in src/AppBundle/Resources.

[aschempp]

Yeah, but:

• Customized templates from third-party bundles (from vendor) will be in app/Resources
• Your custom bundle (src/AppBundle) can still contain its own templates for its own frontend modules

[leofeyer]

No, that's not correct according to the "Symfony best practice" book.

[aschempp]

You might be right, but it's all a bit messy to me and confusing because we're not a standard Symfony application… In Twig different bundles can have the same template name and it would still work (because of Bundle subfolders in app/Resources).

[discordier]

I'd rather not put empty directories (which must contain a .gitignore or the like to be present).
If end users want to build a custom app bundle, they most likely already know how to do so. If they do not know, they most likely don't want to build one.

[leofeyer]

Ok :)

[tsarma]

These kind of decisions are very much appreciate in Contao 4 documentation page. Because people tends to learn Symfony in standard installations and when they come to Contao 4, like myself, they might also get confused to see some standards folders are missing!

[discordier]

@tsarma The documentation is community maintained, feel free to file a pull request against the docs.
For details please refer to @aschempp who is responsible for merging the docs (He is on holiday for the next two weeks though).