#!/usr/bin/env bash set -Eeuo pipefail # Usage: # ./install-adminlte-scaffold-tools-v2.sh ["App Name"] ["target-dir"] # # Works on: # - macOS (Darwin, BSD sed) # - Linux (GNU sed) APP_NAME="${1:-Admin Portal}" BASE_DIR="${2:-admin}" echo "Installing AdminLTE PHP scaffold (tools v2) in: ${BASE_DIR}" mkdir -p \ "${BASE_DIR}/includes" \ "${BASE_DIR}/assets/css" \ "${BASE_DIR}/assets/js" # ---------- Helper: portable in-place sed ---------- sed_inplace() { local expr="$1" local file="$2" sed -i.bak "${expr}" "${file}" rm -f "${file}.bak" } # --------------------------------------------------- cat > "${BASE_DIR}/admin.index.php" <<'PHP' <?= htmlspecialchars($pageTitle, ENT_QUOTES, 'UTF-8') ?> | Admin

  1. Home
PHP cat > "${BASE_DIR}/includes/navbar.php" <<'PHP'
PHP cat > "${BASE_DIR}/includes/sidebar.php" <<'PHP'
Admin Portal
PHP cat > "${BASE_DIR}/includes/content.php" <<'PHP'

150

New Orders

More info

53%

Bounce Rate

More info

44

User Registrations

More info

65

Unique Visitors

More info

System Status

Use the Admin menu in the sidebar to run tests, audits, UI tweaks, and utility checks.

PHP cat > "${BASE_DIR}/includes/footer.php" <<'PHP' Copyright © Your Company. All rights reserved.
AdminLTE PHP Scaffold
PHP cat > "${BASE_DIR}/includes/modal.php" <<'PHP'
PHP cat > "${BASE_DIR}/includes/toast.php" <<'PHP'
Notification
PHP cat > "${BASE_DIR}/includes/debugwin.php" <<'PHP'
Debug Window
Request method:
Request URI:
PHP version:
GET data
POST data
Session data
PHP cat > "${BASE_DIR}/assets/css/custom.css" <<'CSS' .app-content { min-height: calc(100vh - 130px); } .debug-output { max-height: 180px; overflow: auto; padding: 0.75rem; border-radius: 0.375rem; background: #212529; color: #d1e7dd; font-size: 0.8rem; white-space: pre-wrap; } .small-box .small-box-icon { font-size: 4rem; opacity: 0.25; } /* Debug layout: colored borders around sections */ .debug-layout-border#layout-navbar { outline: 3px solid #e74c3c; /* red */ outline-offset: -3px; } .debug-layout-border#layout-sidebar { outline: 3px solid #3498db; /* blue */ outline-offset: -3px; } .debug-layout-border#layout-header { outline: 3px solid #2ecc71; /* green */ outline-offset: -3px; } .debug-layout-border#layout-content { outline: 3px solid #f39c12; /* orange */ outline-offset: -3px; } .debug-layout-border#layout-footer { outline: 3px solid #9b59b6; /* purple */ outline-offset: -3px; } CSS cat > "${BASE_DIR}/assets/js/admin-tools.js" <<'JS' /** * Admin tools – modular JS for testing, audit, UI, and utilities. * * Exposes: * window.initAdminTools() */ (function () { 'use strict'; const layoutIds = [ 'layout-navbar', 'layout-sidebar', 'layout-header', 'layout-content', 'layout-footer' ]; function showAuditMessage(title, lines) { const toastEl = document.getElementById('liveToast'); if (!toastEl) return; const header = toastEl.querySelector('.toast-header'); const body = toastEl.querySelector('.toast-body'); if (!header || !body) return; header.innerHTML = '' + '' + title + '' + ''; body.innerHTML = lines.join('
'); const toast = bootstrap.Toast.getOrCreateInstance(toastEl, { delay: 6000 }); toast.show(); } function checkSessionStatus() { // Basic session checks using what PHP exposes via the page. // If you want more detail, you can add a small JSON endpoint later. const hasSessionCookie = (document.cookie && document.cookie.length > 0); const statusLine = hasSessionCookie ? 'Session cookie: present' : 'Session cookie: not detected'; showAuditMessage('Session Status', [ statusLine, 'If tests fail, ensure the session directory exists and is writable.' ]); } function checkLayoutIntegrity() { const missing = []; layoutIds.forEach(function (id) { if (!document.getElementById(id)) { missing.push(id); } }); if (missing.length === 0) { showAuditMessage('Layout Integrity', ['All required layout sections are present.']); } else { showAuditMessage('Layout Integrity', [ 'Missing layout sections:', missing.join(', ') ]); } } function showPhpInfoBasic() { const lines = [ 'User agent: ' + navigator.userAgent, 'Language: ' + navigator.language, 'Platform: ' + navigator.platform, 'Cookies enabled: ' + navigator.cookieEnabled, 'Online: ' + navigator.onLine ]; showAuditMessage('PHP Info (basic)', lines); } function showEnvCheck() { const lines = [ 'Bootstrap Toast: ' + (typeof bootstrap !== 'undefined' ? 'yes' : 'no'), 'jQuery: ' + (typeof jQuery !== 'undefined' ? 'yes' : 'no'), 'Admin tools loaded: yes' ]; showAuditMessage('Environment Check', lines); } function clearAllHighlights() { // Remove border highlights layoutIds.forEach(function (id) { const el = document.getElementById(id); if (el) { el.classList.remove('debug-layout-border'); } }); // Reset any inline display toggles we applied via visibility buttons layoutIds.forEach(function (id) { const el = document.getElementById(id); if (el) { el.style.display = ''; } }); } function initAdminTools() { // Trigger toast test const toastBtn = document.getElementById('test-toast-btn'); if (toastBtn) { toastBtn.addEventListener('click', function (e) { e.preventDefault(); const toastEl = document.getElementById('liveToast'); if (!toastEl) return; const header = toastEl.querySelector('.toast-header'); const body = toastEl.querySelector('.toast-body'); if (header && body) { header.innerHTML = '' + 'Test Toast' + ''; body.textContent = 'This is a test toast message triggered from the sidebar.'; } const toast = bootstrap.Toast.getOrCreateInstance(toastEl, { delay: 2500 }); toast.show(); }); } // Audit: session status const sessionBtn = document.getElementById('audit-session-btn'); if (sessionBtn) { sessionBtn.addEventListener('click', function (e) { e.preventDefault(); checkSessionStatus(); }); } // Audit: layout integrity const layoutBtn = document.getElementById('audit-layout-btn'); if (layoutBtn) { layoutBtn.addEventListener('click', function (e) { e.preventDefault(); checkLayoutIntegrity(); }); } // UI: toggle borders let bordersOn = false; const bordersBtn = document.getElementById('toggle-borders-btn'); if (bordersBtn) { bordersBtn.addEventListener('click', function (e) { e.preventDefault(); bordersOn = !bordersOn; layoutIds.forEach(function (id) { const el = document.getElementById(id); if (el) { el.classList.toggle('debug-layout-border', bordersOn); } }); }); } // UI: clear all highlights const clearBtn = document.getElementById('clear-highlights-btn'); if (clearBtn) { clearBtn.addEventListener('click', function (e) { e.preventDefault(); clearAllHighlights(); }); } // UI: toggle visibility helpers function toggleVisibility(id) { const el = document.getElementById(id); if (!el) return; const visible = getComputedStyle(el).display !== 'none'; el.style.display = visible ? 'none' : ''; } const visMap = { 'toggle-navbar-vis-btn': 'layout-navbar', 'toggle-sidebar-vis-btn': 'layout-sidebar', 'toggle-header-vis-btn': 'layout-header', 'toggle-content-vis-btn': 'layout-content', 'toggle-footer-vis-btn': 'layout-footer' }; Object.keys(visMap).forEach(function (btnId) { const btn = document.getElementById(btnId); if (!btn) return; btn.addEventListener('click', function (e) { e.preventDefault(); toggleVisibility(visMap[btnId]); }); }); // Functions: PHP info basic const phpInfoBtn = document.getElementById('util-php-info-btn'); if (phpInfoBtn) { phpInfoBtn.addEventListener('click', function (e) { e.preventDefault(); showPhpInfoBasic(); }); } // Functions: env check const envBtn = document.getElementById('util-env-check-btn'); if (envBtn) { envBtn.addEventListener('click', function (e) { e.preventDefault(); showEnvCheck(); }); } // Testing: spinner const spinnerBtn = document.getElementById('test-spinner-btn'); const spinnerOverlay = document.getElementById('spinnerOverlay'); if (spinnerBtn && spinnerOverlay) { spinnerBtn.addEventListener('click', function (e) { e.preventDefault(); spinnerOverlay.style.display = 'flex'; spinnerOverlay.setAttribute('aria-hidden', 'false'); // Auto-hide after 2 seconds setTimeout(function () { spinnerOverlay.style.display = 'none'; spinnerOverlay.setAttribute('aria-hidden', 'true'); }, 2000); }); } } // Expose initializer window.initAdminTools = initAdminTools; })(); JS cat > "${BASE_DIR}/index.php" <<'PHP' "${BASE_DIR}/README.md" <<'EOF' # AdminLTE PHP Scaffold (Tools v2) - `admin.index.php` – locked semantic HTML scaffold (do not edit per app). - `includes/*` – fragments only (navbar, sidebar, content, footer, modal, toast, debugwin). - `assets/js/admin-tools.js` – modular JS for: - Testing (toast, modal, debug window, spinner) - Audit (session status, layout integrity) - UI (borders, clear highlights, visibility toggles) - Functions (basic PHP info, environment check) ## Sidebar organization Under **Admin**: - **Testing** - Trigger Toast - Open Modal - Toggle Debug Window - Test Spinner - **Audit** - Session Status - Layout Integrity - **UI** - Toggle Section Borders - Clear All Highlights - Toggle visibility of navbar, sidebar, header, content, footer - **Functions** - PHP Info (basic) - Environment Check ## Notes - Session path is set in `admin.index.php` and `index.php`: ```php ini_set('session.save_path', '/Users/rbutare/websites/system/tmp/sessions'); ``` Ensure this directory exists and is writable. ## Run locally ```bash php -S localhost:8000 -t . ``` Then open: http://localhost:8000 EOF chmod -R u+rwX,go+rX "${BASE_DIR}" echo echo "Installation complete." echo echo "Created:" find "${BASE_DIR}" -type f | sort echo echo "Start the PHP development server with:" echo " cd ${BASE_DIR}" echo " php -S localhost:8000" echo echo "Then open: http://localhost:8000"