---
url: https://docs.ogmabox.com/vi/app/plugins.md
description: >-
  Cài đặt, quản lý, cập nhật và phát triển plugin Ogma từ gói cục bộ, thư mục,
  tệp nén zip và kho plugin.
---

# Plugin {#plugins}

Plugin mở rộng Ogma với trang giao diện tùy chỉnh, xử lý backend, hook sự kiện và bảng cài đặt - tất cả đều giới hạn trong các quyền mà plugin khai báo.

## Những gì plugin có thể bổ sung {#what-plugins-can-add}

* Trang giao diện tùy chỉnh truy cập được từ thanh điều hướng bên trái.
* Tuyến backend xử lý yêu cầu hoặc phản hồi.
* Hook sự kiện được kích hoạt bởi lưu lượng đã ghi nhận.
* Trang cài đặt cho cấu hình riêng của plugin.
* Lệnh có thể đăng ký trong bảng lệnh.

## Cài đặt từ thư mục {#install-from-folder}

1. Nhấp **Cài đặt** trong màn hình Plugin.
2. Chọn **Thư mục**.
3. Chọn thư mục gốc của plugin. Thư mục phải chứa bản kê plugin hợp lệ và các tệp mà bản kê khai báo.
4. Ogma kiểm tra tính hợp lệ của gói và đăng ký plugin.
5. Bật plugin để kích hoạt.

## Cài đặt từ tệp nén zip {#install-from-zip-archive}

1. Nhấp **Cài đặt** trong màn hình Plugin.
2. Chọn **Zip**.
3. Chọn tệp `.zip` của plugin.
4. Kiểm tra tên và phiên bản plugin được nhận diện.
5. Nhấp **Cài đặt**, rồi bật plugin.

Các bản cài từ zip được sao chép vào thư mục plugin do Ogma quản lý. Có thể xóa tệp nén gốc sau khi cài đặt.

## Cảnh báo tương thích {#compatibility-warnings}

Sau khi cài đặt, Ogma có thể hiển thị cảnh báo trên trang chi tiết plugin. Đây là thông tin tham khảo - không ngăn plugin chạy.

Các cảnh báo thường gặp:

* **Tệp không được tham chiếu** - tệp có trong gói nhưng không được bản kê khai báo.
* **Thiếu shim thời gian chạy** - plugin dùng API yêu cầu một lớp tương thích không có trong phiên bản Ogma này.

Kiểm tra cảnh báo trước khi bật plugin chưa quen thuộc.

## Bật và tắt {#enable-and-disable}

Dùng công tắc **Đã bật** trên hàng plugin để kích hoạt hoặc vô hiệu hóa plugin. Plugin bị tắt vẫn được cài đặt nhưng không chạy. Bật lại khôi phục plugin mà không cần cài lại.

## Các thẻ chi tiết plugin {#plugin-detail-tabs}

Chọn plugin để mở bảng chi tiết. Bảng có các thẻ sau.

| Thẻ | Nội dung |
|-----|----------|
| Tổng quan | Tên, phiên bản, tác giả, mô tả và nguồn của plugin. |
| Cảnh báo | Vấn đề tương thích được phát hiện khi cài đặt hoặc bật. |
| Quyền | Các quyền plugin yêu cầu và những quyền Ogma cấp khi chạy. |
| Tệp | Danh sách tệp trong gói plugin. |
| Nhật ký | Đầu ra khi chạy plugin, có tô sáng cú pháp cho dòng nhật ký có cấu trúc. |
| UI | Trang tùy chỉnh của plugin, được hiển thị trực tiếp. |

## Quyền {#permissions}

Thẻ Quyền liệt kê từng quyền plugin khai báo trong bản kê và trạng thái cấp quyền hiện tại. Các lệnh gọi backend được kiểm soát ở phía máy chủ. Giao diện phản ánh trạng thái trực tiếp của từng quyền.

Nếu plugin không hoạt động như mong đợi, kiểm tra thẻ Quyền để xác nhận các quyền cần thiết đã được cấp.

## Chế độ phát triển {#dev-mode}

Plugin cài từ thư mục hiển thị nhãn **Phát triển** và nút **Tải lại**.

Nhấp **Tải lại** để áp dụng thay đổi mã mà không cần cài lại. Plugin khởi động lại và đăng ký lại mọi hook và tuyến. Đây là chu trình phát triển tiêu chuẩn cho tác giả plugin.

Plugin ở chế độ phát triển vẫn liên kết với thư mục nguồn. Thay đổi tệp trong thư mục đó có hiệu lực ở lần tải lại tiếp theo.

## Kho plugin {#marketplace}

Thẻ **Kho plugin** liệt kê plugin cộng đồng từ danh mục Awesome Ogma Plugins.

1. Duyệt hoặc tìm trong danh sách plugin.
2. Nhấp plugin để xem mô tả, phiên bản và siêu dữ liệu tương thích.
3. Nhấp **Cài đặt** để cài trực tiếp.
4. Nếu plugin đã cài từ kho có phiên bản tương thích mới hơn, thao tác đổi thành **Cập nhật**.

Cài từ kho plugin yêu cầu kết nối mạng để tải gói.

## Trang liên quan {#related-pages}

* [Bắt đầu nhanh với plugin](/vi/plugins/quickstart)
* [SDK backend](/vi/plugins/backend-sdk)
* [SDK frontend](/vi/plugins/frontend-sdk)