Tilføjelse af brugerdefinerede sider til Bootstrap Admin-navigationen
Guide til tilpasning af menu

For at tilføje links til brugerdefinerede sider i Bootstrap Admin-panelets sidebar skal du oprette din side, knytte den til den primære router og derefter tilføje den til sidebar'en.


Sidebar'ens struktur

Sidebar'en består af kategorier, navs og links. Kategorierne er sidebar'ens hovedsektioner, navs er underafdelingerne af kategorierne, og links er de faktiske links til siderne.

Her er strukturen:

Sidebar structure

Link til brugerdefinerede sider i Bootstrap Admin-panelets sidebar

  1. Opret din(e) målfil(er) i admin/
    dvs.: admin/custom-page-one.php og admin/custom-page-two.php
  2. Opret nye router-regel(er) i admin/index.php der fører til din(e) nye side(r). dvs.:
    // add your custom page(s) to the router
    // the first parameter is the method (GET, POST, PUT, DELETE)
    // the second parameter is the path to the page
    // the third parameter is the name given to the route (any arbitrary name. It must be unique, without spaces, without special characters)
    $router->map('GET', '/custom-page-one', 'custom-page-one.php', 'custom-page-one');
    $router->map('GET', '/custom-page-two', 'custom-page-two.php', 'custom-page-two');
  3. Tilføj din(e) side(r) til sidebar'en

    Følgende kode opretter en ny kategori med navnet "My New Category" og tilføjer derefter et Nav objekt til kategorien og tilføjer til sidst links til Nav-objektet.

    Metoderne brugt i denne kode er følgende:

    • Sidebar::addCategory() - tilføjer en ny kategori til sidebar'en - /class/bootstrap/sidebar/Sidebar.php
    • SidebarCategories::addNav() - tilføjer et nyt Nav-objekt til kategorien - /class/bootstrap/sidebar/SidebarCategories.php
    • Nav::addLink() - tilføjer et nyt link til Nav-objektet - /class/bootstrap/sidebar/Nav.php
    1. åbn admin\inc\sidebar.php
    2. Tilføj følgende kode i slutningen af filen & tilpas efter ønske:
      
      // create an array with the pages that we'll add to the "My New Category" category
      // using the route names we gave in index.php => $router->map()
      $category_pages = array('custom-page-one', 'custom-page-two');
      
      /* ===================================
      =              Category              =
      ==================================== */
      
      $is_category_collapsed = true;
      
      // test if the active (current) page is in the $category_pages array using $match from the router
      // and expand the category accordingly
      if (isset($match['name']) && in_array($match['name'], $category_pages)) {
          $is_category_collapsed = false;
      }
      
      // add the category
      $sidebar->addCategory('new-category', 'New Category', '', '', true, $is_category_collapsed);
      
      /* ===================================
      =                 Nav                =
      ==================================== */
      
      // create a nav object inside the category. The nav object will contain the links
      // add nav into category - the 'newCategory' object is the sidebar's newly created category.
      // its name ('newCategory') is the lower-camelcase version of 'new-category'
      $sidebar->newCategory->addNav('new-nav', 'navbar-nav flex-column py-0');
      
      /* ===================================
      =                Links               =
      ==================================== */
      
      // first link
      
      $active = false;
      
      // check if the page is active and set the active variable to true
      if (isset($match['name']) && $match['name'] == 'custom-page-one') {
          $active = true;
      }
      
      // add the first link to the nav object
      $sidebar->newCategory->newNav->addLink(ADMIN_URL . 'custom-page-one', 'Custom page one', 'fas fa-circle-info', $active, 'class=nav-item', 'class=nav-link d-flex align-items-center');
      
      // second link
      
      $active = false;
      
      // check if the page is active and set the active variable to true
      if (isset($match['name']) && $match['name'] == 'custom-page-two') {
          $active = true;
      }
      
      // add the second link to the nav object
      $sidebar->newCategory->newNav->addLink(ADMIN_URL . 'custom-page-two', 'Custom page two', 'fas fa-users', $active, 'class=nav-item', 'class=nav-link d-flex align-items-center');
      
  4. Færdig.

PHP CRUD-tutorial hovedside