2017 © Pedro PelĆ”ez
 

library module-country

Country module for Netcore CMS ecosystem

image

netcore/module-country

Country module for Netcore CMS ecosystem

  • Thursday, June 7, 2018
  • by netcorelv
  • Repository
  • 3 Watchers
  • 0 Stars
  • 470 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 0 Forks
  • 0 Open issues
  • 8 Versions
  • 209 % Grown

The README.md

Description

This module provides helper methods to work with lists of countries and currencies, (*1)

Pre-installation

This package is part of Netcore CMS ecosystem and is only functional in a project that has the following packages installed:, (*2)

  1. https://github.com/netcore/netcore

Installation

  • Require this package using composer
composer require netcore/module-country
  • Publish configuration, migrations and assets
php artisan module:publish-config Country
php artisan module:publish-migration Country
php artisan module:publish Country
php artisan migrate
  • Seed the configuration to database
php artisan module:seed Country

Usage

  • Get all countries:
country()->all();
  • Find a country by its ISO 3166-2 code:
$country = country()->findByCode('SE');
$country->code; // SE
$country->name; // Sweden
$country->capital; // Stockholm
$country->full_name; // Kingdom of Sweden
$country->calling_code; // 46
$country->eea; // true
$country->flag_url; // Will return asset URL to the country flag
  • Get all countries as a collection for select lists (will return a collection in this format - ID => Country name)
country()->getSelectList();

You can also attach a country or a currency to any model:, (*3)

public function country(): Illuminate\Database\Eloquent\Relations\BelongsTo
{
    return $this->belongsTo(Modules\Country\Models\Country::class);
}
public function currency(): Illuminate\Database\Eloquent\Relations\BelongsTo
{
    return $this->belongsTo(Modules\Country\Models\Currency::class);
}

Disclaimer

We take no responsibility for the accuracy of the country, currency and flag lists provided in the source files. The lists were made diregarding any political and religious views. If you find the country list inaccurate, feel free to fork the repository and change the lists how you wish., (*4)

Todo:

  • Add unit tests
  • Make countries and currencies manageable in the admin panel

The Versions

07/06 2018

dev-master

9999999-dev

Country module for Netcore CMS ecosystem

  Sources   Download

The Requires

  • php >=7.1

 

by Viktors Ņikiforovs
by Gustavs Racenajs

07/06 2018

v1.1.3

1.1.3.0

Country module for Netcore CMS ecosystem

  Sources   Download

The Requires

  • php >=7.1

 

by Viktors Ņikiforovs
by Gustavs Racenajs

07/06 2018

1.1.x-dev

1.1.9999999.9999999-dev

Country module for Netcore CMS ecosystem

  Sources   Download

The Requires

  • php >=7.1

 

by Viktors Ņikiforovs
by Gustavs Racenajs

20/05 2018

v1.1.2

1.1.2.0

Country module for Netcore CMS ecosystem

  Sources   Download

The Requires

  • php >=7.1

 

by Viktors Ņikiforovs
by Gustavs Racenajs

18/05 2018

v1.1.1

1.1.1.0

Country module for Netcore CMS ecosystem

  Sources   Download

The Requires

  • php >=7.1

 

by Viktors Ņikiforovs
by Gustavs Racenajs

18/05 2018

v1.1.0

1.1.0.0

  Sources   Download

by Gustavs Racenajs

11/02 2018

1.0.x-dev

1.0.9999999.9999999-dev

  Sources   Download

by Gustavs Racenajs

11/02 2018

v1.0.0

1.0.0.0

  Sources   Download

by Gustavs Racenajs