Devilbox: Update Documentation for CONTAO CMS

[fkaminski]

ISSUE TYPE

• Documentation
  

SUMMARY

I just realized that there is a documentation for the Contao CMS:
https://devilbox.readthedocs.io/en/latest/examples/setup-contao.html

It describes how to install Contao with Composer (console/shell).
This will probably not work because of the default PHP memory_limit ( 512M ).

So you have to setup the .ini with "memory_limit = -1" first for example. As described in:
https://devilbox.readthedocs.io/en/latest/configuration-files/php-ini.html#change-memory-limit-for-php-7-1

Using the "Contao Manager"
Another approach would be to use the "Contao Manager". The "Contao Manager" is a graphical tool to manage a Contao installation - and more. The CM includes a useful service called "Composer Cloud Resolver":

The Composer Cloud Resolver allows to install Composer dependencies even if your server does not provide enough local memory. Please be aware that your package information will be transmitted to a cloud server operated by the Contao Association.

To use the CM you have to download the "contao-manager.phar" file from https://contao.org/de/download.html and copy it to the contao "web" folder.
Rename it to "contao-manager.phar.php".

Or just - in the Contao/vhost folder:
curl -o web/contao-manager.phar.php -L https://download.contao.org/contao-manager.phar

Call it like: https://my-contao.loc/contao-manager.phar.php ...

Goal

Update Documentation for CONTAO CMS

[fkaminski]

Supplement:
After calling the "Contao Manager" in your Browser you have to set a Username and Password for the CM first. The CM will than check the environment.
Under "Server Configuration" you have to select "Other".

With the devilbox the correct PHP binary path should be recognized automatically. With a fresh installation you can than choose which Contao Version to install.

Furthermore, if there is already a composer.json respectively a composer.lock the CM will install the exact configuration provided via these corresponding configuration files.

After the installation process you could search and install further Contao extensions or use several maintenance tools without using a console at all.

By the way:
You can use the CM at any time even if there is a complete Contao Version already installed!

[stale[bot]]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

[fkaminski]

What about this "stale" mode. Do you need something more ... ?

[cytopia]

The bot automatically helps me mange my issues and will mark (and later close) issues with no activity.
Currently I haven't had the time to provide more detailed documentation and will rely on others to jump in here to support ;)

[stale[bot]]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

[cytopia]

@fkaminski would you care to create a PR for that.

[stale[bot]]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

[fkaminski]

The Contao Documentation now includes a devilbox guide:
https://docs.contao.org/manual/de/lokale-installation/devilbox/
https://docs.contao.org/manual/en/guides/local/devilbox/

[stale[bot]]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

[cytopia]

Fixed here: https://github.com/cytopia/devilbox/pull/750