mohammadhprp/filament-ip-to-country-flag-column

Display Country flag from IP address in your Filament tables
18,727 22
Install
composer require mohammadhprp/filament-ip-to-country-flag-column
Latest Version:v1.0.2
PHP:^8.1
License:MIT
Last Updated:Mar 21, 2025
Links: GitHub  ·  Packagist
Maintainer: mohammadhprp

IP to country flag Column for Filament 🚩

License Latest Version on Packagist Total Downloads

Display country flag from IP address in your Filament tables

Warning This plugin may cause a slight delay in page loading due to API calls to iplocation.

Screenshot

image

Installation

You can install the package via composer:

composer require mohammadhprp/filament-ip-to-country-flag-column

For Filament v2:

composer require mohammadhprp/filament-ip-to-country-flag-column:"^0.2.0"

Usage

To use the package, follow these steps:

use Mohammadhprp\IPToCountryFlagColumn\Columns\IPToCountryFlagColumn;

IPToCountryFlagColumn::make('client_ip');

Options

  1. Flag position: Change the position of the flag using flagPosition. Available options: right and left.

    IPToCountryFlagColumn::make('client_ip')->flagPosition('left');
    

    💡 Note: Default flag position is right.

  2. Hide flag: Hide the flag using hideFlag.

    IPToCountryFlagColumn::make('client_ip')->hideFlag();
    
  3. Location position: Change the location position using location(). Available options: below and above.

    IPToCountryFlagColumn::make('client_ip')->location(position: 'above');
    

    💡 Note: Default location position is below.

  4. Location separator: Change the location separator using location().

    IPToCountryFlagColumn::make('client_ip')->location(separator: '-');
    

    💡 Note: Default location separator is ,.

  5. Hide city or country name: Hide city or country name using hideCity() or hideCountry().

    IPToCountryFlagColumn::make('client_ip')
         ->hideCountry()
         ->hideCity();
    

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

  1. Fork the repository.
  2. Create a new branch for your feature.
  3. Make your changes and commit them with clear commit messages.
  4. Submit a pull request to the master branch.

Credits

License

This project is licensed under the MIT License - see the License file for details.