HackMD Dark Theme

--- title: HackMD Dark Theme tags: theme description: Use `{%hackmd theme-dark %}` syntax to include this theme. --- <style> html, body, .ui-content { background-color: #333; color: #ddd; } .markdown-body h1, .markdown-body h2, .markdown-body h3, .markdown-body h4, .markdown-body h5, .markdown-body h6 { color: #ddd; } .markdown-body h1, .markdown-body h2 { border-bottom-color: #ffffff69; } .markdown-body h1 .octicon-link, .markdown-body h2 .octicon-link, .markdown-body h3 .octicon-link, .markdown-body h4 .octicon-link, .markdown-body h5 .octicon-link, .markdown-body h6 .octicon-link { color: #fff; } .markdown-body img { background-color: transparent; } .ui-toc-dropdown .nav>.active:focus>a, .ui-toc-dropdown .nav>.active:hover>a, .ui-toc-dropdown .nav>.active>a { color: white; border-left: 2px solid white; } .expand-toggle:hover, .expand-toggle:focus, .back-to-top:hover, .back-to-top:focus, .go-to-bottom:hover, .go-to-bottom:focus { color: white; } .ui-toc-dropdown { background-color: #333; } .ui-toc-label.btn { background-color: #191919; color: white; } .ui-toc-dropdown .nav>li>a:focus, .ui-toc-dropdown .nav>li>a:hover { color: white; border-left: 1px solid white; } .markdown-body blockquote { color: #bcbcbc; } .markdown-body table tr { background-color: #5f5f5f; } .markdown-body table tr:nth-child(2n) { background-color: #4f4f4f; } .markdown-body code, .markdown-body tt { color: #eee; background-color: rgba(230, 230, 230, 0.36); } a, .open-files-container li.selected a { color: #5EB7E0; } </style> # GameShark UII CPL #### baca ini dlu !!! https://blog.javan.co.id/skinny-controller-2145a059ea47 ## Konvensi ### Penamaan Global Pastikan penamaannya konsisten. Konsisten, bukan tentang bahasa Inggris semua atau bahasa Indonesia semua, tapi lebih ke konsistensi pemakaian istilah. Konsisten, bukan hanya di level dokumen teknis, tapi di seluruh lingkup proyek. Ketika ketemu User membahas kasi, lalu di dokumen analisis dituliskan Kepasa Seksi, jangan tiba-tiba berubah menjadi head_of_section atau section_chief di rancangan database. Pakai saja istilah aslinya, kasi. Lumayan mengurangi overhead otak untuk melakukan translation dan dictionary lookup. ### Controller #### Penamaan Penamaan controller untuk resource tertentu menggunakan konvensi `SingularController`, maksudnya jika nama resource nya `category`, maka nama controller menjadi `CategoryController`. #### Daftar Method Daftar nama method yang boleh pada sebuah controller hanya - index **[GET]** > List data dari resource. - create **[GET]** > Menampilkan halaman create resource pada pengguna - store **[POST]** > Melakukan proses penyimpanan resource - show **[GET]** > Menampilkan detail dari resource tertentu - edit **[GET]** > Menampilkan halaman edit resource pada pengguna - update **[POST]** > Melakukan proses pembaruan resource - destroy **[POST]** > Melakukan proses penghapusan resource Selebihnya, jika terdapat resource yang tidak terkover pada method tersebut, usahakan tetap menggunakan method tersebut. Namun, jika tidak bisa, maka boleh menggunakan nama method lain, asalkan masih masuk akal. ### Model #### Penamaan Penamaan model untuk resource tertentu menggunakan konvensi `SingularModel`, maksudnya jika nama resource nya `Category`, maka nama model menjadi `CategoryModel`. ### Seeder #### Penamaan Penamaan seeder untuk resource tertentu menggunakan konvensi `PluralTableSeeder`, maksudnya jika nama resourcenya `User`, maka nama seeder menjadi `UsersTableSeeder`. ## How To ### Membuat migration Membuat migration dapat dilakukan melalui perintah : ``` $ php artisan make:migration <snake_case_migration_name> ``` Hasil migration dengan command ini dapat dilihat di folder `database/migrations`. Untuk membuat migration pada module yang telah dibuat, dapat dilakukan melalui perintah : ``` $ php artisan module:make-migration <snake_case_migration_name> <ModuleName> ``` Hasil migration dapat dilihat pada folder `src/<ModuleName>/Database/Migrations`. Contoh file migration yang telah dibuat seperti di bawah ini. ``` <?php use Illuminate\Support\Facades\Schema; use Illuminate\Database\Schema\Blueprint; use Illuminate\Database\Migrations\Migration; class CreatePagesTable extends Migration { /** * Run the migrations. * * @return void */ public function up() { Schema::create('examples', function (Blueprint $table) { // Column dengan type bigIncrements akan otomatis menjadi primary key $table->bigIncrements('id'); // Column unique. $table->string('slug')->unique(); // Column nullable. $table->string('title')->nullable(); // Column dengan default value ketika null. $table->boolean('deleted')->default(0); // Column yang nantinya akan dijadikan foreign key menggunakan type unsignedBigInteger. $table->unsignedBigInteger('example_foreign_id'); // Column untuk membuat created_at dan updated_at. $table->timestamps(); }); Schema::table('examples', function (Blueprint $table) { // Contoh pembuatan foreign column. $table->foreign('example_foreign_id') ->references('id')->on('example_parents') ->onDelete('cascade'); }); } /** * Reverse the migrations. * * @return void */ public function down() { Schema::dropIfExists('examples'); } } ``` ### Membuat Model Membuat model dapat dilakukan melalui perintah : ``` $ php artisan make:model <CamelCaseModelName> ``` Hasil model dengan command ini dapat dilihat di folder `app`. Untuk membuat model pada module yang telah dibuat, dapat dilakukan melalui perintah : ``` $ php artisan module:make-model <CamelCaseModelName> <ModuleName> ``` Hasil model dapat dilihat pada folder `src/<ModuleName>/Models`. Contoh file model yang telah dibuat seperti di bawah ini. ``` <?php namespace Modules\Category\Models; use Sofa\Eloquence\Eloquence; use Laravolt\Suitable\AutoSort; use Laravolt\Suitable\AutoFilter; use Illuminate\Database\Eloquent\Model; class Category extends Model { use AutoSort, AutoFilter; use Eloquence; // Nama tabel. protected $table = 'examples'; protected $guarded = []; // Kolom yang dapat dicari. protected $searchableColumns = ['title']; // Mengatur kolom mana saja yang dapat diisi melalui input. protected $fillable = [ 'title', 'example_foreign_id' ]; } ``` ### Membuat Seeder Membuat seeder dapat dilakukan melalui perintah : ``` $ php artisan make:seeder <CamelCaseSeeder> ``` Hasil seeder dengan command ini dapat dilihat di folder `database/seeds`. Untuk membuat seeder pada module yang telah dibuat, dapat dilakukan melalui perintah : ``` $ php artisan module:make-seed <CamelCaseSeeder> <ModuleName> ``` Hasil seeder dapat dilihat pada folder `src/<ModuleName>/Database/Seeders`. ### Membuat Controller #### Controller Biasa Membuat controller dapat dilakukan melalui perintah : ``` $ php artisan make:controller <CamelCaseController> ``` Hasil controller dengan command ini dapat dilihat di folder `app/Http/Controllers`. Untuk membuat controller pada module yang telah dibuat, dapat dilakukan melalui perintah : ``` $ php artisan module:make-controller <CamelCaseController> <ModuleName> ``` Hasil controller dapat dilihat pada folder `src/<ModuleName>/Http/Controllers`. Contoh file controller dapat dilihat di bawah ini. ``` <?php namespace Modules\Klpd\Http\Controllers; use Modules\Klpd\Models\Klpd; use Illuminate\Routing\Controller; use Modules\Klpd\Http\Requests\Store; use Modules\Klpd\Http\Requests\Update; use Modules\Klpd\TableView\IndexTableView; class KlpdController extends Controller { public function index() { $items = Klpd::orderBy('created_at')->get(); return view('klpd.index'); } public function create() { return view('klpd.create'); } public function store(Store $request) { Klpd::create($request->all()); return redirect()->route('klpd.index')->withSuccess('Klpd saved'); } public function show(Klpd $klpd) { return view('klpd::show', compact('klpd')); } public function edit(Klpd $klpd) { return view('klpd.edit', compact('klpd')); } public function update(Update $request, Klpd $klpd) { $klpd->update($request->all()); return redirect()->back()->withSuccess('Klpd saved'); } public function destroy(Klpd $klpd) { $klpd->delete(); return redirect()->route('klpd.index')->withSuccess('Klpd deleted'); } } ``` ### Membuat Paginasi Ketika ingin menampilkan list data dari database, maka data tersebut **HARUS** dilakukan paginasi (di limit), sehingga setiap kali pengguna mengakses sistem, tidak akan memberatkan server. Untuk membuat paginasi, Anda bisa menggunakan kode`->paginate(10)` di akhir query (Anda bisa mengganti 10 dengan limit yg ingin ditampilkan per halaman, walaupun sangat direkomendasikan untuk tetap limit 10). Contoh penggunaan nya seperti ini: ``` public function index() { $users = $this->userModel->where('deleted', 0)->paginate(); return view('users.index', compact('users')); } ``` Kemudian, untuk menampilkan tombol-tombol paginasi nya pada view, Anda cukup menggunakan kode `{!! $users->links() !!}`. ### Melakukan JOIN table Untuk melakukan JOIN, Anda bisa menggunakan syntax Laravel. ``` $users = DB::table('users') ->join('contacts', 'users.id', '=', 'contacts.user_id') ->join('orders', 'users.id', '=', 'orders.user_id') ->select('users.*', 'contacts.phone', 'orders.price') ->get(); ``` ## Additional Info ### Baca Dokumen Laravel, Google, Stackoverflow, kalau mentok yaudah pasrah aja