HAMU LOCAL PROJECTS PANEL, yerel geliştirme ortamında projeleri kolayca yönetebilmeniz için geliştirilmiş, modüler yapıya sahip ve genişletilebilir bir kontrol panelidir. Proje; çoklu dil desteği, dinamik veritabanı kontrolü, modül entegrasyonu, yerel dosya yöneticisi, mini SQL terminali gibi pek çok özelliği bünyesinde barındırır.
Gereksinimler
# 1) Repo
git clone https://github.com/huseyinavniuzun/hamu-local-projects-panel.git
cd hamu-local-projects-panel
# 2) (Varsa) bağımlılıklar
# composer install
# 3) (Otomatik oluşmuyorsa) config örneği
# cp .hamu/config.example.json .hamu/config.json
# 4) Lokal deneme (PHP built-in)
php -S localhost:8000 -t .
# 5) Tarayıcı
# http://localhost:8000lang.php ve lang_switcher.php üzerinden dil desteği. db_actions.php ile canlı SQL sorguları, autocomplete desteği. .hamu/css ve .hamu/js dizinleri üzerinden özelleştirme. - Detaylı kurulum: docs/INSTALL.md
Bu dokümantasyon, sistemin genel yapısını, klasör/dosya organizasyonunu, modül entegrasyon sürecini ve temel kullanım yönergelerini kapsamaktadır. Geliştiriciler ve kullanıcılar için sistemi daha iyi anlamaya yardımcı olmayı amaçlar.
Projenin ana dizini ve alt klasörlerinin yapısı aşağıdaki gibidir:
/ (Proje Kök Dizin)
│
├── index.php # Uygulamanın giriş noktası, ana kontrol paneli
│
└── .hamu/
│
├── h_header.php # Sayfa üst tag yapısı + CSS / Bootstrap vb
├── h_navbar.php # Navigasyon yapısı (özelleştirilebilir)
├── h_sidebar.php # Menü yapısı, responsive ve offcanvas mod
├── h_footer.php # Sayfa alt tag yapısı (result modal + settings modal)
├── config.json # Sistem ayarlarının tanımlandığı JSON dosyası
├── config.php # Ayarları yöneten PHP dosyası
├── database.php # Veritabanı bağlantı işlemleri
├── functions.php # Genel yardımcı fonksiyonlar
├── db_actions.php # SQL terminal işlevselliği, sorgu yardımı, otomatik tamamlama
├── lang.php # Çoklu dil desteği için dil dosyası
├── lang_switcher.php # Dil değiştirme arayüzü
├── about.php # Geliştirici ve uygulama bilgisi
├── readme.php # Markdown okuma sayfası
├── cache/
│ └── cache_autocomplete.json # Autocomplete cache dosyası
├── logs/
│ └── db_terminal.log # SQL terminal log dosyası
├── css/
│ └── custom.css # Özel stil dosyası
├── js/
│ ├── general.js # Genel JavaScript işlevleri
│ ├── dbactions.js # SQL terminali ve veritabanı etkileşimleri
│ └── extra.js # Ekstra sayfa ve modül scriptleri
├── images/
│ ├── favicon/ # Favicon dosyaları
│ └── manifest.json # Uygulama manifest dosyası
└── modules/
├── file_manager.php # Responsive dosya yöneticisi (örnek modül)
└── (Diğer modül dosyaları)
# Örneğin: modul_example.php
# Bu dosyalarda yer alan "$page_title" tanımı, index.php üzerinde modül listesinde gösterilir.
# Translate(lang) desteği ile dil dosyasındaki gibi gösterir, yoksa yazıldığı gibi.Yeni modüller, .hamu/modules/ dizinine eklenir ve aşağıdaki kriterlere uymalıdır:
$page_title tanımı yapılmalıdır:<?php
$md_file = "modul.md"; // Markdown dosyası (opsiyonel)
$page_title = "Modül Başlığı"; // Modülün gösterilecek başlığı
$body_class = ""; // Body etiketi için CSS sınıfları
$include_db = 0; // Veritabanı bağlantısı (0=hayır, 1=evet)
$menu_type = 1; // Menü gösterimi (0=mobil, 1=tüm ekranlar)
require_once $_SERVER['DOCUMENT_ROOT'].'/.hamu/h_header.php';
require_once $_SERVER['DOCUMENT_ROOT'].'/.hamu/h_navbar.php';
?>
<h1>Modül İçeriği</h1>
<?php echo markdown($md_file); ?> <!-- Opsiyonel -->
<?php translate('yazı'); ?> <!-- Dil çeviri opsiyonel -->
<?php require_once $_SERVER['DOCUMENT_ROOT'].'/.hamu/h_footer.php'; ?>Sistem otomatik olarak yeni modülleri algılar ve kullanıcı arayüzünde listeler.
SQL terminalinde sorgularınızı yazıp çalıştırabilirsiniz:
config.json üzerinden yapılandırılır.feature/... veya fix/.... Ayrıntılı kurallar için CONTRIBUTING.md dosyasına bakın.
Bu proje, açık kaynak kodlu olup MIT Lisansı ile dağıtılmaktadır.
Responsive File Manager da MIT lisansı ile kullanılmaktadır.
Bu proje içinde Responsive File Manager kullanılmaktadır ve aşağıdaki lisans koşullarına tabidir:
Bu lisansa göre:
LICENSE dosyasını ve ilgili dosyalardaki telif hakkı bilgilerini silmemeniz gerekmektedir.pdo, json, mbstring, curl- Genişletilebilirlik:
Sistem, modüler yapısı sayesinde ek modüller ile kolayca genişletilebilir. Geliştiricilerin kullanabileceği örnek modül dosyaları ve API dokümantasyonunun hazırlanması önerilir.
.hamu/, logs/ ve config.json kesinlikle public erişime açık olmamalıdır..htaccess: HAMU LOCAL PROJECTS PANEL, kapsamlı ve modüler bir yapı ile kullanıcı ve geliştiricilere yerel projelerini etkin biçimde yönetmeleri için güçlü araçlar sağlar.