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

Display Country flag from IP address in your Filament tables

v1.0.2 2023-08-13 19:13 UTC

This package is auto-updated.

Last update: 2024-10-13 21:36:52 UTC


README

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.