{"id":16466864,"url":"https://github.com/matriphe/bendera","last_synced_at":"2026-03-14T02:35:57.251Z","repository":{"id":41886323,"uuid":"364285837","full_name":"matriphe/bendera","owner":"matriphe","description":"Laravel package to convert country code (ISO 3166-1 alpha-2) to the corresponding flag emoji","archived":false,"fork":false,"pushed_at":"2025-08-08T22:11:47.000Z","size":74,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-11-10T09:02:33.452Z","etag":null,"topics":["hacktoberfest"],"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/matriphe.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2021-05-04T14:36:12.000Z","updated_at":"2025-08-08T22:10:07.000Z","dependencies_parsed_at":"2024-10-11T11:45:04.596Z","dependency_job_id":"3303fcf9-5f69-4a27-ad26-83ba84be4e63","html_url":"https://github.com/matriphe/bendera","commit_stats":{"total_commits":58,"total_committers":1,"mean_commits":58.0,"dds":0.0,"last_synced_commit":"a0030858fadf3b1166c8fc6013fda76206320552"},"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/matriphe/bendera","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matriphe%2Fbendera","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matriphe%2Fbendera/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matriphe%2Fbendera/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matriphe%2Fbendera/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/matriphe","download_url":"https://codeload.github.com/matriphe/bendera/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matriphe%2Fbendera/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30486111,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-14T01:54:10.014Z","status":"online","status_checked_at":"2026-03-14T02:00:06.612Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["hacktoberfest"],"created_at":"2024-10-11T11:45:03.017Z","updated_at":"2026-03-14T02:35:57.229Z","avatar_url":"https://github.com/matriphe.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Bendera\n\n[![Run Tests](https://github.com/matriphe/bendera/actions/workflows/run-tests.yml/badge.svg)](https://github.com/matriphe/bendera/actions/workflows/run-tests.yml)\n[![Latest Stable Version](https://poser.pugx.org/matriphe/bendera/v)](//packagist.org/packages/matriphe/bendera)\n[![Total Downloads](https://poser.pugx.org/matriphe/bendera/downloads)](//packagist.org/packages/matriphe/bendera)\n\nA Laravel package to convert country code (ISO 3166-1 alpha-2) to corresponding flag emoji.\n\nThis packages wraps [Country Flags](https://github.com/stidges/country-flags) and all limitations on that package also apply to this.\n\n\u003e *Bendera* means flag in Indonesian 🇮🇩.\n\n## Installation\n\nYou can install the package via composer:\n\n### Laravel 10\n\n```shell\ncomposer require matriphe/bendera\n```\n\n### Laravel 9 or Older\n\n```shell\ncomposer require matriphe/bendera:0.3.0\n```\n\n## Configuration\n\nIt is not necessary, but if you want to add mapping, publish the config file.\n\n```shell\nphp artisan vendor:publish --provider=\"Matriphe\\Bendera\\BenderaServiceProvider\" --tag=\"bendera\"\n```\n\nFor example you want to map a custom country `XY` and shows it as `ID`.\n\n```php\nreturn [\n    'aliases' =\u003e [\n        'XY' =\u003e 'ID',\n    ]\n];\n```\n\n## Usage\n\nYou can use the Facade `Bendera` to get the emoji.\n\n```php\nBendera::emoji('id'); // will return 🇮🇩\nBendera::emoji('en'); // will return 🇬🇧\nBendera::emoji('uk'); // will return 🇬🇧\nBendera::emoji('GB'); // will return 🇬🇧\nBendera::emoji('XYZ'); // will return null\n```\n\nFor invalid country code, it will return `null`;\n\nYou can also use dependency injection style by injecting `BenderaContract` to your class.\n\n```php\nclass SomeAwesomeClass \n{\n    public function awesome(\\Matriphe\\Bendera\\BenderaContract $bendera)\n    {\n        return $bendera-\u003eemoji('id');\n    }\n}\n```\n\n## Contributing\n\nContributions are welcome via Pull Requests on Github.\n\n## Credits\n\n- [Stidges](https://github.com/stidges) for his initial Country Flags package.\n- [Spatie](https://github.com/spatie) for their awesome packages.\n\n## License\n\nThe [MIT License (MIT)](LICENSE.txt). Please see License File for more information.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatriphe%2Fbendera","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmatriphe%2Fbendera","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatriphe%2Fbendera/lists"}