{"id":14983856,"url":"https://github.com/jbtronics/translation-editor-bundle","last_synced_at":"2025-04-10T19:41:46.326Z","repository":{"id":255442053,"uuid":"849010400","full_name":"jbtronics/translation-editor-bundle","owner":"jbtronics","description":"A symfony bundle to allow editing translations in the symfony profiler","archived":false,"fork":false,"pushed_at":"2025-03-29T15:22:48.000Z","size":423,"stargazers_count":6,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-02T22:09:10.228Z","etag":null,"topics":["php","symfony","symfony-bundle","symfony-profiler","translations"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jbtronics.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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":{"github":"jbtronics","custom":["https://www.paypal.me/do9jhb"]}},"created_at":"2024-08-28T20:10:23.000Z","updated_at":"2025-04-01T21:37:54.000Z","dependencies_parsed_at":"2024-09-24T15:26:12.272Z","dependency_job_id":"2c68b575-7e0e-4f40-967a-c6b696e48f64","html_url":"https://github.com/jbtronics/translation-editor-bundle","commit_stats":{"total_commits":23,"total_committers":1,"mean_commits":23.0,"dds":0.0,"last_synced_commit":"a725eee3a29373160c355d15bc0d5f8ea463e0d2"},"previous_names":["jbtronics/translation-editor-bundle"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jbtronics%2Ftranslation-editor-bundle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jbtronics%2Ftranslation-editor-bundle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jbtronics%2Ftranslation-editor-bundle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jbtronics%2Ftranslation-editor-bundle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jbtronics","download_url":"https://codeload.github.com/jbtronics/translation-editor-bundle/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248281415,"owners_count":21077423,"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":["php","symfony","symfony-bundle","symfony-profiler","translations"],"created_at":"2024-09-24T14:08:04.837Z","updated_at":"2025-04-10T19:41:46.317Z","avatar_url":"https://github.com/jbtronics.png","language":"PHP","funding_links":["https://github.com/sponsors/jbtronics","https://www.paypal.me/do9jhb"],"categories":[],"sub_categories":[],"readme":"![GitHub License](https://img.shields.io/github/license/jbtronics/settings-bundle)\n\n# Profiler Translation Editor Bundle\n\nThis bundle provides a way to edit the translations of your Symfony application directly from the Symfony profiler.\n\n\n![Animated Showcase](./docs/showcase.gif)\n\n\nThis bundle is inspired by the [php-translation/symfony-bundle](https://github.com/php-translation/symfony-bundle), which\noffers a similar feature, but has more dependencies and is more complex to use. This bundle provides a simpler and more\nmodern alternative to this, which supports the latest Symfony versions and slightly faster.\n\n## Requirements\n\n* PHP 8.1 or higher\n* Symfony 6.4 or higher (compatible with Symfony 7)\n\n## Installation\n\nYou can install this bundle using composer:\n\n```bash\ncomposer require --dev jbtronics/translation-editor-bundle\n```\n\nNote the `--dev` flag, as this bundle is only intended for development and debugging purposes.\n\nIf you are using Symfony Flex, the bundle will be automatically enabled. If not, you have to enable it manually in your\n`config/bundles.php`:\n\n```php\nreturn [\n    // ...\n    Jbtronics\\TranslationEditorBundle\\JbtronicsTranslationEditorBundle::class =\u003e ['dev' =\u003e true],\n];\n```\nPlease note that this bundle should only be enabled in the `dev` environment.\n\nYou also need to enable the required routes for your bundle. You can do this by creating a new file in your `config/routes`\ndirectory (e.g. `config/routes/jbtronics_translation_editor.yaml`):\n\n```yaml\n# config/routes/jbtronics_translation_editor.yaml\n\nwhen@dev:\n    translation_editor:\n      resource: '@JbtronicsTranslationEditorBundle/config/routes.php'\n```\n\n## Configuration\n\nIf you do not use the standard paths for your translation files, or not the XLF format, you have to configure the bundle\nto generate the right files. If you just use the standard paths and XLF format, the defaults should be fine for you, and\nyou can skip this step and you do not need to create a configuration file.\n\nOtherwise create a new file in your `config/packages` directory (e.g. `config/packages/jbtronics_translation_editor.yaml`)\nand configure the options you need (here the default values are shown):\n\n```yaml\n# config/packages/jbtronics_translation_editor.yaml\n\njbtronics_translation_editor:\n\n  # The path where the translation files are stored (normally %kernel.project_dir%/translations)\n  translations_path: \"%translator.default_path%\"\n\n  # The format in which the translation files should be outputted\n  format: yaml\n\n  # The version of the XLIFF format to use\n  xliff_version: 2.0\n\n  # Any additional options that should be passed to the translation writer. This depends on the format you use.\n  writer_options:\n    #as_tree: true\n\n  # Use Intl message format\n  use_intl_icu_format: false\n```\n\n## Usage\n\nAfter you have installed and configured the bundle, just open the Symfony profiler for the request you want the\ntranslations to edit. In the table with the messages, you will see a new column with an edit button. Click on this\nbutton to open a editor for the message and click save to save the changes.\n\nAfter submission the field is colored blue, while the changes are saved. If the changes were saved sucessfully, the field\nwill turn green for a short time, otherwise red if an error occurred.\n\n## Security\n\nThe endpoint for the translation editor is not protected. Anybody who can access the web application and the profiler can\nedit the translations, with all consequences. As translations are not necessarily translated, this could allow attackers\nto inject malicious code as an XSS attack.\n\nHowever, this bundle, similar to the Symfony profiler itself, is only intended for development and debugging purposes and\nshould only run in a dedicated development environment, where only trusted users have access (and could modify the code\ndirectly anyway). Therefore, the security risk should be minimal in the intended use case.\n\nThis bundle enforces the `dev` environment, so it should not be possible to use it in a production environment. Anyway,\nyou should make sure that the bundle and especially the translation editor endpoint must not be accessible in a production\nenvironment.\n\n## License\n\nSettingsBundle is licensed under the MIT License.\nThis mostly means that you can use this bundle for whatever you want (even use it commercially)\nas long as you retain the copyright/license information.\n\nSee [LICENSE](https://github.com/jbtronics/translation-editor-bundle/blob/master/LICENSE) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjbtronics%2Ftranslation-editor-bundle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjbtronics%2Ftranslation-editor-bundle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjbtronics%2Ftranslation-editor-bundle/lists"}