Documentation

TravelCategoryRepository extends Repository

Table of Contents

PAGINATION_LIMIT  = 15
RESPONSE_STATUS_ERROR  = 'error'
RESPONSE_STATUS_FAIL  = 'fail'
RESPONSE_STATUS_SUCCESS  = 'success'
$agencyRepo  : mixed
$model  : mixed
Model var
$repo  : mixed
Repo var
__construct()  : mixed
addImageToStorage()  : string
Add image to storage
all()  : array<string|int, mixed>
Get all instances of model
allChild()  : string
Return a list of database records
cleanNullValues()  : null
Change null values and put string("")
create()  : object
Create a new record in the database
delete()  : bool
It soft-deletes a record from the database
deleteChild()  : string
Delete record from the database
ensureHttp400Code()  : string
Return a extension from mimetype
firstOrCreate()  : object
Retrieves first element of the database. If it doesn't exists, it creates it before returning it.
firstOrNew()  : object
Retrieves first element of the database. If it doesn't exists, it instanciates it before returning it.
forceDelete()  : bool
It definitely removes a record from the database
getConcatString()  : string
Concatenate string to make it compatible with SQLite
getErrorResponse()  : array<string|int, mixed>
Return all an array of errors like validation in one format
getFailResponse()  : array<string|int, mixed>
Return all an array of errors like validation in one format
getModel()  : Model
Get the associated model
getSuccessResponse()  : array<string|int, mixed>
Return all an array of errors like validation in one format
microsecondsToSeconds()  : array<string|int, mixed>
Return all an array of errors like validation in one format
mime2ext()  : string
Return a extension from mimetype
moveImagesPredefinedText()  : mixed
Move the temporary images to the final folder.
orderQuery()  : null
Destroy record from the database
paginate()  : Model
picture_add()  : string
Adds a picture
picture_delete()  : string
Deletes a travel cateogry picture
picture_principal()  : string
Sets a picture as main picture
publicIndex()  : string
Public list ordered by custom order
publicShow()  : string
Public single element show
removeImageToStorage()  : void
Remove image to storage
reorder()  : array<string|int, mixed>
It reorders a travel category by its custom_order field.
sendMail()  : bool
Send an email
setModel()  : mixed
Set the associated model
show()  : object
Show the record with the given id
showChild()  : object
Show the record with the given id
showWith()  : Model
Eager load database relationships
storeChild()  : string
update()  : object
Updates a record in the database
updateChild()  : string
Update record from the database
savePictures()  : string
Save the pictures

Constants

PAGINATION_LIMIT

public mixed PAGINATION_LIMIT = 15

RESPONSE_STATUS_ERROR

public mixed RESPONSE_STATUS_ERROR = 'error'

RESPONSE_STATUS_FAIL

public mixed RESPONSE_STATUS_FAIL = 'fail'

RESPONSE_STATUS_SUCCESS

public mixed RESPONSE_STATUS_SUCCESS = 'success'

Properties

Methods

addImageToStorage()

Add image to storage

public addImageToStorage(array<string|int, mixed> $data) : string
Parameters
$data : array<string|int, mixed>
Return values
string

all()

Get all instances of model

public all() : array<string|int, mixed>
Return values
array<string|int, mixed>

allChild()

Return a list of database records

public allChild(int $parent_id) : string
Parameters
$parent_id : int
  • Id of the parent objects that we want to get.
Return values
string

cleanNullValues()

Change null values and put string("")

public cleanNullValues(array<string|int, mixed> &$data[, array<string|int, mixed> $exceptions = [] ]) : null
Parameters
$data : array<string|int, mixed>
  • Array with parameters
$exceptions : array<string|int, mixed> = []
  • Array with exceptions keys
Return values
null

create()

Create a new record in the database

public create(array<string|int, mixed> $data) : object
Parameters
$data : array<string|int, mixed>
  • Data of the object that we want to create.
Tags
throws
Exception
Return values
object

delete()

It soft-deletes a record from the database

public delete(array<string|int, mixed> $data, int $id) : bool
Parameters
$data : array<string|int, mixed>
$id : int
  • Id of the object that we want to remove.
Tags
throws
Exception
Return values
bool
  • Success or fail

deleteChild()

Delete record from the database

public deleteChild(array<string|int, mixed> $data, int $parent_id, int $id) : string

Re-sets the indexes for custom_order

Parameters
$data : array<string|int, mixed>
$parent_id : int
  • Id of the parent object that we want to delete.
$id : int
  • Id of the object that we want to delete.
Tags
throws
ValidationException
Return values
string

ensureHttp400Code()

Return a extension from mimetype

public ensureHttp400Code(mixed $code) : string
Parameters
$code : mixed
Return values
string

firstOrCreate()

Retrieves first element of the database. If it doesn't exists, it creates it before returning it.

public firstOrCreate(array<string|int, mixed> $data) : object
Parameters
$data : array<string|int, mixed>
  • Data of the object that we want to create.
Tags
throws
Exception
Return values
object

firstOrNew()

Retrieves first element of the database. If it doesn't exists, it instanciates it before returning it.

public firstOrNew(array<string|int, mixed> $data) : object
Parameters
$data : array<string|int, mixed>
  • Data of the object that we want to create.
Tags
throws
Exception
Return values
object

forceDelete()

It definitely removes a record from the database

public forceDelete(array<string|int, mixed> $data, int $id) : bool
Parameters
$data : array<string|int, mixed>
$id : int
  • Id of the object that we want to remove.
Tags
throws
Exception
Return values
bool
  • Success or fail

getConcatString()

Concatenate string to make it compatible with SQLite

public getConcatString( $firstField,  $secondField[,  $concatCharacter = ' ' ]) : string
Parameters
$firstField :

to concat

$secondField :

to concat

$concatCharacter : = ' '

Character used to join fields, default is space

Return values
string

getErrorResponse()

Return all an array of errors like validation in one format

public getErrorResponse(mixed $message[, mixed $code = null ]) : array<string|int, mixed>
Parameters
$message : mixed
$code : mixed = null
Return values
array<string|int, mixed>

getFailResponse()

Return all an array of errors like validation in one format

public getFailResponse(array<string|int, mixed> $data) : array<string|int, mixed>
Parameters
$data : array<string|int, mixed>
  • Array with parameters
Return values
array<string|int, mixed>

getModel()

Get the associated model

public getModel() : Model
Return values
Model

$model - A specific model

getSuccessResponse()

Return all an array of errors like validation in one format

public getSuccessResponse([array<string|int, mixed> $data = "" ]) : array<string|int, mixed>
Parameters
$data : array<string|int, mixed> = ""
  • Array with parameters
Return values
array<string|int, mixed>

microsecondsToSeconds()

Return all an array of errors like validation in one format

public microsecondsToSeconds(mixed $microseconds) : array<string|int, mixed>
Parameters
$microseconds : mixed
Return values
array<string|int, mixed>

mime2ext()

Return a extension from mimetype

public mime2ext(string $mime) : string
Parameters
$mime : string
  • String with mimetype
Return values
string

moveImagesPredefinedText()

Move the temporary images to the final folder.

public moveImagesPredefinedText(mixed $travelCategory) : mixed
Parameters
$travelCategory : mixed
Tags
throws
Exception
Return values
mixed

orderQuery()

Destroy record from the database

public orderQuery(mixed &$query, array<string|int, mixed> $params) : null
Parameters
$query : mixed
$params : array<string|int, mixed>
  • Array with the pagination params
Return values
null

paginate()

public paginate(mixed $paginationLimit) : Model
Parameters
$paginationLimit : mixed
Tags
desc

Get items with pagination

Return values
Model

$model - N instances of mode

picture_add()

Adds a picture

public picture_add(array<string|int, mixed> $data,  $agency_id,  $travel_category_id) : string
Parameters
$data : array<string|int, mixed>
$agency_id :
$travel_category_id :
Tags
throws
ValidationException
Return values
string

picture_delete()

Deletes a travel cateogry picture

public picture_delete(array<string|int, mixed> $data,  $agency_id,  $travel_category_id,  $picture_id) : string
Parameters
$data : array<string|int, mixed>
$agency_id :
$travel_category_id :
$picture_id :
Tags
throws
Exception
Return values
string

picture_principal()

Sets a picture as main picture

public picture_principal(array<string|int, mixed> $data,  $agency_id,  $travel_category_id,  $picture_id) : string
Parameters
$data : array<string|int, mixed>
$agency_id :
$travel_category_id :
$picture_id :
Tags
throws
Exception
Return values
string

publicIndex()

Public list ordered by custom order

public publicIndex(array<string|int, mixed> $data) : string
Parameters
$data : array<string|int, mixed>
Tags
throws
Exception
Return values
string

publicShow()

Public single element show

public publicShow(array<string|int, mixed> $data,  $uuid) : string
Parameters
$data : array<string|int, mixed>
$uuid :
Tags
throws
Exception
Return values
string

removeImageToStorage()

Remove image to storage

public removeImageToStorage(array<string|int, mixed> $data, mixed $parent_id, mixed $id) : void
Parameters
$data : array<string|int, mixed>
$parent_id : mixed
$id : mixed
Return values
void

reorder()

It reorders a travel category by its custom_order field.

public reorder(array<string|int, mixed> $data,  $agency_id,  $travel_category_id) : array<string|int, mixed>

If we move an element backward (from position 5 to 2) we increase by one and replace that exact element.

If we move an element forward (from position 2 to 5) we want to put the element AFTER it, if we don't do it, we will se the element in one position behind where we pretended.

Parameters
$data : array<string|int, mixed>
$agency_id :
$travel_category_id :
Tags
throws
Exception
Return values
array<string|int, mixed>

travel

sendMail()

Send an email

public sendMail( $mail, string $toEmail[, string $bccEmail = null ]) : bool
Parameters
$mail :
  • Mailable extended class to send
$toEmail : string
  • Delivery address
$bccEmail : string = null
  • Black carbon copy address
Return values
bool

setModel()

Set the associated model

public setModel(Model $model) : mixed
Parameters
$model : Model
  • A specific model
Return values
mixed

show()

Show the record with the given id

public show(int $id) : object
Parameters
$id : int
  • Id of the object that we want to show.
Return values
object

showChild()

Show the record with the given id

public showChild( $parent_id, int $id) : object
Parameters
$parent_id :
$id : int
  • Id of the object that we want to show.
Tags
throws
Exception
Return values
object

showWith()

Eager load database relationships

public showWith(mixed $id, string $relations) : Model
Parameters
$id : mixed
$relations : string
  • A name of relations to add
Return values
Model

$model - A specific model

storeChild()

public storeChild(array<string|int, mixed> $data, int $parent_id) : string
Parameters
$data : array<string|int, mixed>
$parent_id : int
  • Id of the parent object that we want to create.
Tags
desc

Create a new record in the database

Re-sets the custom_order indexes

throws
ValidationException
throws
Exception
Return values
string

update()

Updates a record in the database

public update(array<string|int, mixed> $data, int $id) : object
Parameters
$data : array<string|int, mixed>
  • Datas of the object that we want to update.
$id : int
  • Id of the object that we want to update.
Tags
throws
Exception
Return values
object

updateChild()

Update record from the database

public updateChild(array<string|int, mixed> $data, int $parent_id, int $id) : string
Parameters
$data : array<string|int, mixed>
$parent_id : int
  • Id of the parent object that we want to update.
$id : int
  • Id of the object that we want to update.
Tags
throws
ValidationException
throws
Exception
Return values
string

savePictures()

Save the pictures

private savePictures( $file,  $travelCategory, int $isPrincipal) : string
Parameters
$file :
$travelCategory :
$isPrincipal : int
Return values
string

Search results