# TYPO3 Auto-Installation
Since I need a TYPO3 test environment from time to time, I use these bash scripts for the automatic installation and removal of TYPO3.
The installation script currently supports TYPO3 versions **10, 11, 12, 13, 14 and dev**.

## Installation
I have stored the scripts under:
```
~/.shellscripts/typo3/
```
I use the following aliases:
```bash
alias install-typo3="bash ~/.shellscripts/typo3/install.sh"
alias remove-typo3="bash ~/.shellscripts/typo3/remove.sh"
```

## Requirements
Since the installation script set up a local development environment based on Docker and DDEV, you must ensure that DDEV is installed in the latest available version and is working correctly on your machine before running it. For help with installing DDEV, please see the [official DDEV documentation](https://ddev.readthedocs.io/en/stable/).

## Usage
The installation script can be called with a version number as the first parameter, which can be "10", "11", "12", "13", "14" or "dev" (for the latest dev version), and any number of string parameters. Each string parameter after the version number is used as the DDEV project name and directory name of the TYPO3 instance.

**Example:**
```
install-typo3 13 domain1.com domain2.com domain3.com
```
This command creates three TYPO3 13 projects in the directories `domain1.com/`, `domain2.com/` and `domain3.com/`.

If no directory names are specified, the name `typo3-<version>-project` is used. If no version number is specified, the latest version 14 will be installed in directory `typo3-14-project`.

## What it does
- The DDEV plugin [DDEV-CRON](https://github.com/ddev/ddev-cron) automatically creates a cronjob that runs the TYPO3 scheduler every minute.
- [phpMyAdmin](https://github.com/ddev/ddev-phpmyadmin) is also installed via DDEV plugin and can be called via `ddev phpmyadmin`.
- Furthermore a `packages/` directory is created and stored in the `composer.json` as local repository path.
- Inside `packages/` my [sitepackage basic structure](https://github.com/ErHaWeb/sitepackage.git) is cloned and changed to the branch matching the TYPO3 version.
- With the installation of the sitepackage a root site is created with references to the `Page TSconfig` and `TypoScript` of the sitepackage, so you can start directly.

## Backend-Login
With the following credentials you can log in to the backend:

Username: `admin`\
Password: `Password1%`

## Showcase on YouTube
I have recorded the installation process of all versions as a [YouTube-video here](https://www.youtube.com/watch?v=PiNRszYlZxg):

## Uninstall
If you don't need the TYPO3 test-installation anymore you can change to the directory of the installation and execute `remove-typo3` (see alias above).
This will A) delete the DDEV project and B) delete the whole directory (with sudo).

## Disclaimer
Please note that the execution of these scripts is at your own risk and I assume no liability for anything. For this reason you should make sure that you have understood which steps are executed by the script.