Update documentation to customize the application config

This commit is contained in:
Javi Martín
2024-08-30 15:24:20 +02:00
parent 0b928e52b1
commit a4063d0ec0
8 changed files with 54 additions and 32 deletions

View File

@@ -0,0 +1,25 @@
# Customizing application configuration
## Overwriting application.rb
If you need to extend or modify the `config/application.rb` file, you can do so using the `config/application_custom.rb` file. For example, if you'd like to change the application timezone to the Canary Islands, just add:
```ruby
module Consul
class Application < Rails::Application
config.time_zone = "Atlantic/Canary"
end
end
```
In this particular case, note that the application time zone can alternatively be modified by editing the `config/secrets.yml` file.
Remember that in order to apply these changes you'll need to restart the application.
## Overwriting environment configuration
If you'd like to customize the development, test, staging, preproduction or production environments, you can do so by editing the files under `config/environments/custom/`.
Note that changes in `config/environments/custom/production.rb` are also applied to the staging and preproduction environments, and changes in `config/environments/custom/staging.rb` are also applied to the preproduction environment.
And remember that in order to apply these changes you'll need to restart the application.

View File

@@ -9,4 +9,4 @@
* [Controllers](controllers.md)
* [Components](components.md)
* [Gems](gems.md)
* [Overwriting Application](overwriting.md)
* [Application configuration](application.md)

View File

@@ -1,14 +0,0 @@
# Overwriting application.rb
If you need to extend or modify the `config/application.rb` just do it at the `config/application_custom.rb` file. For example if you want to change de default language to English, just add:
```ruby
module Consul
class Application < Rails::Application
config.i18n.default_locale = :en
config.i18n.available_locales = [:en, :es]
end
end
```
Remember that in order to see this changes live you'll need to restart the server.