Setting up your dev environment
Pydio Code and Dependencies
Pydio code is available on Github. Clone our main repository on your local machine, and set up apache (or any web server running on your machine to server the core/src/ folder as the DocumentRoot.
git clone https://github.com/pydio/pydio-core.git
Of course, your machine should have PHP5.4+ installed, and a Database server (MySQL/PostGreSQL) as well.
sudo apt-get install nodejs nodejs-dev npm
This will allow you to recompile UI resources by running the following command inside each plugin that contains a Gruntfile.js file:
npm install grunt
The Less compiler will also be required to compile the CSS files.
npm install less
Other Useful tools
PHP Xdebug Extension
If you are working on PHP, you should as well install the PHP XDebug extension, as it can be interacting with your IDE and provide very useful way of understanding what's going on in your (or our) code.
Chrome Developer Tools
On the client side, the best set of tools ever are the Chrome Developer tools.
Pydio Debug Modes
When developing on Pydio, there are two configurations that you must be aware of in the conf/bootstrap_context.php file :
- AJXP_SERVER_DEBUG : When set to true, triggers a more verbose level of logging in the server. Coupled with that, it can be handy to switch your logger to "Text Logger" when developing, to be able to tail the content of the logs via a command line instead of by listing the content of an SQL table.
We are always very happy and excited to welcome new contributers on the code. There are just a couple of rules that you must follow in order to make the on-boarding process smooth:
- Check that there is not an on-going PR or opened issue already on the same topic.
- Sign the CLA
- Submit a Pull Request via Github.
- Don't be offended if we discuss your PR with you :-)