Development Setup

Currently development of this apps for OC are staled and only support for bugfixes and users contribution, if some has interest in the proyect please post in issues!

• Local complete devel setup
  • Tools Setup
  • Environment Setup
  • Docker setup
• Easy Coding Contribution with github interface
  • Single pull Requests and edit file
  • Multiple Pull Requests and Edits

Local complete development setup

The setup here are only Linux and Mac !

Tools Setup

• Install Java
• Install NPM & tools
  • NodeJS Installation
  • Grunt and Bower

sudo npm install -g grunt-cli
sudo npm install -g bower

• Install [Docker] (https://docs.docker.com/installation)
• Install Maven 3.0.5
• Install ZendStudio

Environment Setup

• Just clone the repo

• Setup docker for [port forwarding and remote API] (http://kekz-box.de/wiki/index.php/Docker)

• To run all unit tests execute mvn clean test

• To run only javascript test go to one module and execute

grunt test

• For javascript unit test debugging execute:

karma start src/test/webapp/karma.conf.js

and point your browser to http://localhost:9080/

Docker Setup

• For running the all tests within a docker container:

mvn30 clean verify -Denv.BUILD_NUMBER=42 -Doc_version=OC80 -Drc_version=RC11 -Ddb_type=mysql  -Dwebdriver.base.url=http://127.0.0.1:49080/owncloud/

You can use different Roundcube version (RC07,RC08,RC09,RC10,RC11) and OwnCloud Versions (OC60,OC70,OC80) as parameter. After passing them via the above maven command you're container exposed the OwnCloud Installation via http://127.0.0.1:49080/owncloud/ and Roundcube at http://127.0.0.1:49080/roundcube/.

The Logins are the following:

• Roundcube:
  • positive@roundcube.owncloud.org / 42
  • positive2@roundcube.owncloud.org / 43
• OwnCloud:
  • positive@roundcube.owncloud.org / 42
  • admin / password

There is also phpmyadmin available at http://127.0.0.1:49080/phpmyadmin/index

• oc_testing / password

Coding contribution with github

Submitting improved code fixes and enhancements is easy:

1. Log in to GitHub

2. Fork the Repository

• https://github.com/hypery2k/owncloud
• Click "Fork" and you'll have your very own copy of the repository plugin source code at http://github.com/{your-username}/owncloud

3. Edit files within your fork. This can be done directly on GitHub.com at http://github.com/{your-username}/owncloud

4. Submit a Pull Request (tell in a issue/pull explicit details about your changes)

• Click "Pull Prequest"
• Enter a Message details that will go with your commit to be reviewed by others
• Click “Send Pull Request”

Single pull Requests and edit file

Each pull request must be more better have their own branch for changes, by this way we can discard some code from others. The github interface when submit the pull request will ask for that. There are a number of ways to create branches within your fork, but GitHub makes the process very easy.

Multiple Pull Requests and Edits

When submitting pull requests, it is extremely helpful to isolate the changes you want included from other unrelated changes you may have made to your fork of plugin repository. The easiest way to accomplish this is to use a different branch for each pull request, but if some change are in same way, a "Propose File Change" its the way to do:

1. Start by finding the file you want to edit in Typesetter's code repository at https://github.com/hypery2k/owncloud.
2. Once you have located the file, navigate to the code view and click "Edit". For example, if you want to change the xxxx.php file, the "Edit" button would appear on this page: https://github.com/hypery2k/owncloud/blob/master/xxxx.php
3. Now, edit the file as you like then click "Propose File Change"

NOTE here we use the "xxx" file as example, but this not exist in the plugin repository