-
+
Bootstrap Icons class name.
diff --git a/application/modules/menus/config/permissions.php b/application/modules/menus/config/permissions.php
new file mode 100644
index 0000000..cf5a236
--- /dev/null
+++ b/application/modules/menus/config/permissions.php
@@ -0,0 +1,23 @@
+ Menus edits the admin sidebar. The built-in items in
+| application/config/menu.php are always shown; these permissions only
+| decide who may change the menu.
+*/
+
+$config['permissions']['menus'] = [
+ 'label' => 'Menu builder',
+ 'icon' => 'bi-list',
+ 'permissions' => [
+ 'view' => 'See the menu builder',
+ 'create' => 'Add menu items',
+ 'edit' => 'Edit and reorder menu items',
+ 'delete' => 'Delete menu items',
+ ],
+];
diff --git a/application/modules/menus/controllers/Menu_builder.php b/application/modules/menus/controllers/Menu_builder.php
new file mode 100644
index 0000000..8fb017c
--- /dev/null
+++ b/application/modules/menus/controllers/Menu_builder.php
@@ -0,0 +1,270 @@
+ Menus: build the admin sidebar without touching menu.php.
+ *
+ * Routes (application/config/routes.php):
+ * GET /admin/menus menus.view the tree, drag to reorder
+ * GET|POST /admin/menus/create menus.create
+ * GET|POST /admin/menus/edit/{id} menus.edit
+ * POST /admin/menus/delete/{id} menus.delete
+ * POST /admin/menus/reorder menus.edit new order (JSON)
+ *
+ * The items in application/config/menu.php stay; what is built here is merged
+ * into the sidebar by menu_items() (application/helpers/theme_helper.php).
+ * A section row is a heading, a link row is an entry (links may be nested
+ * one level, depth 2 in the builder).
+ *
+ * @property Template $template
+ * @property Menu_model $menu_model
+ * @property Audit $audit
+ * @property Rbac $rbac
+ * @property CI_Input $input
+ * @property CI_Output $output
+ * @property CI_Form_validation $form_validation
+ */
+class Menu_builder extends MX_Controller
+{
+ public function __construct()
+ {
+ parent::__construct();
+ require_login();
+ $this->load->helper('form');
+ $this->load->model('menus/menu_model', 'menu_model');
+ }
+
+ public function index()
+ {
+ require_permission('menus.view');
+
+ $this->template
+ ->set_title('Menu builder')
+ ->set_subtitle('Drag an item onto another to nest it. Changes appear in the sidebar straight away.')
+ ->set_breadcrumbs(['Home' => '', 'Menu builder' => null])
+ ->add_foot('')
+ ->render('index', [
+ 'items' => $this->menu_model->all(),
+ 'available' => $this->menu_model->available(),
+ 'can_create' => can('menus.create'),
+ 'can_edit' => can('menus.edit'),
+ 'can_delete' => can('menus.delete'),
+ 'csrf_name' => $this->security->get_csrf_token_name(),
+ 'csrf_hash' => $this->security->get_csrf_hash(),
+ ], 'admin');
+ }
+
+ public function create()
+ {
+ require_permission('menus.create');
+
+ if ($this->input->method() === 'post') {
+ $this->save(null);
+
+ return;
+ }
+
+ $this->form(null, $this->menu_model->defaults(), []);
+ }
+
+ public function edit($id = 0)
+ {
+ require_permission('menus.edit');
+
+ $item = $this->menu_model->find((int) $id);
+ if (!$item) {
+ show_404();
+ }
+
+ if ($this->input->method() === 'post') {
+ $this->save($item);
+
+ return;
+ }
+
+ $this->form($item, $item, []);
+ }
+
+ public function delete($id = 0)
+ {
+ if ($this->input->method() !== 'post') {
+ show_404();
+ }
+ require_permission('menus.delete');
+
+ $item = $this->menu_model->find((int) $id);
+ if (!$item) {
+ show_404();
+ }
+
+ if ($this->menu_model->delete((int) $id)) {
+ $this->audit->deleted('menus', $item['id'], $item['label'], $item);
+ flash('success', 'Menu item deleted. Its children moved up one level.');
+ } else {
+ flash('error', 'The menu could not be changed. Run the migrations first: php index.php console migrate');
+ }
+
+ redirect('admin/menus');
+ }
+
+ /**
+ * The order the builder dropped things into: [[id, depth], ...].
+ */
+ public function reorder()
+ {
+ if ($this->input->method() !== 'post') {
+ $this->json(['ok' => false, 'message' => 'POST only.'], 405);
+
+ return;
+ }
+ require_permission('menus.edit');
+
+ $raw = json_decode((string) $this->input->post('order'), true);
+ $order = [];
+ foreach ((array) $raw as $pair) {
+ if (is_array($pair) && isset($pair[0], $pair[1])) {
+ $order[] = [(int) $pair[0], (int) $pair[1]];
+ }
+ }
+
+ $ok = $this->menu_model->reorder($order);
+ if ($ok) {
+ $this->audit->event('reorder', 'menus', null, 'Sidebar menu', ['order' => implode(',', array_map(static function ($p) {
+ return $p[0].':'.$p[1];
+ }, $order))]);
+ }
+
+ $this->json(['ok' => $ok, 'message' => $ok ? 'Menu saved.' : 'The order could not be saved.'], $ok ? 200 : 500);
+ }
+
+ /**
+ * @param array'.$e($errors[$key]).'
' : ''; };
+$type = (string) ($values['type'] ?? 'link');
+?>
+
+
diff --git a/application/modules/menus/views/index.php b/application/modules/menus/views/index.php
new file mode 100644
index 0000000..3b6b5c3
--- /dev/null
+++ b/application/modules/menus/views/index.php
@@ -0,0 +1,69 @@
+ Menus: the tree, dragged into shape with assets/js/menus.js.
+ *
+ * @var array
+
+
+
+
+
+
+
+
+
+
+
+
+
+ To fill a dropdown, add links and choose the dropdown under "Inside". A link that has items inside it also opens them, and then its own address is not used.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Relative URLs stay on this site;
+ page/your-slug opens a page made in Admin → Pages.
+
+
+
+ Press Choose to pick from all Bootstrap Icons, or type a class such as
+ bi-star.
+
+
+
+
+
+
+
+ Up to three levels deep. A heading (section) is always top level.
+
+
+
+
+
+
+
+
+
+
+
+ >
+
+
+
+
+
+ >
+
+
+
+
+ Cancel
+
+
+
+ The menu table does not exist yet. Run
+
+
+
+ php index.php console migrate to build it — the menu below is the file-based one.
+
+
+
+
+Items from application/config/menu.php are always shown; these are added on top.
+
+
+
diff --git a/application/modules/pages/config/permissions.php b/application/modules/pages/config/permissions.php
new file mode 100644
index 0000000..0075871
--- /dev/null
+++ b/application/modules/pages/config/permissions.php
@@ -0,0 +1,22 @@
+ Pages builds the content pages served at /page/{slug}.
+*/
+
+$config['permissions']['pages'] = [
+ 'label' => 'Page builder',
+ 'icon' => 'bi-file-earmark-richtext',
+ 'permissions' => [
+ 'view' => 'See the list of pages',
+ 'create' => 'Create pages',
+ 'edit' => 'Edit pages and their layout',
+ 'delete' => 'Delete pages',
+ 'html' => 'Write raw HTML in pages (can run scripts for every visitor: give it only to people you trust as much as a developer)',
+ ],
+];
diff --git a/application/modules/pages/controllers/Pages.php b/application/modules/pages/controllers/Pages.php
new file mode 100644
index 0000000..6e03690
--- /dev/null
+++ b/application/modules/pages/controllers/Pages.php
@@ -0,0 +1,341 @@
+ Pages builds them, /page/{slug} serves them.
+ *
+ * Routes (application/config/routes.php):
+ * GET /admin/pages pages.view the list (server-side DataTable)
+ * GET /admin/pages/data pages.view its JSON rows
+ * GET|POST /admin/pages/create pages.create
+ * GET|POST /admin/pages/edit/{id} pages.edit
+ * POST /admin/pages/delete/{id} pages.delete
+ * GET /page/{slug} public published pages (a draft
+ * is a preview for editors)
+ *
+ * A page is a list of sections (hero, text, features, cta, image, html) stored
+ * as JSON; see App\Page\SectionTypes for the blocks and their rendering.
+ *
+ * Who may write what: pages.create / pages.edit build pages out of the safe blocks
+ * (text is escaped or rebuilt from an allow-list, addresses must pass Links::safe()).
+ * The raw "Custom HTML" block can run anything in a visitor's browser, so adding or
+ * changing one needs pages.html, which only super_admin has until it is granted.
+ *
+ * @property Template $template
+ * @property Page_model $page_model
+ * @property Audit $audit
+ * @property Datatable $datatable
+ * @property CI_Input $input
+ * @property CI_Output $output
+ */
+class Pages extends MX_Controller
+{
+ public function __construct()
+ {
+ parent::__construct();
+ $this->load->helper('form');
+ $this->load->model('pages/page_model', 'page_model');
+ }
+
+ // ------------------------------------------------------------------ Admin
+
+ public function index()
+ {
+ require_permission('pages.view');
+
+ $this->template
+ ->set_title('Pages')
+ ->set_subtitle('Pages built here are served at /page/{address}. A draft is only visible to editors.')
+ ->set_breadcrumbs(['Home' => '', 'Pages' => null])
+ ->render('index', [
+ 'available' => $this->page_model->available(),
+ 'can_create' => can('pages.create'),
+ ], 'admin');
+ }
+
+ /**
+ * JSON rows for the list. Only the page being shown is read (never the whole table).
+ */
+ public function data()
+ {
+ require_permission('pages.view');
+
+ $canEdit = can('pages.edit');
+ $canDelete = can('pages.delete');
+ $e = static function ($v) {
+ return htmlspecialchars((string) $v, ENT_QUOTES, 'UTF-8');
+ };
+
+ $this->datatable
+ ->from(static function ($db) {
+ $db->from('pages p');
+ })
+ ->select('p.id, p.title, p.slug, p.status, p.meta_description, p.updated_at, p.sections')
+ ->column('title', 'p.title')
+ ->column('slug', 'p.slug')
+ ->column('sections', null)
+ ->column('status', 'p.status')
+ ->column('updated', 'p.updated_at', false)
+ ->column('actions', null)
+ ->default_order(['p.updated_at DESC', 'p.id DESC'])
+ ->respond(function ($r) use ($canEdit, $canDelete, $e) {
+ $actions = '';
+ if ($canEdit) {
+ $actions .= ' ';
+ }
+ if ($canDelete) {
+ $actions .= ' '.form_open('admin/pages/delete/'.(int) $r['id'], ['class' => 'd-inline', 'data-confirm' => 'Delete the page "'.$r['title'].'"?'])
+ .''.form_close();
+ }
+
+ return [
+ 'title' => ''.$e($r['title']).''
+ .(trim((string) $r['meta_description']) !== '' ? '
+
+
+No menu items yet
+ + + + +'.$e($r['meta_description']).'
' : ''),
+ 'slug' => '/page/'.$e($r['slug']).'',
+ 'sections' => (string) count(SectionTypes::toArray($r['sections'] ?? '')),
+ 'status' => $r['status'] === Page_model::STATUS_PUBLISHED ? 'published' : 'draft',
+ 'updated' => $r['updated_at'] ? ''.$e(date('M j, Y H:i', strtotime($r['updated_at']))).'' : '',
+ 'actions' => $actions,
+ ];
+ });
+ }
+
+ public function create()
+ {
+ require_permission('pages.create');
+
+ if ($this->input->method() === 'post') {
+ $this->save(null);
+
+ return;
+ }
+
+ $this->form(null, ['title' => '', 'slug' => '', 'status' => Page_model::STATUS_DRAFT, 'meta_description' => '', 'sections' => []], []);
+ }
+
+ public function edit($id = 0)
+ {
+ require_permission('pages.edit');
+
+ $page = $this->page_model->find((int) $id);
+ if (!$page) {
+ show_404();
+ }
+
+ if ($this->input->method() === 'post') {
+ $this->save($page);
+
+ return;
+ }
+
+ $this->form($page, $page, []);
+ }
+
+ public function delete($id = 0)
+ {
+ if ($this->input->method() !== 'post') {
+ show_404();
+ }
+ require_permission('pages.delete');
+
+ $page = $this->page_model->find((int) $id);
+ if (!$page) {
+ show_404();
+ }
+
+ if ($this->page_model->delete((int) $id)) {
+ $this->audit->deleted('pages', $page['id'], $page['title'], $page);
+ flash('success', 'Page deleted.');
+ } else {
+ flash('error', 'The page could not be deleted. Run the migrations first: php index.php console migrate');
+ }
+
+ redirect('admin/pages');
+ }
+
+ // ----------------------------------------------------------------- Public
+
+ /**
+ * GET /page/{slug} — published pages for everyone; a draft is a preview
+ * for whoever may edit pages.
+ */
+ public function view($slug = '')
+ {
+ $page = $this->page_model->find_by_slug($slug, true);
+
+ if ($page === null) {
+ // Not published: editors may preview it, everyone else gets a 404.
+ $preview = is_logged_in() && can('pages.edit') ? $this->page_model->find_by_slug($slug, false) : null;
+ if ($preview === null) {
+ show_404();
+
+ return;
+ }
+ $page = $preview;
+ $preview_note = true;
+ } else {
+ $preview_note = false;
+ }
+
+ if (!empty($preview_note)) {
+ $this->output->set_header('Cache-Control: private, no-store');
+ }
+
+ $description = trim((string) ($page['meta_description'] ?? ''));
+ if ($description !== '') {
+ $this->template->add_head('');
+ }
+
+ $this->template
+ ->set_title($page['title'])
+ ->set_breadcrumbs(['Home' => '', $page['title'] => null])
+ ->render('view', [
+ 'page' => $page,
+ 'content' => SectionTypes::renderAll($page['sections'], static function ($address) {
+ return Links::resolve($address, 'site_url');
+ }),
+ 'preview' => !empty($preview_note),
+ 'edit_url' => can('pages.edit') ? site_url('admin/pages/edit/'.(int) $page['id']) : null,
+ ], 'public');
+ }
+
+ // ------------------------------------------------------------- Form & save
+
+ /**
+ * @param array'.$e($errors[$key]).'
' : ''; };
+
+/** One setting as a form field. */
+$field = static function (array $f, $index, $value, $e) {
+ $name = 'sections['.(int) $index.'][settings]['.$f['name'].']';
+ $help = !empty($f['help']) ? ''.$e($f['help']).'
' : '';
+ $label = '';
+
+ if ($f['type'] === 'textarea') {
+ $rows = (int) ($f['rows'] ?? 4);
+
+ return ''.$label
+ .''.$help.'
';
+ }
+ if ($f['type'] === 'color') {
+ $v = preg_match('/^#[0-9a-fA-F]{3,8}$/', (string) $value) ? (string) $value : '';
+
+ return ''.$label
+ .''.$help.'
';
+ }
+
+ return ''.$label
+ .''.$help.'
';
+};
+
+$section_card = static function ($index, $type, array $settings, $labels, $fields, $field, $e) {
+ $out = '';
+ $out .= '
';
+
+ return $out;
+};
+?>
+
+ ';
+ $out .= '';
+ $out .= ''.$e(isset($labels[$type]) ? $labels[$type] : $type).'';
+ $out .= '';
+ $out .= '';
+ $out .= '';
+ $out .= '';
+ $out .= '';
+ $out .= '
';
+ foreach ($fields[$type] ?? [] as $f) {
+ $out .= $field($f, $index, (string) ($settings[$f['name']] ?? ''), $e);
+ }
+ $out .= '
Please fix the following:
+
+
+
+ 'page-form']) ?>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ /page/
+
+
+
+ Leave empty to build one from the title.
+
+
+
+
+
+ Shown by Google below the link. Optional.
+
+
+
+
+
+
+
diff --git a/application/modules/pages/views/index.php b/application/modules/pages/views/index.php
new file mode 100644
index 0000000..5ebb658
--- /dev/null
+++ b/application/modules/pages/views/index.php
@@ -0,0 +1,33 @@
+ Pages: the list (a server-side DataTable, see Pages::data()).
+ *
+ * @var bool $available the pages table exists (migrations run)
+ * @var bool $can_create
+ */
+$columns = [
+ ['Title', ['priority' => 1]],
+ ['Address', ['priority' => 3]],
+ ['Sections', ['priority' => 5, 'orderable' => false, 'class' => 'text-center']],
+ ['Status', ['priority' => 2]],
+ ['Updated', ['priority' => 4, 'orderable' => true]],
+ ['', ['priority' => 1, 'orderable' => false, 'class' => 'text-end text-nowrap']],
+];
+?>
+
+
+ Layout
+ Sections run top to bottom.
+
+
+
+
+
+
+
+
+
+ $section) {
+ echo $section_card($i, (string) ($section['type'] ?? ''), (array) ($section['settings'] ?? []), $catalog['labels'], $catalog['fields'], $field, $e);
+ }
+ ?>
+
+ > + No sections yet — pick a type above and press “Add section”. +
+ +
+ The pages table does not exist yet. Run
+
+
+php index.php console migrate to build it.
+
+
+
+Every page lives at /page/{address} and can be linked from Admin → Menu builder.
+
diff --git a/application/modules/pages/views/view.php b/application/modules/pages/views/view.php
new file mode 100644
index 0000000..3711c23
--- /dev/null
+++ b/application/modules/pages/views/view.php
@@ -0,0 +1,24 @@
+ $page
+ * @var string $content SectionTypes::renderAll()
+ * @var bool $preview a draft being previewed by an editor
+ * @var string|null $edit_url
+ */
+$e = static function ($v) { return htmlspecialchars((string) $v, ENT_QUOTES, 'UTF-8'); };
+?>
+
+
+ [4, 'desc'], 'empty' => 'No pages yet.']) ?>
+
+
+ Draft preview — only editors can see this.
+ Edit this page
+
+
+
+
+
+
+
+
+ This page has no sections yet.
+ diff --git a/application/src/Menus/MenuTree.php b/application/src/Menus/MenuTree.php new file mode 100644 index 0000000..284fed0 --- /dev/null +++ b/application/src/Menus/MenuTree.php @@ -0,0 +1,134 @@ + $order posted as [id, depth] + * @param array'.$html.'
', LIBXML_NONET | LIBXML_NOWARNING | LIBXML_NOERROR);
+ libxml_clear_errors();
+ libxml_use_internal_errors($previous);
+
+ $root = $doc->getElementById('root');
+ if (!$root instanceof DOMElement) {
+ return htmlspecialchars(strip_tags($html), ENT_QUOTES, 'UTF-8');
+ }
+
+ $href = $href ?: [Links::class, 'safe'];
+ self::clean($root, $href);
+
+ $out = '';
+ foreach (iterator_to_array($root->childNodes) as $child) {
+ $out .= $doc->saveHTML($child);
+ }
+
+ return trim($out);
+ }
+
+ /**
+ * @param callable(string): ?string $href
+ */
+ private static function clean(DOMNode $parent, $href)
+ {
+ foreach (iterator_to_array($parent->childNodes) as $node) {
+ if ($node->nodeType === XML_TEXT_NODE) {
+ continue;
+ }
+
+ if (!$node instanceof DOMElement) {
+ $parent->removeChild($node); // comments, processing instructions, CDATA...
+
+ continue;
+ }
+
+ $name = strtolower($node->nodeName);
+
+ if (in_array($name, self::DROP_WITH_CONTENT, true)) {
+ $parent->removeChild($node);
+
+ continue;
+ }
+
+ self::clean($node, $href);
+
+ if (!in_array($name, self::KEEP, true)) {
+ // Unknown element: keep what is inside it, lose the element.
+ while ($node->firstChild) {
+ $parent->insertBefore($node->firstChild, $node);
+ }
+ $parent->removeChild($node);
+
+ continue;
+ }
+
+ $wanted = null;
+ if ($name === 'a' && $node->hasAttribute('href')) {
+ $wanted = $href(html_entity_decode($node->getAttribute('href'), ENT_QUOTES, 'UTF-8'));
+ }
+
+ foreach (iterator_to_array($node->attributes) as $attribute) {
+ $node->removeAttribute($attribute->nodeName);
+ }
+
+ if ($name === 'a' && is_string($wanted) && $wanted !== '') {
+ $node->setAttribute('href', $wanted);
+ $node->setAttribute('rel', 'noopener noreferrer');
+ }
+ }
+ }
+}
diff --git a/application/src/Page/Links.php b/application/src/Page/Links.php
new file mode 100644
index 0000000..4eb1251
--- /dev/null
+++ b/application/src/Page/Links.php
@@ -0,0 +1,85 @@
+ 2000) {
+ return null;
+ }
+ // Whitespace or control characters inside an address are how filters get fooled
+ // (browsers ignore tabs and newlines in "java\tscript:"), and a backslash is read as a slash.
+ if (preg_match('/[\x00-\x20\x7f\\\\]/', $url)) {
+ return null;
+ }
+ // "//host/path" would leave this site without saying so.
+ if (strpos($url, '//') === 0) {
+ return null;
+ }
+
+ if (preg_match('/^([a-z][a-z0-9+.\-]*):/i', $url, $m)) {
+ if (!in_array(strtolower($m[1]), self::SCHEMES, true)) {
+ return null;
+ }
+ if (in_array(strtolower($m[1]), ['http', 'https'], true)) {
+ $host = parse_url($url, PHP_URL_HOST);
+ if (!is_string($host) || $host === '') {
+ return null;
+ }
+ }
+
+ return $url;
+ }
+
+ return $url;
+ }
+
+ /**
+ * Whether a (safe) address already says where it goes, as opposed to a page of this site.
+ */
+ public static function isAbsolute($url)
+ {
+ return (bool) preg_match('/^(https?|mailto|tel):/i', (string) $url);
+ }
+
+ /**
+ * The address to put in the page: absolute ones as they are, pages of this site through $site
+ * (normally site_url).
+ *
+ * @param callable(string): string $site
+ *
+ * @return string|null null when the address must not be used
+ */
+ public static function resolve($url, callable $site)
+ {
+ $safe = self::safe($url);
+ if ($safe === null) {
+ return null;
+ }
+ if (self::isAbsolute($safe)) {
+ return $safe;
+ }
+
+ return $safe[0] === '#' ? $safe : $site(ltrim($safe, '/'));
+ }
+}
diff --git a/application/src/Page/SectionTypes.php b/application/src/Page/SectionTypes.php
new file mode 100644
index 0000000..e536cfc
--- /dev/null
+++ b/application/src/Page/SectionTypes.php
@@ -0,0 +1,320 @@
+ Pages), as pure PHP: which types
+ * exist, what each one asks for, how a stored layout is cleaned up, and how it
+ * is rendered on the public page. Unit-tested in tests-app/Unit/PageSectionsTest.php.
+ *
+ * A page's `sections` column holds a JSON list:
+ *
+ * [{"type": "hero", "settings": {"heading": "Hello", ...}}, ...]
+ *
+ * Everything except the "html" block type escapes its values, so a layout
+ * authored in the admin cannot inject markup into the public page by accident:
+ * text is escaped, the body of a text block is rebuilt from an allow-list (Html),
+ * and every link or image address must pass Links::safe(). The "html" block is
+ * raw on purpose and is only for people with the `pages.html` permission.
+ */
+final class SectionTypes
+{
+ public const HERO = 'hero';
+ public const TEXT = 'text';
+ public const FEATURES = 'features';
+ public const CTA = 'cta';
+ public const IMAGE = 'image';
+ public const HTML = 'html';
+
+ /** Most blocks a page may hold (keeps one page inside a TEXT column). */
+ public const MAX_SECTIONS = 40;
+
+ /** Longest single setting value; longer text is cut by normalize(). */
+ public const MAX_VALUE = 20000;
+
+ /**
+ * @return array'
+ .(!empty($s['heading']) ? '
'.self::text($s['heading']).'
' : '') + .(!empty($s['subheading']) ? ''.nl2br(self::text($s['subheading'])).'
' : '') + .self::button($s, 'btn btn-primary', $url) + .''
+ .(!empty($s['heading']) ? '
'.self::text($s['heading']).'
' : '') + .(!empty($s['body']) ? ''.self::body($s['body'], $url).'
' : '')
+ .''
+ .(!empty($s['heading']) ? '
'.self::text($s['heading']).'
' : ''); + if ($items !== []) { + $html .= '';
+ foreach ($items as [$title, $text]) {
+ $html .= '';
+ }
+ $html .= '
';
+ }
+ return $html.''
+ .'
'.self::text($title).'
' + .($text !== '' ? ''.self::text($text).'
' : '') + .''
+ .(!empty($s['heading']) ? '
'.self::text($s['heading']).'
' : '') + .(!empty($s['text']) ? ''.self::text($s['text']).'
' : '') + .self::button($s, 'btn btn-light', $url) + .''
+ .(!empty($s['caption']) ? ''.$img.''.self::text($s['caption']).' ' : $img)
+ .'
", $html) ?? $html; + + return '
'.trim($html).'
'; + } + + private static function button(array $s, $class, $url) + { + if (empty($s['button_label']) || empty($s['button_url'])) { + return ''; + } + $href = $url((string) $s['button_url']); + if ($href === null || $href === '') { + return ''; + } + + return ''.self::text($s['button_label']).''; + } + + /** "Title | description" lines as pairs. */ + private static function pairs($text) + { + $out = []; + foreach (preg_split('/\R/', (string) $text) ?: [] as $line) { + $line = trim($line); + if ($line === '') { + continue; + } + $parts = array_map('trim', explode('|', $line, 2)); + $out[] = [$parts[0], $parts[1] ?? '']; + } + + return $out; + } + + private static function background($color, $fallback = '') + { + $color = (string) $color; + if (!preg_match('/^#[0-9a-fA-F]{3,8}$/', $color)) { + return $fallback !== '' ? 'background:'.$fallback : ''; + } + + return 'background:'.$color; + } + + private static function cut($value) + { + return mb_strlen($value) > self::MAX_VALUE ? mb_substr($value, 0, self::MAX_VALUE) : $value; + } +} diff --git a/application/views/layouts/admin.php b/application/views/layouts/admin.php index d70fea6..72a49f5 100644 --- a/application/views/layouts/admin.php +++ b/application/views/layouts/admin.php @@ -29,7 +29,9 @@ continue; } - echo '';
+ document.body.appendChild(modalEl);
+ modal = new bootstrap.Modal(modalEl);
+ searchEl = modalEl.querySelector('input[type=search]');
+ gridEl = modalEl.querySelector('.icon-grid');
+ countEl = modalEl.querySelector('.icon-count');
+ statusEl = modalEl.querySelector('.icon-status');
+
+ var timer = null;
+ searchEl.addEventListener('input', function () { clearTimeout(timer); timer = setTimeout(filter, 120); });
+ gridEl.addEventListener('scroll', function () {
+ if (shown < matches.length && gridEl.scrollTop + gridEl.clientHeight > gridEl.scrollHeight - 200) { draw(false); }
+ });
+ gridEl.addEventListener('click', function (e) {
+ var b = e.target.closest('.icon-pick');
+ if (b) { choose('bi-' + b.getAttribute('data-name')); }
+ });
+ modalEl.querySelector('.icon-clear').addEventListener('click', function () { choose(''); });
+ modalEl.addEventListener('shown.bs.modal', function () { searchEl.focus(); });
+ }
+
+ function choose(value) {
+ if (target) {
+ target.value = value;
+ target.dispatchEvent(new Event('input', { bubbles: true }));
+ target.dispatchEvent(new Event('change', { bubbles: true }));
+ }
+ modal.hide();
+ if (target) { target.focus(); }
+ }
+
+ function open(input) {
+ build();
+ target = input;
+ searchEl.value = '';
+ statusEl.textContent = '';
+ countEl.textContent = 'Loading…';
+ gridEl.innerHTML = '';
+ modal.show();
+ load(input.getAttribute('data-icon-picker')).then(function () {
+ filter();
+ // The icon in use may be far down the list: draw up to it so it can be shown and highlighted.
+ var at = matches.indexOf(current());
+ while (at >= shown && shown < matches.length) { draw(false); }
+ var sel = gridEl.querySelector('.is-selected');
+ if (sel) { sel.scrollIntoView({ block: 'center' }); }
+ }).catch(function () {
+ countEl.textContent = '';
+ statusEl.textContent = 'The icon list could not be loaded. Type the class name (for example bi-house) instead.';
+ });
+ }
+
+ Array.prototype.forEach.call(inputs, function (input) {
+ var group = input.parentElement && input.parentElement.classList.contains('input-group') ? input.parentElement : null;
+ var preview = null;
+
+ if (!group) {
+ group = document.createElement('div');
+ group.className = 'input-group';
+ input.parentNode.insertBefore(group, input);
+ preview = document.createElement('span');
+ preview.className = 'input-group-text';
+ preview.innerHTML = '';
+ group.appendChild(preview);
+ group.appendChild(input);
+ }
+
+ var button = document.createElement('button');
+ button.type = 'button';
+ button.className = 'btn btn-outline-secondary';
+ button.innerHTML = 'Choose';
+ button.addEventListener('click', function () { open(input); });
+ input.insertAdjacentElement('afterend', button);
+
+ function sync() {
+ if (!preview) { return; }
+ var v = input.value.trim();
+ preview.firstChild.className = 'bi ' + (/^bi-[a-z0-9-]+$/.test(v) ? v : 'bi-image');
+ }
+ input.addEventListener('input', sync);
+ sync();
+ });
+})();
diff --git a/assets/js/menu-form.js b/assets/js/menu-form.js
new file mode 100644
index 0000000..cbe5b31
--- /dev/null
+++ b/assets/js/menu-form.js
@@ -0,0 +1,23 @@
+/*
+ * Admin -> Menu builder, the add/edit form (assets/js/menu-form.js)
+ *
+ * Shows only the fields that matter for the chosen kind: a link has an address, a dropdown has
+ * none (it only opens its items), a section heading has neither an address, an icon nor a parent.
+ */
+(function () {
+ 'use strict';
+
+ var kind = document.getElementById('m_type');
+ if (!kind) { return; }
+
+ function update() {
+ var current = kind.value;
+ document.querySelectorAll('[data-show-for]').forEach(function (el) {
+ var visible = el.getAttribute('data-show-for').split(/\s+/).indexOf(current) !== -1;
+ el.hidden = !visible;
+ });
+ }
+
+ kind.addEventListener('change', update);
+ update();
+})();
diff --git a/assets/js/menus.js b/assets/js/menus.js
new file mode 100644
index 0000000..8f3422b
--- /dev/null
+++ b/assets/js/menus.js
@@ -0,0 +1,210 @@
+/*
+ * Admin -> Menus (assets/js/menus.js)
+ *
+ * Drags the sidebar rows into a new order, including nesting: dropping in the
+ * middle of a row makes the dragged item its child, dropping on the top or
+ * bottom third inserts it before/after that row at the same level. The ↑/↓
+ * buttons do the same without dragging. Either way the finished order is sent
+ * as [[id, depth], ...] to admin/menus/reorder and saved server-side.
+ */
+(function () {
+ 'use strict';
+
+ var list = document.getElementById('menu-builder');
+ if (!list) return;
+
+ var status = document.getElementById('menu-builder-status');
+ var readonly = list.hasAttribute('data-readonly');
+ var indent = 24;
+ var maxDepth = 2;
+ var dragged = null;
+ var saved = null;
+
+ function rows() {
+ return Array.prototype.slice.call(list.querySelectorAll('.menu-row'));
+ }
+
+ function depthOf(row) {
+ return parseInt(row.getAttribute('data-depth') || '0', 10);
+ }
+
+ function setDepth(row, depth) {
+ depth = Math.max(0, Math.min(maxDepth, depth));
+ row.setAttribute('data-depth', depth);
+ row.style.marginInlineStart = (depth * indent) + 'px';
+ }
+
+ function paint() {
+ rows().forEach(function (row) {
+ setDepth(row, depthOf(row));
+ });
+ }
+
+ /** The row plus everything nested under it. */
+ function subtree(row) {
+ var out = [row];
+ var depth = depthOf(row);
+ var next = row.nextElementSibling;
+ while (next && next.classList.contains('menu-row') && depthOf(next) > depth) {
+ out.push(next);
+ next = next.nextElementSibling;
+ }
+ return out;
+ }
+
+ /** Whether `ancestor` contains `row` (dropping a parent into its own child). */
+ function isAncestor(ancestor, row) {
+ var depth = depthOf(row);
+ var node = row;
+ while (node && node !== list) {
+ if (node === ancestor) return true;
+ node = node.previousElementSibling;
+ while (node && depthOf(node) >= depth && node !== ancestor) {
+ node = node.previousElementSibling;
+ }
+ depth = node ? depthOf(node) : -1;
+ if (node === ancestor) return true;
+ if (!node || depth < 0) return false;
+ }
+ return false;
+ }
+
+ function message(text, isError) {
+ if (!status) return;
+ status.textContent = text;
+ status.classList.toggle('text-danger', !!isError);
+ status.classList.toggle('text-body-secondary', !isError);
+ }
+
+ function order() {
+ return rows().map(function (row) {
+ return [parseInt(row.getAttribute('data-id'), 10), depthOf(row)];
+ });
+ }
+
+ function save() {
+ var next = JSON.stringify(order());
+ if (next === saved) return;
+ if (readonly) return;
+ saved = next;
+
+ var token = document.getElementById('menu-csrf-hash');
+ var name = document.getElementById('menu-csrf-name');
+ var body = new URLSearchParams();
+ body.set(name ? name.value : 'csrf_token', token ? token.value : '');
+ body.set('order', next);
+
+ message('Saving…');
+ fetch(list.getAttribute('data-reorder-url'), {
+ method: 'POST',
+ headers: { 'Content-Type': 'application/x-www-form-urlencoded', 'X-Requested-With': 'XMLHttpRequest' },
+ body: body.toString()
+ }).then(function (r) {
+ return r.json().then(function (data) { return { ok: r.ok && data.ok, data: data }; });
+ }).then(function (res) {
+ message(res.data.message || (res.ok ? 'Menu saved.' : 'Could not save.'), !res.ok);
+ if (res.ok) saved = JSON.stringify(order());
+ }).catch(function () {
+ message('Could not save the menu (network error).', true);
+ saved = null;
+ });
+ }
+
+ // ---------------------------------------------------------------- Drag
+ rows().forEach(function (row) {
+ row.setAttribute('draggable', readonly ? 'false' : 'true');
+
+ row.addEventListener('dragstart', function (e) {
+ dragged = row;
+ row.classList.add('dragging');
+ if (e.dataTransfer) {
+ e.dataTransfer.effectAllowed = 'move';
+ try { e.dataTransfer.setData('text/plain', row.getAttribute('data-id')); } catch (err) {}
+ }
+ });
+
+ row.addEventListener('dragend', function () {
+ row.classList.remove('dragging');
+ dragged = null;
+ save();
+ });
+
+ row.addEventListener('dragover', function (e) {
+ if (!dragged || dragged === row || isAncestor(dragged, row)) return;
+ e.preventDefault();
+ if (e.dataTransfer) e.dataTransfer.dropEffect = 'move';
+
+ var box = row.getBoundingClientRect();
+ var y = (e.clientY - box.top) / box.height;
+ var depth = depthOf(row);
+
+ if (y > 0.33 && y < 0.67) {
+ // Onto the row: it becomes the parent.
+ row.after(dragged);
+ setDepth(dragged, depth + 1);
+ } else if (y <= 0.33) {
+ row.before(dragged);
+ setDepth(dragged, depth);
+ } else {
+ var block = subtree(row);
+ block[block.length - 1].after(dragged);
+ setDepth(dragged, depth);
+ }
+ });
+
+ row.addEventListener('drop', function (e) {
+ e.preventDefault();
+ });
+ });
+
+ list.addEventListener('dragover', function (e) {
+ if (dragged && e.target === list) e.preventDefault();
+ });
+ list.addEventListener('drop', function (e) {
+ if (dragged && e.target === list) {
+ e.preventDefault();
+ list.appendChild(dragged);
+ setDepth(dragged, 0);
+ save();
+ }
+ });
+
+ // ------------------------------------------------------------- Buttons
+ list.addEventListener('click', function (e) {
+ var btn = e.target.closest ? e.target.closest('.menu-up, .menu-down') : null;
+ if (!btn || readonly) return;
+
+ var row = btn.closest('.menu-row');
+ if (!row) return;
+
+ if (btn.classList.contains('menu-up')) {
+ var prev = row.previousElementSibling;
+ while (prev && !prev.classList.contains('menu-row')) prev = prev.previousElementSibling;
+ if (prev) {
+ var block = subtree(prev);
+ block[0].before.apply(block[0], subtree(row));
+ if (depthOf(prev) !== depthOf(row)) setDepth(row, depthOf(prev));
+ }
+ } else {
+ var next = row.nextElementSibling;
+ while (next && !next.classList.contains('menu-row')) next = next.nextElementSibling;
+ if (next) {
+ var mine = subtree(row);
+ // Nesting deeper with ↓ when the next row is deeper already.
+ if (depthOf(next) > depthOf(row)) {
+ setDepth(row, depthOf(next));
+ next.after(mine[0]);
+ } else {
+ subtree(next)[subtree(next).length - 1].after.apply(mine[0], mine);
+ setDepth(row, depthOf(next));
+ }
+ }
+ }
+
+ paint();
+ save();
+ });
+
+ paint();
+ saved = JSON.stringify(order());
+})();
diff --git a/assets/js/pages.js b/assets/js/pages.js
new file mode 100644
index 0000000..d3fec6b
--- /dev/null
+++ b/assets/js/pages.js
@@ -0,0 +1,118 @@
+/*
+ * Admin -> Pages (assets/js/pages.js)
+ *
+ * Adds, moves and removes the section cards in the layout editor. Every card
+ * is plain form fields (sections[0][settings][heading]); after any change the
+ * indexes are renumbered so the server receives an ordered list. The markup
+ * mirrors the server-rendered cards in application/modules/pages/views/form.php.
+ */
+(function () {
+ 'use strict';
+
+ var host = document.getElementById('page-sections');
+ var form = document.getElementById('page-form');
+ if (!host || !form) return;
+
+ var catalogEl = document.getElementById('page-catalog');
+ var catalog = { labels: {}, fields: {} };
+ try { catalog = JSON.parse(catalogEl.textContent); } catch (e) {}
+
+ var empty = document.getElementById('page-sections-empty');
+
+ function esc(value) {
+ return String(value == null ? '' : value)
+ .replace(/&/g, '&').replace(//g, '>')
+ .replace(/"/g, '"').replace(/'/g, ''');
+ }
+
+ function fieldHtml(f, index, value) {
+ var name = 'sections[' + index + '][settings][' + f.name + ']';
+ var help = f.help ? '
' + esc(f.help) + '
' : '';
+ var label = '';
+
+ if (f.type === 'textarea') {
+ return '' + label +
+ '' + help + '
';
+ }
+ if (f.type === 'color') {
+ return '' + label +
+ '' + help + '
';
+ }
+ return '' + label +
+ '' + help + '
';
+ }
+
+ function cardHtml(type, index) {
+ var label = catalog.labels[type] || type;
+ var fields = (catalog.fields && catalog.fields[type]) || [];
+
+ var html = '' +
+ '
';
+ }
+
+ function cards() {
+ return Array.prototype.slice.call(host.querySelectorAll('.page-section'));
+ }
+
+ function renumber() {
+ cards().forEach(function (card, i) {
+ card.setAttribute('data-index', i);
+ var type = card.querySelector('[data-role="type"]');
+ if (type) type.name = 'sections[' + i + '][type]';
+ card.querySelectorAll('[data-field]').forEach(function (input) {
+ input.name = 'sections[' + i + '][settings][' + input.getAttribute('data-field') + ']';
+ });
+ });
+ if (empty) empty.hidden = cards().length > 0;
+ }
+
+ var add = document.getElementById('page-add');
+ var typeSelect = document.getElementById('page-add-type');
+ if (add && typeSelect) {
+ add.addEventListener('click', function () {
+ var type = typeSelect.value;
+ host.insertAdjacentHTML('beforeend', cardHtml(type, cards().length));
+ renumber();
+ var last = host.lastElementChild;
+ if (last) {
+ var first = last.querySelector('input, textarea');
+ if (first) first.focus();
+ }
+ });
+ }
+
+ host.addEventListener('click', function (e) {
+ var btn = e.target.closest ? e.target.closest('.section-up, .section-down, .section-remove') : null;
+ if (!btn) return;
+ var card = btn.closest('.page-section');
+ if (!card) return;
+
+ if (btn.classList.contains('section-remove')) {
+ card.remove();
+ } else if (btn.classList.contains('section-up') && card.previousElementSibling) {
+ host.insertBefore(card, card.previousElementSibling);
+ } else if (btn.classList.contains('section-down') && card.nextElementSibling) {
+ host.insertBefore(card.nextElementSibling, card);
+ }
+
+ renumber();
+ });
+
+ form.addEventListener('submit', renumber);
+ renumber();
+})();
diff --git a/assets/vendor/bootstrap-icons/icons.json b/assets/vendor/bootstrap-icons/icons.json
new file mode 100644
index 0000000..ada6312
--- /dev/null
+++ b/assets/vendor/bootstrap-icons/icons.json
@@ -0,0 +1 @@
+["0-circle","0-circle-fill","0-square","0-square-fill","1-circle","1-circle-fill","1-square","1-square-fill","123","2-circle","2-circle-fill","2-square","2-square-fill","3-circle","3-circle-fill","3-square","3-square-fill","4-circle","4-circle-fill","4-square","4-square-fill","5-circle","5-circle-fill","5-square","5-square-fill","6-circle","6-circle-fill","6-square","6-square-fill","7-circle","7-circle-fill","7-square","7-square-fill","8-circle","8-circle-fill","8-square","8-square-fill","9-circle","9-circle-fill","9-square","9-square-fill","activity","airplane","airplane-engines","airplane-engines-fill","airplane-fill","alarm","alarm-fill","alexa","align-bottom","align-center","align-end","align-middle","align-start","align-top","alipay","alphabet","alphabet-uppercase","alt","amazon","amd","android","android2","app","app-indicator","apple","archive","archive-fill","arrow-90deg-down","arrow-90deg-left","arrow-90deg-right","arrow-90deg-up","arrow-bar-down","arrow-bar-left","arrow-bar-right","arrow-bar-up","arrow-clockwise","arrow-counterclockwise","arrow-down","arrow-down-circle","arrow-down-circle-fill","arrow-down-left","arrow-down-left-circle","arrow-down-left-circle-fill","arrow-down-left-square","arrow-down-left-square-fill","arrow-down-right","arrow-down-right-circle","arrow-down-right-circle-fill","arrow-down-right-square","arrow-down-right-square-fill","arrow-down-short","arrow-down-square","arrow-down-square-fill","arrow-down-up","arrow-left","arrow-left-circle","arrow-left-circle-fill","arrow-left-right","arrow-left-short","arrow-left-square","arrow-left-square-fill","arrow-repeat","arrow-return-left","arrow-return-right","arrow-right","arrow-right-circle","arrow-right-circle-fill","arrow-right-short","arrow-right-square","arrow-right-square-fill","arrow-through-heart","arrow-through-heart-fill","arrow-up","arrow-up-circle","arrow-up-circle-fill","arrow-up-left","arrow-up-left-circle","arrow-up-left-circle-fill","arrow-up-left-square","arrow-up-left-square-fill","arrow-up-right","arrow-up-right-circle","arrow-up-right-circle-fill","arrow-up-right-square","arrow-up-right-square-fill","arrow-up-short","arrow-up-square","arrow-up-square-fill","arrows","arrows-angle-contract","arrows-angle-expand","arrows-collapse","arrows-collapse-vertical","arrows-expand","arrows-expand-vertical","arrows-fullscreen","arrows-move","arrows-vertical","aspect-ratio","aspect-ratio-fill","asterisk","at","award","award-fill","back","backpack","backpack-fill","backpack2","backpack2-fill","backpack3","backpack3-fill","backpack4","backpack4-fill","backspace","backspace-fill","backspace-reverse","backspace-reverse-fill","badge-3d","badge-3d-fill","badge-4k","badge-4k-fill","badge-8k","badge-8k-fill","badge-ad","badge-ad-fill","badge-ar","badge-ar-fill","badge-cc","badge-cc-fill","badge-hd","badge-hd-fill","badge-sd","badge-sd-fill","badge-tm","badge-tm-fill","badge-vo","badge-vo-fill","badge-vr","badge-vr-fill","badge-wc","badge-wc-fill","bag","bag-check","bag-check-fill","bag-dash","bag-dash-fill","bag-fill","bag-heart","bag-heart-fill","bag-plus","bag-plus-fill","bag-x","bag-x-fill","balloon","balloon-fill","balloon-heart","balloon-heart-fill","ban","ban-fill","bandaid","bandaid-fill","bank","bank2","bar-chart","bar-chart-fill","bar-chart-line","bar-chart-line-fill","bar-chart-steps","basket","basket-fill","basket2","basket2-fill","basket3","basket3-fill","battery","battery-charging","battery-full","battery-half","behance","bell","bell-fill","bell-slash","bell-slash-fill","bezier","bezier2","bicycle","bing","binoculars","binoculars-fill","blockquote-left","blockquote-right","bluetooth","body-text","book","book-fill","book-half","bookmark","bookmark-check","bookmark-check-fill","bookmark-dash","bookmark-dash-fill","bookmark-fill","bookmark-heart","bookmark-heart-fill","bookmark-plus","bookmark-plus-fill","bookmark-star","bookmark-star-fill","bookmark-x","bookmark-x-fill","bookmarks","bookmarks-fill","bookshelf","boombox","boombox-fill","bootstrap","bootstrap-fill","bootstrap-reboot","border","border-all","border-bottom","border-center","border-inner","border-left","border-middle","border-outer","border-right","border-style","border-top","border-width","bounding-box","bounding-box-circles","box","box-arrow-down","box-arrow-down-left","box-arrow-down-right","box-arrow-in-down","box-arrow-in-down-left","box-arrow-in-down-right","box-arrow-in-left","box-arrow-in-right","box-arrow-in-up","box-arrow-in-up-left","box-arrow-in-up-right","box-arrow-left","box-arrow-right","box-arrow-up","box-arrow-up-left","box-arrow-up-right","box-fill","box-seam","box-seam-fill","box2","box2-fill","box2-heart","box2-heart-fill","boxes","braces","braces-asterisk","bricks","briefcase","briefcase-fill","brightness-alt-high","brightness-alt-high-fill","brightness-alt-low","brightness-alt-low-fill","brightness-high","brightness-high-fill","brightness-low","brightness-low-fill","brilliance","broadcast","broadcast-pin","browser-chrome","browser-edge","browser-firefox","browser-safari","brush","brush-fill","bucket","bucket-fill","bug","bug-fill","building","building-add","building-check","building-dash","building-down","building-exclamation","building-fill","building-fill-add","building-fill-check","building-fill-dash","building-fill-down","building-fill-exclamation","building-fill-gear","building-fill-lock","building-fill-slash","building-fill-up","building-fill-x","building-gear","building-lock","building-slash","building-up","building-x","buildings","buildings-fill","bullseye","bus-front","bus-front-fill","c-circle","c-circle-fill","c-square","c-square-fill","cake","cake-fill","cake2","cake2-fill","calculator","calculator-fill","calendar","calendar-check","calendar-check-fill","calendar-date","calendar-date-fill","calendar-day","calendar-day-fill","calendar-event","calendar-event-fill","calendar-fill","calendar-heart","calendar-heart-fill","calendar-minus","calendar-minus-fill","calendar-month","calendar-month-fill","calendar-plus","calendar-plus-fill","calendar-range","calendar-range-fill","calendar-week","calendar-week-fill","calendar-x","calendar-x-fill","calendar2","calendar2-check","calendar2-check-fill","calendar2-date","calendar2-date-fill","calendar2-day","calendar2-day-fill","calendar2-event","calendar2-event-fill","calendar2-fill","calendar2-heart","calendar2-heart-fill","calendar2-minus","calendar2-minus-fill","calendar2-month","calendar2-month-fill","calendar2-plus","calendar2-plus-fill","calendar2-range","calendar2-range-fill","calendar2-week","calendar2-week-fill","calendar2-x","calendar2-x-fill","calendar3","calendar3-event","calendar3-event-fill","calendar3-fill","calendar3-range","calendar3-range-fill","calendar3-week","calendar3-week-fill","calendar4","calendar4-event","calendar4-range","calendar4-week","camera","camera-fill","camera-reels","camera-reels-fill","camera-video","camera-video-fill","camera-video-off","camera-video-off-fill","camera2","capslock","capslock-fill","capsule","capsule-pill","car-front","car-front-fill","card-checklist","card-heading","card-image","card-list","card-text","caret-down","caret-down-fill","caret-down-square","caret-down-square-fill","caret-left","caret-left-fill","caret-left-square","caret-left-square-fill","caret-right","caret-right-fill","caret-right-square","caret-right-square-fill","caret-up","caret-up-fill","caret-up-square","caret-up-square-fill","cart","cart-check","cart-check-fill","cart-dash","cart-dash-fill","cart-fill","cart-plus","cart-plus-fill","cart-x","cart-x-fill","cart2","cart3","cart4","cash","cash-coin","cash-stack","cassette","cassette-fill","cast","cc-circle","cc-circle-fill","cc-square","cc-square-fill","chat","chat-dots","chat-dots-fill","chat-fill","chat-heart","chat-heart-fill","chat-left","chat-left-dots","chat-left-dots-fill","chat-left-fill","chat-left-heart","chat-left-heart-fill","chat-left-quote","chat-left-quote-fill","chat-left-text","chat-left-text-fill","chat-quote","chat-quote-fill","chat-right","chat-right-dots","chat-right-dots-fill","chat-right-fill","chat-right-heart","chat-right-heart-fill","chat-right-quote","chat-right-quote-fill","chat-right-text","chat-right-text-fill","chat-square","chat-square-dots","chat-square-dots-fill","chat-square-fill","chat-square-heart","chat-square-heart-fill","chat-square-quote","chat-square-quote-fill","chat-square-text","chat-square-text-fill","chat-text","chat-text-fill","check","check-all","check-circle","check-circle-fill","check-lg","check-square","check-square-fill","check2","check2-all","check2-circle","check2-square","chevron-bar-contract","chevron-bar-down","chevron-bar-expand","chevron-bar-left","chevron-bar-right","chevron-bar-up","chevron-compact-down","chevron-compact-left","chevron-compact-right","chevron-compact-up","chevron-contract","chevron-double-down","chevron-double-left","chevron-double-right","chevron-double-up","chevron-down","chevron-expand","chevron-left","chevron-right","chevron-up","circle","circle-fill","circle-half","circle-square","clipboard","clipboard-check","clipboard-check-fill","clipboard-data","clipboard-data-fill","clipboard-fill","clipboard-heart","clipboard-heart-fill","clipboard-minus","clipboard-minus-fill","clipboard-plus","clipboard-plus-fill","clipboard-pulse","clipboard-x","clipboard-x-fill","clipboard2","clipboard2-check","clipboard2-check-fill","clipboard2-data","clipboard2-data-fill","clipboard2-fill","clipboard2-heart","clipboard2-heart-fill","clipboard2-minus","clipboard2-minus-fill","clipboard2-plus","clipboard2-plus-fill","clipboard2-pulse","clipboard2-pulse-fill","clipboard2-x","clipboard2-x-fill","clock","clock-fill","clock-history","cloud","cloud-arrow-down","cloud-arrow-down-fill","cloud-arrow-up","cloud-arrow-up-fill","cloud-check","cloud-check-fill","cloud-download","cloud-download-fill","cloud-drizzle","cloud-drizzle-fill","cloud-fill","cloud-fog","cloud-fog-fill","cloud-fog2","cloud-fog2-fill","cloud-hail","cloud-hail-fill","cloud-haze","cloud-haze-fill","cloud-haze2","cloud-haze2-fill","cloud-lightning","cloud-lightning-fill","cloud-lightning-rain","cloud-lightning-rain-fill","cloud-minus","cloud-minus-fill","cloud-moon","cloud-moon-fill","cloud-plus","cloud-plus-fill","cloud-rain","cloud-rain-fill","cloud-rain-heavy","cloud-rain-heavy-fill","cloud-slash","cloud-slash-fill","cloud-sleet","cloud-sleet-fill","cloud-snow","cloud-snow-fill","cloud-sun","cloud-sun-fill","cloud-upload","cloud-upload-fill","clouds","clouds-fill","cloudy","cloudy-fill","code","code-slash","code-square","coin","collection","collection-fill","collection-play","collection-play-fill","columns","columns-gap","command","compass","compass-fill","cone","cone-striped","controller","cookie","copy","cpu","cpu-fill","credit-card","credit-card-2-back","credit-card-2-back-fill","credit-card-2-front","credit-card-2-front-fill","credit-card-fill","crop","crosshair","crosshair2","cup","cup-fill","cup-hot","cup-hot-fill","cup-straw","currency-bitcoin","currency-dollar","currency-euro","currency-exchange","currency-pound","currency-rupee","currency-yen","cursor","cursor-fill","cursor-text","dash","dash-circle","dash-circle-dotted","dash-circle-fill","dash-lg","dash-square","dash-square-dotted","dash-square-fill","database","database-add","database-check","database-dash","database-down","database-exclamation","database-fill","database-fill-add","database-fill-check","database-fill-dash","database-fill-down","database-fill-exclamation","database-fill-gear","database-fill-lock","database-fill-slash","database-fill-up","database-fill-x","database-gear","database-lock","database-slash","database-up","database-x","device-hdd","device-hdd-fill","device-ssd","device-ssd-fill","diagram-2","diagram-2-fill","diagram-3","diagram-3-fill","diamond","diamond-fill","diamond-half","dice-1","dice-1-fill","dice-2","dice-2-fill","dice-3","dice-3-fill","dice-4","dice-4-fill","dice-5","dice-5-fill","dice-6","dice-6-fill","disc","disc-fill","discord","display","display-fill","displayport","displayport-fill","distribute-horizontal","distribute-vertical","door-closed","door-closed-fill","door-open","door-open-fill","dot","download","dpad","dpad-fill","dribbble","dropbox","droplet","droplet-fill","droplet-half","duffle","duffle-fill","ear","ear-fill","earbuds","easel","easel-fill","easel2","easel2-fill","easel3","easel3-fill","egg","egg-fill","egg-fried","eject","eject-fill","emoji-angry","emoji-angry-fill","emoji-astonished","emoji-astonished-fill","emoji-dizzy","emoji-dizzy-fill","emoji-expressionless","emoji-expressionless-fill","emoji-frown","emoji-frown-fill","emoji-grimace","emoji-grimace-fill","emoji-grin","emoji-grin-fill","emoji-heart-eyes","emoji-heart-eyes-fill","emoji-kiss","emoji-kiss-fill","emoji-laughing","emoji-laughing-fill","emoji-neutral","emoji-neutral-fill","emoji-smile","emoji-smile-fill","emoji-smile-upside-down","emoji-smile-upside-down-fill","emoji-sunglasses","emoji-sunglasses-fill","emoji-surprise","emoji-surprise-fill","emoji-tear","emoji-tear-fill","emoji-wink","emoji-wink-fill","envelope","envelope-arrow-down","envelope-arrow-down-fill","envelope-arrow-up","envelope-arrow-up-fill","envelope-at","envelope-at-fill","envelope-check","envelope-check-fill","envelope-dash","envelope-dash-fill","envelope-exclamation","envelope-exclamation-fill","envelope-fill","envelope-heart","envelope-heart-fill","envelope-open","envelope-open-fill","envelope-open-heart","envelope-open-heart-fill","envelope-paper","envelope-paper-fill","envelope-paper-heart","envelope-paper-heart-fill","envelope-plus","envelope-plus-fill","envelope-slash","envelope-slash-fill","envelope-x","envelope-x-fill","eraser","eraser-fill","escape","ethernet","ev-front","ev-front-fill","ev-station","ev-station-fill","exclamation","exclamation-circle","exclamation-circle-fill","exclamation-diamond","exclamation-diamond-fill","exclamation-lg","exclamation-octagon","exclamation-octagon-fill","exclamation-square","exclamation-square-fill","exclamation-triangle","exclamation-triangle-fill","exclude","explicit","explicit-fill","exposure","eye","eye-fill","eye-slash","eye-slash-fill","eyedropper","eyeglasses","facebook","fan","fast-forward","fast-forward-btn","fast-forward-btn-fill","fast-forward-circle","fast-forward-circle-fill","fast-forward-fill","feather","feather2","file","file-arrow-down","file-arrow-down-fill","file-arrow-up","file-arrow-up-fill","file-bar-graph","file-bar-graph-fill","file-binary","file-binary-fill","file-break","file-break-fill","file-check","file-check-fill","file-code","file-code-fill","file-diff","file-diff-fill","file-earmark","file-earmark-arrow-down","file-earmark-arrow-down-fill","file-earmark-arrow-up","file-earmark-arrow-up-fill","file-earmark-bar-graph","file-earmark-bar-graph-fill","file-earmark-binary","file-earmark-binary-fill","file-earmark-break","file-earmark-break-fill","file-earmark-check","file-earmark-check-fill","file-earmark-code","file-earmark-code-fill","file-earmark-diff","file-earmark-diff-fill","file-earmark-easel","file-earmark-easel-fill","file-earmark-excel","file-earmark-excel-fill","file-earmark-fill","file-earmark-font","file-earmark-font-fill","file-earmark-image","file-earmark-image-fill","file-earmark-lock","file-earmark-lock-fill","file-earmark-lock2","file-earmark-lock2-fill","file-earmark-medical","file-earmark-medical-fill","file-earmark-minus","file-earmark-minus-fill","file-earmark-music","file-earmark-music-fill","file-earmark-pdf","file-earmark-pdf-fill","file-earmark-person","file-earmark-person-fill","file-earmark-play","file-earmark-play-fill","file-earmark-plus","file-earmark-plus-fill","file-earmark-post","file-earmark-post-fill","file-earmark-ppt","file-earmark-ppt-fill","file-earmark-richtext","file-earmark-richtext-fill","file-earmark-ruled","file-earmark-ruled-fill","file-earmark-slides","file-earmark-slides-fill","file-earmark-spreadsheet","file-earmark-spreadsheet-fill","file-earmark-text","file-earmark-text-fill","file-earmark-word","file-earmark-word-fill","file-earmark-x","file-earmark-x-fill","file-earmark-zip","file-earmark-zip-fill","file-easel","file-easel-fill","file-excel","file-excel-fill","file-fill","file-font","file-font-fill","file-image","file-image-fill","file-lock","file-lock-fill","file-lock2","file-lock2-fill","file-medical","file-medical-fill","file-minus","file-minus-fill","file-music","file-music-fill","file-pdf","file-pdf-fill","file-person","file-person-fill","file-play","file-play-fill","file-plus","file-plus-fill","file-post","file-post-fill","file-ppt","file-ppt-fill","file-richtext","file-richtext-fill","file-ruled","file-ruled-fill","file-slides","file-slides-fill","file-spreadsheet","file-spreadsheet-fill","file-text","file-text-fill","file-word","file-word-fill","file-x","file-x-fill","file-zip","file-zip-fill","files","files-alt","filetype-aac","filetype-ai","filetype-bmp","filetype-cs","filetype-css","filetype-csv","filetype-doc","filetype-docx","filetype-exe","filetype-gif","filetype-heic","filetype-html","filetype-java","filetype-jpg","filetype-js","filetype-json","filetype-jsx","filetype-key","filetype-m4p","filetype-md","filetype-mdx","filetype-mov","filetype-mp3","filetype-mp4","filetype-otf","filetype-pdf","filetype-php","filetype-png","filetype-ppt","filetype-pptx","filetype-psd","filetype-py","filetype-raw","filetype-rb","filetype-sass","filetype-scss","filetype-sh","filetype-sql","filetype-svg","filetype-tiff","filetype-tsx","filetype-ttf","filetype-txt","filetype-wav","filetype-woff","filetype-xls","filetype-xlsx","filetype-xml","filetype-yml","film","filter","filter-circle","filter-circle-fill","filter-left","filter-right","filter-square","filter-square-fill","fingerprint","fire","flag","flag-fill","floppy","floppy-fill","floppy2","floppy2-fill","flower1","flower2","flower3","folder","folder-check","folder-fill","folder-minus","folder-plus","folder-symlink","folder-symlink-fill","folder-x","folder2","folder2-open","fonts","forward","forward-fill","front","fuel-pump","fuel-pump-diesel","fuel-pump-diesel-fill","fuel-pump-fill","fullscreen","fullscreen-exit","funnel","funnel-fill","gear","gear-fill","gear-wide","gear-wide-connected","gem","gender-ambiguous","gender-female","gender-male","gender-neuter","gender-trans","geo","geo-alt","geo-alt-fill","geo-fill","gift","gift-fill","git","github","gitlab","globe","globe-americas","globe-asia-australia","globe-central-south-asia","globe-europe-africa","globe2","google","google-play","gpu-card","graph-down","graph-down-arrow","graph-up","graph-up-arrow","grid","grid-1x2","grid-1x2-fill","grid-3x2","grid-3x2-gap","grid-3x2-gap-fill","grid-3x3","grid-3x3-gap","grid-3x3-gap-fill","grid-fill","grip-horizontal","grip-vertical","h-circle","h-circle-fill","h-square","h-square-fill","hammer","hand-index","hand-index-fill","hand-index-thumb","hand-index-thumb-fill","hand-thumbs-down","hand-thumbs-down-fill","hand-thumbs-up","hand-thumbs-up-fill","handbag","handbag-fill","hash","hdd","hdd-fill","hdd-network","hdd-network-fill","hdd-rack","hdd-rack-fill","hdd-stack","hdd-stack-fill","hdmi","hdmi-fill","headphones","headset","headset-vr","heart","heart-arrow","heart-fill","heart-half","heart-pulse","heart-pulse-fill","heartbreak","heartbreak-fill","hearts","heptagon","heptagon-fill","heptagon-half","hexagon","hexagon-fill","hexagon-half","highlighter","highlights","hospital","hospital-fill","hourglass","hourglass-bottom","hourglass-split","hourglass-top","house","house-add","house-add-fill","house-check","house-check-fill","house-dash","house-dash-fill","house-door","house-door-fill","house-down","house-down-fill","house-exclamation","house-exclamation-fill","house-fill","house-gear","house-gear-fill","house-heart","house-heart-fill","house-lock","house-lock-fill","house-slash","house-slash-fill","house-up","house-up-fill","house-x","house-x-fill","houses","houses-fill","hr","hurricane","hypnotize","image","image-alt","image-fill","images","inbox","inbox-fill","inboxes","inboxes-fill","incognito","indent","infinity","info","info-circle","info-circle-fill","info-lg","info-square","info-square-fill","input-cursor","input-cursor-text","instagram","intersect","journal","journal-album","journal-arrow-down","journal-arrow-up","journal-bookmark","journal-bookmark-fill","journal-check","journal-code","journal-medical","journal-minus","journal-plus","journal-richtext","journal-text","journal-x","journals","joystick","justify","justify-left","justify-right","kanban","kanban-fill","key","key-fill","keyboard","keyboard-fill","ladder","lamp","lamp-fill","laptop","laptop-fill","layer-backward","layer-forward","layers","layers-fill","layers-half","layout-sidebar","layout-sidebar-inset","layout-sidebar-inset-reverse","layout-sidebar-reverse","layout-split","layout-text-sidebar","layout-text-sidebar-reverse","layout-text-window","layout-text-window-reverse","layout-three-columns","layout-wtf","life-preserver","lightbulb","lightbulb-fill","lightbulb-off","lightbulb-off-fill","lightning","lightning-charge","lightning-charge-fill","lightning-fill","line","link","link-45deg","linkedin","list","list-check","list-columns","list-columns-reverse","list-nested","list-ol","list-stars","list-task","list-ul","lock","lock-fill","luggage","luggage-fill","lungs","lungs-fill","magic","magnet","magnet-fill","mailbox","mailbox-flag","mailbox2","mailbox2-flag","map","map-fill","markdown","markdown-fill","marker-tip","mask","mastodon","medium","megaphone","megaphone-fill","memory","menu-app","menu-app-fill","menu-button","menu-button-fill","menu-button-wide","menu-button-wide-fill","menu-down","menu-up","messenger","meta","mic","mic-fill","mic-mute","mic-mute-fill","microsoft","microsoft-teams","minecart","minecart-loaded","modem","modem-fill","moisture","moon","moon-fill","moon-stars","moon-stars-fill","mortarboard","mortarboard-fill","motherboard","motherboard-fill","mouse","mouse-fill","mouse2","mouse2-fill","mouse3","mouse3-fill","music-note","music-note-beamed","music-note-list","music-player","music-player-fill","newspaper","nintendo-switch","node-minus","node-minus-fill","node-plus","node-plus-fill","noise-reduction","nut","nut-fill","nvidia","nvme","nvme-fill","octagon","octagon-fill","octagon-half","opencollective","optical-audio","optical-audio-fill","option","outlet","p-circle","p-circle-fill","p-square","p-square-fill","paint-bucket","palette","palette-fill","palette2","paperclip","paragraph","pass","pass-fill","passport","passport-fill","patch-check","patch-check-fill","patch-exclamation","patch-exclamation-fill","patch-minus","patch-minus-fill","patch-plus","patch-plus-fill","patch-question","patch-question-fill","pause","pause-btn","pause-btn-fill","pause-circle","pause-circle-fill","pause-fill","paypal","pc","pc-display","pc-display-horizontal","pc-horizontal","pci-card","pci-card-network","pci-card-sound","peace","peace-fill","pen","pen-fill","pencil","pencil-fill","pencil-square","pentagon","pentagon-fill","pentagon-half","people","people-fill","percent","person","person-add","person-arms-up","person-badge","person-badge-fill","person-bounding-box","person-check","person-check-fill","person-circle","person-dash","person-dash-fill","person-down","person-exclamation","person-fill","person-fill-add","person-fill-check","person-fill-dash","person-fill-down","person-fill-exclamation","person-fill-gear","person-fill-lock","person-fill-slash","person-fill-up","person-fill-x","person-gear","person-heart","person-hearts","person-lines-fill","person-lock","person-plus","person-plus-fill","person-raised-hand","person-rolodex","person-slash","person-square","person-standing","person-standing-dress","person-up","person-vcard","person-vcard-fill","person-video","person-video2","person-video3","person-walking","person-wheelchair","person-workspace","person-x","person-x-fill","phone","phone-fill","phone-flip","phone-landscape","phone-landscape-fill","phone-vibrate","phone-vibrate-fill","pie-chart","pie-chart-fill","piggy-bank","piggy-bank-fill","pin","pin-angle","pin-angle-fill","pin-fill","pin-map","pin-map-fill","pinterest","pip","pip-fill","play","play-btn","play-btn-fill","play-circle","play-circle-fill","play-fill","playstation","plug","plug-fill","plugin","plus","plus-circle","plus-circle-dotted","plus-circle-fill","plus-lg","plus-slash-minus","plus-square","plus-square-dotted","plus-square-fill","postage","postage-fill","postage-heart","postage-heart-fill","postcard","postcard-fill","postcard-heart","postcard-heart-fill","power","prescription","prescription2","printer","printer-fill","projector","projector-fill","puzzle","puzzle-fill","qr-code","qr-code-scan","question","question-circle","question-circle-fill","question-diamond","question-diamond-fill","question-lg","question-octagon","question-octagon-fill","question-square","question-square-fill","quora","quote","r-circle","r-circle-fill","r-square","r-square-fill","radar","radioactive","rainbow","receipt","receipt-cutoff","reception-0","reception-1","reception-2","reception-3","reception-4","record","record-btn","record-btn-fill","record-circle","record-circle-fill","record-fill","record2","record2-fill","recycle","reddit","regex","repeat","repeat-1","reply","reply-all","reply-all-fill","reply-fill","rewind","rewind-btn","rewind-btn-fill","rewind-circle","rewind-circle-fill","rewind-fill","robot","rocket","rocket-fill","rocket-takeoff","rocket-takeoff-fill","router","router-fill","rss","rss-fill","rulers","safe","safe-fill","safe2","safe2-fill","save","save-fill","save2","save2-fill","scissors","scooter","screwdriver","sd-card","sd-card-fill","search","search-heart","search-heart-fill","segmented-nav","send","send-arrow-down","send-arrow-down-fill","send-arrow-up","send-arrow-up-fill","send-check","send-check-fill","send-dash","send-dash-fill","send-exclamation","send-exclamation-fill","send-fill","send-plus","send-plus-fill","send-slash","send-slash-fill","send-x","send-x-fill","server","shadows","share","share-fill","shield","shield-check","shield-exclamation","shield-fill","shield-fill-check","shield-fill-exclamation","shield-fill-minus","shield-fill-plus","shield-fill-x","shield-lock","shield-lock-fill","shield-minus","shield-plus","shield-shaded","shield-slash","shield-slash-fill","shield-x","shift","shift-fill","shop","shop-window","shuffle","sign-dead-end","sign-dead-end-fill","sign-do-not-enter","sign-do-not-enter-fill","sign-intersection","sign-intersection-fill","sign-intersection-side","sign-intersection-side-fill","sign-intersection-t","sign-intersection-t-fill","sign-intersection-y","sign-intersection-y-fill","sign-merge-left","sign-merge-left-fill","sign-merge-right","sign-merge-right-fill","sign-no-left-turn","sign-no-left-turn-fill","sign-no-parking","sign-no-parking-fill","sign-no-right-turn","sign-no-right-turn-fill","sign-railroad","sign-railroad-fill","sign-stop","sign-stop-fill","sign-stop-lights","sign-stop-lights-fill","sign-turn-left","sign-turn-left-fill","sign-turn-right","sign-turn-right-fill","sign-turn-slight-left","sign-turn-slight-left-fill","sign-turn-slight-right","sign-turn-slight-right-fill","sign-yield","sign-yield-fill","signal","signpost","signpost-2","signpost-2-fill","signpost-fill","signpost-split","signpost-split-fill","sim","sim-fill","sim-slash","sim-slash-fill","sina-weibo","skip-backward","skip-backward-btn","skip-backward-btn-fill","skip-backward-circle","skip-backward-circle-fill","skip-backward-fill","skip-end","skip-end-btn","skip-end-btn-fill","skip-end-circle","skip-end-circle-fill","skip-end-fill","skip-forward","skip-forward-btn","skip-forward-btn-fill","skip-forward-circle","skip-forward-circle-fill","skip-forward-fill","skip-start","skip-start-btn","skip-start-btn-fill","skip-start-circle","skip-start-circle-fill","skip-start-fill","skype","slack","slash","slash-circle","slash-circle-fill","slash-lg","slash-square","slash-square-fill","sliders","sliders2","sliders2-vertical","smartwatch","snapchat","snow","snow2","snow3","sort-alpha-down","sort-alpha-down-alt","sort-alpha-up","sort-alpha-up-alt","sort-down","sort-down-alt","sort-numeric-down","sort-numeric-down-alt","sort-numeric-up","sort-numeric-up-alt","sort-up","sort-up-alt","soundwave","sourceforge","speaker","speaker-fill","speedometer","speedometer2","spellcheck","spotify","square","square-fill","square-half","stack","stack-overflow","star","star-fill","star-half","stars","steam","stickies","stickies-fill","sticky","sticky-fill","stop","stop-btn","stop-btn-fill","stop-circle","stop-circle-fill","stop-fill","stoplights","stoplights-fill","stopwatch","stopwatch-fill","strava","stripe","subscript","substack","subtract","suit-club","suit-club-fill","suit-diamond","suit-diamond-fill","suit-heart","suit-heart-fill","suit-spade","suit-spade-fill","suitcase","suitcase-fill","suitcase-lg","suitcase-lg-fill","suitcase2","suitcase2-fill","sun","sun-fill","sunglasses","sunrise","sunrise-fill","sunset","sunset-fill","superscript","symmetry-horizontal","symmetry-vertical","table","tablet","tablet-fill","tablet-landscape","tablet-landscape-fill","tag","tag-fill","tags","tags-fill","taxi-front","taxi-front-fill","telegram","telephone","telephone-fill","telephone-forward","telephone-forward-fill","telephone-inbound","telephone-inbound-fill","telephone-minus","telephone-minus-fill","telephone-outbound","telephone-outbound-fill","telephone-plus","telephone-plus-fill","telephone-x","telephone-x-fill","tencent-qq","terminal","terminal-dash","terminal-fill","terminal-plus","terminal-split","terminal-x","text-center","text-indent-left","text-indent-right","text-left","text-paragraph","text-right","text-wrap","textarea","textarea-resize","textarea-t","thermometer","thermometer-half","thermometer-high","thermometer-low","thermometer-snow","thermometer-sun","threads","threads-fill","three-dots","three-dots-vertical","thunderbolt","thunderbolt-fill","ticket","ticket-detailed","ticket-detailed-fill","ticket-fill","ticket-perforated","ticket-perforated-fill","tiktok","toggle-off","toggle-on","toggle2-off","toggle2-on","toggles","toggles2","tools","tornado","train-freight-front","train-freight-front-fill","train-front","train-front-fill","train-lightrail-front","train-lightrail-front-fill","translate","transparency","trash","trash-fill","trash2","trash2-fill","trash3","trash3-fill","tree","tree-fill","trello","triangle","triangle-fill","triangle-half","trophy","trophy-fill","tropical-storm","truck","truck-flatbed","truck-front","truck-front-fill","tsunami","tv","tv-fill","twitch","twitter","twitter-x","type","type-bold","type-h1","type-h2","type-h3","type-h4","type-h5","type-h6","type-italic","type-strikethrough","type-underline","ubuntu","ui-checks","ui-checks-grid","ui-radios","ui-radios-grid","umbrella","umbrella-fill","unindent","union","unity","universal-access","universal-access-circle","unlock","unlock-fill","upc","upc-scan","upload","usb","usb-c","usb-c-fill","usb-drive","usb-drive-fill","usb-fill","usb-micro","usb-micro-fill","usb-mini","usb-mini-fill","usb-plug","usb-plug-fill","usb-symbol","valentine","valentine2","vector-pen","view-list","view-stacked","vignette","vimeo","vinyl","vinyl-fill","virus","virus2","voicemail","volume-down","volume-down-fill","volume-mute","volume-mute-fill","volume-off","volume-off-fill","volume-up","volume-up-fill","vr","wallet","wallet-fill","wallet2","watch","water","webcam","webcam-fill","wechat","whatsapp","wifi","wifi-1","wifi-2","wifi-off","wikipedia","wind","window","window-dash","window-desktop","window-dock","window-fullscreen","window-plus","window-sidebar","window-split","window-stack","window-x","windows","wordpress","wrench","wrench-adjustable","wrench-adjustable-circle","wrench-adjustable-circle-fill","x","x-circle","x-circle-fill","x-diamond","x-diamond-fill","x-lg","x-octagon","x-octagon-fill","x-square","x-square-fill","xbox","yelp","yin-yang","youtube","zoom-in","zoom-out"]
\ No newline at end of file
diff --git a/tests-app/Unit/MenuTreeTest.php b/tests-app/Unit/MenuTreeTest.php
new file mode 100644
index 0000000..623b133
--- /dev/null
+++ b/tests-app/Unit/MenuTreeTest.php
@@ -0,0 +1,96 @@
+ current parent, i.e. rows 1..4 exist. */
+ private function known()
+ {
+ return [1 => 0, 2 => 0, 3 => 0, 4 => 0];
+ }
+
+ public function testFlatOrderStaysFlat(): void
+ {
+ $parents = MenuTree::parents([[1, 0], [2, 0], [3, 0]], [1 => 0, 2 => 0, 3 => 0]);
+
+ $this->assertSame([1 => 0, 2 => 0, 3 => 0], $parents);
+ }
+
+ public function testDepthBecomesAParent(): void
+ {
+ $parents = MenuTree::parents([[1, 0], [2, 1], [3, 1], [4, 0]], $this->known());
+
+ $this->assertSame([1 => 0, 2 => 1, 3 => 1, 4 => 0], $parents);
+ }
+
+ public function testSecondLevelNestsUnderTheItemAboveIt(): void
+ {
+ $parents = MenuTree::parents([[1, 0], [2, 1], [3, 2], [4, 2]], $this->known());
+
+ $this->assertSame([1 => 0, 2 => 1, 3 => 2, 4 => 2], $parents);
+ }
+
+ public function testARowThatSkipsALevelFallsBackToTheNearestAncestor(): void
+ {
+ // Depth 2 straight after a depth 0 item: the missing level is skipped.
+ $parents = MenuTree::parents([[1, 0], [2, 0], [3, 2]], [1 => 0, 2 => 0, 3 => 0]);
+
+ $this->assertSame([1 => 0, 2 => 0, 3 => 2], $parents);
+ }
+
+ public function testUnknownAndDuplicateIdsAreRejected(): void
+ {
+ $this->assertFalse(MenuTree::parents([[1, 0], [99, 0]], $this->known()));
+ $this->assertFalse(MenuTree::parents([[1, 0], [1, 1], [2, 0], [3, 0], [4, 0]], $this->known()));
+ }
+
+ public function testAPartialOrderIsRejected(): void
+ {
+ $this->assertFalse(MenuTree::parents([[1, 0], [2, 0]], $this->known()), 'rows were left out');
+ $this->assertFalse(MenuTree::parents([], $this->known()));
+ }
+
+ public function testDepthsBeyondTheLimitAreRejected(): void
+ {
+ $this->assertFalse(MenuTree::parents([[1, 0], [2, 1], [3, 4]], [1 => 0, 2 => 0, 3 => 0]));
+ $this->assertFalse(MenuTree::parents([[1, -1], [2, 0]], [1 => 0, 2 => 0]));
+ }
+
+ public function testCanNestRules(): void
+ {
+ // 1 (top) > 2 > 3, and 4 alone. ids => parent
+ $tree = [1 => 0, 2 => 1, 3 => 2, 4 => 0];
+
+ $this->assertTrue(MenuTree::canNest($tree, 4, 0), 'top level is always fine');
+ $this->assertTrue(MenuTree::canNest($tree, 4, 1), 'a lone item under a top-level one');
+ $this->assertFalse(MenuTree::canNest($tree, 4, 3), 'under the third level would be level four');
+ $this->assertFalse(MenuTree::canNest($tree, 1, 1), 'never its own parent');
+ $this->assertFalse(MenuTree::canNest($tree, 1, 3), 'never inside its own subtree');
+ $this->assertFalse(MenuTree::canNest($tree, 2, 3), 'a child cannot become its own parent\'s child');
+ $this->assertFalse(MenuTree::canNest($tree, 4, 99), 'the parent must exist');
+ $this->assertFalse(MenuTree::canNest($tree, 1, 4), 'a subtree that is already three levels deep cannot move down');
+ $this->assertTrue(MenuTree::canNest([1 => 0, 2 => 0, 3 => 2], 2, 1), 'a two-level subtree may go under a top-level item');
+ }
+
+ public function testCanNestForAnItemThatDoesNotExistYet(): void
+ {
+ // 1 (top) > 2 > 3 : a new item (id 0) has no subtree of its own
+ $tree = [1 => 0, 2 => 1, 3 => 2, 4 => 0];
+
+ $this->assertTrue(MenuTree::canNest($tree, 0, 0));
+ $this->assertTrue(MenuTree::canNest($tree, 0, 1), 'a new item under a top-level one');
+ $this->assertTrue(MenuTree::canNest($tree, 0, 2), 'a new item may be the third level');
+ $this->assertFalse(MenuTree::canNest($tree, 0, 3), 'but not the fourth');
+ $this->assertFalse(MenuTree::canNest($tree, 0, 99), 'and its parent must exist');
+ }
+
+ public function testCanNestSurvivesLoopsInStoredData(): void
+ {
+ $this->assertFalse(MenuTree::canNest([1 => 2, 2 => 1, 3 => 0], 3, 1), 'a loop above the new parent is unusable');
+ }
+}
+
diff --git a/tests-app/Unit/PageSafetyTest.php b/tests-app/Unit/PageSafetyTest.php
new file mode 100644
index 0000000..77b8f5e
--- /dev/null
+++ b/tests-app/Unit/PageSafetyTest.php
@@ -0,0 +1,112 @@
+assertSame($url, Links::safe($url), $url);
+ }
+ $this->assertSame('https://example.com', Links::safe(' https://example.com '), 'trimmed');
+ }
+
+ public function testRefusedAddresses(): void
+ {
+ $bad = [
+ '', ' ', 'javascript:alert(1)', 'JaVaScRiPt:alert(1)', "java\tscript:alert(1)", "java\nscript:alert(1)", " javascript:alert(1)",
+ 'data:text/html,', 'vbscript:x', 'file:///etc/passwd', 'blob:https://x', 'ftp://example.com',
+ '//evil.example/path', '\\\\evil.example', 'https:///nohost', 'http://', "https://exa mple.com", "https://exa\0mple.com",
+ str_repeat('a', 2001),
+ ];
+ foreach ($bad as $url) {
+ $this->assertNull(Links::safe($url), json_encode($url));
+ }
+ }
+
+ public function testResolveKeepsAbsoluteAndPutsThisSitesPagesUnderTheSiteAddress(): void
+ {
+ $site = static function ($path) {
+ return 'https://app.test/index.php/'.$path;
+ };
+
+ $this->assertSame('https://example.com/x', Links::resolve('https://example.com/x', $site));
+ $this->assertSame('mailto:a@b.c', Links::resolve('mailto:a@b.c', $site));
+ $this->assertSame('https://app.test/index.php/page/about', Links::resolve('page/about', $site));
+ $this->assertSame('https://app.test/index.php/register', Links::resolve('/register', $site));
+ $this->assertSame('#top', Links::resolve('#top', $site));
+ $this->assertNull(Links::resolve('javascript:alert(1)', $site));
+ }
+
+ // ---- Html ----------------------------------------------------------
+
+ public function testNormalMarkupSurvives(): void
+ {
+ $this->assertSame('' +
+ '' +
+ '' + esc(label) + '' +
+ '' +
+ '' +
+ '' +
+ '' +
+ '' +
+ '
' +
+ '';
+
+ fields.forEach(function (f) {
+ html += fieldHtml(f, index, '');
+ });
+
+ return html + '
Hello big world
', Html::sanitize('Hello big world
')); + $this->assertSame('- a
- b
- a
- b
hi
'], + 'img onerror' => ['