2020-02-26 10:19:43 +01:00
# Fab-manager
2015-05-05 03:10:25 +02:00
2021-04-30 16:14:05 +02:00
Fab-manager is the Fab Lab management solution. It provides a comprehensive, web-based, open-source tool to simplify your administrative tasks, and document your marker's projects.
2015-05-05 03:10:25 +02:00
2019-08-30 18:43:05 +02:00
[](https://coveralls.io/github/sleede/fab-manager)
2018-12-18 10:55:28 +01:00
[](https://hub.docker.com/r/sleede/fab-manager/)
2021-04-27 11:00:49 +02:00
[](https://hub.docker.com/r/sleede/fab-manager/builds)
2019-12-16 16:54:40 +01:00
[](https://crowdin.com/project/fab-manager)
2015-05-05 03:10:25 +02:00
2021-06-08 09:44:34 +02:00
Please visit [fab-manager.com ](https://www.fab-manager.com/ ) for more information about this software and its features.
2015-05-05 03:10:25 +02:00
2021-06-08 09:44:34 +02:00
##### Table of Contents
1. [Contributing ](#contributing )
2. [Documentation ](#documentation )
3. [Open Projects ](#open-projects )
4. [Plugins ](#plugins )
5. [Single Sign-On ](#sso )
2015-05-05 03:10:25 +02:00
2016-03-23 18:39:41 +01:00
< a name = "contributing" > < / a >
## Contributing
2015-05-05 03:10:25 +02:00
2016-03-23 18:39:41 +01:00
Contributions are welcome. Please read [the contribution guidelines ](CONTRIBUTING.md ) for more information about the contribution process.
2015-05-05 03:10:25 +02:00
2021-05-17 15:42:23 +02:00
< a name = "documentation" > < / a >
## Documentation
2016-03-23 18:39:41 +01:00
2021-05-17 15:42:23 +02:00
The full documentation is available at [doc.fab.mn ](http://doc.fab.mn ).
2016-03-23 18:39:41 +01:00
2016-05-03 11:27:01 +02:00
< a name = "open-projects" > < / a >
## Open Projects
**This configuration is optional.**
2020-02-26 10:19:43 +01:00
You can configure your Fab-manager to synchronize every project with the [Open Projects platform ](https://github.com/sleede/openlab-projects ).
It's very simple and straightforward and in return, your users will be able to search over projects from all Fab-manager instances from within your platform.
2018-07-04 16:30:19 +02:00
The deal is fair, you share your projects and as reward you benefits from projects of the whole community.
2016-05-03 11:29:14 +02:00
2020-02-26 10:19:43 +01:00
If you want to try it, you can visit [this Fab-manager ](https://fablab.lacasemate.fr/#!/projects ) and see projects from different Fab-managers.
2016-05-03 11:27:01 +02:00
To start using this awesome feature, there are a few steps:
2020-06-08 15:08:07 +02:00
- send a mail to **contact@fab-manager.com** asking for your Open Projects client's credentials and giving them the name and the URL of your Fab-manager, they will give you an `App ID` and a `secret`
- fill in the value of the keys in Admin > Projects > Settings > Projects sharing
2020-08-24 16:19:03 +02:00
- export your projects to open-projects (if you already have projects created on your Fab-manager, unless you can skip that part) executing this command: `bundle exec rails fablab:openlab:bulk_export`
2016-05-03 11:27:01 +02:00
2016-06-13 11:34:11 +02:00
**IMPORTANT: please run your server in production mode.**
2016-05-03 11:29:38 +02:00
Go to your projects gallery and enjoy seeing your projects available from everywhere ! That's all.
2016-03-23 18:39:41 +01:00
2016-06-16 18:01:45 +02:00
< a name = "plugins" > < / a >
## Plugins
2016-06-16 18:08:20 +02:00
Fab-manager has a system of plugins mainly inspired by [Discourse ](https://github.com/discourse/discourse ) architecture.
2016-06-16 18:01:45 +02:00
It enables you to write plugins which can:
- have its proper models and database tables
- have its proper assets (js & css)
- override existing behaviours of Fab-manager
- add features by adding views, controllers, ect...
To install a plugin, you just have to copy the plugin folder which contains its code into the folder `plugins` of Fab-manager.
2019-03-26 14:04:45 +01:00
You can see an example on the [repo of navinum gamification plugin ](https://github.com/sleede/navinum-gamification )
2016-06-16 18:01:45 +02:00
2016-09-12 17:29:44 +02:00
< a name = "sso" > < / a >
## Single Sign-On
Fab-manager can be connected to a [Single Sign-On ](https://en.wikipedia.org/wiki/Single_sign-on ) server which will provide its own authentication for the platform's users.
2020-05-20 10:14:44 +02:00
Currently, OAuth 2 is the only supported protocol for SSO authentication.
2016-09-12 17:29:44 +02:00
2020-05-20 10:14:44 +02:00
For an example of how to use configure an SSO in Fab-manager, please read [sso_with_github.md ](doc/sso_with_github.md ).
