{"id":19987521,"url":"https://github.com/waithawoo/laravel-deeplapi-translate","last_synced_at":"2025-05-04T08:31:25.847Z","repository":{"id":46407478,"uuid":"417439241","full_name":"waithawoo/laravel-deeplapi-translate","owner":"waithawoo","description":"To translate languages with Deep L Translator API","archived":false,"fork":false,"pushed_at":"2023-06-14T19:05:42.000Z","size":30,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-08T06:02:37.597Z","etag":null,"topics":["deepl","deepl-translate","deepl-translation-api","laravel","translate","translate-api"],"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/waithawoo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-10-15T09:16:31.000Z","updated_at":"2023-11-08T06:21:29.000Z","dependencies_parsed_at":"2022-07-22T09:22:28.044Z","dependency_job_id":null,"html_url":"https://github.com/waithawoo/laravel-deeplapi-translate","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waithawoo%2Flaravel-deeplapi-translate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waithawoo%2Flaravel-deeplapi-translate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waithawoo%2Flaravel-deeplapi-translate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waithawoo%2Flaravel-deeplapi-translate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/waithawoo","download_url":"https://codeload.github.com/waithawoo/laravel-deeplapi-translate/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252307970,"owners_count":21727103,"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":["deepl","deepl-translate","deepl-translation-api","laravel","translate","translate-api"],"created_at":"2024-11-13T04:36:51.884Z","updated_at":"2025-05-04T08:31:20.839Z","avatar_url":"https://github.com/waithawoo.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Laravel DeepL API Translation Package\n[![GitHub issues](https://img.shields.io/github/issues/waithawoo/laravel-deeplapi-translate)](https://github.com/waithawoo/laravel-deeplapi-translate/issues)\n[![GitHub stars](https://img.shields.io/github/stars/waithawoo/laravel-deeplapi-translate)](https://github.com/waithawoo/laravel-deeplapi-translate/stargazers)\n[![GitHub forks](https://img.shields.io/github/forks/waithawoo/laravel-deeplapi-translate)](https://github.com/waithawoo/laravel-deeplapi-translate/network)\n[![GitHub license](https://img.shields.io/github/license/waithawoo/laravel-deeplapi-translate)](https://github.com/waithawoo/laravel-deeplapi-translate/blob/main/LICENSE)\n\n## To translate languages with Deep L Translator API \n\nEasy to use Deep L API for translation in Laravel projects\n - **[Installation](#installation)**\n - **[Usage](#usage)**\n\n## Installation\n\nInstall this package via [Composer](https://getcomposer.org/).\n\n```\ncomposer require waithaw/deeplapitranslate\n```\nYou can publish the config file using the following command:\n```\nphp artisan vendor:publish --provider=\"WaiThaw\\DeeplTranslate\\DeeplTranslateServiceProvider\"\n```\nThis will create the package's config file called deepltranslate.php in the config directory. The contents of the published config file are as follows.\n```php\nreturn [\n    /*\n      |-------------------------------------------------------------------------------\n      | Api Key generated from Deep L account.\n      |-------------------------------------------------------------------------------\n      */\n    'auth_key' =\u003e env('DEEPL_TRANSLATE_API_KEY'),\n\n    /*\n      |-------------------------------------------------------------------------------\n      | Api Endpoint URL from Deep L account.\n      |-------------------------------------------------------------------------------\n      */\n    'api_url' =\u003e env('DEEPL_TRANSLATE_API_ENDPOINT_URL'),\n];\n```\n\n## Usage\n- After setting up the config file values in .env, you can use translation methods.\n\n### Create DeeplTranslate object\n\n```php\nuse WaiThaw\\DeeplTranslate\\DeeplTranslate;\n\n$deepl = new DeeplTranslate();\n```\n\n### Translate\n```php\n// parameters are $text, $source_language, $target_language\n$translated_text = $deepl-\u003etranslate('are you hungry?', 'EN', 'JA'); // Output translated text string\n\necho $translated_text;\n```\n\n### Supported languages\n```php\n$languages = $deepl-\u003elanguages();\nforeach($languages as $lang){\n    echo $lang['language'].\"-\".$lang['name'].'\u003cbr\u003e';\n}\n```\nFor supported Source-languages\n```php\n$source_languages = $deepl-\u003elanguages('source');\nforeach($source_languages as $lang){\n    echo $lang['language'].\"-\".$lang['name'].'\u003cbr\u003e';\n}\n```\n\nFor supported Target-languages\n```php\n$target_languages = $deepl-\u003elanguages('target');\nforeach($target_languages as $lang){\n    echo $lang['language'].\"-\".$lang['name'].'\u003cbr\u003e';\n}\n```\n\n### Monitoring Usage\nYou can monitor the number of traslated characters and maximun limitations\n```php\n$usage= $deepl-\u003eusage();\necho $usage['character_count'].' characters have been used. Maximum number of characters that can be translated in the current billing period are '.$usage['character_limit'];\n```\n\n### Setting for cURL timeout\nYou can setup a timeout to prevent waiting in case of api unreachable\n```php\n$deepl-\u003esetTimeout(10);\n```\n\n## Security\n\nIf you discover any security related issues, please email them to [waithawoocw@gmail.com](mailto:waithawoocw@gmail.com) instead of using the issue tracker.\n\n## License\n\nThe MIT License (MIT). Please see the [License File](LICENSE) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwaithawoo%2Flaravel-deeplapi-translate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwaithawoo%2Flaravel-deeplapi-translate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwaithawoo%2Flaravel-deeplapi-translate/lists"}