# SportsManager

## Deploy status

### DEV environment
[![buddy pipeline](https://buddy.kicktemp.com/kicktemp/com-sportsmanager/pipelines/pipeline/173/badge.svg?token=de39e4e4c47351d592b59a5d1e26a41cf5196861f67d4499bbab990600468001 "buddy pipeline")](https://buddy.kicktemp.com/kicktemp/com-sportsmanager/pipelines/pipeline/173) [Preview: sportsmanager.s10.kicktemp.dev](https://sportsmanager.s10.kicktemp.dev)

[![buddy pipeline](https://buddy.kicktemp.com/kicktemp/com-sportsmanager/pipelines/pipeline/204/badge.svg?token=de39e4e4c47351d592b59a5d1e26a41cf5196861f67d4499bbab990600468001 "buddy pipeline")](https://buddy.kicktemp.com/kicktemp/com-sportsmanager/pipelines/pipeline/204) [Preview: stage.kickern-hamburg.de](https://stage.kickern-hamburg.de)

### PROD environment
[![buddy pipeline](https://buddy.kicktemp.com/kicktemp/com-sportsmanager/pipelines/pipeline/218/badge.svg?token=de39e4e4c47351d592b59a5d1e26a41cf5196861f67d4499bbab990600468001 "buddy pipeline")](https://buddy.kicktemp.com/kicktemp/com-sportsmanager/pipelines/pipeline/218) [Preview: dtfb.de](https://dtfb.de)

[![buddy pipeline](https://buddy.kicktemp.com/kicktemp/com-sportsmanager/pipelines/pipeline/219/badge.svg?token=de39e4e4c47351d592b59a5d1e26a41cf5196861f67d4499bbab990600468001 "buddy pipeline")](https://buddy.kicktemp.com/kicktemp/com-sportsmanager/pipelines/pipeline/219) [Preview: kickern-hamburg.de](https://kickern-hamburg.de)


## Test setup
### Installation
To start joomla and the database, run

```shell
   docker-compose up -d
```

### Release creation
To create a release execute 
```shell
    npm run release
```

### Deployment
Deployment can only be done manually right now (sad)  
To do this go to
[Testserver Extension Installer Site](http://localhost:8080/administrator/index.php?option=com_installer&view=install)
and upload the zip file found in `./package/packages`


### Development Tools
If you are using Intellij, there is a plugin named Joomla! which helps with resolving
joomla specific database prefixes like #__  
To set it up, insert into the configuration popup which follows after you enable the framework support:  
Joomla install path: `./data/joomla_data`  
JConfig: `./data/joomla_data/configuration.php`
> This works only with mounted volumes. However, mounted volumes will slow down the joomla instance significantly.  
> The current setup does not use mounted volumes.
> An alternative would be to download joomla and use that installation
 
### Debugging (with Docker/Intellij)
1. Start Docker Container (see above)
2. Create a terminal for that container
    ```shell 
      docker exec -it <container_name> bash
    ```
3. install xdebug within the container since joomla does not come with xdebug preinstalled  
    ```shell 
      pecl install xdebug
    ```
4. restart the container
5. In Intellij Go to [File | Settings | Languages & Frameworks | PHP | Servers](jetbrains://idea/settings?name=Languages+%26+Frameworks--PHP--Servers) and setup your server

    |          |           |
    |----------|-----------|
    | name     | anything  |
    | host     | localhost |
    | port     | 8080      |
    | debugger | xdebug    |
    
    use the path mapping and map the repo structure to the container content

    | File/Directory                                                   | path on server |
    |------------------------------------------------------------------|----------------|
    | \<path>/com_sportsmanager/src/structure/administrator/components | /var/www/html/administrator/components |
    | \<path>/com_sportsmanager/src/structure/components | /var/www/html/components  |
6. Click on "Start Listening for PHP Debug Connections" in the top row of intellij
7. (Not sure if optional) Install a browser extension by Jetbrains  
https://chromewebstore.google.com/detail/xdebug-helper-by-jetbrain/aoelhdemabeimdhedkidlnbkfhnhgnhm