You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Igor Scheller c1e0e121f0 Navbar: Display user angel icon 6 years ago
bin Fixups and cleanup for GitLab CI 6 years ago
config Merge remote-tracking branch 'MyIgel/session' 6 years ago
contrib Fixed release file build (did not include frontend files), formatting 6 years ago
db Migrations: Added namespace 6 years ago
import camp 2011 export 13 years ago
includes Merge remote-tracking branch 'MyIgel/mailing' 6 years ago
public Moved emojis to assets 6 years ago
resources Navbar: Display user angel icon 6 years ago
src Migrations: Added namespace 6 years ago
templates Merge remote-tracking branch 'MyIgel/mailing' 6 years ago
tests Migrations: Added namespace 6 years ago
.babelrc frontend stuff with babel and webpack 7 years ago
.gitignore Added junit xml export artifacts for GitLab CI 6 years ago
.gitlab-ci.yml Added junit xml export artifacts for GitLab CI 6 years ago
LICENSE directory renames and cleanup 14 years ago
README.md Fixed release file build (did not include frontend files), formatting 6 years ago
composer.json Migrations: Added namespace 6 years ago
package.json Moved scripts/copyAssets.js to resources folder and fixed formatting 6 years ago
phpunit.xml Merge branch 'noc0lour:fix_setup_bugs', closes #335 7 years ago
webpack.config.js Asset step & script 6 years ago

README.md

Codacy Badge GPL

Engelsystem

Please visit https://engelsystem.de for a feature list.

To report bugs use engelsystem/issues

Installation

Requirements:

  • PHP >= 7.0
  • MySQL-Server >= 5.5 or MariaDB-Server >= 5.5
  • Webserver, i.e. lighttpd, nginx, or Apache
  • Node >= 8 (Development/Building only)
  • Yarn (Development/Building only)

Directions:

  • Clone the master branch: git clone https://github.com/engelsystem/engelsystem.git

  • Install Composer and Yarn (which requires Node.js)

  • Install project dependencies:

    composer install
    yarn
    

    On production systems it is recommended to use

    composer install --no-dev
    composer dump-autoload --optimize
    

    to install the engelsystem

  • Build the frontend assets

    yarn build
    
  • The webserver must have write access to the import directory and read access for all other directories

  • The webserver must point to the public directory.

  • The webserver must read the .htaccess file and mod_rewrite must be enabled

  • Recommended: Directory Listing should be disabled.

  • There must a be MySQL database created with a user who has full rights to that database.

  • If necessary, create a config/config.php to override values from config/config.default.php.

  • To import the database the bin/migrate script has to be called.

  • In the browser, login with credentials admin:asdfasdf and change the password.

Engelsystem can now be used.

Session Settings:

  • Make sure the config allows for sessions.
  • Both Apache and Nginx allow for different VirtualHost configurations.

Development

Since the engelsystem is open source, you can help to improve the system. We really love to get pull requests containing fixes or implementations of our Github issues.

Please create single pull requests for every feature instead of creating one big monster of pull request containing a complete rewrite.

Testing

To run the unit tests use

vendor/bin/phpunit --testsuite Unit

If a database is configured and the engelsystem is allowed to mess around with some files, you can run feature tests. The tests can potentially delete some database entries, so they should never be run on a production system!

vendor/bin/phpunit --testsuite Feature
# or for unit- and feature tests:
vendor/bin/phpunit

CI & Build Pipeline

The engelsystem can be tested and automatically deployed to a testing/staging/production environment. This functionality requires a GitLab server with a running docker minion.

To use the deployment features the following secret variables need to be defined (if undefined the step will be skipped):

SSH_PRIVATE_KEY         # The ssh private key
STAGING_REMOTE          # The staging server, e.g. user@remote.host
STAGING_REMOTE_PATH     # The path on the remote server, e.g. /var/www/engelsystem
PRODUCTION_REMOTE       # Same as STAGING_REMOTE but for the production environment
PRODUCTION_REMOTE_PATH  # Same as STAGING_REMOTE_PATH but for the production environment

Docker container

To build the engelsystem and the engelsystem-nginx container:

cd contrib
docker-compose build

or to build the containers separately

docker build -f contrib/nginx/Dockerfile . -t engelsystem-nginx
docker build -f contrib/Dockerfile . -t engelsystem

Import database

docker exec -i db_container mysql -u engelsystem -pengelsystem engelsystem < db/install.sql
docker exec -i db_container mysql -u engelsystem -pengelsystem engelsystem < db/update.sql

To be able to send mails a relay is needed. Set SMTPHOST=[mail container] to configure it.

Scripts

bin/deploy.sh

The bin/deploy.sh script can be used to deploy the engelsystem. It uses rsync to deploy the application to a server over ssh.

For usage see ./bin/deploy.sh -h

bin/migrate

The bin/migrate script can be used to import and update the database of the engelsystem.

For more information on how to use it call ./bin/migrate help

Codestyle

Please ensure that your pull requests follow PSR-2 and PSR-4.