Sindbad~EG File Manager

# ✅ PDF Export for Administration Reference IDs

## 🎯 Feature Overview

Added **PDF export functionality** to all three administration pages (Areas, Districts, and Assemblies) allowing admins to export complete reference lists with codes.

---

## 📦 What Was Implemented

### **1. Areas PDF Export**
- Complete list of all areas with reference codes
- Shows district and assembly counts
- Color-coded by active/inactive status
- Filename: `areas_reference_YYYYMMDD_HHMMSS.pdf`

### **2. Districts PDF Export**
- Complete list of all districts with reference codes
- Shows parent area code
- Displays assembly count per district
- Filename: `districts_reference_YYYYMMDD_HHMMSS.pdf`

### **3. Assemblies PDF Export**
- Complete list of all assemblies with reference codes
- Shows area code and district code hierarchy
- Includes pastor name and member count
- **Landscape orientation** for more columns
- Filename: `assemblies_reference_YYYYMMDD_HHMMSS.pdf`

---

## 📄 PDF Content Details

### **Areas PDF Contains:**

| Column | Description |
|--------|-------------|
| # | Sequential number |
| Area Code | Unique area reference code |
| Area Name | Full area name |
| Districts | Number of districts in area |
| Assemblies | Number of assemblies in area |
| Status | Active/Inactive indicator |

### **Districts PDF Contains:**

| Column | Description |
|--------|-------------|
| # | Sequential number |
| Area Code | Parent area reference code |
| District Code | Unique district reference code |
| District Name | Full district name |
| Assemblies | Number of assemblies in district |
| Status | Parent area name |
| Active | Yes/No indicator |

### **Assemblies PDF Contains:**

| Column | Description |
|--------|-------------|
| # | Sequential number |
| Area Code | Parent area reference code |
| District Code | Parent district reference code |
| Assembly Code | Unique assembly reference code |
| Assembly Name | Full assembly name |
| Pastor Name | Pastor's name (if available) |
| Members | Number of members |
| City | City location |
| Active | Yes/No indicator |

---

## 🎨 PDF Features

### **Common Features (All Three):**
- ✅ Church branding (APP_NAME as title)
- ✅ Generation date and time
- ✅ Total count summary
- ✅ Professional blue header row
- ✅ Color-coded rows (Green=Active, Red=Inactive)
- ✅ Automatic page breaks
- ✅ Timestamped filenames

### **Unique Features:**
- **Areas**: Portrait orientation, focus on hierarchy counts
- **Districts**: Portrait orientation, shows parent area relationship
- **Assemblies**: **Landscape orientation** for more detailed information

---

## 📁 Files Modified

### **Modified Files:**
1. ✅ `modules/administration/areas.php`
   - Added PDF export handler (lines 12-85)
   - Added "Export PDF" button

2. ✅ `modules/administration/districts.php`
   - Added PDF export handler (lines 12-87)
   - Added "Export PDF" button

3. ✅ `modules/administration/assemblies.php`
   - Added PDF export handler (lines 12-92)
   - Added "Export PDF" button (landscape PDF)

### **Dependencies:**
- Uses existing TCPDF library (already required for member upload)
- No additional composer packages needed

---

## 🚀 How to Use

### **For Areas:**
```
Visit: http://localhost/copmadinaarea/modules/administration/areas.php
Click: "Export PDF" button (red, top-right)
Result: areas_reference_20251113_120015.pdf downloads
```

### **For Districts:**
```
Visit: http://localhost/copmadinaarea/modules/administration/districts.php
Click: "Export PDF" button (red, top-right)
Result: districts_reference_20251113_120015.pdf downloads
```

### **For Assemblies:**
```
Visit: http://localhost/copmadinaarea/modules/administration/assemblies.php
Click: "Export PDF" button (red, top-right)
Result: assemblies_reference_20251113_120015.pdf downloads
```

---

## 💡 Use Cases

### **1. Reference Documentation**
- Print and distribute reference codes to staff
- Keep physical copies for offline reference
- Share with other administrators

### **2. Data Verification**
- Cross-reference codes during data entry
- Verify hierarchical relationships
- Audit location structure

### **3. Planning & Reporting**
- Review coverage (assemblies per district)
- Identify gaps in structure
- Generate reports for leadership

### **4. Bulk Upload Preparation**
- Get list of valid area codes before district upload
- Get list of valid district codes before assembly upload
- Ensure correct parent codes are used

### **5. Member Registration**
- Reference for assigning members to correct assembly
- Verify area/district/assembly codes
- Ensure data consistency

---

## 🎯 Button Placement

All three pages now have **3 action buttons** in the header:

```
[Add New Area/District/Assembly]  [Bulk Upload]  [Export PDF]
     (Orange Gradient)             (Blue Gradient)  (Red)
```

**Button Colors:**
- **Orange** = Create new record
- **Blue** = Import from file
- **Red** = Export to PDF

---

## 📊 PDF Layout Examples

### **Areas PDF (Portrait):**
```
                    [Church Name]
              Areas Reference List
         Generated: November 13, 2025 - 12:00 PM

Total Areas: 5

┌─────┬──────────┬───────────────┬──────────┬───────────┬────────┐
│  #  │Area Code │  Area Name    │Districts │Assemblies │ Status │
├─────┼──────────┼───────────────┼──────────┼───────────┼────────┤
│  1  │   GA     │Greater Accra  │    10    │     45    │ Active │
│  2  │  ASH     │Ashanti Region │     8    │     32    │ Active │
└─────┴──────────┴───────────────┴──────────┴───────────┴────────┘
```

### **Assemblies PDF (Landscape):**
```
                           [Church Name]
                    Assemblies Reference List
              Generated: November 13, 2025 - 12:00 PM

Total Assemblies: 125

┌───┬──────┬────────┬──────────┬───────────────┬─────────┬────────┬────────┬──────┐
│ # │ Area │District│Assembly  │Assembly Name  │ Pastor  │Members │  City  │Active│
│   │ Code │  Code  │   Code   │               │  Name   │        │        │      │
├───┼──────┼────────┼──────────┼───────────────┼─────────┼────────┼────────┼──────┤
│ 1 │  GA  │  MAD   │ MCA001   │Madina Central │Rev. Doe │   250  │ Accra  │ Yes  │
│ 2 │  GA  │  MAD   │ MCA002   │Madina East    │Rev. Jane│   180  │ Accra  │ Yes  │
└───┴──────┴────────┴──────────┴───────────────┴─────────┴────────┴────────┴──────┘
```

---

## ✨ Benefits

1. **Quick Reference** - All codes in one document
2. **Printable** - Professional format for printing
3. **Shareable** - Easy to distribute to staff
4. **Organized** - Sorted by hierarchy (Area → District → Assembly)
5. **Complete** - All locations in one place
6. **Visual Status** - Color-coded active/inactive
7. **Detailed** - Includes counts and relationships
8. **Timestamped** - Know when reference was generated

---

## 🔍 Technical Details

### **PDF Specifications:**
- **Library**: TCPDF (already installed)
- **Page Sizes**: 
  - Areas: A4 Portrait
  - Districts: A4 Portrait
  - Assemblies: A4 Landscape
- **Margins**: 15mm all sides
- **Auto Page Break**: Enabled
- **Font**: Helvetica

### **Color Scheme:**
- **Header**: Blue (#1E40AF) with white text
- **Active Rows**: Light Green (#F0FDF4)
- **Inactive Rows**: Light Red (#FEF2F2)

### **Data Ordering:**
- **Areas**: Alphabetical by area name
- **Districts**: By area name, then district name
- **Assemblies**: By area, district, then assembly name

---

## 📝 Summary

**Feature Status:** ✅ Complete and Ready to Use

**Pages Updated:** 3 (Areas, Districts, Assemblies)

**New Buttons:** 3 "Export PDF" buttons added

**Dependencies:** TCPDF (already installed)

**Installation Required:** None (uses existing setup)

---

**All three administration pages now support PDF export of reference IDs!** 🎉

Admins can quickly generate professional PDF reference lists for areas, districts, and assemblies with all codes and hierarchy information.