A package to use helper functions and Iranian Validator in laravel apps.
MIT License
Installation
Publish Config file
Helper functions and facades that exists in package
Helper Functions Usage
Validators that exists in package
Validators Usage
Categories Usage
Requirements
composer require va/cutlet-helper
php artisan vendor:publish --tag=cutlet-helper
integerToken($length = 5) // Generate integer token or code
stringToken($length = 16, $characters = '2345679acdefghjkmnpqrstuvwxyz') // Generate string token or code
digitsToEastern($number) // Covert a Weatern number(English) or digits to Eastern number(Persian or Arabic)
easternToDigits($number) // Covert a Eastern number(Persion, Arabic) to Eastern number(English)
isActive($key, $activeClassName = 'active') // Check the route name(string) or route names(array) is avtive or no for css classes
prepareInteger(input: string or integer) // removes `,` from integer (can be used in request for prices)
prepareSlug(slug, title, model) // generate clean slug from title and checks slug unique in specific model
// With Facade format:
CutletHelper::integerToken(length: 10);
CutletHelper::stringToken(length: 32, characters: '2345679acdefghjkmnpqrstuvwxyz');
CutletHelper::digitsToEastern(number: 1375);
CutletHelper::easternToDigits(number: ۱۳۷۵);
CutletHelper::isActive(key: ['posts.index', 'posts.create', 'posts.edit'], activeClassName: 'acive');
CutletHelper::prepareInteger(input: string or integer);
CutletHelper::prepareSlug(slug, title, model);
// Call a helper function:
integerToken(length: 10)
stringToken(length: 32, characters: '2345679acdefghjkmnpqrstuvwxyz');
digitsToEastern(number: 1375);
easternToDigits(number: ۱۲۳۴۵);
isActive(key: ['posts.index', 'posts.create', 'posts.edit'], activeClassName: 'acive');
prepareInteger(input: string or integer);
prepareSlug(slug, title, model);
national_code
A rule for validating Iranian national code (How calculated)
return [
'code' => 'required|national_code'
];
// For national_code with exeptions code or valid codes for foreign national codes
// First step for use this parameters is migrate, php artisan migrate, and save your exeptions in this table
// but if you want to use another table you can set your table and column
return [
'code' => 'required|national_code:national_code_exceptions' // This is default table that contains exeption codes
// -- OR --
'code' => 'required|national_code:national_code_exceptions,code' // Second parameter is column of exeption table
];
// -- OR --
return [
'code' => ['required', 'national_code']
];
// -- OR --
$validatedData = $request->validate([
'code' => 'national_code',
]);
iban
A rule for validating IBAN (International Bank Account Number) known in Iran as Sheba. (How calculated)
return [
'account' => 'iban'
];
// -- OR --
// Add `false` optional parameter after `iban`, If IBAN doesn't begin with `IR`, so the validator will add `IR` as default to the account number:
return [
'account' => 'iban:false'
];
// -- OR --
// If you want to validate non Iranian IBAN, add the 2 letters of country code after `false` optional parameter:
return [
'account' => 'iban:false,DE'
];
debit_card
A rule for validating Iranian debit cards. (How calculated)
return [
'code' => 'required|debit_card'
];
// -- OR --
return [
'code' => ['required', 'debit_card']
];
// -- OR --
$validatedData = $request->validate([
'code' => 'debit_card',
]);
// -- OR --
// You can add an optional parameter if you want to validate a card from a specific bank:
return [
'code' => 'required|debit_card:bmi'
];
/* List of the bank codes:
- bmi (بانک ملی)
- banksepah (بانک سپه)
- edbi (بانک توصعه صادرات)
- bim (بانک صنعت و معدن)
- bki (بانک کشاورزی)
- bank-maskan (بانک مسکن)
- postbank (پست بانک ایران)
- ttbank (بانک توسعه تعاون)
- enbank (بانک اقتصاد نوین)
- parsian-bank (بانک پارسیان)
- bpi (بانک پاسارگاد)
- karafarinbank (بانک کارآفرین)
- sb24 (بانک سامان)
- sinabank (بانک سینا)
- sbank (بانک سرمایه)
- shahr-bank (بانک شهر)
- bank-day (بانک دی)
- bsi (بانک صادرات)
- bankmellat (بانک ملت)
- tejaratbank (بانک تجارت)
- refah-bank (بانک رفاه)
- ansarbank (بانک انصار)
- mebank (بانک مهر اقتصاد)
*/
postal_code
return [
'code' => 'required|postal_code'
];
// --OR--
return [
'code' => ['required, 'postal_code']
];
// --OR--
$validatedData = $request->validate([
'code' => 'postal_code',
]);
shenase_meli
A rule for validating Iranian shenase meli (How calculated)
return [
'code' => 'required|shenase_meli'
];
// --OR--
return [
'code' => ['required, 'shenase_meli']
];
// --OR--
$validatedData = $request->validate([
'code' => 'shenase_meli',
]);
mobile
return [
'mobile' => 'required|mobile'
];
// --OR--
return [
'mobile' => ['required, 'mobile']
];
// --OR--
$validatedData = $request->validate([
'mobile' => 'mobile',
]);
username (Valid characters: English Alphabetic, Numbers and _)
return [
'username' => 'required|username'
];
// --OR--
return [
'username' => ['required, 'username']
];
// --OR--
$validatedData = $request->validate([
'username' => 'username',
]);
phone
return [
'phone' => 'required|phone'
];
// --OR--
return [
'phone' => ['required, 'phone']
];
// --OR--
$validatedData = $request->validate([
'phone' => 'phone',
]);
unique_dynamic (table_name, target_column, extra_column, extra_column_value, ignore_column, ignore_column_value)
return [
// Without ignore for create user, 4 parameters
// If we want to check a username is unique in users table when type of this useranme equal student
// If username = 'v.ashourzadeh' and type = 'student' you can't create username = 'v.ashourzadeh' but create username = 'v.ashourzadeh' if type = 'teacher'
'username' => 'required|unique_dynamic:users,username,type,student'
// With ignore for edit user, 6 parameters
// If we want to check a username is unique in users table and ignore this for special id, for example id = 5
// If username = 'v.ashourzadeh' and type = 'student' you can set username = 'v.ashourzadeh' when id = 5
'username' => 'required|unique_dynamic:users,username,type,student,id,5'
];
// --OR--
return [
// Without ignore for create user, 4 parameters
'username' => ['required, 'unique_dynamic:users,username,type,student']
// With ignore for edit user, 6 parameter
'username' => ['required, 'unique_dynamic:users,username,type,student,id,5']
];
// --OR--
$validatedData = $request->validate([
// Without ignore for create user, 4 parameters
'username' => 'unique_dynamic:users,username,type,student',
// With ignore for edit user, 6 parameter
'username' => 'unique_dynamic:users,username,type,student,id,5',
]);
persian_alphabetic
return [
'code' => 'required|persian_alphabetic'
];
// --OR--
return [
'code' => ['required, 'persian_alphabetic']
];
// --OR--
$validatedData = $request->validate([
'code' => 'persian_alphabetic',
]);
persian_number
return [
'code' => 'required|persian_number'
];
// --OR--
return [
'code' => ['required, 'persian_number']
];
// --OR--
$validatedData = $request->validate([
'code' => 'persian_number',
]);
This package provides category handling for blew table structure with Category
model:
categories => id, slug, title, category_type, description, parent_id, creator_id
categorizables => category_id, categorizable_id, categorizable_type
Usage in category create blade :
<x-category-options page="create" type="serviceCategory"></x-category-options>
this tag generates select options , so you can use it in select or select2 tags.
type: the category type used in the table structure, for example postCategory
page: the blade page that contains the current tag
Usage in category edit blade:
<x-category-options page="edit" type="serviceCategory" parent="{{ $category->parent_id }}" category="{{ $category->id }}"></x-category-options>
parent: that contains current category parent_id
category: that contains current category_id
Usage in specific create blade that contains category:
<x-category-checkboxes page="create" type="serviceCategory"></x-category-checkboxes>
this tag generates checkboxes , so you can use it in any div tag.
type: the category type used in the table structure, for example postCategory
page: the blade page that contains the current tag
Usage in specific edit blade that contains category:
<x-category-checkboxes type="serviceCategory" page="edit" checked="{{ $service->categories->pluck('id') }}"></x-category-checkboxes>