|
|
@@ -0,0 +1,39 @@
|
|
|
+# Contributing to BIM
|
|
|
+
|
|
|
+To contribute to BIM, follow these steps:
|
|
|
+
|
|
|
+* Install the [requirements](#requirements)
|
|
|
+* Fork the repo
|
|
|
+* Clone it
|
|
|
+* Install the [dependencies](#installing-dependencies)
|
|
|
+* Set up the dev [environnement](#setting-up-the-dev-environnnement)
|
|
|
+* Create a topic branch from master
|
|
|
+* Change what you want to change
|
|
|
+* Push the branch to your repo
|
|
|
+* Open a pull request
|
|
|
+
|
|
|
+## Requirements
|
|
|
+
|
|
|
+* PHP
|
|
|
+* Composer
|
|
|
+* php-ldap (depending on your distro you may need to install a package (debian) or activating it in `/etc/php/php.ini` (arch))
|
|
|
+
|
|
|
+## Installing dependencies
|
|
|
+
|
|
|
+```
|
|
|
+$ cd BIM
|
|
|
+$ composer install
|
|
|
+```
|
|
|
+
|
|
|
+## Setting up the dev environnnement
|
|
|
+
|
|
|
+Copy `includes/config.ini.example` to `includes/config.ini` and edit it.
|
|
|
+
|
|
|
+> hostname : hostname or ip of ldap test server
|
|
|
+
|
|
|
+> port : port of ldap test server
|
|
|
+
|
|
|
+> basedn : where to search
|
|
|
+
|
|
|
+Then, you can start the development web server with :
|
|
|
+`php -S localhost:8080`
|