E.Noorlander/CodePress
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
CodePress/plugins/HTMLBlock
History
Edwin Noorlander e3a3cc5b6d Add sidebar toggle button to breadcrumb with open/close functionality 
Move sidebar toggle from sidebar panel to breadcrumb navigation, positioned
left of the HOME icon. Uses distinct icons for open (sidebar-inset) and
closed (sidebar) states. Sidebar state persists via sessionStorage. Remove
old non-functional toggle buttons from layout and HTMLBlock plugin.
2026-02-16 14:39:30 +01:00
..
HTMLBlock.php
Add sidebar toggle button to breadcrumb with open/close functionality
2026-02-16 14:39:30 +01:00
README.md
Fix guide template variable replacement and enhance documentation
2025-11-26 16:50:49 +01:00

README.md

HTMLBlock Plugin

Deze plugin toont een custom HTML blok in de sidebar met pagina-informatie en navigatie.

Functies

  • Pagina informatie: Toont huidige pagina titel en metadata
  • Bestandsinfo: Aanmaak- en wijzigingsdatums
  • Dynamische navigatie: Genereert quick links uit het menu
  • Interactive controls: Verversen en sidebar toggle
  • Responsive: Werkt op desktop en mobiel

Installatie

  1. Kopieer de HTMLBlock map naar plugins/
  2. De plugin wordt automatisch geladen

Gebruik

De plugin wordt automatisch in de sidebar geladen en toont:

Huidige Pagina Info

  • Pagina titel
  • Huidige taal
  • Homepage status

Bestandsinformatie

  • Aanmaakdatum
  • Laatste wijziging
  • Bestandsgrootte

Quick Navigation

  • Dynamische links uit het CMS menu
  • Automatische URL generatie

Interactive Controls

  • Ververs Content: Herlaadt de huidige pagina
  • Toggle Sidebar: Toont/verbergt de sidebar

Customization

De plugin content kan worden aangepast door de getSidebarContent() methode te wijzigen in HTMLBlock.php.

Voorbeeld Custom Content

public function getSidebarContent(): string
{
    $currentPage = $this->api ? $this->api->getCurrentPageTitle() : 'Onbekend';
    
    return '
        <div class="card">
            <div class="card-body">
                <h5>Mijn Custom Block</h5>
                <p>Huidige pagina: ' . htmlspecialchars($currentPage) . '</p>
            </div>
        </div>';
}

API Integration

De plugin maakt gebruik van de CMS API voor:

  • getCurrentPageTitle() - Huidige pagina titel
  • getCurrentLanguage() - Huidige taal
  • isHomepage() - Check of homepage
  • getCurrentPageFileInfo() - Bestandsinformatie
  • getMenu() - Menu structuur
  • createUrl($page, $lang) - URL generatie

Styling

De plugin gebruikt Bootstrap 5 classes:

  • card, card-header, card-body voor kaarten
  • btn, btn-outline-primary voor knoppen
  • list-unstyled voor navigatie

JavaScript

De plugin bevat JavaScript voor:

  • Pagina verversen
  • Sidebar toggle functionaliteit
  • Dynamische content updates

Development

De plugin is een goed voorbeeld voor:

  • API integratie
  • Dynamic content generatie
  • User interface components
  • Responsive design

Bestandsstructuur

HTMLBlock/
├── HTMLBlock.php    # Hoofd plugin bestand
└── README.md        # Deze documentatie