To update the Decidim installation on this project, first we update Gemfile dependencies, then we call the Decidim upgrade script and then we apply migrations (if any)
bundle update decidim decidim-devbin/rails decidim:upgradebin/rails db:migrate
There are some customizations that have been done to the platform. During an upgrade all the files that have been overridden need to be checked to ensure compatibility. docs/overrides.md lists all these modifications.
Requeriments (MacOS)
GraphicsMagick is required to be installed. For example (with brew): brew install graphicsmagick
Development environment installation
- Install development environment (Ruby 2.4+, PostgreSQL 9.4+). Check the following guide for instructions on different OS: https://gorails.com/setup/
- Clone the repository:
git clone git@github.com:diputacioBCN/decidim-diba.git cd decidim-diba- Install dependencies:
bundle install - Setup database:
bin/rails db:setup - Launch development server:
bin/rails server
More information can be found in the Decidim github repository: https://github.com/decidim/decidim
Run tests
Use: bin/rspec (with spring) or bundle exec rspec (without spring)
Testing emails in development
Decidim is using the letter_opener_web gem. To see all emails sent in the development environment you can do it by visiting the https://localhost:3000/letter_opener URL.
Testing LDAP integration in development
To launch a development ldap server, you can use:
rake ldap:server
You can find a sample LDAP configuration in: decidim-ldap/spec/factories.rb and a list
of users inside decidim-ldap/lib/ladle/default.ldif
Start the app with the development ldap environment variables:
export LDAP_USERNAME=uid=admin,ou=people,dc=example,dc=com
export LDAP_PASSWORD=password1234
bin/rails s
When signing in, the following fields from the default.ldif should ve used:
- uid: for the email, e.g. "Alice".
- userPassword: for the password, e.g. "password1234".
Specific issues
- The translations are available only in catalan, spanish and english.
- You can configure the minimum age of a feature using the following json:
{"edad": 20 }. By default the minimum age is 18 years old.