https://github.com/tomatophp/filament-locations
A database of countries, cities, area, languages, currenacy with json base and database base for FilamentPHP
https://github.com/tomatophp/filament-locations
cities-list country-list filamentphp filamentphp-plugin location locations-database world-countries-data
Last synced: 12 months ago
JSON representation
A database of countries, cities, area, languages, currenacy with json base and database base for FilamentPHP
- Host: GitHub
- URL: https://github.com/tomatophp/filament-locations
- Owner: tomatophp
- License: mit
- Created: 2024-04-08T13:17:50.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2025-06-16T10:04:27.000Z (about 1 year ago)
- Last Synced: 2025-07-23T05:13:59.514Z (about 1 year ago)
- Topics: cities-list, country-list, filamentphp, filamentphp-plugin, location, locations-database, world-countries-data
- Language: PHP
- Homepage: https://tomatophp.com/en/open-source/filament-locations
- Size: 5.38 MB
- Stars: 18
- Watchers: 2
- Forks: 7
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
- Security: .github/SECURITY.md
Awesome Lists containing this project
README
# Filament Locations
[](https://github.com/tomatophp/filament-locations/actions/workflows/dependabot/dependabot-updates)
[](https://github.com/tomatophp/filament-locations/actions/workflows/fix-php-code-styling.yml)
[](https://github.com/tomatophp/filament-locations/actions/workflows/tests.yml)
[](https://packagist.org/packages/tomatophp/filament-locations)
[](https://packagist.org/packages/tomatophp/filament-locations)
[](https://packagist.org/packages/tomatophp/filament-locations)
A database of countries, cities, area, languages, currenacy with json base and database base for FilamentPHP
## Screenshots
## Installation
```bash
composer require tomatophp/filament-locations
```
after install your package please run this command
```bash
php artisan filament-locations:install
```
finally reigster the plugin on `/app/Providers/Filament/AdminPanelProvider.php`
```php
->plugin(\TomatoPHP\FilamentLocations\FilamentLocationsPlugin::make())
```
## Disable Setting Hub
to disable the setting hub you can use this method
```php
->plugin(\TomatoPHP\FilamentLocations\FilamentLocationsPlugin::make()->settingsHub(false))
```
## Disable Resources
to disable the resources you can use this method
```php
->plugin(
\TomatoPHP\FilamentLocations\FilamentLocationsPlugin::make()
->countries(false)
->languages(false)
->currency(false)
->locations(false)
)
```
## Use Database Driver
to use database driver or if you don't have "sqlite" on your app, you can change the driver on config to "database" first publish the config
```bash
php artisan vendor:publish --tag="filament-locations-config"
```
after that go to `config/filament-locations.php` and change the driver to "database"
```php
'driver' => 'database'
```
now you need to run migration
```bash
php artisan migrate
```
now load the data to seeder
```bash
php artisan filament-locations:seed
```
and the full data will be migrated to your database
## Use Custom JSON Files
if you like to use your json data files it's easy you can just change the path of json on your config file with the matched json schema
```php
'driver' => 'json',
'json' => [
'countries' => base_path('resources/json/countries.json'),
'cities' => base_path('resources/json/cities.json'),
'areas' => base_path('resources/json/areas.json'),
'languages' => base_path('resources/json/languages.json'),
'currencies' => base_path('resources/json/currencies.json'),
],
```
## Currency Helper
we have ready to use helper to convert the money amount to the currency symbol
```php
dollar($amount) // Output $100.00
```
## Publish Assets
you can publish config file by use this command
```bash
php artisan vendor:publish --tag="filament-locations-config"
```
you can publish views file by use this command
```bash
php artisan vendor:publish --tag="filament-locations-views"
```
you can publish languages file by use this command
```bash
php artisan vendor:publish --tag="filament-locations-lang"
```
you can publish migrations file by use this command
```bash
php artisan vendor:publish --tag="filament-locations-migrations"
```
## Other Filament Packages
Checkout our [Awesome TomatoPHP](https://github.com/tomatophp/awesome)