IOKI Social is a CMS application that helps organizing life and work at a company. This application will facilitate providing employees with all the necessary information about the company, their work, etc. Furthermore, it will serve as means of internal communication.
This project was born out of a strong desire to improve the organization of life and work at the office. It will be strongly integrated with the company's day-to-day life. The ultimate aim of this app is to enahnce the working cycle of all employees in the company.
IOKI Social features :
- Open Source,
- 'twitter like' communication,
- office map,
- attendance list,
- holidays schedule,
- projects Dashboard,
- release schedule,
- Configuring per team,
- Like / Diss,
- group messages,
- burnout charts,
- Ordering meals,
- Teams profiles,
- small ads,
- quick polls,
- book rooms,
- timesheets,
- notifications.
-
download Vagrant http://www.vagrantup.com/downloads.html
-
download VirtualBox https://www.virtualbox.org/wiki/Downloads
check VirtualBox version to ensure that it was installed correctly, if there you see error,follow instructions to resolve it
VBoxManage --version
Install plugin for vagrant
vagrant plugin install vagrant-vbguest
mkdir ioki-social-project
cd ioki-social-project
Fork repository from GitHub project repository https://github.com/PearsonIOKI/ioki-social to your private GitHub account
Clone project from your private GitHub repository
git clone [email protected]:<yourAccountName>/ioki-social.git
Enter cloned folder:
cd ioki-social
Set remote to track changes from main repository, not from yours
git remote add upstream [email protected]:PearsonIOKI/ioki-social.git
You could now pull changes from main repository
git pull --rebase upstream master
Vagrant will install and set up everything for you, just run this command:
vagrant up
You can now start developing project. Run this command:
vagrant ssh
cd /vagrant/
Activate virtual environment
. isocial-venv/bin/activate
Start local server
python app.py
Navigate to browser and type your localhost address to see your changes
http://127.0.0.1:8080/
Other commands:
# if there were any changes changes in provision section
vagrant provision
# or reboot with provision
vagrant reload --provision
Commit changes and push it to yours GitHub fork
git push
# git push origin dev
Last thing you need to do is to open 'Pull request' of your changes on GitHub to the main repository.
Documentation is available on the wiki.
First, building, testing and reporting bug is highly appreciated. Please include console's output and reproduction step in your bug report.
Changes and improvements are more than welcome! Feel free to fork and open a pull request. Please make your changes in a specific branch and request to pull into master! If you can, please make sure the app fully works before sending the PR, as that will help speed up the process.
If you want to develop, you can look at the issues, especialy the bug and fix them. Here's a list of tasks (https://github.com/PearsonIOKI/ioki-social/issues?state=open).
Please follow the Contributions guidelines.
IOKI Social is licensed under the MIT License
http://opensource.org/licenses/mit-license.php
We really appreciate all kind of feedback and contributions. Please visit https://groups.google.com/d/forum/iokisocial or send message on [email protected].
Thanks for using and supporting IOKI Social!