Mails
extends Master
in package
implements
WithIncludes
The communications widget
Implements interfaces to handle email and email setup administration Additional function is the access to the mail sender configuration
On top, this system widget provides access to the internal mail buffer, the sender status and the option to resend a delivered but possible not received mail
Tags
Interfaces, Classes, Traits and Enums
Table of Contents
- $request : Request|null
- $endpoint : Endpoint|null
- $response : Response|null
- $setup : Widget|null
- $git_repo : array<string|int, mixed>
- __construct() : mixed
- Needs to be there even if it is empty
- AddMailSetup() : mixed
- AddNewsletter() : void
- call() : mixed
- CopyMailSetup() : mixed
- DeleteMailSetup() : void
- DeleteNewsletterQueue() : void
- DeleteShortLink() : void
- DeleteSingle() : mixed
- DownloadAttachments() : mixed
- DropNewsletter() : void
- Endpoint() : Endpoint|null
- Get/Set endpoint
- FetchMailSendInterface() : mixed
- FetchMailSendInterfaces() : mixed
- FetchMailSendInterfaceSetup() : mixed
- FetchNewsletter() : void
- FetchNewsletters() : void
- FetchProcessed() : void
- FetchShortLink() : void
- FetchSingle() : mixed
- FetchSinglePreview() : void
- GitRepo() : Git
- Git object
- ListNewsletterQueue() : mixed
- ListShortLinks() : void
- MailSetup() : void
- MailSetups() : mixed
- MailSetupsSelect() : mixed
- NewsletterMailPreview() : void
- PreviewNewsletterTriggerTimes() : void
- PushSetupLoad() : mixed
- PushSetupPreset() : mixed
- PushSetupSave() : mixed
- RegisterIncludes() : array<string|int, mixed>
- Register includes on add the widget to certain page
- Request() : Request
- The request Sets or gets the widget request object
- Response() : Response
- Response object Get / Set the widget response
- Setup() : Widget|null
- Get/Set the widget context
- SubmitAndSend() : void
- UpdateMailSendInterface() : mixed
- UpdateMailSetup() : void
- UpdateNewsletter() : void
- UpdateShortLink() : void
- ConfigGet() : void
- Get a configuration by name
- ConfigGetPreset() : void
- Get the configuration preset data
- ConfigGetRaw() : Result
- Get configuration data as object from setup handler
- ConfigSave() : void
- Store a configuration with values from body and a given name
- CopyEntity() : void
- copy a single content links the frontend to the copy handler for single contents identified by rest end point argument
- CreateEntity() : mixed
- create new object
- deleteEntity() : void
- Delete a single content
- fetchAssignedEntityList() : mixed
- fetchEntityList() : void
- Fetch list of entries Use the direct loader method to retrieve a list obf objects
- fetchEntityListFiltered() : void
- Fetch filtered list
- fetchObject() : BaseContent|bool|null
- Retrieve an object from storage
- handleSubViewList() : mixed
- Handle the list/object loading for sub view of contents
- loadSingleEntity() : void
- load a single content implements the loader for single contents identified by rest end point argument
- prepareObjectLogs() : void
- Prepare the object comment and arguments for changes in diff
- UpdateEntity() : void
- Update a single content
Properties
$request
public
Request|null
$request
= null
$endpoint
protected
Endpoint|null
$endpoint
= null
$response
protected
Response|null
$response
= null
$setup
protected
Widget|null
$setup
= null
$git_repo
private
array<string|int, mixed>
$git_repo
= array()
Methods
__construct()
Needs to be there even if it is empty
public
__construct() : mixed
Return values
mixed —AddMailSetup()
public
AddMailSetup() : mixed
Return values
mixed —AddNewsletter()
public
AddNewsletter() : void
Return values
void —call()
public
call() : mixed
Return values
mixed —CopyMailSetup()
public
CopyMailSetup() : mixed
Return values
mixed —DeleteMailSetup()
public
DeleteMailSetup() : void
Return values
void —DeleteNewsletterQueue()
public
DeleteNewsletterQueue() : void
Return values
void —DeleteShortLink()
public
DeleteShortLink() : void
Return values
void —DeleteSingle()
public
DeleteSingle() : mixed
Return values
mixed —DownloadAttachments()
public
DownloadAttachments() : mixed
Return values
mixed —DropNewsletter()
public
DropNewsletter() : void
Return values
void —Endpoint()
Get/Set endpoint
public
Endpoint([Endpoint|null $endpoint = null ]) : Endpoint|null
Sets or gets the widget arguments, they contain the endpoint this widget was called at
Parameters
- $endpoint : Endpoint|null = null
-
A system request list
Return values
Endpoint|null —A system endpoint object
FetchMailSendInterface()
public
FetchMailSendInterface() : mixed
Return values
mixed —FetchMailSendInterfaces()
public
FetchMailSendInterfaces() : mixed
Return values
mixed —FetchMailSendInterfaceSetup()
public
FetchMailSendInterfaceSetup() : mixed
Return values
mixed —FetchNewsletter()
public
FetchNewsletter() : void
Return values
void —FetchNewsletters()
public
FetchNewsletters() : void
Return values
void —FetchProcessed()
public
FetchProcessed() : void
Return values
void —FetchShortLink()
public
FetchShortLink() : void
Return values
void —FetchSingle()
public
FetchSingle() : mixed
Return values
mixed —FetchSinglePreview()
public
FetchSinglePreview() : void
Return values
void —GitRepo()
Git object
public
GitRepo([string $path = 'data' ]) : Git
Gets the widget git instance, either for config or, for data repo
Parameters
- $path : string = 'data'
-
The target repo, default is data
Return values
Git —A system git object with data folder as start point
ListNewsletterQueue()
public
ListNewsletterQueue() : mixed
Return values
mixed —ListShortLinks()
public
ListShortLinks() : void
Return values
void —MailSetup()
public
MailSetup() : void
Return values
void —MailSetups()
public
MailSetups() : mixed
Return values
mixed —MailSetupsSelect()
public
MailSetupsSelect() : mixed
Return values
mixed —NewsletterMailPreview()
public
NewsletterMailPreview() : void
Return values
void —PreviewNewsletterTriggerTimes()
public
PreviewNewsletterTriggerTimes() : void
Return values
void —PushSetupLoad()
public
PushSetupLoad() : mixed
Return values
mixed —PushSetupPreset()
public
PushSetupPreset() : mixed
Return values
mixed —PushSetupSave()
public
PushSetupSave() : mixed
Return values
mixed —RegisterIncludes()
Register includes on add the widget to certain page
public
RegisterIncludes(Request $request) : array<string|int, mixed>
Parameters
- $request : Request
Tags
Return values
array<string|int, mixed> —Request()
The request Sets or gets the widget request object
public
Request([Request|null $request = null ]) : Request
Parameters
- $request : Request|null = null
-
A system request object
Return values
Request —A system request object
Response()
Response object Get / Set the widget response
public
Response([Response|null $response = null ]) : Response
Parameters
- $response : Response|null = null
Return values
Response —A system response object
Setup()
Get/Set the widget context
public
Setup([Widget|null $setup = null ]) : Widget|null
Parameters
- $setup : Widget|null = null
Return values
Widget|null —SubmitAndSend()
public
SubmitAndSend() : void
Return values
void —UpdateMailSendInterface()
public
UpdateMailSendInterface() : mixed
Return values
mixed —UpdateMailSetup()
public
UpdateMailSetup() : void
Return values
void —UpdateNewsletter()
public
UpdateNewsletter() : void
Return values
void —UpdateShortLink()
public
UpdateShortLink() : void
Return values
void —ConfigGet()
Get a configuration by name
protected
ConfigGet(string $name) : void
Parameters
- $name : string
-
The name of the config file
Return values
void —ConfigGetPreset()
Get the configuration preset data
protected
ConfigGetPreset(string $name) : void
Parameters
- $name : string
-
The name of the config file
Return values
void —ConfigGetRaw()
Get configuration data as object from setup handler
protected
ConfigGetRaw(string $name) : Result
Parameters
- $name : string
-
The name of the config file
Return values
Result —ConfigSave()
Store a configuration with values from body and a given name
protected
ConfigSave(string $name) : void
Parameters
- $name : string
-
The name of the config file
Return values
void —CopyEntity()
copy a single content links the frontend to the copy handler for single contents identified by rest end point argument
protected
CopyEntity(array<string|int, mixed>|string $type, int|string $epIndex) : void
Parameters
- $type : array<string|int, mixed>|string
-
The requested content type
- $epIndex : int|string
-
Parse this parameter as id
Return values
void —CreateEntity()
create new object
protected
CreateEntity(string $type) : mixed
this method creates a new instance of a specific system content type
Parameters
- $type : string
-
A registered system content type
Return values
mixed —deleteEntity()
Delete a single content
protected
deleteEntity(string|array<string|int, string> $type, int|string $epIndex) : void
Implements the delete handler for single contents identified by rest end point argument
Parameters
- $type : string|array<string|int, string>
-
The requested content type
- $epIndex : int|string
-
Parse this parameter as id
Return values
void —fetchAssignedEntityList()
protected
fetchAssignedEntityList( $list[, null $language = null ]) : mixed
Parameters
Tags
Return values
mixed —fetchEntityList()
Fetch list of entries Use the direct loader method to retrieve a list obf objects
protected
fetchEntityList(string $type[, bool $raw = false ]) : void
Parameters
- $type : string
-
Fetch list of elements
- $raw : bool = false
-
Return as raw object and not plain
Return values
void —fetchEntityListFiltered()
Fetch filtered list
protected
fetchEntityListFiltered(string|array<string|int, string> $type[, array<string|int, mixed>|null $extra_payload = null ]) : void
Implements the server side data tables processing functions Supports free text search, paging and ordering at the moment
Parameters
- $type : string|array<string|int, string>
-
The requested content type(s)
- $extra_payload : array<string|int, mixed>|null = null
-
Additional filter operators
Return values
void —fetchObject()
Retrieve an object from storage
protected
fetchObject(int|string $id, string|array<string|int, string> $type[, string $right = 'view' ]) : BaseContent|bool|null
Load a single content from storage as instance If object was not found it will set the 404 error code
Parameters
- $id : int|string
-
A object id
- $type : string|array<string|int, string>
-
A object type
- $right : string = 'view'
-
An access level to test against
Return values
BaseContent|bool|null —A base content or null when not found or false when not access
handleSubViewList()
Handle the list/object loading for sub view of contents
protected
handleSubViewList(array<string|int, mixed> $payload) : mixed
Parameters
- $payload : array<string|int, mixed>
-
The request payload parent_type string Name of the parent type to manage inside parent string/int The id of the parent content attr string The attribute name to manage type string Type of the content to assign elements array List of elements when type is __multi content int Id when a direct content edit is performed (e.g. in child contents)
Tags
Return values
mixed —loadSingleEntity()
load a single content implements the loader for single contents identified by rest end point argument
protected
loadSingleEntity(string $type, int|string $epIndex[, string|null $language = null ]) : void
Parameters
- $type : string
-
The requested content type
- $epIndex : int|string
-
Parse this parameter as id
- $language : string|null = null
-
Language code to fetch element in
Return values
void —prepareObjectLogs()
Prepare the object comment and arguments for changes in diff
protected
prepareObjectLogs(BaseContent $item) : void
Parameters
- $item : BaseContent
Return values
void —UpdateEntity()
Update a single content
protected
UpdateEntity(string|array<string|int, string> $type, int|string $epIndex[, bool $return = false ]) : void
Implements the update handler for single contents identified by rest end point argument Does return the values when config option says so
Parameters
- $type : string|array<string|int, string>
-
The requested content type or, a list of allowed types
- $epIndex : int|string
-
Parse this parameter as id
- $return : bool = false