Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

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: about 1 month 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 (9 months ago)
Default Branch: master
Last Pushed: 2024-11-27T12:37:04.000Z (about 2 months ago)
Last Synced: 2024-11-27T13:23:34.955Z (about 2 months 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.44 MB
Stars: 11
Watchers: 1
Forks: 4
Open Issues: 0
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

        ![Screenshot](https://raw.githubusercontent.com/tomatophp/filament-locations/master/arts/3x1io-tomato-locations.jpg)

# Filament Locations

[![Dependabot Updates](https://github.com/tomatophp/filament-locations/actions/workflows/dependabot/dependabot-updates/badge.svg)](https://github.com/tomatophp/filament-locations/actions/workflows/dependabot/dependabot-updates)

[![PHP Code Styling](https://github.com/tomatophp/filament-locations/actions/workflows/fix-php-code-styling.yml/badge.svg)](https://github.com/tomatophp/filament-locations/actions/workflows/fix-php-code-styling.yml)

[![Tests](https://github.com/tomatophp/filament-locations/actions/workflows/tests.yml/badge.svg)](https://github.com/tomatophp/filament-locations/actions/workflows/tests.yml)

[![Latest Stable Version](https://poser.pugx.org/tomatophp/filament-locations/version.svg)](https://packagist.org/packages/tomatophp/filament-locations)

[![License](https://poser.pugx.org/tomatophp/filament-locations/license.svg)](https://packagist.org/packages/tomatophp/filament-locations)

[![Downloads](https://poser.pugx.org/tomatophp/filament-locations/d/total.svg)](https://packagist.org/packages/tomatophp/filament-locations)

A database of countries, cities, area, languages, currenacy with json base and database base for FilamentPHP

## Screenshots

![Countires](https://raw.githubusercontent.com/tomatophp/filament-locations/master/arts/country.png)

![Edit Countires](https://raw.githubusercontent.com/tomatophp/filament-locations/master/arts/edit-country.png)

![Languages](https://raw.githubusercontent.com/tomatophp/filament-locations/master/arts/languages.png)

![Currency](https://raw.githubusercontent.com/tomatophp/filament-locations/master/arts/currency.png)

![Locaitons](https://raw.githubusercontent.com/tomatophp/filament-locations/master/arts/locations.png)

## 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)