diff --git a/.ruby-gemset b/.ruby-gemset index cd7672936..ae4c9edf0 100644 --- a/.ruby-gemset +++ b/.ruby-gemset @@ -1 +1 @@ -fab-manager +Fab-manager diff --git a/3rd-PARTY-LICENSES.md b/3rd-PARTY-LICENSES.md index e112be4c1..5fc887b81 100644 --- a/3rd-PARTY-LICENSES.md +++ b/3rd-PARTY-LICENSES.md @@ -1,5 +1,5 @@ -Fab-Manager uses some external components, which are licenced under the +Fab-manager uses some external components, which are licenced under the terms of the following licences: - [Apache 2 license](http://www.apache.org/licenses/LICENSE-2.0): diff --git a/CHANGELOG.md b/CHANGELOG.md index 2b4dfc249..2f3310bac 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -223,7 +223,7 @@ - Improved date checks before closing an accounting period - Paginate list of coupons - Allow filtering coupons list -- Fix a bug: when VAT has changed during fab-manager's lifecycle, this may not be reflected in archives +- Fix a bug: when VAT has changed during Fab-manager's lifecycle, this may not be reflected in archives - Fix a bug: using a quote in event category's name results in angular $parse:syntax Error ## v3.0.1 2019 April 1st @@ -256,7 +256,7 @@ - [TODO DEPLOY] `rake fablab:setup:chain_invoices_records` - [TODO DEPLOY] `rake fablab:setup:chain_history_values_records` - [TODO DEPLOY] add `DISK_SPACE_MB_ALERT` and `SUPERADMIN_EMAIL` environment variables (see [doc/environment.md](doc/environment.md) for configuration details) -- [TODO DEPLOY] add the `accounting` volume to the fab-manager's image in [docker-compose.yml](docker/docker-compose.yml) +- [TODO DEPLOY] add the `accounting` volume to the Fab-manager's image in [docker-compose.yml](docker/docker-compose.yml) ## v2.8.4 2019 March 18 @@ -395,7 +395,7 @@ - Ability to share trainings on social medias - Fix a bug: a reminder notification were sent for canceled reservations - Fix a bug: sharing an event on facebook has HTML tags in the description -- Set Stripe API version, all fab-managers has to use this version because codebase relies on it +- Set Stripe API version, all Fab-managers has to use this version because codebase relies on it - Fix a security issue: OmniAuth < 1.3.2 has a security vulnerability described in [CVE-2017-18076](https://nvd.nist.gov/vuln/detail/CVE-2017-18076) - Fix a security issue: rack-protection < 1.5.5 has a security vulnerability described in [CVE-2018-1000119](https://nvd.nist.gov/vuln/detail/CVE-2018-1000119) - Fix a security issue: http gem < 0.7.3 has a security vulnerability described in [CVE-2015-1828](https://nvd.nist.gov/vuln/detail/CVE-2015-1828), updates twitter gem as a dependency @@ -666,7 +666,7 @@ - Project images will show in full-size on a click - Add a checkbox "I accept to receive informations from the FabLab" on Sign-up dialog and user's profile - Share project with Facebook/Twitter -- Display fab-manager's version in "Powered by" label, when logged as admin +- Display Fab-manager's version in "Powered by" label, when logged as admin - Load translation locales from subdirectories - Add wallet to user, client can pay total/partial reservation or subscription by wallet - Public calendar for show all trainings/machines/events diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index d7ee792fc..862ce5648 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,6 +1,6 @@ -# Contributing to FabManager +# Contributing to Fab-manager -♥ [FabManager](http://www.fab-manager.com) and want to get involved? +♥ [Fab-manager](http://www.fab-manager.com) and want to get involved? Thanks! There are plenty of ways you can help! Please take a moment to review this document in order to make the contribution process easy and effective for everyone diff --git a/README.md b/README.md index 5e88e7180..9e64b8952 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ -# FabManager +# Fab-manager -FabManager is the Fab Lab management solution. It provides a comprehensive, web-based, open-source tool to simplify your administrative tasks and your marker's projects. +Fab-manager is the Fab Lab management solution. It provides a comprehensive, web-based, open-source tool to simplify your administrative tasks and your marker's projects. [![Coverage Status](https://coveralls.io/repos/github/sleede/fab-manager/badge.svg)](https://coveralls.io/github/sleede/fab-manager) [![Docker pulls](https://img.shields.io/docker/pulls/sleede/fab-manager.svg)](https://hub.docker.com/r/sleede/fab-manager/) @@ -24,7 +24,7 @@ FabManager is the Fab Lab management solution. It provides a comprehensive, web- ## Software stack -FabManager is a Ruby on Rails / AngularJS web application that runs on the following software: +Fab-manager is a Ruby on Rails / AngularJS web application that runs on the following software: - Ubuntu LTS 14.04+ / Debian 8+ - Ruby 2.3 @@ -41,13 +41,13 @@ Contributions are welcome. Please read [the contribution guidelines](CONTRIBUTIN ## Setup a production environment -To run fab-manager as a production application, this is highly recommended to use [Docker-compose](https://docs.docker.com/compose/overview/). +To run Fab-manager as a production application, this is highly recommended to use [Docker-compose](https://docs.docker.com/compose/overview/). The procedure to follow is described in the [docker-compose readme](doc/docker-compose_readme.md). ## Setup a development environment -In you intend to run fab-manager on your local machine to contribute to the project development, you can set it up by following the [development readme](doc/development_readme.md). +In you intend to run Fab-manager on your local machine to contribute to the project development, you can set it up by following the [development readme](doc/development_readme.md). This procedure relies on docker to set-up the dependencies. Optionally, you can use a virtual development environment that relies on Vagrant and Virtual Box by following the [virtual machine instructions](virtual-machine.md). @@ -55,7 +55,7 @@ Optionally, you can use a virtual development environment that relies on Vagrant ## Internationalization (i18n) -The FabManager application can only run in a single language but this language can easily be changed. +The Fab-manager application can only run in a single language but this language can easily be changed. Please refer to the [translation readme](doc/translation_readme.md) for instructions about configuring the language or to contribute to the translation. @@ -64,17 +64,17 @@ Please refer to the [translation readme](doc/translation_readme.md) for instruct **This configuration is optional.** -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. +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. The deal is fair, you share your projects and as reward you benefits from projects of the whole community. -If you want to try it, you can visit [this fab-manager](https://fablab.lacasemate.fr/#!/projects) and see projects from different fab-managers. +If you want to try it, you can visit [this Fab-manager](https://fablab.lacasemate.fr/#!/projects) and see projects from different Fab-managers. To start using this awesome feature, there are a few steps: -- send a mail to **contact@fab-manager.com** asking for your Open Projects client's credentials and giving them the name of your fab-manager, they will give you an `OPENLAB_APP_ID` and an `OPENLAB_APP_SECRET` +- send a mail to **contact@fab-manager.com** asking for your Open Projects client's credentials and giving them the name of your Fab-manager, they will give you an `OPENLAB_APP_ID` and an `OPENLAB_APP_SECRET` - fill in the value of the keys in your environment file -- start your fab-manager app -- 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 rake fablab:openlab:bulk_export` +- start your Fab-manager app +- 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 rake fablab:openlab:bulk_export` **IMPORTANT: please run your server in production mode.** diff --git a/app/assets/javascripts/controllers/application.js.erb b/app/assets/javascripts/controllers/application.js.erb index a81e2784a..e4cba65d5 100644 --- a/app/assets/javascripts/controllers/application.js.erb +++ b/app/assets/javascripts/controllers/application.js.erb @@ -37,7 +37,7 @@ Application.Controllers.controller('ApplicationController', ['$rootScope', '$sco $rootScope.currentUser = user; Session.create(user); getNotifications(); - // fab-manager's app-version + // Fab-manager's app-version if (user.role === 'admin') { return $scope.version = Version.get(); } else { diff --git a/app/controllers/api/stylesheets_controller.rb b/app/controllers/api/stylesheets_controller.rb index db50b7268..67a5f2afb 100644 --- a/app/controllers/api/stylesheets_controller.rb +++ b/app/controllers/api/stylesheets_controller.rb @@ -1,7 +1,7 @@ # frozen_string_literal: true # API Controller for resources of type Stylesheet -# Stylesheets are used to customize the appearance of fab-manager +# Stylesheets are used to customize the appearance of Fab-manager class API::StylesheetsController < API::ApiController caches_page :show # magic happens here diff --git a/app/controllers/api/version_controller.rb b/app/controllers/api/version_controller.rb index bc3ff255b..394efe8d4 100644 --- a/app/controllers/api/version_controller.rb +++ b/app/controllers/api/version_controller.rb @@ -1,7 +1,7 @@ # frozen_string_literal: true require 'version' -# API Controller to get the fab-manager version +# API Controller to get the Fab-manager version class API::VersionController < API::ApiController before_action :authenticate_user! diff --git a/app/controllers/health_controller.rb b/app/controllers/health_controller.rb index eb07977c8..30dfd723f 100644 --- a/app/controllers/health_controller.rb +++ b/app/controllers/health_controller.rb @@ -8,7 +8,7 @@ class HealthController < ActionController::Base require 'version' render json: { - name: 'Fab-Manager', + name: 'Fab-manager', status: 'running', dependencies: { postgresql: HealthService.database?, diff --git a/app/models/stylesheet.rb b/app/models/stylesheet.rb index 4582964f5..1576be93a 100644 --- a/app/models/stylesheet.rb +++ b/app/models/stylesheet.rb @@ -1,6 +1,6 @@ # frozen_string_literal: true -# Stylesheet is a cached CSS file that allows to easily customize the interface of Fab-Manager with some configurable colors and +# Stylesheet is a cached CSS file that allows to easily customize the interface of Fab-manager with some configurable colors and # a picture for the background of the user's profile. # There's only one stylesheet record in the database, which is updated on each colour change. class Stylesheet < ActiveRecord::Base diff --git a/app/views/archive/_accounting.json.jbuilder b/app/views/archive/_accounting.json.jbuilder index de1178eb7..e4c115a0e 100644 --- a/app/views/archive/_accounting.json.jbuilder +++ b/app/views/archive/_accounting.json.jbuilder @@ -37,7 +37,7 @@ json.totals do end json.software do - json.name 'Fab-Manager' + json.name 'Fab-manager' json.version software_version json.code_checksum code_checksum end diff --git a/config/locales/app.admin.en.yml b/config/locales/app.admin.en.yml index 1672ef99c..258ae83ea 100644 --- a/config/locales/app.admin.en.yml +++ b/config/locales/app.admin.en.yml @@ -1000,10 +1000,10 @@ en: publish_will_notify: "Publish a new version will send a notification to every users." publish: "Publish" users_notified: "Platform users will be notified of the update." - about_analytics: "I agree to share anonymous data with the development team to help improve Fab-Manager." + about_analytics: "I agree to share anonymous data with the development team to help improve Fab-manager." read_more: "Which data do we collect?" analytics: - intro_analytics_html: "You'll find below a detailed view of all the data, Fab-Manager will collect if permission is granted." + intro_analytics_html: "You'll find below a detailed view of all the data, Fab-manager will collect if permission is granted." version: "Application version" members: "Number of members" admins: "Number of administrators" diff --git a/config/locales/app.admin.es.yml b/config/locales/app.admin.es.yml index 11e1bb1fb..6ee3197c8 100644 --- a/config/locales/app.admin.es.yml +++ b/config/locales/app.admin.es.yml @@ -976,10 +976,10 @@ es: publish_will_notify: "Publish a new version will send a notification to every users." publish: "Publish" users_notified: "Platform users will be notified of the update." - about_analytics: "I agree to share anonymous data with the development team to help improve Fab-Manager." + about_analytics: "I agree to share anonymous data with the development team to help improve Fab-manager." read_more: "Which data do we collect?" analytics: - intro_analytics_html: "You'll find below a detailed view of all the data, Fab-Manager will collect if permission is granted." + intro_analytics_html: "You'll find below a detailed view of all the data, Fab-manager will collect if permission is granted." version: "Application version" members: "Number of members" admins: "Number of administrators" diff --git a/config/locales/app.admin.fr.yml b/config/locales/app.admin.fr.yml index b073ad93c..fca355cad 100644 --- a/config/locales/app.admin.fr.yml +++ b/config/locales/app.admin.fr.yml @@ -1000,10 +1000,10 @@ fr: publish_will_notify: "Publier une nouvelle version enverra une notification à l'ensemble des utilisateurs." publish: "Publier" users_notified: "Les utilisateurs de la plateforme seront notifiés de la mise à jour." - about_analytics: "J'accepte de partager des données anonymes avec l'équipe de développement pour aider à améliorer Fab-Manager." + about_analytics: "J'accepte de partager des données anonymes avec l'équipe de développement pour aider à améliorer Fab-manager." read_more: "Quelles informations collectons-nous ?" analytics: - intro_analytics_html: "Vous trouverez ci-dessous une vue détaillée de toutes les données de Fab-Manager collectera si l'autorisation lui est accordée." + intro_analytics_html: "Vous trouverez ci-dessous une vue détaillée de toutes les données de Fab-manager collectera si l'autorisation lui est accordée." version: "Version de l'application" members: "Nombre de membres" admins: "Nombre d'administrateurs" @@ -1059,7 +1059,7 @@ fr: tour: conclusion: title: "Merci de votre attention" - content: "Affichez de l'aide en appuyant sur F1 à n'importe quel moment.
Bonne continuation avec Fab-Manager." + content: "Affichez de l'aide en appuyant sur F1 à n'importe quel moment.
Bonne continuation avec Fab-manager." trainings: welcome: title: "Suivi formations" @@ -1095,7 +1095,7 @@ fr: content: "Ici vous pourrez créer, modifier et supprimer des membres et des administrateurs. Vous pourrez également réaliser des imports et des exports avec des fichiers de tableur, ou connecter un logiciel de SSO." list: title: "Liste des membres" - content: "Par défaut, ce tableau liste l'ensemble des membres de votre Fab-Manager. Vous pouvez trier la liste dans un ordre différent en cliquant sur l'entête de chaque colonne." + content: "Par défaut, ce tableau liste l'ensemble des membres de votre Fab-manager. Vous pouvez trier la liste dans un ordre différent en cliquant sur l'entête de chaque colonne." search: title: "Rechercher un utilisateur" content: "Ce champ de saisie vous permet de faire une recherche en texte libre sur l'ensemble des colonnes du tableau ci-dessous." @@ -1110,10 +1110,10 @@ fr: content: "Chacun de ces boutons lance la génération d'un fichier Excel listant l'ensemble des membres, abonnements ou réservations, actuelles et passées." import: title: "Importer des membres" - content: "Permet d'importer une liste de membres à créer dans Fab-Manager, à partir d'un fichier CSV." + content: "Permet d'importer une liste de membres à créer dans Fab-manager, à partir d'un fichier CSV." admins: title: "Gérer les administrateurs" - content: "De la même manière que les membres, gérez ici les administrateurs de votre Fab-Manager.
Les administrateurs peuvent prendre des réservations pour n'importe quel membre ainsi que modifier l'ensemble des paramètres du logiciel." + content: "De la même manière que les membres, gérez ici les administrateurs de votre Fab-manager.
Les administrateurs peuvent prendre des réservations pour n'importe quel membre ainsi que modifier l'ensemble des paramètres du logiciel." groups: title: "Gérer les groupes" content: "Les groupes vous permettent de segmenter finement votre offre tarifaire." @@ -1129,7 +1129,7 @@ fr: content: "Ici, vous pourrez télécharger des factures émises et gérer tout ce qui a trait à la comptabilité et à la facturation." list: title: "Liste des factures" - content: "Par défaut, ce tableau liste l'ensemble des factures émises via Fab-Manager. Vous pouvez trier la liste dans un ordre différent en cliquant sur l'entête de chaque colonne." + content: "Par défaut, ce tableau liste l'ensemble des factures émises via Fab-manager. Vous pouvez trier la liste dans un ordre différent en cliquant sur l'entête de chaque colonne." chained: title: "Indicateur de chaînage" content: "Cette icône assure l'inaltérablité des données comptables liées à la facture sur cette ligne. Si une icône rouge apparaît au lieu de cette-ci, merci de contactez immédiatement le support technique." @@ -1215,7 +1215,7 @@ fr: settings: welcome: title: "Personnalisation de l'application" - content: "D'ici, vous pourrez configurer les réglages généraux de Fab-Manager ainsi que personnaliser différents éléments de l'interface." + content: "D'ici, vous pourrez configurer les réglages généraux de Fab-manager ainsi que personnaliser différents éléments de l'interface." home: title: "Personnaliser la page d'accueil" content: "

Cet éditeur WYSIWYG vous permet de personnaliser l'apparence de la page d'accueil tout en utilisant différents composants (dernier tweet, brève, etc.).

Attention : Gardez à l'esprit que toute modification non maîtrisée peut casser l'apparence de la page d'accueil.

" @@ -1243,7 +1243,7 @@ fr: open_api: welcome: title: "OpenAPI" - content: "Fab-Manager propose une API ouverte permettant à des logiciels tiers de s'interfacer simplement avec ses données. Cet écran vous permet d'accorder des accès à cette API." + content: "Fab-manager propose une API ouverte permettant à des logiciels tiers de s'interfacer simplement avec ses données. Cet écran vous permet d'accorder des accès à cette API." doc: title: "Documentation" content: "Cliquez ici pour accéder à la documentation en ligne de l'API" diff --git a/config/locales/app.admin.pt.yml b/config/locales/app.admin.pt.yml index 8d2b88421..fde36f238 100755 --- a/config/locales/app.admin.pt.yml +++ b/config/locales/app.admin.pt.yml @@ -1000,10 +1000,10 @@ pt: publish_will_notify: "Publish a new version will send a notification to every users." publish: "Publish" users_notified: "Platform users will be notified of the update." - about_analytics: "I agree to share anonymous data with the development team to help improve Fab-Manager." + about_analytics: "I agree to share anonymous data with the development team to help improve Fab-manager." read_more: "Which data do we collect?" analytics: - intro_analytics_html: "You'll find below a detailed view of all the data, Fab-Manager will collect if permission is granted." + intro_analytics_html: "You'll find below a detailed view of all the data, Fab-manager will collect if permission is granted." version: "Application version" members: "Number of members" admins: "Number of administrators" diff --git a/config/locales/app.public.en.yml b/config/locales/app.public.en.yml index 75bf82171..0551c11af 100644 --- a/config/locales/app.public.en.yml +++ b/config/locales/app.public.en.yml @@ -123,8 +123,8 @@ en: # Fab-manager's version version: "Version:" - upgrade_fabmanager: "Upgrade Fab-Manager" - current_version: "You are currently using version {VERSION} of Fab-Manager." + upgrade_fabmanager: "Upgrade Fab-manager" + current_version: "You are currently using version {VERSION} of Fab-manager." upgrade_to: "A new release is available. You can upgrade up to version {VERSION}." read_more: "View the details of this release" security_version_html: "Your current version is vulnerable!
A later version, currently available, includes security fixes. Upgrade as soon as possible!" diff --git a/config/locales/app.public.es.yml b/config/locales/app.public.es.yml index b1150d2ea..63f04f513 100644 --- a/config/locales/app.public.es.yml +++ b/config/locales/app.public.es.yml @@ -111,8 +111,8 @@ es: you_will_receive_in_a_moment_an_email_with_instructions_to_reset_your_password: "En un momento recibirá las instrucciones para restablecer su contraseña en su mail." #Fab-manager's version version: "Version:" - upgrade_fabmanager: "Upgrade Fab-Manager" - current_version: "You are currently using version {VERSION} of Fab-Manager." + upgrade_fabmanager: "Upgrade Fab-manager" + current_version: "You are currently using version {VERSION} of Fab-manager." upgrade_to: "A new release is available. You can upgrade up to version {VERSION}." read_more: "View the details of this release" security_version_html: "Your current version is vulnerable!
A later version, currently available, includes security fixes. Upgrade as soon as possible!" diff --git a/config/locales/app.public.fr.yml b/config/locales/app.public.fr.yml index 4b162bbf9..224522722 100644 --- a/config/locales/app.public.fr.yml +++ b/config/locales/app.public.fr.yml @@ -123,8 +123,8 @@ fr: # Fab-manager's version version: "Version :" - upgrade_fabmanager: "Mettez à jour Fab-Manager" - current_version: "Vous utilisez actuellement la version {VERSION} de Fab-Manager." + upgrade_fabmanager: "Mettez à jour Fab-manager" + current_version: "Vous utilisez actuellement la version {VERSION} de Fab-manager." upgrade_to: "Une nouvelle version est disponible. Vous pouvez mettre à jour vers la version {VERSION}." read_more: "Voir les détails de cette version" security_version_html: "Votre version actuelle est vulnérable !
Une version ultérieure, actuellement disponible, inclut des correctifs de sécurité. Mettez à jour dès que possible !" @@ -382,10 +382,10 @@ fr: tour: conclusion: title: "Merci de votre attention" - content: "Affichez de l'aide en appuyant sur F1 à n'importe quel moment.
Bonne continuation avec Fab-Manager." + content: "Affichez de l'aide en appuyant sur F1 à n'importe quel moment.
Bonne continuation avec Fab-manager." welcome: welcome: - title: "Bienvenue dans Fab-Manager" + title: "Bienvenue dans Fab-manager" content: "Afin de vous aider à bien prendre en main l'application, nous allons procéder à une rapide visite guidée des fonctionnalités." home: title: "Page d'accueil" @@ -413,7 +413,7 @@ fr: content: "Les abonnements offrent un moyen de segmenter vos tarifs et d'accorder des avantages aux utilisateurs réguliers." admin: title: "Section administrateur" - content: "L'ensemble des éléments ci-dessous ne sont accessibles qu'aux administrateurs. Ils permettent de gérer et de configurer Fab-Manager. À la fin de cette visite, cliquez sur l'un d'entre eux pour en savoir plus." + content: "L'ensemble des éléments ci-dessous ne sont accessibles qu'aux administrateurs. Ils permettent de gérer et de configurer Fab-manager. À la fin de cette visite, cliquez sur l'un d'entre eux pour en savoir plus." about: title: "À propos" content: "Une page que vous pouvez entièrement personnaliser, pour y présenter votre activité." @@ -422,10 +422,10 @@ fr: content: "Chaque fois qu'il se passe quelque chose d'important, vous serez notifié ici." profile: title: "Menu utilisateur" - content: "Retrouvez ici vos informations personnelles ainsi que toute votre activité sur Fab-Manager." + content: "Retrouvez ici vos informations personnelles ainsi que toute votre activité sur Fab-manager." version: title: "Version de l'application" - content: "Passez votre curseur sur cette icône pour connaître la version de Fab-Manager. Si vous n'êtes pas à jour, cela vous sera signalé ici et vous pourrez alors obtenir des détails en cliquant dessus." + content: "Passez votre curseur sur cette icône pour connaître la version de Fab-manager. Si vous n'êtes pas à jour, cela vous sera signalé ici et vous pourrez alors obtenir des détails en cliquant dessus." machines: welcome: title: "Gérer les machines" diff --git a/config/locales/app.public.pt.yml b/config/locales/app.public.pt.yml index 081522873..44cf3dc06 100755 --- a/config/locales/app.public.pt.yml +++ b/config/locales/app.public.pt.yml @@ -123,8 +123,8 @@ pt: # Fab-manager's version version: "Versão:" - upgrade_fabmanager: "Upgrade Fab-Manager" - current_version: "You are currently using version {VERSION} of Fab-Manager." + upgrade_fabmanager: "Upgrade Fab-manager" + current_version: "You are currently using version {VERSION} of Fab-manager." upgrade_to: "A new release is available. You can upgrade up to version {VERSION}." read_more: "View the details of this release" security_version_html: "Your current version is vulnerable!
A later version, currently available, includes security fixes. Upgrade as soon as possible!" diff --git a/config/locales/mails.en.yml b/config/locales/mails.en.yml index 1709f0226..b66edd9ee 100644 --- a/config/locales/mails.en.yml +++ b/config/locales/mails.en.yml @@ -291,7 +291,7 @@ en: notify_admin_free_disk_space: subject: "Low disk space" - body: "Warning: available disk space on the server hosting fab-manager is less than %{THRESHOLD} MiB. This can affect its operation and prevent saving some data. Currently, %{AVAILABLE} MiB of free disk space remains available on the mount point." + body: "Warning: available disk space on the server hosting Fab-manager is less than %{THRESHOLD} MiB. This can affect its operation and prevent saving some data. Currently, %{AVAILABLE} MiB of free disk space remains available on the mount point." notify_admin_close_period_reminder: subject: "Remind to close your accounting periods" diff --git a/config/locales/mails.es.yml b/config/locales/mails.es.yml index 9d18032be..649ce1799 100644 --- a/config/locales/mails.es.yml +++ b/config/locales/mails.es.yml @@ -291,7 +291,7 @@ es: notify_admin_free_disk_space: subject: "Low disk space" - body: "Warning: available disk space on the server hosting fab-manager is less than %{THRESHOLD} MiB. This can affect its operation and prevent saving some data. Currently, %{AVAILABLE} MiB of free disk space remains available on the mount point." + body: "Warning: available disk space on the server hosting Fab-manager is less than %{THRESHOLD} MiB. This can affect its operation and prevent saving some data. Currently, %{AVAILABLE} MiB of free disk space remains available on the mount point." notify_admin_close_period_reminder: subject: "Remind to close your accounting periods" diff --git a/config/locales/mails.fr.yml b/config/locales/mails.fr.yml index 0c7fc4852..904c0d02c 100644 --- a/config/locales/mails.fr.yml +++ b/config/locales/mails.fr.yml @@ -291,7 +291,7 @@ fr: notify_admin_free_disk_space: subject: "Espace disque faible" - body: "Attention : l'espace disque disponible sur le serveur hébergeant fab-manager est inférieur à %{THRESHOLD} MiO. Cela peut nuire à son bon fonctionnement et empêcher la sauvegarde de certaines données. Actuellement, il reste %{AVAILABLE} MiO d'espace libre sur le point de montage." + body: "Attention : l'espace disque disponible sur le serveur hébergeant Fab-manager est inférieur à %{THRESHOLD} MiO. Cela peut nuire à son bon fonctionnement et empêcher la sauvegarde de certaines données. Actuellement, il reste %{AVAILABLE} MiO d'espace libre sur le point de montage." notify_admin_close_period_reminder: subject: "Pensez à clôturer vos périodes comptables" diff --git a/config/locales/mails.pt.yml b/config/locales/mails.pt.yml index 7cf38e1af..57201cabd 100755 --- a/config/locales/mails.pt.yml +++ b/config/locales/mails.pt.yml @@ -291,7 +291,7 @@ pt: notify_admin_free_disk_space: subject: "Low disk space" - body: "Warning: available disk space on the server hosting fab-manager is less than %{THRESHOLD} MiB. This can affect its operation and prevent saving some data. Currently, %{AVAILABLE} MiB of free disk space remains available on the mount point." + body: "Warning: available disk space on the server hosting Fab-manager is less than %{THRESHOLD} MiB. This can affect its operation and prevent saving some data. Currently, %{AVAILABLE} MiB of free disk space remains available on the mount point." notify_admin_close_period_reminder: subject: "Remind to close your accounting periods" diff --git a/db/migrate/20191127153729_create_i_calendars.rb b/db/migrate/20191127153729_create_i_calendars.rb index b9b558a0f..7b64522a8 100644 --- a/db/migrate/20191127153729_create_i_calendars.rb +++ b/db/migrate/20191127153729_create_i_calendars.rb @@ -1,7 +1,7 @@ # frozen_string_literal: true # From this migration, we store URL to iCalendar files and a piece of configuration about them. -# This allows to display the events of these external calendars in fab-manager +# This allows to display the events of these external calendars in Fab-manager class CreateICalendars < ActiveRecord::Migration def change create_table :i_calendars do |t| diff --git a/doc/development_readme.md b/doc/development_readme.md index afdb92a4e..3c26c9de0 100644 --- a/doc/development_readme.md +++ b/doc/development_readme.md @@ -1,6 +1,6 @@ -# Install Fab-Manager in a development environment with Docker +# Install Fab-manager in a development environment with Docker -This document will guide you through all the steps needed to set up a development environment for Fab-Manager. +This document will guide you through all the steps needed to set up a development environment for Fab-manager. ##### Table of contents @@ -42,7 +42,7 @@ This procedure is not easy to follow so if you don't need to write some code for sudo reboot ``` -6. Create a docker network for fab-manager. +6. Create a docker network for Fab-manager. You may have to change the network address if it is already in use. > 🍏 If you're using MacOS, this is not required. ```bash @@ -132,7 +132,7 @@ This procedure is not easy to follow so if you don't need to write some code for foreman s -p 3000 ``` -16. You should now be able to access your local development FabManager instance by accessing `http://localhost:3000` in your web browser. +16. You should now be able to access your local development Fab-manager instance by accessing `http://localhost:3000` in your web browser. 17. You can login as the default administrator using the credentials defined previously. @@ -162,12 +162,12 @@ We will use docker to easily install the required version of PostgreSQL. postgres:9.6 ``` -3. Configure fab-manager to use it. +3. Configure Fab-manager to use it. On linux systems, PostgreSQL will be available at 172.18.0.2. On MacOS, you'll have to set the host to 127.0.0.1 (or localhost). See [environment.md](environment.md) for more details. -4 . Finally, you may want to have a look at detailed informations about PostgreSQL usage in fab-manager. +4 . Finally, you may want to have a look at detailed informations about PostgreSQL usage in Fab-manager. Some information about that is available in the [PostgreSQL Readme](postgresql_readme.md). @@ -175,7 +175,7 @@ We will use docker to easily install the required version of PostgreSQL. ElasticSearch is a powerful search engine based on Apache Lucene combined with a NoSQL database used as a cache to index data and quickly process complex requests on it. -In FabManager, it is used for the admin's statistics module and to perform searches in projects. +In Fab-manager, it is used for the admin's statistics module and to perform searches in projects. ### Install ElasticSearch @@ -205,7 +205,7 @@ In FabManager, it is used for the admin's statistics module and to perform searc elasticsearch:5.6 ``` -4. Configure fab-manager to use it. +4. Configure Fab-manager to use it. On linux systems, ElasticSearch will be available at 172.18.0.3. On MacOS, you'll have to set the host to 127.0.0.1 (or localhost). See [environment.md](environment.md) for more details. diff --git a/doc/docker-compose_readme.md b/doc/docker-compose_readme.md index 650863947..6a031d055 100644 --- a/doc/docker-compose_readme.md +++ b/doc/docker-compose_readme.md @@ -1,9 +1,9 @@ -# Install Fab-Manager in production with docker-compose +# Install Fab-manager in production with docker-compose -This document will guide you through all the steps needed to set up your Fab-Manager app on a production server, based on a solution using Docker and Docker-compose. +This document will guide you through all the steps needed to set up your Fab-manager app on a production server, based on a solution using Docker and Docker-compose. We recommend DigitalOcean, but these steps will work on any Docker-compatible cloud provider or local server. -In order to make it work, please use the same directories structure as described in this guide in your Fab-Manager app folder. +In order to make it work, please use the same directories structure as described in this guide in your Fab-manager app folder. You will need to be root through the rest of the setup. ##### Table of contents @@ -39,7 +39,7 @@ Here's a non exhaustive list: Choose one, depending on your budget, on the server's location, on the uptime guarantee, etc. -You will need at least 2GB of addressable memory (RAM + swap) to install and use FabManager. +You will need at least 2GB of addressable memory (RAM + swap) to install and use Fab-manager. We recommend 4 GB RAM for larger communities. On DigitalOcean, create a Droplet with One-click apps **"Docker on Ubuntu 16.04 LTS"**. @@ -71,7 +71,7 @@ connect to the server with `ssh root@your-domain-name`. ### Prepare the server -Before installing fab-manager, we recommend you to: +Before installing Fab-manager, we recommend you to: - Upgrade your system - Setup the server timezone - Add at least 2GB of swap memory @@ -84,16 +84,16 @@ You can run the following script as root to easily perform all these operations: ``` -## Install Fab-Manager +## Install Fab-manager -Run the following command to install Fab-Manager. +Run the following command to install Fab-manager. This script will guide you through the installation process by checking the requirements and asking you the configuration elements. ```bash \curl -sSL setup.fab-manager.com | bash ``` -**OR**, if you don't want to install fab-manager in `/apps/fabmanager`, use the following instead: +**OR**, if you don't want to install Fab-manager in `/apps/fabmanager`, use the following instead: ```bash \curl -sSL setup.fab-manager.com | bash -s "/my/custom/path" ``` @@ -142,14 +142,14 @@ docker-compose run --rm -e ADMIN_EMAIL=xxx -e ADMIN_PASSWORD=xxx fabmanager bund ## Update Fab-manager -*This procedure updates Fab-Manager to the most recent version by default.* +*This procedure updates Fab-manager to the most recent version by default.* > ⚠ If you are upgrading from a very outdated version, you must first upgrade to v2.8.3, then to v3.1.2 and finally to the last version ### Steps -When a new version is available, follow this procedure to update fab-manager app in a production environment, using docker-compose. +When a new version is available, follow this procedure to update Fab-manager app in a production environment, using docker-compose. You can subscribe to [this atom feed](https://github.com/sleede/fab-manager/releases.atom) to get notified when a new release comes out. 1. go to your app folder diff --git a/doc/elastic_upgrade.md b/doc/elastic_upgrade.md index c07e1f128..ceb62b652 100644 --- a/doc/elastic_upgrade.md +++ b/doc/elastic_upgrade.md @@ -3,7 +3,7 @@ ## Automatic upgrade Fab-manager release 2.6.5 has upgraded its dependency to ElasticSearch from version 1.7 to version 5.6 as the previous was unsupported for months. -To keep using fab-manager you need to upgrade your installation with the new version. +To keep using Fab-manager you need to upgrade your installation with the new version. We've wrote a script to automate the process while keeping your data integrity, but there's some requirements to understand before running it. - You need to install *curl*, *jq*, *GNU awk* and *sudo* on your system before running the script. @@ -16,7 +16,7 @@ We've wrote a script to automate the process while keeping your data integrity, Please ensure that you'll have enough space, considering the point above. The script won't run otherwise. - This script will run on any Linux or Macintoch systems if you installed ElasticSearch using docker or docker-compose. Otherwise, only Debian compatible OS (like Ubuntu) and MacOS X are supported for classical installations. On any other cases you'll need to perform the upgrade yourself manually. -- If your ElasticSearch instance uses replicas shards, you can't use this script and you must perform a manual upgrade (if you have a standard fab-manager installation and you don't understand what this mean, you're probably not concerned). +- If your ElasticSearch instance uses replicas shards, you can't use this script and you must perform a manual upgrade (if you have a standard Fab-manager installation and you don't understand what this mean, you're probably not concerned). Once you've understood all the points above, you can run the migration script with the following: diff --git a/doc/postgres_upgrade.md b/doc/postgres_upgrade.md index a73d47551..00bc9fda7 100644 --- a/doc/postgres_upgrade.md +++ b/doc/postgres_upgrade.md @@ -3,7 +3,7 @@ ## Automatic upgrade Fab-manager release 4.2.0 has upgraded its dependency to PostgreSQL from version 9.4 to version 9.6 as the previous won't be maintained from february 2020. -To keep using fab-manager you need to upgrade your installation with the new version. +To keep using Fab-manager you need to upgrade your installation with the new version. We've wrote a script to automate the process while keeping your data integrity, but there's some requirements to understand before running it. - You need to install *curl*, *GNU awk* and *sudo* on your system before running the script. diff --git a/doc/postgresql_readme.md b/doc/postgresql_readme.md index be4fda6b3..1d95dcddb 100644 --- a/doc/postgresql_readme.md +++ b/doc/postgresql_readme.md @@ -1,4 +1,4 @@ -# Detailed informations about PostgreSQL usage in fab-manager +# Detailed informations about PostgreSQL usage in Fab-manager ## Run the PostgreSQL command line interface @@ -51,7 +51,7 @@ psql -U postgres -d fabmanager_production -f fabmanager_production_$(date -I).sq - While setting up the database, we'll need to activate two PostgreSQL extensions: [unaccent](https://www.postgresql.org/docs/current/static/unaccent.html) and [trigram](https://www.postgresql.org/docs/current/static/pgtrgm.html). This can only be achieved if the user, configured in `config/database.yml`, was granted the _SUPERUSER_ role **OR** if these extensions were white-listed. So here's your choices, mainly depending on your security requirements: - - Use the default PostgreSQL super-user (postgres) as the database user. This is the default behavior in fab-manager. + - Use the default PostgreSQL super-user (postgres) as the database user. This is the default behavior in Fab-manager. - Set your user as _SUPERUSER_; run the following command in `psql` (after replacing `username` with you user name): ```sql diff --git a/doc/sso_authentication.md b/doc/sso_authentication.md index 62e6da0ce..835c313fa 100644 --- a/doc/sso_authentication.md +++ b/doc/sso_authentication.md @@ -1,6 +1,6 @@ -# How to add an authentication method to the Fab-Manager ? +# How to add an authentication method to the Fab-manager ? -First, take a look at the [OmniAuth list of strategies](https://github.com/intridea/omniauth/wiki/List-of-Strategies) for the Strategy or Developer Strategy you want to add to the Fab-Manager. +First, take a look at the [OmniAuth list of strategies](https://github.com/intridea/omniauth/wiki/List-of-Strategies) for the Strategy or Developer Strategy you want to add to the Fab-manager. For this guide, we will consider you want to add a generic *developer strategy*, like LDAP. @@ -36,7 +36,7 @@ class LdapProvider < ActiveRecord::Base has_many :ldap_mappings, dependent: :destroy accepts_nested_attributes_for :ldap_mappings, allow_destroy: true - # return the fields you want to protect from being directly managed by the Fab-Manager, typically mapped fields + # return the fields you want to protect from being directly managed by the Fab-manager, typically mapped fields def protected_fields fields = [] ldap_mappings.each do |mapping| @@ -141,4 +141,4 @@ And to include this interface into the existing one ( **app/assets/templates/adm ``` -Do not forget that you can find examples and inspiration in the OAuth 2.0 implementation. \ No newline at end of file +Do not forget that you can find examples and inspiration in the OAuth 2.0 implementation. diff --git a/doc/sso_with_github.md b/doc/sso_with_github.md index ac048e63c..5275b91f4 100644 --- a/doc/sso_with_github.md +++ b/doc/sso_with_github.md @@ -1,24 +1,24 @@ # How to configure Fab-manager to use a Single Sign-On authentication? -For this guide, we will use [GitHub](https://developer.github.com/v3/oauth/) as an example authentication provider, because it uses OAuth 2.0 which is currently implemented in fab-manager, it has a standard implementation of the protocol and it is free to use for everyone. +For this guide, we will use [GitHub](https://developer.github.com/v3/oauth/) as an example authentication provider, because it uses OAuth 2.0 which is currently implemented in Fab-manager, it has a standard implementation of the protocol and it is free to use for everyone. - First, you must have a GitHub account. This is free, so create one if you don't have any. Visit https://github.com/join?source=login to create an account. -- Secondly, you will need to register your fab-manager instance as an application in GitHub. +- Secondly, you will need to register your Fab-manager instance as an application in GitHub. Visit https://github.com/settings/applications/new to register your instance. - - In `Application name`, we advise you to set the same name as your fab-manager's instance title. - - In `Homepage URL`, put the public URL where your fab-manager's instance is located (eg. https://example.com). + - In `Application name`, we advise you to set the same name as your Fab-manager's instance title. + - In `Homepage URL`, put the public URL where your Fab-manager's instance is located (eg. https://example.com). - In `Authorization callback URL`, you must specify an URL that will match this scheme: https://example.com/users/auth/oauth2-github/callback - - **example.com** is your own fab-manager's address - - **oauth2-github** match the provider's "strategy name" in the fab-manager. + - **example.com** is your own Fab-manager's address + - **oauth2-github** match the provider's "strategy name" in the Fab-manager. It is composed of: **SSO's protocol**, _dash_, **slug of the provider's name**. - If you have a doubt about what it will be, set any value, create the authentication provider in your fab-manager (see below), then the strategy's name will be shown in the providers list. + If you have a doubt about what it will be, set any value, create the authentication provider in your Fab-manager (see below), then the strategy's name will be shown in the providers list. Afterwards, edit your app on GitHub to set the correct name. - You'll be redirected to a page displaying two important information: your **Client ID** and your **Client Secret**. -- Now go to your fab-manager's instance, login as an administrator, go to `Users management` and `Authentication`. +- Now go to your Fab-manager's instance, login as an administrator, go to `Users management` and `Authentication`. Click `Add a new authentication provider`, and select _OAuth 2.0_ in the `Authentication type` drop-down list. In `name`, you can set whatever you want, but you must be aware that: 1. You will need to type this name in a terminal to activate the provider, so prefer avoiding chars that must be escaped. @@ -33,7 +33,7 @@ For this guide, we will use [GitHub](https://developer.github.com/v3/oauth/) as - **Client identifier**: Your Client ID, collected just before. - **Client secret**: Your Client Secret, collected just before. -- Then you will need to define the matching of the fields between the fab-manager and what the external SSO can provide. +- Then you will need to define the matching of the fields between the Fab-manager and what the external SSO can provide. Please note that the only mandatory field is `User.uid`. To continue with our GitHub example, you will need to look at [this documentation page](https://developer.github.com/v3/users/#get-the-authenticated-user) to know witch field can be mapped and how, and [this one](https://developer.github.com/v3/) to know the root URL of the API. - **Model**: `User` diff --git a/doc/translation_readme.md b/doc/translation_readme.md index 16b85d761..c646e6fcc 100644 --- a/doc/translation_readme.md +++ b/doc/translation_readme.md @@ -1,6 +1,6 @@ -# Fab-Manager translation documentation +# Fab-manager translation documentation -This document will explain you what you need to know to contribute to the translation process of Fab-Manager. +This document will explain you what you need to know to contribute to the translation process of Fab-manager. ##### Table of contents @@ -19,14 +19,14 @@ This document will explain you what you need to know to contribute to the transl ### Using a TMS -We use [Crowdin](https://www.crowdin.com), a translation management system (TMS) to simplify translator's job in fab-manager. +We use [Crowdin](https://www.crowdin.com), a translation management system (TMS) to simplify translator's job in Fab-manager. You can access it at [translate.fab-manager.com](https://translate.fab-manager.com) and start translating to one of the already configured languages. -If you want to translate Fab-Manager to a new language, just send us an email to [contact@fab-manager.com](mailto:contact@fab-manager.com) and we'll add this new language to the TMS. +If you want to translate Fab-manager to a new language, just send us an email to [contact@fab-manager.com](mailto:contact@fab-manager.com) and we'll add this new language to the TMS. ### Using In-Context translation To translate the front-end application (angularJS client), and the notifications, you can use [Crowdin In-Context](https://crowdin.com/page/in-context-localization). -This allows you to use Fab-Manager as normally, but with the addition of small "edit" icons on the top-left corner of each text blocs. +This allows you to use Fab-manager as normally, but with the addition of small "edit" icons on the top-left corner of each text blocs. Clicking on this "edit" icon will open the Crowdin translation interface and you'll be able to translate or modify existing translations directly. You can access it at [in-context.translate.fab-manager.com](https://in-context.translate.fab-manager.com/). diff --git a/lib/fab_hub.rb b/lib/fab_hub.rb index 479d45335..82c33e3b1 100644 --- a/lib/fab_hub.rb +++ b/lib/fab_hub.rb @@ -1,6 +1,6 @@ # frozen_string_literal: true -# Fab-Manager central hub (remote host) +# Fab-manager central hub (remote host) class FabHub def self.version_check_payload { diff --git a/lib/plugin/instance.rb b/lib/plugin/instance.rb index 2d3269fc4..4fb9ced63 100644 --- a/lib/plugin/instance.rb +++ b/lib/plugin/instance.rb @@ -3,7 +3,7 @@ require 'fileutils' require 'plugin_registry' -# fab-manager extensible functionalities +# Fab-manager extensible functionalities module Plugin; end class Plugin::Instance diff --git a/package.json b/package.json index 520746dca..c9f03b2ee 100644 --- a/package.json +++ b/package.json @@ -1,7 +1,7 @@ { "name": "fab-manager", "version": "4.3.0-dev", - "description": "FabManager is the FabLab management solution. It provides a comprehensive, web-based, open-source tool to simplify your administrative tasks and your marker's projects.", + "description": "Fab-manager is the FabLab management solution. It provides a comprehensive, web-based, open-source tool to simplify your administrative tasks and your marker's projects.", "keywords": [ "fablab", "reservations", diff --git a/scripts/elastic-upgrade.sh b/scripts/elastic-upgrade.sh index 9a06fc4e4..c264aff02 100755 --- a/scripts/elastic-upgrade.sh +++ b/scripts/elastic-upgrade.sh @@ -77,7 +77,7 @@ config() fi FM_PATH=$(pwd) TYPE="NOT-FOUND" - read -rp "Is fab-manager installed at \"$FM_PATH\"? (y/n) " confirm "$FABMANAGER_PATH/config/env" # nginx configuration @@ -204,7 +204,7 @@ get_md_anchor() configure_env_file() { printf "\n\nWe will now configure the environment variables.\n" - echo "This allows you to customize Fab-Manager's appearance and behavior." + echo "This allows you to customize Fab-manager's appearance and behavior." read -rp "Proceed? (Y/n) " confirm