Create New Project

Prerequisite

Pastikan prerequisite di bagian instalasi sudah terpenuhi.

Struktur

Hasil project yang dibuat menggunakan FastPlaz secara default memiliki struktur direktori seperti berikut:

├── docs
├── public_html
└── source
    ├── api
    │   ├── controllers
    │   └── routes
    ├── app
    │   ├── controllers
    │   └── routes
    ├── common
    │   ├── controllers
    │   └── models
    └── sql

Disarankan memisahkan antara masing-masing controller, models maupun routes-nya.

Berikut ini adalah contoh struktur project dari aplikasi yang di generate menggunakan fitur Full Package Application

.
├── app
│   ├── build.sh
│   ├── clean.sh
│   ├── controllers
│   │   ├── app_controller.pas
│   │   ├── database_controller.pas
│   │   ├── example_controller.pas
│   │   └── example_form_controller.pas
│   ├── extra.cfg
│   ├── fastplaz.lpi
│   ├── fastplaz.lpr
│   ├── fastplaz.lps
│   └── routes
│       └── app_routes.pas
├── common
│   ├── controllers
│   └── models
│       ├── db_model.pas
│       └── warehouse_model.pas
└── sql
    └── db.sql

Terlihat pula penamaan file-nya yang seragam, dan mudah dibaca.

Penamaan

FastPlaz menyarankan standarisasi penamaan file-file unit di dalam project. Setiap nama file diawali dengan 'nama tugasnya', diikuti dengan fungsinya (_controller,_model,_route). Penamaan tugaspun sebaiknya disesuaikan dengan permalink yang akan digunakan.

Misal akan membuat controller untuk menangani url http://localhost/employee, maka nama file unit controller-nya menjadi employee_controller.pas.

Demikian juga untuk file model yang akan mengakses table employees, maka nama file unit model-nya adalah employee_model.pas.

url: http://localhost/employee
tabel: employees
file controller : employee_controller.pas
file model      : employee_model.pas

Wizard

Wizard ini merupakan salah satu fitur dari FastPlaz yang digunakan untuk memudahkan engineer dalam membuat aplikasi. Hanya dengan beberapa klik, fitur-fitur yang diinginkan telah terbentuk dengan otomatis.

Aplikasi Simple dan API

Membuat FastPlaz Project baru bisa dilakukan melalui menu File|New Project ....

Menu FastPlaz

Ada 2 pilihan:

  1. Simple Application Membuat aplikasi sederhan berbasis FastPlaz disertai dengan simple theme yang sudah disediakan. Menu ini membantu untuk para developer yang akan membuat custom project.
  2. API Application Membuat API (Application Programming Interface) akan semakin mudah melalui menu ini. Hasilnya akan di buat file-project disertai dengan contoh output JSON-nya.

Selanjutnya akan muncul dialog sepert ini: Menu FastPlaz

Isikan nama project sesuai kebutuhan Anda, dan juga webroot directory yang merupakan direktori tempat website tersebut dibaca oleh web server.

Pilih opsi generate structure jika Anda ingin dibuatkan struktur direktori aplikasi/api secara otomatis. Untuk pemula disarankan memilih opsi ini.

Jika Anda membuat API yang memerlukan parsing parameter di Header, isikan nama-nama variabel header yang akan digunakan. Pada API, biasanya memerlukan header seperti token, client-id, client-secret dan lain lain.

Full Package Application

Ingin membuat aplikasi yang lebih kompleks dan canggih? Ada akses ke database dan juga beberapa pilihan theme yang menarik? Silakan gunakan pilihan ini.

Menu FastPlaz

Kemudian isikan nama project dan target direktori tempat aplikasi akan dibuat.

Menu FastPlaz

Selanjutnya akan terbentuk direktori dan file seperti berikut Menu FastPlaz

Sudah disediakan theme siap pakai:

  1. Basic
  2. Simple
  3. Dashboard

Jika proses kompilasi berhasil, tampilan di browser akan indah seperti ini: Menu FastPlaz

Di template ini sudah disediakan contoh kode untuk

  1. Pengelolaan form, dengan security sederhana menggunakan CSRF. Method POST dan upload file.
  2. Akses view ke database. Untuk akses database menggunakan ajax (jsGrid) bisa dilihat dari repo Database Example.
  3. Membaca variabel dari query string.
  4. Penggunaan Session.
  5. Penggunaan layout modul kustom.
  6. Penggunaan global layout kustom untuk halaman Home.
  7. Pemanfaatan (assign) variabel di theme.
  8. Flash Messages

FastPlaz juga menyedikan beberapa variabel tag yang bisa digunakan di theme anda. Detil informasinya bisa dibaca di dokumen ini di bagian FTE - FastPlaz Theme Engine.

← Common FunctionController →