shimmie2/core/block.php

<?php

declare(strict_types=1);

/**
 * Class Block
 *
 * A basic chunk of a page.
 */
class Block
{
    /**
     * The block's title.
     */
    public ?string $header;

    /**
     * The content of the block.
     */
    public ?string $body;

    /**
     * Where the block should be placed. The default theme supports
     * "main" and "left", other themes can add their own areas.
     */
    public string $section;

    /**
     * How far down the section the block should appear, higher
     * numbers appear lower. The scale is 0-100 by convention,
     * though any number will work.
     */
    public int $position;

    /**
     * A unique ID for the block.
     */
    public string $id;

    /**
     * Should this block count as content for the sake of
     * the 404 handler
     */
    public bool $is_content = true;

    public function __construct(string $header=null, string|\MicroHTML\HTMLElement $body=null, string $section="main", int $position=50, string $id=null)
    {
        $this->header = $header;
        $this->body = (string)$body;
        $this->section = $section;
        $this->position = $position;

        if (is_null($id)) {
            $id = (empty($header) ? md5($body ?? '') : $header) . $section;
        }
        $str_id = preg_replace('/[^\w-]/', '', str_replace(' ', '_', $id));
        assert(is_string($str_id));
        $this->id = $str_id;
    }

    /**
     * Get the HTML for this block.
     */
    public function get_html(bool $hidable=false): string
    {
        $h = $this->header;
        $b = $this->body;
        $i = $this->id;
        $html = "<section id='$i'>";
        $h_toggler = $hidable ? " shm-toggler" : "";
        if (!empty($h)) {
            $html .= "<h3 data-toggle-sel='#$i' class='$h_toggler'>$h</h3>";
        }
        if (!empty($b)) {
            $html .= "<div class='blockbody'>$b</div>";
        }
        $html .= "</section>\n";
        return $html;
    }
}


/**
 * Class NavBlock
 *
 * A generic navigation block with a link to the main page.
 *
 * Used because "new NavBlock()" is easier than "new Block('Navigation', ..."
 *
 */
class NavBlock extends Block
{
    public function __construct()
    {
        parent::__construct("Navigation", "<a href='".make_link()."'>Index</a>", "left", 0);
    }
}