Skip to content

Scope ​

A scope in Laravel is a reusable query. It helps keep things clean and makes queries easy to chain. You can think of it as a shortcut for adding common query conditions to your models.

Where Flag Color ​

php
->whereFlagColor(string|array $name)
php
Country::whereFlagColor('Blue')->get();
php
Illuminate\Database\Eloquent\Collection {▼
  items: array:134 [▼
    0 => Lwwcas\LaravelCountries\Models\Country {#288 ▼
      connection: "mysql"
      table: "lc_countries"
      primaryKey: "id"
      keyType: "int"
      +incrementing: true
      with: []
      withCount: []
      +preventsLazyLoading: false
      perPage: 15
      +exists: true
      +wasRecentlyCreated: false
      escapeWhenCastingToString: false
      attributes: array:34 [▼
        "id" => 246
        "lc_region_id" => 9
        "uid" => "01J9VCYERPV0Q73J9MA9TBEKJ6"
        "official_name" => "Principality of Andorra"
        "capital" => "Andorra la Vella"
        "iso_alpha_2" => "AD"
        "iso_alpha_3" => "AND"
        "iso_numeric" => 20
        "international_phone" => "376"
        "geoname_id" => "3041565"
        "wmo" => "AN"
        "independence_day" => "1278-09-08"
        "population" => "77543"
        "area" => "468"
        "gdp" => "3"
        "languages" => "["ca"]"
        "tld" => "[".ad"]"
        "alternative_tld" => "[]"
        "borders" => "["fr", "es"]"
        "timezones" => "{"main": [], "others": {"standard_time": "UTC+1", "daylight_saving_time": "UTC+2"}}"
        "currency" => " {"code": "EUR", "name": "Euro", "unit": ...
        "flag_emoji" => "{"css": "\\1F1E6\\1F1E9", "hex": ...
        "flag_colors" => "["Blue", "Yellow", "Red"]"
        "flag_colors_web" => "["blue", "yellow", "red"]"
        "flag_colors_contrast" => "["#FFFFFF", "#000000", "#FFFFFF"]"
        "flag_colors_hex" => "["#0032A0", "#FEDF00", "#D1001F"]"
        "flag_colors_rgb" => "["0,50,160", "254,223,0", "209,0,31"]"
        "flag_colors_cmyk" => "["100,69,0,37", "0,12,100,0", "0,100,85,18"]"
        "flag_colors_hsl" => "["224,100%,31%", "52,100%,50%", "350,100%,41%"]"
        "flag_colors_hsv" => "["224,100%,63%", "52,100%,100%", "350,100%,82%"]"
        "flag_colors_pantone" => "["Pantone 286 C", "Pantone 116 C", "Pantone 199 C"]"
        "is_visible" => 1
        "created_at" => "2024-10-10 14:22:25"
        "updated_at" => "2024-10-10 14:22:25"
      ]
      original: array:34 [▶]
      changes: []
      casts: array:18 [▶]
      classCastCache: []
      attributeCastCache: []
      dateFormat: null
      appends: []
      dispatchesEvents: []
      observables: []
      relations: array:1 [▶]
      touches: []
      +timestamps: true
      +usesUniqueIds: false
      hidden: []
      visible: []
      fillable: array:31 [▶]
      guarded: array:1 [▶]
      +localeKey: "locale"
      +translationModel: "Lwwcas\LaravelCountries\Models\CountryTranslation"
      +translatedAttributes: array:2 [▶]
      +translationForeignKey: "lc_country_id"
      defaultLocale: null
    }
    1 => Lwwcas\LaravelCountries\Models\Country {#289 ▶}
    2 => Lwwcas\LaravelCountries\Models\Country {#290 ▶}
    3 => Lwwcas\LaravelCountries\Models\Country {#291 ▶}
    4 => Lwwcas\LaravelCountries\Models\Country {#292 ▶}
    ...
  ]
  escapeWhenCastingToString: false
}
php
Country::whereFlagColor(['Blue', 'Red'])->get();
php
Illuminate\Database\Eloquent\Collection {▼
  items: array:228 [▼
    0 => Lwwcas\LaravelCountries\Models\Country {#288 ▼
      connection: "mysql"
      table: "lc_countries"
      primaryKey: "id"
      keyType: "int"
      +incrementing: true
      with: []
      withCount: []
      +preventsLazyLoading: false
      perPage: 15
      +exists: true
      +wasRecentlyCreated: false
      escapeWhenCastingToString: false
      attributes: array:34 [▼
        "id" => 246
        "lc_region_id" => 9
        "uid" => "01J9VCYERPV0Q73J9MA9TBEKJ6"
        "official_name" => "Principality of Andorra"
        "capital" => "Andorra la Vella"
        "iso_alpha_2" => "AD"
        "iso_alpha_3" => "AND"
        "iso_numeric" => 20
        "international_phone" => "376"
        "geoname_id" => "3041565"
        "wmo" => "AN"
        "independence_day" => "1278-09-08"
        "population" => "77543"
        "area" => "468"
        "gdp" => "3"
        "languages" => "["ca"]"
        "tld" => "[".ad"]"
        "alternative_tld" => "[]"
        "borders" => "["fr", "es"]"
        "timezones" => "{"main": [], "others": {"standard_time": "UTC+1", "daylight_saving_time": "UTC+2"}}"
        "currency" => " {"code": "EUR", "name": "Euro", "unit": {"sub": ...
        "flag_emoji" => "{"css": "\\1F1E6\\1F1E9", "hex": "&#x1F ...
        "flag_colors" => "["Blue", "Yellow", "Red"]"
        "flag_colors_web" => "["blue", "yellow", "red"]"
        "flag_colors_contrast" => "["#FFFFFF", "#000000", "#FFFFFF"]"
        "flag_colors_hex" => "["#0032A0", "#FEDF00", "#D1001F"]"
        "flag_colors_rgb" => "["0,50,160", "254,223,0", "209,0,31"]"
        "flag_colors_cmyk" => "["100,69,0,37", "0,12,100,0", "0,100,85,18"]"
        "flag_colors_hsl" => "["224,100%,31%", "52,100%,50%", "350,100%,41%"]"
        "flag_colors_hsv" => "["224,100%,63%", "52,100%,100%", "350,100%,82%"]"
        "flag_colors_pantone" => "["Pantone 286 C", "Pantone 116 C", "Pantone 199 C"]"
        "is_visible" => 1
        "created_at" => "2024-10-10 14:22:25"
        "updated_at" => "2024-10-10 14:22:25"
      ]
      original: array:34 [▶]
      changes: []
      casts: array:18 [▶]
      classCastCache: []
      attributeCastCache: []
      dateFormat: null
      appends: []
      dispatchesEvents: []
      observables: []
      relations: array:1 [▶]
      touches: []
      +timestamps: true
      +usesUniqueIds: false
      hidden: []
      visible: []
      fillable: array:31 [▶]
      guarded: array:1 [▶]
      +localeKey: "locale"
      +translationModel: "Lwwcas\LaravelCountries\Models\CountryTranslation"
      +translatedAttributes: array:2 [▶]
      +translationForeignKey: "lc_country_id"
      defaultLocale: null
    }
    1 => Lwwcas\LaravelCountries\Models\Country {#289 ▶}
    2 => Lwwcas\LaravelCountries\Models\Country {#290 ▶}
    3 => Lwwcas\LaravelCountries\Models\Country {#291 ▶}
    4 => Lwwcas\LaravelCountries\Models\Country {#292 ▶}
    ...
  ]
  escapeWhenCastingToString: false
}

INFO

All the other output functions are similar to what we've seen above. So, let's keep things simple and focus on documenting the scopes for filtering colors. This will help ensure clarity and ease when you're using these functions in different contexts to manipulate or retrieve specific flag colors. Let's dive into making the scopes straightforward and well-documented for efficient filtering!

Where Flag Color Web ​

php
->whereFlagColorWeb(string|array $code)
php
Country::whereFlagColorWeb('blue')->get();
php
Country::whereFlagColorWeb(['blue,' 'green'])->get();

Where Flag Contrast ​

php
->whereFlagContrast(string|array $code)
php
Country::whereFlagContrast('#000000')->get();
php
Country::whereFlagContrast(['#000000,' '#FFFFFF'])->get();

Where Flag Color Hex ​

php
->whereFlagColorHex(string|array $code)
php
Country::whereFlagColorHex("#0032A0")->get();
php
Country::whereFlagColorHex(["#FEDF00", "#D1001F"])->get();

Where Flag Color RGB ​

php
->whereFlagColorRGB(string|array $code)
php
Country::whereFlagColorRGB("0,50,160")->get();
php
Country::whereFlagColorRGB(["254,223,0", "209,0,31"])->get();

Where Flag Color CMYK ​

php
->whereFlagColorCMYK(string|array $code)
php
Country::whereFlagColorCMYK("100,69,0,37")->get();
php
Country::whereFlagColorCMYK(["0,12,100,0", "0,100,85,18"])->get();

Where Flag Color HSL ​

php
->whereFlagColorHSL(string|array $code)
php
Country::whereFlagColorHSL("224,100%,31%")->get();
php
Country::whereFlagColorHSL(["52,100%,50%", "350,100%,41%"])->get();

Where Flag Color HSV ​

php
->whereFlagColorHSV(string|array $code)
php
Country::whereFlagColorHSV("204,48%,87%")->get();
php
Country::whereFlagColorHSV(["0,0%,100%", "42,94%,96%"])->get();

Where Flag Color Pantone ​

php
->whereFlagColorPantone(string|array $code)
php
Country::whereFlagColorPantone("Pantone 292 C")->get();
php
Country::whereFlagColorPantone(["Pantone White", "Pantone 1235 C"])->get();

Released under the MIT License.