engelsystem/includes/sys_template.php

433 lines
11 KiB
PHP
Raw Normal View History

2011-06-02 00:48:29 +02:00
<?php
2021-08-05 01:00:12 +02:00
use Illuminate\Support\Str;
2017-12-12 21:57:57 +01:00
/**
* Render a stat for dashborad (big number with label).
* If no style given, style is danger if number > 0, and success if number == 0.
2017-12-25 23:12:52 +01:00
*
2017-12-12 21:57:57 +01:00
* @param string $label
* @param string $number
* @param string $style default, warning, danger or success. Optional.
2017-12-25 23:12:52 +01:00
* @return string
2017-12-12 21:57:57 +01:00
*/
function stats($label, $number, $style = null)
{
2017-12-25 23:12:52 +01:00
if (empty($style)) {
if ($number > 0) {
2017-12-12 21:57:57 +01:00
$style = 'danger';
} else {
$style = 'success';
}
}
2022-04-21 11:16:16 +02:00
return div('col stats text-' . $style, [
2017-12-12 21:57:57 +01:00
$label,
div('number', [
$number,
]),
2017-12-12 21:57:57 +01:00
]);
}
2017-11-24 12:01:19 +01:00
/**
* Renders tabs from the array. Array key is tab name, array value is tab content.
2017-12-25 23:12:52 +01:00
*
2017-11-24 12:01:19 +01:00
* @param array $tabs
2017-12-25 23:12:52 +01:00
* @param int $selected The selected tab, default 0
2017-11-24 12:01:19 +01:00
* @return string HTML
*/
function tabs($tabs, $selected = 0)
2017-11-24 12:01:19 +01:00
{
$tab_header = [];
$tab_content = [];
2017-12-25 23:12:52 +01:00
foreach ($tabs as $header => $content) {
2021-07-24 00:33:55 +02:00
$active = false;
2020-11-24 01:18:05 +01:00
$id = $header;
$href = '#' . $id;
2017-12-25 23:12:52 +01:00
if (count($tab_header) == $selected) {
2021-07-24 00:33:55 +02:00
$active = true;
2017-11-24 12:01:19 +01:00
}
2020-11-24 01:18:05 +01:00
if (is_array($content)) {
$href = $content['href'];
$content = null;
$id = null;
}
2021-07-24 00:33:55 +02:00
$tab_header[] = '<li role="presentation" class="nav-item">
2022-10-18 19:15:22 +02:00
<a href="' . $href . '" class="nav-link' . ($active ? ' active' : '') . '" role="tab"'
2021-07-24 00:33:55 +02:00
. ($id ? ' id="' . $id . '-tab"' : '')
. ($id ? ' aria-controls="' . $id . '" data-bs-target="#' . $id . '" data-bs-toggle="tab" role="tab"' : '')
. ($id && $active ? ' aria-selected="true"' : ' aria-selected="false"')
2020-11-24 01:18:05 +01:00
. '>'
2017-12-25 23:12:52 +01:00
. $header . '</a></li>';
2021-07-24 00:33:55 +02:00
$tab_content[] = $content
? '<div role="tabpanel" class="tab-pane' . ($active ? ' show active' : '') . '" id="' . $id . '"'
. ' aria-labelledby="' . $id . '-tab"'
. '>'
2017-12-25 23:12:52 +01:00
. $content
2021-07-24 00:33:55 +02:00
. '</div>'
: '';
2017-11-24 12:01:19 +01:00
}
return div('', [
'<ul class="nav nav-tabs mb-3" role="tablist">' . join($tab_header) . '</ul>',
'<div class="tab-content">' . join($tab_content) . '</div>',
2017-11-24 12:01:19 +01:00
]);
}
2014-12-22 20:06:37 +01:00
/**
* Display muted (grey) text.
*
2017-01-02 03:57:23 +01:00
* @param string $text
2017-01-03 03:22:48 +01:00
* @return string
2014-12-22 20:06:37 +01:00
*/
2017-01-02 03:57:23 +01:00
function mute($text)
{
return '<span class="text-muted">' . $text . '</span>';
2014-12-22 20:06:37 +01:00
}
2016-11-14 17:58:15 +01:00
/**
* Renders a bootstrap label with given content and class.
*
2017-01-03 03:22:48 +01:00
* @param string $content The text
2022-11-09 00:02:30 +01:00
* @param string $class default, primary, info, success, warning, danger
2017-01-03 03:22:48 +01:00
* @return string
2016-11-14 17:58:15 +01:00
*/
2021-07-23 15:37:11 +02:00
function badge($content, $class = 'default')
2017-01-02 03:57:23 +01:00
{
2021-07-23 15:37:11 +02:00
return '<span class="badge rounded-pill bg-' . $class . '">' . $content . '</span>';
2016-11-14 17:58:15 +01:00
}
2017-01-03 03:22:48 +01:00
/**
* @param int $valuemin
* @param int $valuemax
* @param int $valuenow
* @param string $class
* @param string $content
* @return string
*/
2017-01-02 03:57:23 +01:00
function progress_bar($valuemin, $valuemax, $valuenow, $class = '', $content = '')
{
2017-01-03 03:22:48 +01:00
return '<div class="progress">'
. '<div class="progress-bar ' . $class . '" role="progressbar" '
. 'aria-valuenow="' . $valuenow . '" aria-valuemin="' . $valuemin . '" aria-valuemax="' . $valuemax . '" '
. 'style="width: ' . floor(($valuenow - $valuemin) * 100 / ($valuemax - $valuemin)) . '%"'
. '>'
. $content
2017-01-03 03:22:48 +01:00
. '</div>'
. '</div>';
2014-12-19 22:41:55 +01:00
}
2014-09-28 14:50:08 +02:00
/**
* Render bootstrap icon
*
* @param string $icon_name
* @param string $class
2017-01-03 03:22:48 +01:00
* @return string
2014-09-28 14:50:08 +02:00
*/
function icon(string $icon_name, string $class = ''): string
2017-01-02 03:57:23 +01:00
{
return ' <span class="bi bi-' . $icon_name . ($class ? ' ' . $class : '') . '"></span> ';
2014-09-28 14:50:08 +02:00
}
/**
* Renders a tick or a cross by given boolean
*
2017-01-02 03:57:23 +01:00
* @param boolean $boolean
2017-01-03 03:22:48 +01:00
* @return string
2014-09-28 14:50:08 +02:00
*/
function icon_bool($boolean)
2017-01-02 03:57:23 +01:00
{
2017-12-25 23:12:52 +01:00
return '<span class="text-' . ($boolean ? 'success' : 'danger') . '">'
. icon($boolean ? 'check-lg' : 'x-lg')
2017-12-25 23:12:52 +01:00
. '</span>';
2014-09-28 14:50:08 +02:00
}
2017-01-03 03:22:48 +01:00
/**
* @param string $class
* @param array $content
* @param string $dom_id
* @return string
*/
2017-01-03 14:12:17 +01:00
function div($class, $content = [], $dom_id = '')
2017-01-02 03:57:23 +01:00
{
if (is_array($content)) {
$content = join("\n", $content);
}
$dom_id = $dom_id != '' ? ' id="' . $dom_id . '"' : '';
return '<div' . $dom_id . ' class="' . $class . '">' . $content . '</div>';
2014-08-23 01:55:18 +02:00
}
2017-01-03 03:22:48 +01:00
/**
* @param string $content
* @param int $number
* @return string
*/
2017-01-02 03:57:23 +01:00
function heading($content, $number = 1)
{
2017-01-03 14:12:17 +01:00
return '<h' . $number . '>' . $content . '</h' . $number . '>';
}
2017-01-03 03:22:48 +01:00
/**
* @param string[] $items
* @return string
*/
2017-01-02 03:57:23 +01:00
function toolbar_pills($items)
{
return '<ul class="nav nav-pills">' . join("\n", $items) . '</ul>';
}
2013-10-13 00:52:44 +02:00
/**
* Render a link for a toolbar.
*
2017-01-02 03:57:23 +01:00
* @param string $href
* @param string $icon
2017-01-02 03:57:23 +01:00
* @param string $label
* @param bool $active
2013-10-13 00:52:44 +02:00
* @return string
*/
function toolbar_item_link($href, $icon, $label, $active = false)
2017-01-02 03:57:23 +01:00
{
return '<li class="nav-item">'
2023-01-22 19:16:33 +01:00
. '<a class="nav-link ' . ($active ? 'active" aria-current="page"' : '"') . ' href="' . $href . '">'
. ($icon != '' ? '<span class="bi bi-' . $icon . '"></span> ' : '')
2017-01-03 03:22:48 +01:00
. $label
. '</a>'
. '</li>';
2014-08-22 22:34:13 +02:00
}
function toolbar_dropdown_item(string $href, string $label, bool $active, string $icon = null): string
2017-01-02 03:57:23 +01:00
{
return strtr(
2023-01-22 19:16:33 +01:00
'<li><a class="dropdown-item{active}"{aria} href="{href}">{icon} {label}</a></li>',
[
'{href}' => $href,
'{icon}' => $icon === null ? '' : '<i class="bi bi-' . $icon . '"></i>',
'{label}' => $label,
2023-01-22 19:16:33 +01:00
'{active}' => $active ? ' active' : '',
'{aria}' => $active ? ' aria-current="page"' : '',
]
);
}
function toolbar_dropdown_item_divider(): string
{
return '<li><hr class="dropdown-divider"></li>';
2014-09-24 15:11:50 +02:00
}
2017-01-03 03:22:48 +01:00
/**
* @param string $label
* @param array $submenu
2023-01-22 19:16:33 +01:00
* @param bool $active
2017-01-03 03:22:48 +01:00
* @return string
*/
2023-01-22 19:16:33 +01:00
function toolbar_dropdown($label, $submenu, $active = false): string
2017-01-02 03:57:23 +01:00
{
2022-10-18 19:15:22 +02:00
$template = <<<EOT
2021-09-10 14:30:16 +02:00
<li class="nav-item dropdown">
2023-01-22 19:16:33 +01:00
<a class="nav-link dropdown-toggle{class}" href="#" role="button" data-bs-toggle="dropdown" aria-expanded="false">
{label}
2021-08-05 01:07:15 +02:00
</a>
2023-01-22 19:16:33 +01:00
<ul class="dropdown-menu">
2021-08-05 01:07:15 +02:00
{submenu}
</ul>
</li>
EOT;
return strtr(
$template,
[
2023-01-22 19:16:33 +01:00
'{class}' => $active ? ' active' : '',
'{label}' => $label,
'{submenu}' => join("\n", $submenu),
]
);
2014-08-23 02:16:12 +02:00
}
2011-12-21 22:20:06 +01:00
/**
2013-10-13 00:52:44 +02:00
* Generiert HTML Code für eine "Seite".
* Fügt dazu die übergebenen Elemente zusammen.
2017-01-03 03:22:48 +01:00
*
* @param string[] $elements
* @return string
2011-12-21 22:20:06 +01:00
*/
2017-01-02 03:57:23 +01:00
function page($elements)
{
return join($elements);
2011-12-21 22:20:06 +01:00
}
2014-08-22 22:34:13 +02:00
/**
* Generiert HTML Code für eine "Seite" mit zentraler Überschrift
* Fügt dazu die übergebenen Elemente zusammen.
2017-01-03 03:22:48 +01:00
*
* @param string $title
* @param string[] $elements
2019-12-14 10:35:42 +01:00
* @param bool $container
2017-01-03 03:22:48 +01:00
* @return string
2014-08-22 22:34:13 +02:00
*/
2019-12-14 10:35:42 +01:00
function page_with_title($title, $elements, bool $container = false)
2017-01-02 03:57:23 +01:00
{
2019-12-14 10:35:42 +01:00
if ($container) {
$html = '<div class="container">';
} else {
$html = '<div class="col-md-12">';
}
return $html . '<h1>' . $title . '</h1>' . join($elements) . '</div>';
2014-08-22 22:34:13 +02:00
}
/**
* Renders a description based on the data arrays key and values as label an description.
2017-12-25 23:12:52 +01:00
*
* @param array $data
2017-12-25 23:12:52 +01:00
* @return string
*/
2017-12-25 23:12:52 +01:00
function description($data)
{
$elements = [];
2017-12-25 23:12:52 +01:00
foreach ($data as $label => $description) {
if (!empty($label) && !empty($description)) {
$elements[] = '<dt class="col-sm-1">' . $label . '</dt><dd class="col-sm-11">' . $description . '</dd>';
}
}
return '<dl class="row">' . join($elements) . '</dl>';
}
2011-12-21 22:20:06 +01:00
/**
* Rendert eine Datentabelle
2017-01-03 03:22:48 +01:00
*
2022-11-09 00:02:30 +01:00
* @param array|string $columns
* @param array[]|ArrayAccess $rows_raw
* @param bool $data
2017-01-03 03:22:48 +01:00
* @return string
2011-12-21 22:20:06 +01:00
*/
2017-01-02 03:57:23 +01:00
function table($columns, $rows_raw, $data = true)
{
// If only one column is given
2017-01-02 15:43:36 +01:00
if (!is_array($columns)) {
$rows = [];
foreach ($rows_raw as $row) {
$rows[] = [
'col' => $row,
2017-01-02 15:43:36 +01:00
];
}
return render_table([
'col' => $columns,
2017-01-02 15:43:36 +01:00
], $rows, $data);
}
2017-01-02 03:57:23 +01:00
return render_table($columns, $rows_raw, $data);
2016-09-30 17:38:26 +02:00
}
/**
* Helper for rendering a html-table.
* use table()
2017-01-03 03:22:48 +01:00
*
* @param string[] $columns
* @param array[] $rows
* @param bool $data
* @return string
2016-09-30 17:38:26 +02:00
*/
2017-01-02 03:57:23 +01:00
function render_table($columns, $rows, $data = true)
{
if (count($rows) == 0) {
return info(__('No data found.'), true);
2017-01-02 03:57:23 +01:00
}
2017-01-02 15:43:36 +01:00
2017-01-02 03:57:23 +01:00
$html = '<table class="table table-striped' . ($data ? ' data' : '') . '">';
$html .= '<thead><tr>';
foreach ($columns as $key => $column) {
2017-01-02 03:57:23 +01:00
$html .= '<th class="column_' . $key . '">' . $column . '</th>';
}
2017-01-02 03:57:23 +01:00
$html .= '</tr></thead>';
$html .= '<tbody>';
foreach ($rows as $row) {
$html .= '<tr>';
foreach ($columns as $key => $column) {
$value = '&nbsp;';
2017-01-02 03:57:23 +01:00
if (isset($row[$key])) {
$value = $row[$key];
}
$html .= '<td class="column_' . $key . '">' . $value . '</td>';
}
$html .= '</tr>';
}
$html .= '</tbody>';
$html .= '</table>';
return $html;
2011-12-21 22:20:06 +01:00
}
/**
* Rendert einen Knopf
2017-01-03 03:22:48 +01:00
*
* @param string $href
* @param string $label
* @param string $class
2022-11-29 21:47:26 +01:00
* @param string $id
2017-01-03 03:22:48 +01:00
* @return string
2011-12-21 22:20:06 +01:00
*/
2022-11-29 21:47:26 +01:00
function button($href, $label, $class = '', $id = '')
2017-01-02 03:57:23 +01:00
{
if (!Str::contains(str_replace(['btn-sm', 'btn-xl'], '', $class), 'btn-')) {
2021-08-05 01:00:12 +02:00
$class = 'btn-secondary' . ($class ? ' ' . $class : '');
}
2022-11-29 21:47:26 +01:00
$idAttribute = $id ? 'id="' . $id . '"' : '';
return '<a ' . $idAttribute . ' href="' . $href . '" class="btn ' . $class . '">' . $label . '</a>';
2011-12-21 22:20:06 +01:00
}
/**
* Rendert einen Knopf mit JavaScript onclick Handler
*
* @param string $javascript
* @param string $label
* @param string $class
* @return string
*/
function button_js($javascript, $label, $class = '')
{
return '<a onclick="' . $javascript . '" href="#" class="btn btn-secondary ' . $class . '">' . $label . '</a>';
}
2014-12-06 17:41:16 +01:00
/**
* Renders a button with an icon
2017-01-03 03:22:48 +01:00
*
* @param string $href
* @param string $icon
2017-01-03 03:22:48 +01:00
* @param string $class
*
2017-01-03 03:22:48 +01:00
* @return string
2014-12-06 17:41:16 +01:00
*/
function button_icon($href, $icon, $class = '')
2017-01-02 03:57:23 +01:00
{
return button($href, icon($icon), $class);
2014-12-06 22:26:56 +01:00
}
2014-12-06 17:41:16 +01:00
/**
* Rendert einen Knopf, der zur Hilfe eines bestimmten Themas führt.
2019-05-31 04:03:19 +02:00
*
* @param string $topic documentation resource (like user/), is appended to documentation url.
* @return string
*/
function button_help($topic = '')
{
return button(config('documentation_url') . $topic, icon('question-circle'), 'btn-sm');
}
2011-12-21 22:20:06 +01:00
/**
* Rendert eine Toolbar mit Knöpfen
2017-01-03 03:22:48 +01:00
*
* @param array $buttons
* @return string
2011-12-21 22:20:06 +01:00
*/
2017-01-02 03:57:23 +01:00
function buttons($buttons = [])
{
2021-07-24 18:19:53 +02:00
return '<div class="mb-3">' . table_buttons($buttons) . '</div>';
2014-09-28 14:50:08 +02:00
}
2017-01-03 03:22:48 +01:00
/**
* @param array $buttons
* @return string
*/
2017-01-02 03:57:23 +01:00
function table_buttons($buttons = [])
{
return '<div class="btn-group" role="group">' . join('', $buttons) . '</div>';
2011-12-21 22:20:06 +01:00
}