decidim-term_customizer 0.16.6 → 0.17.0

data/config/locales/fi.yml

@@ -10,72 +10,118 @@ fi:
         value: Kustomoitu termi
       translation_set:
         name: Nimi
-  decidim:
-    admin:
-      actions:
-        add_multiple_translations: Lisää useita
-        back: Takaisin
-        clear_cache: Tyhjennä välimuisti
-        new_translation_set: Uusi käännöspaketti
-        new_translation: Uusi käännös
+      translations_import:
+        file: Tuo tiedosto
+    errors:
       models:
-        translation_sets:
-          fields:
-            name: Nimi
-        translations:
-          fields:
-            key: Käännösavain
-            original_term: Alkuperäinen termi
-            term: Kustomoitu termi
-      titles:
-        translation_sets: Käännöspaketit
-        translations: Käännökset
+        translations_import:
+          attributes:
+            file:
+              invalid_mime_type: 'Virheellinen tiedostotyyppi. Hyväksytyt tiedostomuodot ovat: %{valid_mime_types}'
+  decidim:
     term_customizer:
       admin:
+        actions:
+          add_multiple_translations: Lisää useita
+          back: Takaisin
+          cancel: Peruuta
+          clear_cache: Tyhjennä välimuisti
+          help: Ohjeet
+          import: Tuo
+          new_translation: Uusi käännös
+          new_translation_set: Uusi käännöspaketti
         add_translations:
           index:
             add: Lisää
+            help_html: "<p>Aloita kirjoittamalla muutama ensimmäinen kirjain, jotka esiintyvät termissä, jonka haluat muuttaa. Odota muutama sekunti, niin hakukentän alle ilmestyy lista kaikista termeistä, joista kirjoittamasi hakutermi löytyy. Valitse listasta klikkaamalla ne termit, joita haluat muuttaa. Ne ilmestyvät hakukentän alle lisättävien termien listaan.</p>\n<p>Kun olet lisännyt kaikki termit, jotka haluat muuttaa, klikkaa listan alla olevaa \"%{button_name}\" -painiketta ruudun alalaidasta.</p>"
+            help_title: Kuinka käännöksiä etsitään?
             search: Hae
         caches:
           clear:
             success: Välimuistin tyhjennys onnistui
+        models:
+          translation_sets:
+            fields:
+              name: Nimi
+          translations:
+            fields:
+              key: Käännösavain
+              original_term: Alkuperäinen termi
+              term: Kustomoitu termi
+        titles:
+          add_multiple_translations: Lisää useita
+          translation_sets: Käännöspaketit
+          translations: Käännökset
         translation_sets:
           constraint_fields:
             constraint: Rajaussääntö
             remove: Poista
           create:
-            success: Käännöspaketin luonti onnistui.
             error: Käännöspaketin luonti epäonnistui.
+            success: Käännöspaketin luonti onnistui.
           destroy:
             success: Käännöspaketin poisto onnistui.
           edit:
-            title: Käännöspaketti
             save: Tallenna
+            title: Käännöspaketti
           form:
             add_constraint: Lisää rajaussääntö
-            title: Käännöspaketti
+            constraint_help_html: <p>Rajaussääntöjen avulla voit rajata käännöspaketin muutokset ainoastaan tiettyyn kontekstiin sivustolla.</p><p>Mikäli et määritä mitään sääntöjä, tämän käännöspaketin termikustomoinnit tulevat käyttöön koko applikaatioon. Toisaalta, jos haluat rajata tämän käännöspaketin kustomoinnit ainoastaan tiettyyn prosessiin, valitse "Osallisuusprosessit" osallisuustilaksi ja määritä haluamasi prosessi osallisuustila-kenttään. Voit myös liittää kustomoinnit ainoastaan tiettyyn komponenttiin määrittämällä kyseisen komponentin komponentti-kenttään.</p><p>Jos määrität useita rajaussääntöjä, termikustomointeja käytetään kaikkialla, jokin kyseisistä säännöistä pätee.</p>
+            constraint_help_title: Mitä ovat rajaussäännöt?
+            help_html: <p>Käännöspaketti, on "paketti", joka sisältää käännöksiä tietylle kontekstille, jonka termejä haluat muuttaa.</p><p>Käännöspaketit auttavat sinua pitämään kustomointisi järjestyksessä ja rajaamaan niitä tiettyihin konteksteihin. Tämä mahdollistaa sen, että voit esimerkiksi muuttaa saman termin eri tavalla sivuston eri paikoissa.</p><p>Mikäli haluat esimerkiski muuttaa "Lisää" -napin tekstin erilaiseksi eri prosesseille, voit luoda kaksi erillistä käännöspakettia molempia prosesseja varten. Molemmat paketit rajataan kyseisiin prosesseihin rajaussääntöjen avulla.</p>
+            help_title: Mikä on käännöspaketti?
+            title: Käännöspaketti.
+          index:
+            no_records_html: <p>Ei käännöspaketteja.</p><p>Aloita lisäämällä käännöspaketti "<a href="%{new_set_link}">%{button_name}</a>" -napin avulla.</p>
           new:
             create: Luo
             title: Käännöspaketit
           update:
-            success: Käännöspaketin päivitys onnistui.
             error: Käännöspaketin päivitys epäonnistui.
+            success: Käännöspaketin päivitys onnistui.
         translations:
           create:
-            success: Käännöksen luonti onnistui.
             error: Käännöksen luonti epäonnistui.
+            success: Käännöksen luonti onnistui.
           destroy:
             success: Käännöksen poisto onnistui.
           edit:
-            title: Käännös
             save: Tallenna
+            title: Käännös
           form:
+            help_html: <p>Käännösavain on tekninen viittaus käännökseen. Tämä ei siis ole se termi, jonka haluat muuttaa, vaan tekninen avain, joka viittaa kyseiseen termiin.</p><p>Mikäli haluat muuttaa esimerkiksi sanan <em>"Prosessit"</em> ylävalikosta, voit käyttää käännösavainta <em>"decidim.menu.processes"</em>.</p><p><a href="https://guides.rubyonrails.org/i18n.html" target="_blank">Lue lisää Rails-kehyksen käännöksistä</a>.</p>
+            help_title: Mikä on käännösavain?
+            term_help_html: "<p>Kustomoitu termi on lopullinen sana, jonka haluat esiintyvän käyttöliittymässä alkuperäisen termin sijaan. Luonnollisesti, kustomoitu termi voi olla erilainen kaikille käytössä oleville kielille.</p>"
+            term_help_title: Mikä on kustomoitu termi?
             title: Käännös
+          import:
+            error: Käännösten tuonti epäonnistui
+            success: Käännösten tuonti onnistui.
+          index:
+            actions: Toiminnot
+            no_records_html: <p>Ei käännöksiä tässä paketissa.</p><p>Aloita lisäämällä käännöksiä tähän pakettiin. Helpoin tapa on käyttää "<a href="%{add_multiple_link}">%{button_name}</a>" -painiketta, jota painamalla voit etsiä käännöksiä niillä termeillä, jotka näet käyttöliittymässä.</p>
+            selected: valittu
           new:
             create: Luo
             title: Käännökset
+          new_import:
+            accepted_mime_types:
+              csv: CSV
+              json: JSON
+              xls: XLS
+            file_legend: 'Lisää tiedosto, josta käännöksiä tuodaan. Hyväksytyt tiedostomuodot ovat: %{valid_mime_types}'
+            start_import: Aloita tuonti
+            title: Tuo käännöksiä
+            zip_hint: Voit myös ladata ZIP-tiedoston, jonka olet luonut käännösten vientitoiminnolla.
           update:
-            success: Käännöksen päivitys onnistui.
             error: Käännöksen päivitys epäonnistui.
+            success: Käännöksen päivitys onnistui.
+        translations_destroys:
+          destroy:
+            error: Käännösten poistaminen epäonnistui.
+            success: Käännösten poistaminen onnistui.
+          new:
+            destroy: Poista
+            title: Käännösten poisto
       menu:
         term_customizer: Termien kustomoinnit

data/config/locales/fr.yml

@@ -10,72 +10,118 @@ fr:
         value: terme modifié
       translation_set:
         name: Nom
-  decidim:
-    admin:
-      actions:
-        add_multiple_translations: Ajouter plusieurs
-        back: Retour
-        clear_cache: Purger le cache
-        new_translation_set: Nouveau jeu de traduction
-        new_translation: Nouvelle traduction
+      translations_import:
+        file: Import file
+    errors:
       models:
-        translation_sets:
-          fields:
-            name: Nom
-        translations:
-          fields:
-            key: Clé de traduction
-            original_term: Terme original
-            term: terme modifié
-      titles:
-        translation_sets: Jeu de traductions
-        translations: Traductions
+        translations_import:
+          attributes:
+            file:
+              invalid_mime_type: 'Invalid file type. Accepted formats are: %{valid_mime_types}'
+  decidim:
     term_customizer:
       admin:
+        actions:
+          add_multiple_translations: Ajouter plusieurs
+          back: Retour
+          cancel: Cancel
+          clear_cache: Purger le cache
+          help: Help
+          import: Import
+          new_translation: Nouvelle traduction
+          new_translation_set: Nouveau jeu de traduction
         add_translations:
           index:
             add: Ajouter
+            help_html: <p>Start by typing a couple of letters appearing in the term that you want to change in the search panel. Wait for few seconds and a list of all translations matching your search will be displayed below the search field. Click the translations in that list that you want to change. They will appear below the search field in the list of translations to be added.</p> <p>Once you have added all the translations that you want to change, click the "%{button_name}" button at the bottom of the screen.</p>
+            help_title: How to search for translations?
             search: Rechercher
         caches:
           clear:
             success: Cache purgé avec succès
+        models:
+          translation_sets:
+            fields:
+              name: Nom
+          translations:
+            fields:
+              key: Clé de traduction
+              original_term: Terme original
+              term: Terme modifié
+        titles:
+          add_multiple_translations: Ajouter plusieurs
+          translation_sets: Jeu de traductions
+          translations: Traductions
         translation_sets:
           constraint_fields:
             constraint: Contrainte
             remove: Retirer
           create:
-            success: Jeu de traduction créé avec succès.
             error: Une erreur a lieu durant la création du jeu de traduction.
+            success: Jeu de traduction créé avec succès.
           destroy:
             success: Le jeu de traduction a été supprimé.
           edit:
-            title: Jeu de traduction
             save: Sauvegarder
+            title: Jeu de traduction
           form:
             add_constraint: Ajouter contrainte
-            title: Jeu de traduction
+            constraint_help_html: <p>Constraints are specific rules that allow you to apply the customizations in a set to a specific context.</p> <p>In case you do not define any constraint rules, the customizations in this set will apply to the whole application. On the other hand, if you want the customizations in this set to apply only to a specific process, select "Participatory processes" as the participatory space type and the target process as the participatory space. Furthermore, you can also apply the customizations to a specific component by defining the component for the constraint.</p> <p>If you define multiple constraints, the customizations will apply in all of those.</p>
+            constraint_help_title: What are constraints?
+            help_html: <p>A translation set is a "container" that holds the translations for a specific context you want to customize.</p> <p>Translation sets help you to organize your customizations and apply them to different contexts. This allows you to customize the same translation differently in different contexts.</p> <p>For example, if you want to customize a button with the term "Add" differently for different participatory processes, you can create separate translation sets for both processes and apply the set to those processes using the constraints.</p>
+            help_title: What is a translation set?
+            title: Translation set.
+          index:
+            no_records_html: <p>No translation sets available.</p> <p>Start by adding a translation set from the "<a href="%{new_set_link}">%{button_name}</a>" button.</p>
           new:
             create: Créer
             title: Jeu de traductions
           update:
-            success: Jeu de traduction mis à jour avec succès.
             error: Une erreur a lieu durant la mise à jour du jeu de traduction.
+            success: Jeu de traduction mis à jour avec succès.
         translations:
           create:
-            success: Traduction créée avec succès.
             error: Une erreur a lieu durant la création de la traduction.
+            success: Traduction créée avec succès.
           destroy:
             success: La traduction a été supprimée.
           edit:
-            title: Traduction
             save: Sauvegarder
+            title: Traduction
           form:
+            help_html: <p>A translation key is a technical reference to the translation to be translatated. This is not the term you want to change but the technical key that refers to that translation.</p> <p>For example, if you want to change the term <em>"Processes"</em> in the top menu, you would use the key <em>"decidim.menu.processes"</em>.</p> <p><a href="https://guides.rubyonrails.org/i18n.html" target="_blank"> Read more about Rails Internationalization</a>.</p>
+            help_title: What is translation key?
+            term_help_html: "<p>The customized term is the final word you want to appear in the UI instead of the original term. Obviously, the customized term can differ for each enabled language.</p>"
+            term_help_title: What is customized term?
             title: Traduction
+          import:
+            error: Error importing translations
+            success: Translations successfully imported.
+          index:
+            actions: Actions
+            no_records_html: <p>No translations available in this set.</p> <p>Start by adding translations to this set. The easiest way is to use the "<a href="%{add_multiple_link}">%{button_name}</a>" button where you can search translations with the same terms that you see in the UI.</p>
+            selected: selected
           new:
             create: Créer
             title: Traductions
+          new_import:
+            accepted_mime_types:
+              csv: CSV
+              json: JSON
+              xls: XLS
+            file_legend: 'Add an import file that will be parsed for translations. Suported formats are: %{valid_mime_types}'
+            start_import: Start import
+            title: Import translations
+            zip_hint: You can also upload the ZIP file from the translations export.
           update:
-            success: Traduction mis à jour avec succès.
             error: Une erreur a lieu durant la mise à jour de la traduction.
+            success: Traduction mis à jour avec succès.
+        translations_destroys:
+          destroy:
+            error: Error deleting translations.
+            success: Translations successfully deleted.
+          new:
+            destroy: Delete
+            title: Translations delete
       menu:
         term_customizer: Paramétrages des traductions

data/config/locales/sv.yml

@@ -10,72 +10,118 @@ sv:
         value: Customized term
       translation_set:
         name: Name
-  decidim:
-    admin:
-      actions:
-        add_multiple_translations: Add multiple
-        back: Back
-        clear_cache: Clear cache
-        new_translation_set: New translation set
-        new_translation: New translation
+      translations_import:
+        file: Import file
+    errors:
       models:
-        translation_sets:
-          fields:
-            name: Name
-        translations:
-          fields:
-            key: Translation key
-            original_term: Original term
-            term: Customized term
-      titles:
-        translation_sets: Translation sets
-        translations: Translations
+        translations_import:
+          attributes:
+            file:
+              invalid_mime_type: 'Invalid file type. Accepted formats are: %{valid_mime_types}'
+  decidim:
     term_customizer:
       admin:
+        actions:
+          add_multiple_translations: Add multiple
+          back: Back
+          cancel: Cancel
+          clear_cache: Clear cache
+          help: Help
+          import: Import
+          new_translation: New translation
+          new_translation_set: New translation set
         add_translations:
           index:
             add: Add
+            help_html: <p>Start by typing a couple of letters appearing in the term that you want to change in the search panel. Wait for few seconds and a list of all translations matching your search will be displayed below the search field. Click the translations in that list that you want to change. They will appear below the search field in the list of translations to be added.</p> <p>Once you have added all the translations that you want to change, click the "%{button_name}" button at the bottom of the screen.</p>
+            help_title: How to search for translations?
             search: Search
         caches:
           clear:
             success: Cache cleared successfully
+        models:
+          translation_sets:
+            fields:
+              name: Name
+          translations:
+            fields:
+              key: Translation key
+              original_term: Original term
+              term: Customized term
+        titles:
+          add_multiple_translations: Add multiple
+          translation_sets: Translation sets
+          translations: Translations
         translation_sets:
           constraint_fields:
             constraint: Constraint
             remove: Remove
           create:
-            success: Translation set successfully created.
             error: Error creating translation set.
+            success: Translation set successfully created.
           destroy:
             success: Translation set successfully deleted.
           edit:
-            title: Translation set
             save: Save
+            title: Translation set
           form:
             add_constraint: Add constraint
-            title: Translation set
+            constraint_help_html: <p>Constraints are specific rules that allow you to apply the customizations in a set to a specific context.</p> <p>In case you do not define any constraint rules, the customizations in this set will apply to the whole application. On the other hand, if you want the customizations in this set to apply only to a specific process, select "Participatory processes" as the participatory space type and the target process as the participatory space. Furthermore, you can also apply the customizations to a specific component by defining the component for the constraint.</p> <p>If you define multiple constraints, the customizations will apply in all of those.</p>
+            constraint_help_title: What are constraints?
+            help_html: <p>A translation set is a "container" that holds the translations for a specific context you want to customize.</p> <p>Translation sets help you to organize your customizations and apply them to different contexts. This allows you to customize the same translation differently in different contexts.</p> <p>For example, if you want to customize a button with the term "Add" differently for different participatory processes, you can create separate translation sets for both processes and apply the set to those processes using the constraints.</p>
+            help_title: What is a translation set?
+            title: Translation set.
+          index:
+            no_records_html: <p>No translation sets available.</p> <p>Start by adding a translation set from the "<a href="%{new_set_link}">%{button_name}</a>" button.</p>
           new:
             create: Create
             title: Translation sets
           update:
-            success: Translation set successfully updated.
             error: Error updating translation set.
+            success: Translation set successfully updated.
         translations:
           create:
-            success: Translation successfully created.
             error: Error creating translation.
+            success: Translation successfully created.
           destroy:
             success: Translation successfully deleted.
           edit:
-            title: Translation
             save: Save
+            title: Translation
           form:
+            help_html: <p>A translation key is a technical reference to the translation to be translatated. This is not the term you want to change but the technical key that refers to that translation.</p> <p>For example, if you want to change the term <em>"Processes"</em> in the top menu, you would use the key <em>"decidim.menu.processes"</em>.</p> <p><a href="https://guides.rubyonrails.org/i18n.html" target="_blank"> Read more about Rails Internationalization</a>.</p>
+            help_title: What is translation key?
+            term_help_html: "<p>The customized term is the final word you want to appear in the UI instead of the original term. Obviously, the customized term can differ for each enabled language.</p>"
+            term_help_title: What is customized term?
             title: Translation
+          import:
+            error: Error importing translations
+            success: Translations successfully imported.
+          index:
+            actions: Actions
+            no_records_html: <p>No translations available in this set.</p> <p>Start by adding translations to this set. The easiest way is to use the "<a href="%{add_multiple_link}">%{button_name}</a>" button where you can search translations with the same terms that you see in the UI.</p>
+            selected: selected
           new:
             create: Create
             title: Translations
+          new_import:
+            accepted_mime_types:
+              csv: CSV
+              json: JSON
+              xls: XLS
+            file_legend: 'Add an import file that will be parsed for translations. Suported formats are: %{valid_mime_types}'
+            start_import: Start import
+            title: Import translations
+            zip_hint: You can also upload the ZIP file from the translations export.
           update:
-            success: Translation successfully updated.
             error: Error updating translation.
+            success: Translation successfully updated.
+        translations_destroys:
+          destroy:
+            error: Error deleting translations.
+            success: Translations successfully deleted.
+          new:
+            destroy: Delete
+            title: Translations delete
       menu:
         term_customizer: Term customizer

data/lib/decidim/term_customizer.rb

@@ -8,9 +8,13 @@ require_relative "term_customizer/admin_engine"
 module Decidim
   module TermCustomizer
     autoload :I18nBackend, "decidim/term_customizer/i18n_backend"
+    autoload :Import, "decidim/term_customizer/import"
     autoload :Loader, "decidim/term_customizer/loader"
     autoload :Resolver, "decidim/term_customizer/resolver"
     autoload :TranslationDirectory, "decidim/term_customizer/translation_directory"
+    autoload :TranslationImportCollection, "decidim/term_customizer/translation_import_collection"
+    autoload :TranslationParser, "decidim/term_customizer/translation_parser"
+    autoload :TranslationSerializer, "decidim/term_customizer/translation_serializer"
     autoload :TranslationStore, "decidim/term_customizer/translation_store"
 
     EMPTY_HASH = {}.freeze