LanguageController
extends BaseController
in package
Controller for language configuration.
Handles:
- Language listing and management
- Language creation and editing
- Language deletion
- Text reparsing
- Language pair selection
Tags
Table of Contents
Properties
Methods
- __construct() : mixed
- Create a new LanguageController.
- delete() : void
- Delete a language.
- edit() : void
- Edit language form.
- index() : void
- Languages index page - shows language list.
- new() : void
- Show new language form.
- refresh() : void
- Refresh (reparse) all texts for a language.
- endRender() : void
- End page rendering with standard LWT footer.
- execute() : int
- Execute an INSERT/UPDATE/DELETE query.
- get() : string
- Get a string GET parameter.
- getMarkedIds() : array<string|int, int>
- Get IDs from marked checkboxes.
- getValue() : mixed
- Get a single value from the database.
- hasParam() : bool
- Check if a parameter exists in the request.
- isGet() : bool
- Check if the request is a GET request.
- isPost() : bool
- Check if the request is a POST request.
- json() : JsonResponse
- Return JSON response.
- message() : void
- Display a message (success/error) to the user using Bulma notifications.
- param() : string
- Get a string request parameter (GET, POST, or REQUEST).
- paramArray() : array<string|int, mixed>
- Get an array request parameter.
- paramInt() : int|null
- Get an integer request parameter.
- post() : string
- Get a string POST parameter.
- query() : mysqli_result|bool
- Execute a database query using the LWT query wrapper.
- redirect() : RedirectResponse
- Redirect to another URL.
- render() : void
- Start page rendering with standard LWT header.
- requireInt() : int
- Get a required integer request parameter.
- getLanguagePresetsArray() : array<int, array{id: int|string, name: string}>
- Get language presets as array for searchable select.
- getWizardSelectOptions() : string
- Generate wizard select options HTML.
- prepareLanguageCodes() : void
- Prepare source and target language codes for the form.
- showEditForm() : void
- Show the edit language form.
- showList() : void
- Show the list of languages.
- showNewForm() : void
- Show the new language form.
Properties
$languageFacade
private
LanguageFacade
$languageFacade
Methods
__construct()
Create a new LanguageController.
public
__construct(LanguageFacade $languageFacade) : mixed
Parameters
- $languageFacade : LanguageFacade
-
Language facade for language operations
delete()
Delete a language.
public
delete(int $id) : void
Route: DELETE /languages/{id}
Parameters
- $id : int
-
Language ID from route parameter
edit()
Edit language form.
public
edit(int $id) : void
Route: GET/POST /languages/{id}/edit
Parameters
- $id : int
-
Language ID from route parameter
index()
Languages index page - shows language list.
public
index(array<string|int, mixed> $params) : void
Route: GET /languages
Parameters
- $params : array<string|int, mixed>
-
Route parameters
new()
Show new language form.
public
new(array<string|int, mixed> $params) : void
Route: GET /languages/new
Parameters
- $params : array<string|int, mixed>
-
Route parameters
refresh()
Refresh (reparse) all texts for a language.
public
refresh(int $id) : void
Route: POST /languages/{id}/refresh
Parameters
- $id : int
-
Language ID from route parameter
endRender()
End page rendering with standard LWT footer.
protected
endRender() : void
execute()
Execute an INSERT/UPDATE/DELETE query.
protected
execute(string $sql) : int
Parameters
- $sql : string
-
SQL query
Tags
Return values
int —Number of affected rows
get()
Get a string GET parameter.
protected
get(string $key[, string $default = '' ]) : string
Parameters
- $key : string
-
Parameter name
- $default : string = ''
-
Default value if not set
Return values
string —Parameter value or default
getMarkedIds()
Get IDs from marked checkboxes.
protected
getMarkedIds(string|array<string|int, mixed> $marked) : array<string|int, int>
Parameters
- $marked : string|array<string|int, mixed>
-
The 'marked' request parameter value
Tags
Return values
array<string|int, int> —Array of integer IDs
getValue()
Get a single value from the database.
protected
getValue(string $sql) : mixed
Parameters
- $sql : string
-
SQL query (should return single value as 'value')
Return values
mixed —The value or null
hasParam()
Check if a parameter exists in the request.
protected
hasParam(string $key) : bool
Parameters
- $key : string
-
Parameter name
Return values
bool —True if the parameter exists
isGet()
Check if the request is a GET request.
protected
isGet() : bool
Return values
boolisPost()
Check if the request is a POST request.
protected
isPost() : bool
Return values
booljson()
Return JSON response.
protected
json(mixed $data[, int $status = 200 ]) : JsonResponse
Return this from a controller method; the router will send it.
Parameters
- $data : mixed
-
Data to encode as JSON
- $status : int = 200
-
HTTP status code (default: 200)
Return values
JsonResponsemessage()
Display a message (success/error) to the user using Bulma notifications.
protected
message(string $message[, bool $autoHide = true ]) : void
Parameters
- $message : string
-
The message to display
- $autoHide : bool = true
-
Whether to auto-hide the message (default: true)
param()
Get a string request parameter (GET, POST, or REQUEST).
protected
param(string $key[, string $default = '' ]) : string
Parameters
- $key : string
-
Parameter name
- $default : string = ''
-
Default value if not set
Return values
string —Parameter value or default
paramArray()
Get an array request parameter.
protected
paramArray(string $key[, array<string|int, mixed> $default = [] ]) : array<string|int, mixed>
Parameters
- $key : string
-
Parameter name
- $default : array<string|int, mixed> = []
-
Default value if not set
Return values
array<string|int, mixed> —Parameter value or default
paramInt()
Get an integer request parameter.
protected
paramInt(string $key[, int|null $default = null ][, int|null $min = null ][, int|null $max = null ]) : int|null
Parameters
- $key : string
-
Parameter name
- $default : int|null = null
-
Default value if not set
- $min : int|null = null
-
Minimum allowed value
- $max : int|null = null
-
Maximum allowed value
Return values
int|null —Parameter value or default
post()
Get a string POST parameter.
protected
post(string $key[, string $default = '' ]) : string
Parameters
- $key : string
-
Parameter name
- $default : string = ''
-
Default value if not set
Return values
string —Parameter value or default
query()
Execute a database query using the LWT query wrapper.
protected
query(string $sql) : mysqli_result|bool
Parameters
- $sql : string
-
SQL query
Return values
mysqli_result|bool —Query result
redirect()
Redirect to another URL.
protected
redirect(string $url[, int $statusCode = 302 ]) : RedirectResponse
Return this from a controller method; the router will send it.
Parameters
- $url : string
-
URL to redirect to
- $statusCode : int = 302
-
HTTP status code (default: 302)
Return values
RedirectResponserender()
Start page rendering with standard LWT header.
protected
render(string $title[, bool $showMenu = true ]) : void
Parameters
- $title : string
-
Page title
- $showMenu : bool = true
-
Whether to show navigation menu (default: true)
requireInt()
Get a required integer request parameter.
protected
requireInt(string $key[, int|null $min = null ][, int|null $max = null ]) : int
Parameters
- $key : string
-
Parameter name
- $min : int|null = null
-
Minimum allowed value
- $max : int|null = null
-
Maximum allowed value
Tags
Return values
int —Parameter value
getLanguagePresetsArray()
Get language presets as array for searchable select.
private
getLanguagePresetsArray() : array<int, array{id: int|string, name: string}>
Return values
array<int, array{id: int|string, name: string}>getWizardSelectOptions()
Generate wizard select options HTML.
private
getWizardSelectOptions(string $selected) : string
Parameters
- $selected : string
-
Currently selected value
Return values
string —HTML options
prepareLanguageCodes()
Prepare source and target language codes for the form.
private
prepareLanguageCodes(Language $language, string $currentNativeLanguage, string &$sourceLg, string &$targetLg) : void
Parameters
- $language : Language
-
Language object
- $currentNativeLanguage : string
-
Current native language
- $sourceLg : string
-
Output source language code
- $targetLg : string
-
Output target language code
showEditForm()
Show the edit language form.
private
showEditForm(int $lid) : void
Parameters
- $lid : int
-
Language ID
showList()
Show the list of languages.
private
showList(string $message) : void
Parameters
- $message : string
-
Optional message to display
showNewForm()
Show the new language form.
private
showNewForm() : void