Newer
Older
<?php
/**
* @copyright 2020 Podlibre
* @license https://www.gnu.org/licenses/agpl-3.0.en.html AGPL3
* @link https://castopod.org/
*/
Yassine Doghri
committed
use CodeIgniter\View\Table;
use CodeIgniter\I18n\Time;
if (!function_exists('button')) {
/**
* Button component
*
* Creates a stylized button or button like anchor tag if the URL is defined.
*
Yassine Doghri
committed
* @param array $customOptions button options: variant, size, iconLeft, iconRight
* @param array $customAttributes Additional attributes
*
* @return string
*/
function button(
string $label = '',
Yassine Doghri
committed
string $uri = '',
array $customOptions = [],
array $customAttributes = []
): string {
$defaultOptions = [
'variant' => 'default',
'size' => 'base',
'iconLeft' => null,
'iconRight' => null,
'isSquared' => false,
];
$options = array_merge($defaultOptions, $customOptions);
$baseClass =
'inline-flex items-center font-semibold shadow-xs rounded-full focus:outline-none focus:ring';
$variantClass = [
'default' => 'text-black bg-gray-300 hover:bg-gray-400',
'primary' => 'text-white bg-pine-700 hover:bg-pine-800',
'secondary' => 'text-white bg-gray-700 hover:bg-gray-800',
'accent' => 'text-white bg-rose-600 hover:bg-rose-800',
'success' => 'text-white bg-green-600 hover:bg-green-700',
'danger' => 'text-white bg-red-600 hover:bg-red-700',
'warning' => 'text-black bg-yellow-500 hover:bg-yellow-600',
'info' => 'text-white bg-blue-500 hover:bg-blue-600',
];
$sizeClass = [
'small' => 'text-xs md:text-sm',
'base' => 'text-sm md:text-base',
'large' => 'text-lg md:text-xl',
];
$basePaddings = [
'small' => 'px-2 md:px-3 md:py-1',
'base' => 'px-3 py-1 md:px-4 md:py-2',
'large' => 'px-3 py-2 md:px-5',
];
$squaredPaddings = [
'small' => 'p-1',
'base' => 'p-2',
'large' => 'p-3',
];
$buttonClass =
$baseClass .
' ' .
($options['isSquared']
? $squaredPaddings[$options['size']]
: $basePaddings[$options['size']]) .
' ' .
$sizeClass[$options['size']] .
' ' .
$variantClass[$options['variant']];
if (!empty($customAttributes['class'])) {
$buttonClass .= ' ' . $customAttributes['class'];
unset($customAttributes['class']);
}
if ($options['iconLeft']) {
$label = icon($options['iconLeft'], 'mr-2') . $label;
}
if ($options['iconRight']) {
$label .= icon($options['iconRight'], 'ml-2');
}
Yassine Doghri
committed
if ($uri !== '') {
return anchor(
$uri,
$label,
array_merge(
[
'class' => $buttonClass,
],
$customAttributes,
),
);
}
$defaultButtonAttributes = [
'type' => 'button',
];
$attributes = stringify_attributes(
array_merge($defaultButtonAttributes, $customAttributes),
);
return <<<HTML
Yassine Doghri
committed
<button class="{$buttonClass}" {$attributes}>
{$label}
</button>
HTML;
}
}
// ------------------------------------------------------------------------
if (!function_exists('icon_button')) {
/**
* Icon Button component
*
* Abstracts the `button()` helper to create a stylized icon button
*
Yassine Doghri
committed
* @param string $label The button label
* @param string $uri URI string or array of URI segments
* @param array $customOptions button options: variant, size, iconLeft, iconRight
* @param array $customAttributes Additional attributes
*
* @return string
*/
function icon_button(
string $icon,
string $title,
Yassine Doghri
committed
string $uri = '',
array $customOptions = [],
array $customAttributes = []
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
): string {
$defaultOptions = [
'isSquared' => true,
];
$options = array_merge($defaultOptions, $customOptions);
$defaultAttributes = [
'title' => $title,
'data-toggle' => 'tooltip',
'data-placement' => 'bottom',
];
$attributes = array_merge($defaultAttributes, $customAttributes);
return button(icon($icon), $uri, $options, $attributes);
}
}
// ------------------------------------------------------------------------
if (!function_exists('hint_tooltip')) {
/**
* Hint component
*
* Used to produce tooltip with a question mark icon for hint texts
*
* @param string $hintText The hint text
*
* @return string
*/
function hint_tooltip(string $hintText = '', string $class = ''): string
{
$tooltip =
'<span data-toggle="tooltip" data-placement="bottom" tabindex="0" title="' .
$hintText .
'" class="inline-block text-gray-500 align-middle outline-none focus:ring';
if ($class !== '') {
$tooltip .= ' ' . $class;
}
return $tooltip . '">' . icon('question') . '</span>';
}
}
// ------------------------------------------------------------------------
if (!function_exists('data_table')) {
/**
* Data table component
*
* Creates a stylized table.
*
* @param array $columns array of associate arrays with `header` and `cell` keys where `cell` is a function with a row of $data as parameter
* @param array $data data to loop through and display in rows
* @param array ...$rest Any other argument to pass to the `cell` function
*
* @return string
*/
Yassine Doghri
committed
function data_table(array $columns, array $data = [], ...$rest): string
Yassine Doghri
committed
$table = new Table();
$template = [
'table_open' => '<table class="w-full whitespace-no-wrap">',
'thead_open' =>
'<thead class="text-xs font-semibold text-left text-gray-500 uppercase border-b">',
'heading_cell_start' => '<th class="px-4 py-2">',
'cell_start' => '<td class="px-4 py-2">',
'cell_alt_start' => '<td class="px-4 py-2">',
'row_start' => '<tr class="bg-gray-100 hover:bg-pine-100">',
'row_alt_start' => '<tr class="hover:bg-pine-100">',
];
$table->setTemplate($template);
$tableHeaders = [];
foreach ($columns as $column) {
Yassine Doghri
committed
$tableHeaders[] = $column['header'];
}
$table->setHeading($tableHeaders);
Yassine Doghri
committed
if (($dataCount = count($data)) !== 0) {
for ($i = 0; $i < $dataCount; ++$i) {
$row = $data[$i];
$rowData = [];
foreach ($columns as $column) {
Yassine Doghri
committed
$rowData[] = $column['cell']($row, ...$rest);
}
$table->addRow($rowData);
}
} else {
return lang('Common.no_data');
}
return '<div class="overflow-x-auto bg-white rounded-lg shadow" >' .
$table->generate() .
'</div>';
}
}
// ------------------------------------------------------------------------
Yassine Doghri
committed
if (!function_exists('publication_pill')) {
/**
Yassine Doghri
committed
* Publication pill component
Yassine Doghri
committed
*
Yassine Doghri
committed
* Shows the stylized publication datetime in regards to current datetime.
Yassine Doghri
committed
*
Yassine Doghri
committed
* @param Time $publicationDate publication datetime of the episode
Yassine Doghri
committed
* @param boolean $isPublished whether or not the episode has been published
* @param string $customClass css class to add to the component
*
* @return string
*/
function publication_pill(
Yassine Doghri
committed
?Time $publicationDate,
Yassine Doghri
committed
$publicationStatus,
Yassine Doghri
committed
string $customClass = ''
Yassine Doghri
committed
): string {
Yassine Doghri
committed
if ($publicationDate === null) {
return '';
}
Yassine Doghri
committed
$class =
$publicationStatus === 'published'
? 'text-pine-500 border-pine-500'
: 'text-red-600 border-red-600';
Yassine Doghri
committed
Yassine Doghri
committed
$langOptions = [
'<time pubdate datetime="' .
$publicationDate->format(DateTime::ATOM) .
'" title="' .
$publicationDate .
'">' .
lang('Common.mediumDate', [$publicationDate]) .
'</time>',
];
Yassine Doghri
committed
$label = lang(
'Episode.publication_status.' . $publicationStatus,
Yassine Doghri
committed
$langOptions,
Yassine Doghri
committed
);
return '<span class="px-1 font-semibold border ' .
Yassine Doghri
committed
$class .
' ' .
$customClass .
'">' .
$label .
'</span>';
}
}
Yassine Doghri
committed
// ------------------------------------------------------------------------
if (!function_exists('publication_button')) {
/**
* Publication button component
*
* Displays the appropriate publication button depending on the publication status.
*
* @param boolean $publicationStatus the episode's publication status *
* @return string
*/
function publication_button(
Yassine Doghri
committed
int $podcastId,
int $episodeId,
bool $publicationStatus
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
): string {
switch ($publicationStatus) {
case 'not_published':
$label = lang('Episode.publish');
$route = route_to('episode-publish', $podcastId, $episodeId);
$variant = 'primary';
$iconLeft = 'upload-cloud';
break;
case 'scheduled':
$label = lang('Episode.publish_edit');
$route = route_to(
'episode-publish_edit',
$podcastId,
$episodeId,
);
$variant = 'accent';
$iconLeft = 'upload-cloud';
break;
case 'published':
$label = lang('Episode.unpublish');
$route = route_to('episode-unpublish', $podcastId, $episodeId);
$variant = 'danger';
$iconLeft = 'cloud-off';
break;
}
return button($label, $route, [
'variant' => $variant,
'iconLeft' => $iconLeft,
]);
}
}
// ------------------------------------------------------------------------
Yassine Doghri
committed
if (!function_exists('episode_numbering')) {
/**
* Returns relevant translated episode numbering.
*
* @param string $class styling classes
* @param string $is_abbr component will show abbreviated numbering if true
*
Yassine Doghri
committed
*/
function episode_numbering(
Yassine Doghri
committed
?int $episodeNumber = null,
?int $seasonNumber = null,
string $class = '',
Yassine Doghri
committed
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
$isAbbr = false
): string {
if (!$episodeNumber && !$seasonNumber) {
return '';
}
$transKey = '';
$args = [];
if ($episodeNumber && $seasonNumber) {
$transKey = 'Episode.season_episode';
$args = [
'seasonNumber' => $seasonNumber,
'episodeNumber' => $episodeNumber,
];
} elseif ($episodeNumber && !$seasonNumber) {
$transKey = 'Episode.number';
$args = [
'episodeNumber' => $episodeNumber,
];
} elseif (!$episodeNumber && $seasonNumber) {
$transKey = 'Episode.season';
$args = [
'seasonNumber' => $seasonNumber,
];
}
if ($isAbbr) {
return '<abbr class="' .
$class .
'" title="' .
lang($transKey, $args) .
'">' .
lang($transKey . '_abbr', $args) .
'</abbr>';
}
return '<span class="' .
$class .
'">' .
lang($transKey, $args) .
'</span>';
}
}
if (!function_exists('location_link')) {
/**
* Returns link to display from location info
*/
function location_link(
Yassine Doghri
committed
?string $locationName,
?string $locationGeo,
?string $locationOsmid,
Yassine Doghri
committed
): string {
if (empty($locationName)) {
return '';
Yassine Doghri
committed
return anchor(
location_url($locationName, $locationGeo, $locationOsmid),
icon('map-pin', 'mr-2') . $locationName,
[
'class' =>
'inline-flex items-baseline hover:underline' .
(empty($class) ? '' : " {$class}"),
'target' => '_blank',
'rel' => 'noreferrer noopener',
],
);
Yassine Doghri
committed
// ------------------------------------------------------------------------