1. Ringkasan

Manual ini untuk memasang sistem MYTAMAN pada taman baharu menggunakan cPanel.

Keperluan:

Fail Diperlukan:

📦 MYTAMAN-TEMPLATE/
├── 📄 mytaman-template.sql        (database kosong)
├── 📦 mytaman-v2.zip              (fail sistem)
└── 📄 INSTALL.html                (fail ini)

2. Langkah Pemasangan

1. Login ke cPanel
2. Cari MySQL Databases
3. Buat database baharu:
   • Nama DB: tamanABC_db
   • Klik Create Database
4. Buat user database:
   • Nama User: tamanABC_user
   • Password: (jana kuat — min 12 aksara)
   • Klik Create User
5. Tambah user ke database:
   • User: tamanABC_user
   • Database: tamanABC_db
   • ALL PRIVILEGES ✅
   • Klik Make Changes

1. cPanel → File Manager
2. Masuk ke public_html/
3. Klik Upload → Upload fail mytaman-v2.zip
4. Setelah upload selesai, klik kanan fail → Extract
5. Rename folder hasil extract kepada: tamanABC

Struktur Folder:

public_html/
└── tamanABC/
    ├── app/
    ├── public/
    │   └── index.php
    ├── system/
    ├── vendor/
    ├── writable/
    ├── .env
    └── ...

1. cPanel → phpMyAdmin
2. Kiri: klik tamanABC_db
3. Kanan: tab Import
4. Choose File → pilih mytaman-template.sql
5. Klik Go

Semak 17 Table:

ahli_keluarga, ahli_khairat, aktiviti, bantuan_kebajikan,
ci_sessions, kematian, kewangan, log_aktiviti, pendaftaran,
penduduk, pengumuman, peserta_aktiviti, sumbangan_kematian,
tabung_khairat, tetapan, tugasan_khairat, users, yuran

1. cPanel → File Manager → public_html/tamanABC/
2. Klik kanan .env → Edit
3. Ganti nilai berikut:

# APP
CI_ENVIRONMENT = production
app.baseURL = 'https://domainanda.com/tamanABC/'
app.indexPage = ''
app.appTimezone = 'Asia/Kuala_Lumpur'
app.defaultLocale = 'ms'

# DATABASE
database.default.hostname = localhost
database.default.database = tamanABC_db
database.default.username = tamanABC_user
database.default.password = "passwordUserAnda"
database.default.DBDriver = MySQLi
database.default.port = 3306
database.default.charset = utf8mb4
database.default.DBCollat = utf8mb4_general_ci
database.default.foreignKeys = true

# SESSION
session.driver = 'CodeIgniter\Session\Handlers\DatabaseHandler'
session.savePath = 'ci_sessions'
session.cookieName = 'tamanABC_session'

# ENCRYPTION (jana - Langkah 5)
encryption.key = ''

Cara A: Guna Terminal (kalau ada)

cd ~/public_html/tamanABC
php spark key:generate

Cara B: Guna Skrip PHP (kalau tiada Terminal)

1. Buat fail public_html/tamanABC/public/genkey.php:

<?php
$key = 'base64:' . base64_encode(random_bytes(32));
echo "encryption.key = '" . $key . "'";

2. Buka browser: https://domainanda.com/tamanABC/genkey.php
3. Salin output
4. Edit .env → ganti encryption.key = ''
5. PADAM genkey.php SERTA-MERTA

1. cPanel → File Manager → public_html/tamanABC/

1. Buka: https://domainanda.com/tamanABC/
2. Klik Log Masuk Petugas
3. Login:
   • Username: admin
   • Password: Admin@123

1. Buat fail public_html/tamanABC/public/genhash.php:

<?php
echo password_hash('PasswordBaruAnda@2026', PASSWORD_DEFAULT);

2. Buka: https://domainanda.com/tamanABC/genhash.php
3. Salin hash output
4. Buka phpMyAdmin → tamanABC_db → tab SQL

UPDATE users 
SET password_hash = 'HASH_YANG_ANDA_SALIN' 
WHERE username = 'admin';

5. PADAM genhash.php SERTA-MERTA
6. Login semula dengan password baharu

1. Login admin
2. Sidebar → Tetapan
3. Isi SEMUA medan berikut:

🏘️ Identiti Taman

🔢 Penomboran Ahli

💰 Kadar Yuran Bulanan

🏦 Maklumat Bank

4. Klik Simpan Tetapan

Fail template ada 8 ahli khairat contoh. Ganti dengan AJK sebenar taman anda.

1. Sidebar → Khairat
2. Edit atau padam ahli contoh
3. Tambah AJK sebenar:
   • Pengerusi
   • Timbalan
   • Setiausaha
   • Bendahari
   • AJK (2-3 orang)
   • Anggota (2-3 orang)

3. Test Penuh

Selepas siap konfigurasi, ujian asas:

4. Keselamatan

Semak Akses Fail Sensitif

Selepas setup, uji URL berikut patut pulangkan 403 atau 404:

Backup Automatik

1. cPanel → Backup Wizard
2. Set:
   • Home Directory: Weekly
   • MySQL Databases: Daily
   • Email Configurations: Weekly

5. Masalah Lazim

Error "Cannot connect to database"

• Semak credential .env
• Semak DB wujud dalam cPanel
• Semak user mempunyai akses ke DB

Error "Unknown column 'updated_at'"

Jalankan SQL:

ALTER TABLE nama_table
  ADD COLUMN `updated_at` DATETIME DEFAULT CURRENT_TIMESTAMP 
  ON UPDATE CURRENT_TIMESTAMP AFTER `created_at`;

Error "Session: Database table not found"

• Semak table ci_sessions wujud
• Semak kolum betul

Penduduk tak boleh login

• Semak user wujud dalam table users dengan role = 'penduduk'
• Semak user ada penduduk_id yang betul
• Reset password di admin

Fail upload tidak berjaya

• Semak permission folder uploads/penduduk/ (755 atau 775)
• Semak saiz fail < 2MB
• Semak PHP upload_max_filesize di cPanel

6. Cheat Sheet (Cara Cepat)

1. cPanel → MySQL Databases → Buat DB + User
2. Upload mytaman-v2.zip → Extract → Rename
3. phpMyAdmin → Import mytaman-template.sql
4. Edit .env → DB credential + baseURL
5. Jana encryption.key
6. Set permission writable/ + uploads/ (755)
7. Login admin / Admin@123
8. Tukar password admin
9. Tetapan → Isi maklumat taman
10. Ganti 8 ahli khairat contoh
11. Test: tambah penduduk, yuran, kematian
12. Backup cPanel

SIAP! ✅

© 2026 MyTAMAN
Dibangunkan oleh Ramlan
https://exsttj8990.com/ramlan/v2/