https://github.com/tappnetwork/nova-select-country-code

Country code select field for Laravel Nova
https://github.com/tappnetwork/nova-select-country-code

code country country-code field hacktoberfest laravel nova select

Last synced: 23 days ago
JSON representation

Country code select field for Laravel Nova

• Host: GitHub
• URL: https://github.com/tappnetwork/nova-select-country-code
• Owner: TappNetwork
• Created: 2020-11-13T21:10:09.000Z (about 4 years ago)
• Default Branch: main
• Last Pushed: 2024-05-04T18:41:26.000Z (8 months ago)
• Last Synced: 2024-11-18T09:59:18.740Z (about 1 month ago)
• Topics: code, country, country-code, field, hacktoberfest, laravel, nova, select
• Language: PHP
• Homepage:
• Size: 925 KB
• Stars: 5
• Watchers: 5
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Laravel Nova Country Code Select Field

[![Latest Version on Packagist](https://img.shields.io/packagist/v/tapp/select-country-code.svg?style=flat-square)](https://packagist.org/packages/tapp/select-country-code)

![Code Style Action Status - Pint](https://github.com/TappNetwork/nova-select-country-code/actions/workflows/pint.yml/badge.svg)

[![Total Downloads](https://img.shields.io/packagist/dt/tapp/select-country-code.svg?style=flat-square)](https://packagist.org/packages/tapp/select-country-code)

A country code select field for Laravel Nova.

## Appearance

### Form

![select-country-code-form](https://raw.githubusercontent.com/TappNetwork/nova-select-country-code/main/docs/select-country-code-form.png)

![select-country-code-form1](https://raw.githubusercontent.com/TappNetwork/nova-select-country-code/main/docs/select-country-code-form1.png)

### Detail

![select-country-code-detail](https://raw.githubusercontent.com/TappNetwork/nova-select-country-code/main/docs/select-country-code-detail.png)

## Installation

Install using Composer:

```bash

composer require tapp/select-country-code

```

Publish the flag icons assets to the public project directory:

```bash

php artisan vendor:publish --tag=public --force

```

## Usage

Add the field to your resource in the ```fields``` method:

```php

use Tapp\SelectCountryCode\SelectCountryCode;

SelectCountryCode::make(__('Country Code')),

```

### Options

#### iconsDirectory

Default: ```'/vendor/tapp/nova-select-country-code'```.

If you want to use your own custom image icons, provide the directory of the images with this option:

```php

SelectCountryCode::make(__('Country Code'))

    ->iconsDirectory('/public/path/to/icons'),

```

#### iconsFormat

Default: ```'svg'```.

The image format of the flag icons.

```php

SelectCountryCode::make(__('Country Code'))

    ->iconsFormat('png'),

```

#### options

Array with the options to show on select. The array must contain the associative keys: ```'label'```, ```'country_code'```, and ```'iso_code'```.

Default: 

```php

[

    ['label' => 'Afghanistan', 'country_code' => '+93', 'iso_code' => 'AF'],

    ['label' => 'Albania', 'country_code' => '+355', 'iso_code' => 'AL'],

    // ...

]

```

```php

SelectCountryCode::make(__('Country Code'))

    ->options($optionsArray),

```

## Credits 

SVG of the countries' flags by:

- https://github.com/tabler/tabler

- https://github.com/hjnilsson/country-flags

## Leveraged package

- [Vue Select](https://vue-select.org)