📚 KablaM! Framework Documentation

Complete installation guide and configuration reference

Home Dashboard About Framework Developer

Quick Installation

Prerequisites

Automatic Installation

# Clone or download KablaM! framework
cd /var/www/kablam

# Install dependencies
composer install

# Run the installation script
php install/install.php

Manual Installation

1. Database Setup

# Create database and import schema
mysql -u root -p < install/schema.sql

# Seed initial data
mysql -u root -p < install/seed.sql

2. Configuration

Update config/cms.json with your database credentials:

{
  "database": {
    "host": "localhost",
    "database": "kablam",
    "username": "your_username",
    "password": "your_password",
    "charset": "utf8mb4"
  },
  "stores": {
    "default": {
      "name": "Default Store",
      "database": {
        "host": "localhost",
        "database": "kablam",
        "username": "your_username",
        "password": "your_password",
        "charset": "utf8mb4"
      }
    }
  }
}

3. File Permissions

chmod -R 755 storage/
chmod -R 644 config/

4. Start Development Server

php -S localhost:8000 -t public public/router.php

Default Admin Credentials

After installation, use these Admin credentials to access the dashboard:

⚠️ Important: Change the default password immediately after first login! Create additional accounts with appropriate roles: User (standard operations), Viewer (read-only monitoring), or Developer (debugging access).

Dashboard System

After login, access the comprehensive dashboard at http://localhost:8000/dashboard (or your staging/production domain)

Dashboard Features (Role-Based Access)

User Roles

Theme System

KablaM! includes multiple themes:

Static Pages

Static HTML pages are stored in pages/ directory:

Default Roles

Role ID Description Permissions
Admin 1 Full system administrator All configuration, management, and monitoring features
User 2 Standard user access Basic operations, theme management, monitoring dashboards
Viewer 3 Read-only access Monitoring dashboards, logs, and performance analytics only
Developer 4 Developer with debugging capabilities CMS management, system diagnostics, and debugging tools

WordPress Integration

KablaM! can orchestrate WordPress installations:

  1. Install WordPress in /var/www/wordpress
  2. Update config/cms.json:
{
  "stores": {
    "default": {
      "cms": {
        "wordpress": {
          "enabled": true,
          "path": "/var/www/wordpress",
          "url": "http://localhost:8000",
          "database": "wordpress_db"
        }
      }
    }
  }
}
⚠️ Important: For production deployment, update the url field to match your staging/production domain:

This URL is critical for proper WordPress asset routing and functionality.

Directory Structure

kablam/
├── config/           # Configuration files (cms.json)
├── database/         # Database migrations
├── install/          # Installation scripts
├── pages/            # Static HTML pages
├── public/           # Web root
├── src/              # Framework source code
├── storage/          # Logs, cache, uploads, sessions
├── themes/           # KablaM themes (akira, ceauxvij)
└── vendor/           # Composer dependencies

Troubleshooting

Common Issues

Database Connection Failed

Permission Denied Errors

sudo chown -R www-data:www-data storage/
sudo chmod -R 755 storage/

Session Issues

Debug Mode

Enable debug mode in config/cms.json:

{
  "debug": true,
  "app": {
    "name": "KablaM! Framework",
    "timezone": "UTC"
  }
}

Log Files

Next Steps

  1. Change Default Password - Login and update admin password
  2. Explore Dashboard - Visit http://localhost:8000/dashboard (or your staging/production domain) to configure system
  3. Configure WordPress - Set up WordPress integration via CMS Manager
  4. Customize Theme - Use Theme Manager or create custom themes in themes/
  5. Configure Security - Set up middleware and security settings
  6. Set up SSL - Configure HTTPS for production
  7. Configure Email - Set up SMTP for notifications
  8. Backup Strategy - Implement database and file backups

Security Checklist

Support