Breadcrumb.php

<?php

/**
 * Generates and renders a breadcrumb based on the current url segments
 *
 * @copyright  2021 Podlibre
 * @license    https://www.gnu.org/licenses/agpl-3.0.en.html AGPL3
 * @link       https://castopod.org/
 */

namespace App\Libraries;

class Breadcrumb
{
    /**
     * List of breadcrumb links.
     *
     * @var array
     * $links = [
     *  'text' => (string) the anchor text,
     *  'href' => (string) the anchor href,
     * ]
     */
    protected $links = [];

    /**
     * Initializes the Breadcrumb object using the segments from
     * current_url by populating the $links property with text and href data
     */
    public function __construct()
    {
        $uri = '';
        foreach (current_url(true)->getSegments() as $segment) {
            $uri .= '/' . $segment;
            array_push($this->links, [
                'text' => is_numeric($segment)
                    ? $segment
                    : lang('Breadcrumb.' . $segment),
                'href' => base_url($uri),
            ]);
        }
    }

    /**
     * Replaces all numeric text in breadcrumb's $link property
     * with new params at same position
     *
     * Given a breadcrumb with numeric params, this function
     * replaces them with the values provided in $newParams
     *
     * Example with `Home / podcasts / 1 / episodes / 1`
     *
     * $newParams = [
     *  0 => 'foo',
     *  1 => 'bar'
     * ]
     * replaceParams($newParams);
     *
     * The breadcrumb is now `Home / podcasts / foo / episodes / bar`
     *
     * @param array $newParams
     */
    public function replaceParams($newParams)
    {
        foreach ($this->links as $key => $link) {
            if (is_numeric($link['text'])) {
                $this->links[$key]['text'] = $newParams[0];
                array_shift($newParams);
            }
        }
    }

    /**
     * Renders the breadcrumb object as an accessible html breadcrumb nav
     *
     * @return string
     */
    public function render($class = null)
    {
        $listItems = '';
        $keys = array_keys($this->links);
        foreach ($this->links as $key => $link) {
            if (end($keys) == $key) {
                $listItem =
                    '<li class="breadcrumb-item active" aria-current="page">' .
                    $link['text'] .
                    '</li>';
            } else {
                $listItem =
                    '<li class="breadcrumb-item">' .
                    anchor($link['href'], $link['text']) .
                    '</li>';
            }

            $listItems .= $listItem;
        }

        return '<nav aria-label="' .
            lang('Breadcrumb.label') .
            '"><ol class="breadcrumb ' .
            $class .
            '">' .
            $listItems .
            '</ol></nav>';
    }
}