tomatophp/filament-locations

Database Seeds for Countries / Cities / Areas / Languages / Currancy with ready to use resources for FilamentPHP

2.0.0 2024-11-27 12:36 UTC

Requires

• php: ^8.1|^8.2
• calebporzio/sushi: *
• filament/filament: ^3.2
• tomatophp/console-helpers: ^1.1
• tomatophp/filament-settings-hub: ^2.0

Requires (Dev)

• laravel/pint: ^1.18
• livewire/livewire: ^2.10|^3.0
• nunomaduro/larastan: ^2.9
• orchestra/testbench: ^9.5
• pestphp/pest: ^2.36
• pestphp/pest-plugin-laravel: ^2.4
• pestphp/pest-plugin-livewire: ^2.1
• phpstan/extension-installer: ^1.4
• phpstan/phpstan-deprecation-rules: ^1.2
• phpstan/phpstan-phpunit: ^1.4

MIT

• Fady Mondy

• database
• php
• laravel
• country
• city
• locations
• area
• filament

README

Filament Locations

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

Screenshots

Installation

composer require tomatophp/filament-locations

after install your package please run this command

php artisan filament-locations:install

finally reigster the plugin on /app/Providers/Filament/AdminPanelProvider.php

->plugin(\TomatoPHP\FilamentLocations\FilamentLocationsPlugin::make())

Disable Setting Hub

to disable the setting hub you can use this method

->plugin(\TomatoPHP\FilamentLocations\FilamentLocationsPlugin::make()->settingsHub(false))

Disable Resources

to disable the resources you can use this method

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

php artisan vendor:publish --tag="filament-locations-config"

after that go to config/filament-locations.php and change the driver to "database"

    'driver' => 'database'

now you need to run migration

php artisan migrate

now load the data to seeder

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

    '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

dollar($amount) // Output $100.00

Publish Assets

you can publish config file by use this command

php artisan vendor:publish --tag="filament-locations-config"

you can publish views file by use this command

php artisan vendor:publish --tag="filament-locations-views"

you can publish languages file by use this command

php artisan vendor:publish --tag="filament-locations-lang"

you can publish migrations file by use this command

php artisan vendor:publish --tag="filament-locations-migrations"

Other Filament Packages

Checkout our Awesome TomatoPHP