---
url: https://docs.ogmabox.com/id/app/plugins.md
description: >-
  Instal, kelola, perbarui, dan kembangkan plugin Ogma dari paket lokal, folder,
  arsip zip, dan marketplace.
---

# Plugin {#plugins}

Plugin memperluas Ogma dengan halaman UI kustom, pemrosesan backend, hook peristiwa, dan panel pengaturan - semuanya dibatasi oleh izin yang dideklarasikan plugin.

## Fitur yang Dapat Ditambahkan Plugin {#what-plugins-can-add}

* Halaman UI kustom yang dapat diakses dari navigasi kiri.
* Rute backend yang memproses permintaan atau respons.
* Hook peristiwa yang dipicu oleh lalu lintas yang direkam.
* Halaman pengaturan untuk konfigurasi khusus plugin.
* Perintah yang dapat didaftarkan dalam palet perintah.

## Menginstal dari Folder {#install-from-folder}

1. Klik **Pasang** di tampilan Plugin.
2. Pilih **Folder**.
3. Pilih direktori root plugin. Direktori harus berisi manifes plugin yang valid dan file yang dideklarasikan manifes.
4. Ogma memvalidasi paket dan mendaftarkannya.
5. Aktifkan plugin untuk menjalankannya.

## Menginstal dari Arsip Zip {#install-from-zip-archive}

1. Klik **Pasang** di tampilan Plugin.
2. Pilih **Zip**.
3. Pilih file `.zip` plugin.
4. Tinjau nama dan versi plugin yang terdeteksi.
5. Klik **Pasang**, lalu aktifkan plugin.

Instalasi zip disalin ke direktori plugin yang dikelola Ogma. Arsip asli dapat dihapus setelah instalasi.

## Peringatan Kompatibilitas {#compatibility-warnings}

Setelah instalasi, Ogma mungkin menampilkan peringatan di halaman detail plugin. Peringatan ini bersifat informatif - tidak mencegah plugin berjalan.

Peringatan umum:

* **File yang tidak dirujuk** - file dalam paket yang tidak dideklarasikan manifes.
* **Lapisan kompatibilitas runtime tidak tersedia** - plugin menggunakan API yang memerlukan lapisan kompatibilitas yang tidak tersedia dalam versi Ogma ini.

Tinjau peringatan sebelum mengaktifkan plugin yang belum Anda kenal.

## Mengaktifkan dan Menonaktifkan {#enable-and-disable}

Gunakan sakelar **Diaktifkan** pada baris plugin untuk mengaktifkan atau menonaktifkan plugin. Plugin yang nonaktif tetap terinstal, tetapi tidak berjalan. Mengaktifkannya kembali memulihkan plugin tanpa instalasi ulang.

## Tab Detail Plugin {#plugin-detail-tabs}

Pilih plugin untuk membuka panel detailnya. Panel memiliki tab berikut.

| Tab | Isi |
|-----|----------|
| Ringkasan | Nama, versi, pembuat, deskripsi, dan sumber plugin. |
| Peringatan | Masalah kompatibilitas yang terdeteksi saat instalasi atau aktivasi. |
| Izin | Izin yang diminta plugin dan yang diberikan Ogma saat runtime. |
| File | Daftar file dalam paket plugin. |
| Log | Keluaran runtime plugin, dengan penyorotan sintaks untuk baris log terstruktur. |
| UI | Halaman kustom plugin, dirender langsung di panel. |

## Izin {#permissions}

Tab Izin mencantumkan setiap izin yang dideklarasikan plugin dalam manifesnya dan status pemberian izin saat ini. Izin untuk pemanggilan backend diberlakukan di sisi server. UI mencerminkan status langsung setiap izin.

Jika plugin tidak berperilaku sesuai harapan, periksa tab Izin untuk memastikan izin yang diperlukan telah diberikan.

## Mode Pengembangan {#dev-mode}

Plugin yang diinstal dari folder menampilkan lencana **Pengembangan** dan tombol **Muat ulang**.

Klik **Muat ulang** untuk menerapkan perubahan kode tanpa instalasi ulang. Plugin dimulai ulang dan mendaftarkan kembali semua hook dan rute. Ini adalah siklus iterasi standar bagi pembuat plugin.

Plugin mode pengembangan tetap tertaut ke folder sumber. Perubahan file dalam folder tersebut berlaku pada pemuatan ulang berikutnya.

## Katalog Plugin {#marketplace}

Tab **Katalog Plugin** mencantumkan plugin komunitas dari registri Awesome Ogma Plugins.

1. Telusuri atau cari daftar plugin.
2. Klik plugin untuk melihat deskripsi, versi, dan metadata kompatibilitasnya.
3. Klik **Pasang** untuk menginstalnya secara langsung.
4. Jika versi kompatibel yang lebih baru tersedia untuk plugin marketplace yang terinstal, tindakannya berubah menjadi **Perbarui**.

Instalasi dari marketplace memerlukan koneksi jaringan untuk mengambil paket.

## Halaman Terkait {#related-pages}

* [Panduan Awal Plugin](/id/plugins/quickstart)
* [SDK Backend](/id/plugins/backend-sdk)
* [SDK Frontend](/id/plugins/frontend-sdk)