Download the PHP package ritechoice23/laravel-worldable without Composer
On this page you can find all versions of the php package ritechoice23/laravel-worldable. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download ritechoice23/laravel-worldable
More information about ritechoice23/laravel-worldable
Files in ritechoice23/laravel-worldable
Package laravel-worldable
Short Description Make your Laravel application location-aware in seconds. Worldable is a package that provides a simple and efficient way to add Country, State, City, Currency, Language, and Timezone relationships to your laravel application.
License MIT
Homepage https://github.com/ritechoice23/laravel-worldable
Informations about the package laravel-worldable
Laravel Worldable
Make your Laravel application location-aware in seconds. Worldable is a package that provides a simple and efficient way to add Country, State, City, Currency, Language, and Timezone relationships to your laravel application.
Quick Start
That's it! You now have access to 8 world entities: Continents, Subregions, Countries, States, Cities, Currencies, Languages, and Timezones.
Installation Options
Optional: Publish Configuration
If you need to customize table names, publish the config file:
This creates config/worldable.php where you can customize table names to match your naming convention.
Usage Modes
1. Direct Model Usage (Traditional Approach)
Use world data models directly with standard Eloquent relationships:
2. Polymorphic Relationships (Zero-Migration Approach)
Too lazy to add foreign keys? We got you covered! Use the Worldable trait for instant location awareness without touching your database schema:
Why use polymorphic relationships?
- Zero migrations - No need to modify your existing tables
- Multiple contexts - Separate billing/shipping, citizenship/residence
- Flexible - Attach multiple countries, cities, or currencies to one model
- Metadata support - Store extra data on relationships
- Clean codebase - No foreign key clutter in your models
Key Features
| Feature | Description |
|---|---|
| 8 World Entities | Continents, Subregions, Countries, States, Cities, Currencies, Languages, Timezones |
| Modular Install | Install only what you need, add more later |
| Two Usage Modes | Traditional foreign keys OR polymorphic relationships |
| Context Groups | Separate billing/shipping, citizenship/residence |
| Smart Resolution | Accepts IDs, names, ISO codes automatically |
| Query Scopes | whereFrom(), whereLocatedInCity(), wherePricedIn(), whereSpeaks() |
| Money Formatting | $product->formatMoney(100) → "$100.00" with locale support |
| Bulk Operations | $user->attachCountries(['NG', 'GH', 'KE']) |
| Custom Metadata | Store extra data: $user->attachCountry('NG', 'billing', ['tax_id' => '...']) |
| Health Checks | php artisan world:health --detailed monitors data integrity |
Real-World Example
Documentation
Full Documentation - Deep dive into all features
- Installation - Advanced installation options
- Commands - Complete commands reference
- Basic Usage - Common operations
- API Reference - Complete API documentation
- Cities - Location data
- Timezones - Localization
- Groups - Context-aware relationships
- Meta Data - Custom metadata storage
- Validation Rules - Input validation
- Scopes - Query scopes reference
Testing
Credits
- Daramola Babatunde Ebenezer
- All Contributors
License
The MIT License (MIT). See License File.
All versions of laravel-worldable with dependencies
spatie/laravel-package-tools Version ^1.16
illuminate/contracts Version ^11.0||^12.0