stijnvanouplines / blade-country-flags Goto Github PK

View Code? Open in Web Editor NEW

18.0 3.0 9.0 1.95 MB

A package to easily make use of country flags in your Laravel Blade views.

License: MIT License

Shell 8.90% PHP 91.10%

blade-country-flags's Introduction

Blade Country Flags

A package to easily make use of country flags in your Laravel Blade views.

This package is using SVG flags provided by flag-icon-css. All credits go to this project and all of it's creators.

Requirements

PHP 7.4 or higher
Laravel 8.0 or higher

Installation

composer require stijnvanouplines/blade-country-flags

Blade Icons

Blade Country Flags uses Blade Icons under the hood. Please refer to the Blade Icons readme for additional functionality. We also recommend to enable icon caching with this library.

Configuration

Blade Country Flags also offers the ability to use features from Blade Icons like default classes, default attributes, etc. If you'd like to configure these, publish the blade-country-flags.php config file:

php artisan vendor:publish --tag=blade-country-flags-config

Usage

Flags can be used as self-closing Blade components which will be compiled to SVG flags:

<x-flag-4x3-be/>

You can also pass classes to your flag components:

<x-flag-4x3-be class="w-6"/>

And even use inline styles:

<x-flag-4x3-be style="width: 1.5rem"/>

A square flag can be referenced like this:

<x-flag-1x1-be/>

Raw SVG Flags

If you want to use the raw SVG flags as assets, you can publish them using:

php artisan vendor:publish --tag=blade-country-flags --force

Then use them in your views like:

<img src="{{ asset('vendor/blade-country-flags/4x3-be.svg') }}" width="10"/>

Changelog

Check out the CHANGELOG in this repository for all the recent changes.

Credits

License

Blade Country Flags is open-sourced software licensed under the MIT license.

blade-country-flags's People

Contributors

Stargazers

Watchers

Forkers

ryiski andrefilsantos cswni inmanturbo holgerhatgarkeinenode cobraprojects paulohenriquesg laravel-shift qalainau

blade-country-flags's Issues

List of all flags

Do you have a list/array of all the flags useful for admin selection?

cn.svg is missing stars

it seems that CN is pretty out of date with upstream.
Could it be updated, please?

This repo:

Upstream:

Installation failed

Installation in conjunction with previously installed Filament PLugin "Filament Language Switch" fails:

Problem 1
    - stijnvanouplines/blade-country-flags[1.0.0, ..., 1.0.1] require illuminate/support ^8.0 -> found illuminate/support[v8.0.0, ..., v8.83.27] but these were not loaded, likely because it conflicts with another require.
    - stijnvanouplines/blade-country-flags 1.0.2 requires illuminate/support ^8.0|^9.0 -> found illuminate/support[v8.0.0, ..., v8.83.27, v9.0.0, ..., v9.52.4] but these were not loaded, likely because it conflicts with another require.
    - Root composer.json requires stijnvanouplines/blade-country-flags * -> satisfiable by stijnvanouplines/blade-country-flags[1.0.0, 1.0.1, 1.0.2].

You can also try re-running composer require with an explicit version constraint, e.g. "composer require stijnvanouplines/blade-country-flags:*" to figure out if any version is installable, or "composer require stijnvanouplines/blade-country-flags:^2.1" if you know which you need.

Laravel Version: 10.3.3
Filament Version: 2.17.16
Filament Language Switch (bezhansalleh/filament-language-switch) Version: 1.0.6
PHP Version: 8.2.3
OS: WSL2 (Ubuntu 22.04.2 LTS) on Windows 11