https://openy.org

An open source platform for YMCAs, by YMCAs built on Drupal.

The Open Y Project is a composer based installer for the Open Y distribution.

If you do not have Composer, you may install it by following the official instructions. For usage, see the documentation.

composer create-project ymcatwincities/openy-project MY_PROJECT --no-interaction --no-dev
cd MY_PROJECT

This command will build project based on latest Drupal 8 development release.

composer create-project ymcatwincities/openy-project:8.2.x-development-dev MY_PROJECT --no-interaction --no-dev
cd MY_PROJECT

composer create-project ymcatwincities/openy-project:9.2.x-development-dev MY_PROJECT --no-interaction --no-dev
cd MY_PROJECT

This command will build project based on the Drupal 9 development branch release.

See https://youtu.be/jRlinjpTl0c how to video for the whole process of this command usage.

You should use composer command without --no-dev if you would like to get environment that was configured especially for OpenY. This means you'd remove Vagrant/Docksal from the code tree. So it should look like this:

composer create-project ymcatwincities/openy-project:9.2.x-development-dev MY_PROJECT --no-interaction
cd MY_PROJECT

CIBox VM allows you to make a contribution into OpenY in a few minutes. Just follow steps and then you'll know how to do it.

• Pre Requirements
• Installation
• Local build

Read more details on CIBox VM repo.

Docksal is a tool for defining and managing development environments.

• How to develop
• How to run behat tests

Read more details on Docksal repo.

All development happens in the Open Y Drupal 8 installation profile. In order to start development:

1. Create fork of Open Y installation profile
2. Add your repository to composer.json

"repositories": [
    {
        "type": "vcs",
        "url": "https://github.com/GITHUB_USERNAME/openy"
    }
]

3. Change a version for ymcatwincities/openy to dev-8.x-1.x or any other branch. E.g.:

• branch name "bugfix" - version name dev-bugfix
• branch name "feature/workflow" - version name dev-feature/workflow

"require": {
    "ymcatwincities/openy": "dev-9.x-2.x",
}

"require": {
    "ymcatwincities/openy": "dev-feature/workflow",
}

4. Run composer update to update packages
5. Add and commits changes in docroot/profiles/contrib/openy. Now it should be pointed to your fork.

Documentation about Open Y is available at docs. For details please visit https://openy.org.

For Development information please take a look at docs/Development.

OpenY Project is licensed under the GPL-3.0. See the License file for details.