Task #88940

Standard (composer) installation process in T3 v9 does not offer introduction distribution

Added by Jonas Eberle about 1 month ago. Updated about 1 month ago.

Status:
Needs Feedback
Priority:
Should have
Assignee:
-
Category:
composer
Target version:
-
Start date:
2019-08-08
Due date:
% Done:

0%

TYPO3 Version:
9
PHP Version:
Tags:
Complexity:
Sprint Focus:

Description

After the initial

composer create-project typo3/cms-base-distribution

you do not get the option 'Yes, download the list of distributions' and thus no possibility to install the introduction distribution.

Shouldn't that be the absolute default? How can we pass on that possiblity to enable newbies to try out TYPO3 quickly?


On the other hand, the non-composer

wget -O - get.typo3.org/9 | tar xvzf -
ln -s typo3_src-9.5.8/ typo3_src
ln -s typo3_src/index.php
ln -s typo3_src/typo3/

gets you to 'Yes, download the list of distributions' and actually allows you to install the official introduction package.


Thus, if we want to continue on the composer-way, the installation experience for beginners should be improved.

History

#1 Updated by Oliver Hader about 1 month ago

When using composer, "extension handling" (storage and PSR autoload handling) is delegated to composer completely. That's why in composer mode retrieving extensions from TER as ZIP to be placed in typo3conf/ext is denied - composer stores extensions to vendor directory and symlinks to typo3conf/ext instead.

Thus, using the introduction package in composer mode on command line, it's required to add that to composer.json by using

composer require typo3/cms-introduction

#2 Updated by Oliver Hader about 1 month ago

Thus, the a composer install plugin would have to list available distributions (being available as composer package)...

#3 Updated by Oliver Hader about 1 month ago

  • Category set to composer
  • Status changed from New to Needs Feedback

#4 Updated by Jonas Eberle about 1 month ago

It needs to be

composer req typo3/cms-introduction='*'

because it will fail while trying to install the newest (only v10) otherwise.

Maybe we could advertise a newbie-friendly TYPO3 directly in the docs, https://get.typo3.org and similar pages like https://ddev.readthedocs.io/en/latest/users/cli-usage/#typo3-quickstart?

composer create typo3/cms-base-distribution=^9 . && composer req typo3/cms-introduction='*'

I am really thinking about an easier "try out TYPO3 now"-experience.
What do you think?

#5 Updated by Jonas Eberle about 1 month ago

In this way the distribution installs its dependencies but does not create the example database records.

I did not find a way to run its update script otherwise through the backend - am I missing something?

So it should also be noted that one needs to deactivate/activate the introduction extension.

So to get going in the shortest time it would be:

composer create typo3/cms-base-distribution=^9 . 
composer req typo3/cms-introduction='*'

vendor/bin/typo3 extension:deactivate introduction
vendor/bin/typo3 extension:activate introduction

touch public/FIRST_INSTALL
#  then go to ..../typo3/install.php

Also available in: Atom PDF