> For the complete documentation index, see [llms.txt](https://docs.enspire.online/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.enspire.online/tai-khoan-admin/courses-2/cai-dat-hien-thi.md).

# Cài đặt hiển thị

### 1. Truy cập màn hình

<figure><img src="/files/L6Dgl4r3bE1RnSnVBCa5" alt=""><figcaption></figcaption></figure>

Trên thanh menu bên trái, chọn **Cài đặt & Hệ thống > Cài đặt hiển thị**. Hệ thống sẽ hiển thị màn hình quản lý các cấu hình sản phẩm, nền tảng và phạm vi áp dụng.

### 2. Thẻ thống kê tổng quan

<figure><img src="/files/4JSGkKVikhWv9Baaqcb6" alt=""><figcaption></figcaption></figure>

* **Tổng cấu hình**: tổng số nhóm cấu hình đang có trong hệ thống (hiện tại là 7 cấu hình).
* **Đang bật**: số lượng cấu hình đang ở trạng thái bật/hiển thị (hiện tại là 6/7).
* **IAP**: trạng thái riêng của cấu hình mua trong ứng dụng (In-App Purchase), hiển thị "Đang hiển thị" hoặc "Đang ẩn" tuỳ theo cấu hình hiện tại.

### 3. Ô tìm kiếm cấu hình

* Ô **"Tìm theo tên hoặc key..."** cho phép lọc nhanh danh sách cấu hình theo tên hiển thị (ví dụ: "Triển lãm phim") hoặc theo mã key kỹ thuật (ví dụ: "iap", "film"). Khi gõ từ khoá, danh sách bên dưới sẽ tự động lọc và chỉ hiển thị các cấu hình phù hợp theo thời gian thực.

### 4. Danh sách các nhóm cấu hình

<figure><img src="/files/OF59ur41STbE0y2sZJve" alt=""><figcaption></figcaption></figure>

Mỗi cấu hình được hiển thị dưới dạng một khối có thể thu gọn/mở rộng (bấm vào mũi tên bên phải hoặc vào tiêu đề để xem chi tiết). Các nhóm cấu hình hiện có gồm:

* **Triển lãm phim** (key: `film`) — cấu hình sản phẩm, nền tảng và phạm vi áp dụng cho chức năng triển lãm phim.
* **Hệ thống bài test** (key: `testProgram`) — cấu hình cho chức năng hệ thống bài kiểm tra.
* **Bài tập hè** (key: `summerExercises`) — cấu hình cho chức năng bài tập hè.
* **Thông báo chung** (key: `announcement`) — cấu hình dữ liệu hiển thị cho banner/thông báo chung, có cấu trúc trường khác với các mục còn lại (xem mục 6).
* **Cài đặt IAP** (key: `iap`) — cấu hình cho tính năng mua trong ứng dụng.
* **Phòng trưng bày** (key: `enable_showroom`) — cấu hình cho chức năng phòng trưng bày.
* **Kho videos của bé** (key: `specialWeek`) — cấu hình cho chức năng kho video đặc biệt.

Mỗi khối (trừ "Thông báo chung") có một nhãn trạng thái ở góc phải: **"Đang bật"** (nền xanh) nếu chức năng đang được hiển thị, hoặc **"Đang tắt"** nếu đang bị ẩn. Nhãn này chỉ mang tính hiển thị, phản ánh theo trạng thái của công tắc "Hiển thị" bên trong, không phải nút bấm riêng.

### 5. Ý nghĩa các trường trong một cấu hình sản phẩm (dạng chuẩn)

Khi mở rộng một cấu hình dạng chuẩn (ví dụ: Triển lãm phim, Hệ thống bài test, Bài tập hè, Cài đặt IAP, Phòng trưng bày, Kho videos của bé), các trường bao gồm:

* **Hiển thị**: công tắc bật/tắt tổng, quyết định chức năng này có được hiển thị cho người dùng cuối hay không.
* **Áp dụng cho Android** / **Áp dụng cho iOS**: hai công tắc riêng, quyết định chức năng có áp dụng trên từng nền tảng hay không.
* **Phiên bản tối thiểu iOS áp dụng** / **Phiên bản tối thiểu Android áp dụng**: ô nhập số phiên bản (ví dụ: 3.4 hoặc 1.5.4); nếu để trống thì áp dụng cho tất cả các phiên bản của nền tảng đó.
* **Ngày bắt đầu** / **Ngày kết thúc**: khoảng thời gian áp dụng cấu hình (không bắt buộc với tất cả cấu hình — riêng "Cài đặt IAP" không có 2 trường này).
* **Danh sách trường áp dụng**: cho phép giới hạn cấu hình chỉ áp dụng/không áp dụng cho một số trường học cụ thể (xem chi tiết thao tác ở mục 7).
* **Danh sách quận/huyện áp dụng**: cho phép giới hạn cấu hình theo khu vực quận/huyện cụ thể (xem chi tiết thao tác ở mục 7).

Lưu ý: không phải cấu hình nào cũng có đủ tất cả các trường trên — ví dụ "Cài đặt IAP" chỉ có Hiển thị, Áp dụng cho Android/iOS và phiên bản tối thiểu, không có Ngày bắt đầu/kết thúc hay Danh sách trường/quận huyện áp dụng.

### 6. Ý nghĩa các trường riêng của "Thông báo chung"

<figure><img src="/files/72fyyJIZIDAWTSnGMEYl" alt=""><figcaption></figcaption></figure>

Cấu hình "Thông báo chung" có bộ trường khác biệt so với các cấu hình còn lại:

* **Hiển thị popup**: công tắc bật/tắt việc hiển thị thông báo dưới dạng cửa sổ popup.
* **Hiển thị button**: công tắc bật/tắt việc hiển thị nút bấm đi kèm thông báo.
* **Hiển thị số**: công tắc bật/tắt việc hiển thị số (ví dụ: số lượng/huy hiệu) đi kèm thông báo.
* **Url**: đường dẫn liên kết mà thông báo sẽ trỏ tới khi người dùng bấm vào.

### 7. Hướng dẫn chỉnh sửa một cấu hình

Bước 1: Tại danh sách cấu hình, bấm vào tiêu đề hoặc mũi tên của cấu hình muốn chỉnh sửa để mở rộng khối chi tiết.

<figure><img src="/files/7vUtWE2zk2GVJ0A1CXlM" alt=""><figcaption></figcaption></figure>

Bước 2: Bật/tắt các công tắc (Hiển thị, Áp dụng cho Android, Áp dụng cho iOS...) hoặc nhập/chỉnh sửa các trường số phiên bản, ngày bắt đầu, ngày kết thúc theo nhu cầu.

<figure><img src="/files/fY4XshoAWBSAxuKcSYrl" alt=""><figcaption></figcaption></figure>

Bước 3: Nếu cần giới hạn phạm vi áp dụng theo trường học hoặc quận/huyện, thực hiện theo hướng dẫn tại mục 8 bên dưới.

<figure><img src="/files/R1jriXQ7SIHNMaxBb6Xj" alt=""><figcaption></figcaption></figure>

Bước 4: Sau khi chỉnh sửa xong tất cả các cấu hình cần thiết, bấm nút **"Lưu cài đặt"** ở góc trên bên phải màn hình để lưu lại toàn bộ thay đổi.

<figure><img src="/files/OjGQs2XOWPAMM7FpWINR" alt=""><figcaption></figcaption></figure>

### 8. Hướng dẫn thiết lập "Danh sách trường áp dụng" / "Danh sách quận/huyện áp dụng"

Bước 1: Trong khối cấu hình đã mở rộng, bấm vào ô **"Danh sách trường áp dụng"** (hoặc **"Danh sách quận/huyện áp dụng"**) để mở cửa sổ danh sách chi tiết.

<figure><img src="/files/vIf63tWfCQlzpAvzRHTc" alt=""><figcaption></figcaption></figure>

Bước 2: Trong cửa sổ hiện ra, sử dụng ô tìm kiếm hoặc hai bộ lọc **Tỉnh/thành phố** và **Quận/huyện** để tìm nhanh trường học hoặc quận/huyện cần thiết lập. Có thể dùng các tab **Tất cả**, **Trường áp dụng**, **Trường không áp dụng** để lọc theo trạng thái đã thiết lập trước đó, hoặc bấm **Xóa lọc** để bỏ bộ lọc hiện tại.

<figure><img src="/files/M4math7KG58jhcqZdo3o" alt=""><figcaption></figcaption></figure>

Bước 3: Với mỗi dòng trường học/quận huyện, chọn một trong ba trạng thái: **Áp dụng** (bắt buộc áp dụng), **Không áp dụng** (loại trừ), hoặc **Mặc định** (theo cấu hình chung, không thiết lập riêng).

<figure><img src="/files/f7zKSg22hPdkbgepQr9k" alt=""><figcaption></figcaption></figure>

Bước 4: Quan sát hai ô tổng hợp phía trên cửa sổ ("Trường áp dụng" / "Trường không áp dụng") để kiểm tra số lượng đã chọn.

<figure><img src="/files/EgxO5lzRJHk8vNiSROvA" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/cswQsIZpd2VfLW2WeAzK" alt=""><figcaption></figcaption></figure>

Bước 5: Bấm **"Xong"** để xác nhận lựa chọn và đóng cửa sổ, hoặc bấm biểu tượng **X** ở góc trên bên phải để đóng mà không áp dụng thay đổi.

Lưu ý: Một trường học (hoặc một quận/huyện) không thể vừa nằm trong danh sách "áp dụng" vừa nằm trong danh sách "không áp dụng" cùng lúc. Sau khi thiết lập xong, vẫn cần bấm **"Lưu cài đặt"** ở màn hình chính để các thay đổi có hiệu lực.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.enspire.online/tai-khoan-admin/courses-2/cai-dat-hien-thi.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.