{"id":20779113,"url":"https://github.com/solidusio/solidus_i18n","last_synced_at":"2025-05-16T15:07:03.764Z","repository":{"id":1985087,"uuid":"45206183","full_name":"solidusio/solidus_i18n","owner":"solidusio","description":":earth_asia: This is the Internationalization project for Solidus","archived":false,"fork":false,"pushed_at":"2024-07-18T14:39:36.000Z","size":7538,"stargazers_count":63,"open_issues_count":19,"forks_count":130,"subscribers_count":10,"default_branch":"main","last_synced_at":"2025-04-12T12:54:51.434Z","etag":null,"topics":["ecommerce","ecommerce-platform","hacktoberfest","internationalization","language","solidus","solidus-extensions","translations"],"latest_commit_sha":null,"homepage":"https://solidus.io","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/solidusio.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"open_collective":"solidus"}},"created_at":"2015-10-29T19:39:04.000Z","updated_at":"2025-03-17T10:33:57.000Z","dependencies_parsed_at":"2023-11-22T14:31:07.852Z","dependency_job_id":"aec20d41-28eb-4f74-8186-abbb3b7dfffb","html_url":"https://github.com/solidusio/solidus_i18n","commit_stats":{"total_commits":1023,"total_committers":302,"mean_commits":"3.3874172185430464","dds":0.9305962854349952,"last_synced_commit":"a262c6174aa6b913c4502e758cae46dd1f1df8ba"},"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solidusio%2Fsolidus_i18n","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solidusio%2Fsolidus_i18n/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solidusio%2Fsolidus_i18n/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solidusio%2Fsolidus_i18n/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/solidusio","download_url":"https://codeload.github.com/solidusio/solidus_i18n/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254553959,"owners_count":22090417,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ecommerce","ecommerce-platform","hacktoberfest","internationalization","language","solidus","solidus-extensions","translations"],"created_at":"2024-11-17T13:26:06.066Z","updated_at":"2025-05-16T15:07:03.723Z","avatar_url":"https://github.com/solidusio.png","language":"Ruby","funding_links":["https://opencollective.com/solidus"],"categories":[],"sub_categories":[],"readme":"# Solidus Internationalization\n\n[![CircleCI](https://circleci.com/gh/solidusio/solidus_i18n.svg?style=svg)](https://circleci.com/gh/solidusio/solidus_i18n)\n[![Gem Version](https://badge.fury.io/rb/solidus_i18n.svg)](https://badge.fury.io/rb/solidus_i18n)\n\nThis is the Internationalization project for [Solidus](https://solidus.io)\n\n---\n\n## Changes in Version 2.0\n\nsolidus_i18n Version 2.0+ only contains translation files.\n\nPrevious versions of solidus_i18n included extra functionality like locale\nselectors and which is now built in to Solidus 2.6+. Configuration for\n`routing-filter` has also been removed and must be configured manually\n(See [Locale in URL](#locale-in-url)).\n\n## Installation\n\nAdd the following to your `Gemfile`:\n\n```ruby\ngem 'solidus_i18n'\ngem 'rails-i18n'\ngem 'kaminari-i18n'\n```\n\n## Locale in URL\n\nOlder versions of solidus_i18n included the routing-filter gem and configured routes to include the locale in the URL.\nThis is still supported (maybe even recommended) but requires some additional configuration.\n\n1. Add this gem to your `Gemfile`, then run `bundle install`\n\n``` ruby\ngem 'routing-filter'\n```\n\n2. Add `filter :locale` to your `config/routes.rb`\n\n``` ruby\nRails.application.routes.draw do\n  filter :locale\n\n  mount Spree::Core::Engine, at: '/'\nend\n```\n\n3. Configure routing-fitler in `config/initializers/locale_filter.rb` (optional)\n\n``` ruby\n# Do not include the default locale in the URL\nRoutingFilter::Locale.include_default_locale = false\n```\n\n## Supported languages\n\nWe currently support the [following locales](https://github.com/solidusio/solidus_i18n/tree/main/config/locales)\nby default. If you need a locale that is not in the list you can add a custom\ntranslation file into your application by following the\n[Rails translations guide](http://guides.rubyonrails.org/i18n.html#how-to-store-your-custom-translations).\n\n## Updating Translations\n\nIf you want to improve the translations on your language, run the tasks:\n\n    bundle exec rake solidus_i18n:update_default\n    bundle exec i18n-tasks add-missing --nil-value --locale \u003cLOCALE\u003e\n\nSubstitute \u003cLOCALE\u003e with your locale code (e.g: `it`).\n\nThis will do a cleanup and prepare `\u003cLOCALE\u003e.yml` with all the missing keys.\nYou can then write the translations and open a pull request.\n\n## Model Translations\n\nWe **removed** support for translating models into [a separate Gem](https://github.com/solidusio-contrib/solidus_globalize).\n\nPlease update your `Gemfile` if you still need the model translations.\n\n```ruby\n# Gemfile\ngem 'solidus_globalize', github: 'solidusio-contrib/solidus_globalize', branch: 'master'\n```\n\n## Localizing country names\n\nYou can translate country names by defining `spree.country_names` in your own locale files. For example, to have countries in Spanish do:\n\n```yml\nes:\n  spree:\n    country_names:\n      US: Estados Unidos de América\n      UK: Reino Unido\n      CA: Canadá\n      # ...\n```\n\nSome supported languages already define localized country names. Take a look at this repo's `.yml` files for your locale to confirm if we already provide translations.\n\nContributing\n------------\n\nSolidus is an open source project and we encourage contributions. Please read\n[CONTRIBUTING.md](CONTRIBUTING.md) before contributing.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsolidusio%2Fsolidus_i18n","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsolidusio%2Fsolidus_i18n","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsolidusio%2Fsolidus_i18n/lists"}