XOOPS輕鬆架

# 教師請假模組 `jill_leave` 使用手冊

本模組專為學校設計，旨在提供教學組與相關管理人員掌握教師請假的調代課資訊，並能快速生成鐘點費清冊與 PDF 假單，減少行政作業流程。---

## 1. 模組簡介與環境要求

### 1.1 模組目的
- 提供教師便捷的線上請假與排代課申請。
- 自動化統計代課節次，支援一鍵匯出「鐘點費清冊」(Excel) 與「請假單」(PDF)。
- 前台公告請假動態，利於校內同仁掌握課務狀況。

### 1.2 系統環境需求
- **XOOPS 版本**：2.5.11+
- **PHP 版本**：8.0+
- **必要依賴模組**：`tadtools`

### 1.3 安裝與升級
1. 將 `jill_leave` 資料夾上傳至 XOOPS 網站的 `modules/` 目錄下。
2. 以管理員身份登入 XOOPS 後台，進入「模組管理」->「安裝模組」。
3. 找到「教師請假」模組並點擊「安裝」按鈕。
4. **注意**：若未來有新版本釋出，請將新檔覆蓋舊檔後，至「模組管理」點擊「更新」即可。

---

## 2. 系統參數設定（管理員專區）

安裝完成後，管理員應先至模組後台或前台的「系統參數」進行基礎設定，以利後續功能正常運作。

### 2.1 管理人員 Email (`adm_email`)
- **功能描述**：設定具備本模組最高管理權限（如：審核假單、修改任意假單、匯出報表）的人員 Email。
- **設定方式**：多筆 Email 請以英文分號「`;`」隔開（例如：`admin@school.edu.tw;office@school.edu.tw`）。設定完成後，這些人員重新登入網站後即具備管理權限。

### 2.2 設定全校年級 (`grade`)
- **功能描述**：限定前台請假時可供選擇的年級範圍。
- **設定方式**：例如國小可設為 `1,2,3,4,5,6`。

### 2.3 設定全校最多班級 (`class_room`)
- **功能描述**：設定各年級的最大班級數，用以動態生成班級下拉選單。
- **設定方式**：如全校最多班級數是六年級共 10 班，則填入 `10`，系統即會自動產生 `1班` 到 `10班` 的選項。

### 2.4 節次設定 (`class_period`)
- **功能描述**：自訂學校的授課節次。
- **設定方式**：使用英文逗號「`,`」隔開。例如：`早自修,第1節,第2節,第3節,第4節,第5節,第6節,第7節`。

---

## 3. 假別分類管理（管理員專區）

在教師開始請假前，管理員需先建立學校適用的假別（如：事假、病假、公差假等）。

- **入口路徑**：前台選單 -> 「假別分類」（僅管理員可見）。
- **新增/修改假別**：輸入「假別名稱」，並選擇「狀態」（啟用 / 停用）。
- **排序調整**：假別清單支援 **AJAX 拖曳排序**，直接在前台拖拉假別列即可即時儲存排序，無需手動點擊保存。

---

## 4. 教師請假申請（教師前台）

一般教師登入後，即可在前台進行請假申請與課務排代。

### 4.1 檢視請假記錄
- 教師進入「教師請假主頁」即可看到個人的請假歷史清單、請假起訖時間、代課節數，以及「審核狀態」：
  -

• 
  1) leave_workflow.png
• 
  2) leave-admin.png
• 
  3) 01.png
• 
  4) 02.png
• 
  5) 03.png
• 
  6) 04.png
• 
  7) 05.png

1. 將模組解壓，把解壓縮出來的目錄上傳到 modules 下
2. 需搭配 Tad Tools工具包，詳細安裝方法請按此連結。
3. 進入後台進行模組安裝即可。

1. 更新時，請先登入，並進到「模組管理」畫面，以便上傳完後，可以立即進行更新動作。
2. 將新模組解壓，把解壓縮出來的目錄上傳到 modules 下，直接覆蓋即可（把舊的實體目錄整個刪除（非後台移除），上傳新的，這樣更好）。
3. 若沒有 Tad Tools工具包 或版本太舊，則需下載安裝 Tad Tools工具包，詳細安裝方法請按此連結。
4. 進入後台「模組→系統」進行模組更新。