# Edocman WP Lite

## Giới thiệu

Edocman WP Lite là phiên bản miễn phí và nhẹ của plugin Edocman WP - một hệ thống quản lý tài liệu cho WordPress. Phiên bản Lite cung cấp các tính năng cơ bản để quản lý và hiển thị tài liệu trên website của bạn.

## Tính năng

### Tính năng Admin (Backend)

- ✅ **Quản lý Categories (Danh mục)**
  - Tạo, sửa, xóa danh mục
  - Hỗ trợ danh mục cấp con (hierarchical)
  - Thêm hình ảnh và mô tả cho danh mục
  - Sắp xếp thứ tự hiển thị

- ✅ **Quản lý Documents (Tài liệu)**
  - Upload và quản lý tài liệu
  - Gán tài liệu vào nhiều danh mục
  - Thêm mô tả chi tiết (short description và full description)
  - Upload hình thumbnail cho tài liệu
  - Theo dõi số lượt tải và xem

### Tính năng Frontend (Giao diện người dùng)

- ✅ **Hiển thị danh sách Categories**
  - Shortcode: `[edocman_lite_categories]`
  - Hiển thị dạng lưới với hình ảnh
  - Có thể tùy chỉnh hiển thị description

- ✅ **Hiển thị danh sách Documents theo Category**
  - Shortcode: `[edocman_lite_documents category_id="X"]`
  - Hiển thị thông tin chi tiết: file size, downloads, views
  - Icon tự động theo loại file

- ✅ **Trang chi tiết Document**
  - Shortcode: `[edocman_lite_document]`
  - Hiển thị đầy đủ thông tin tài liệu
  - Nút Download và View
  - Tự động tăng số lượt xem

### Widget

- ✅ **Categories Widget**
  - Hiển thị danh sách categories trong sidebar/widget area
  - Tùy chọn hiển thị hình ảnh
  - Giới hạn số lượng categories hiển thị

## Cài đặt

1. Upload thư mục `edocman-lite` vào `/wp-content/plugins/`
2. Kích hoạt plugin trong trang Plugins của WordPress
3. Plugin sẽ tự động tạo các bảng database cần thiết

## Sử dụng

### Quản lý Categories

1. Vào menu **Edocman Lite > Categories**
2. Click **Add New** để tạo category mới
3. Nhập thông tin:
   - Title (bắt buộc)
   - Parent Category (tùy chọn)
   - Description (tùy chọn)
   - Image (tùy chọn)
   - Published (đánh dấu để hiển thị)

### Quản lý Documents

1. Vào menu **Edocman Lite > Documents**
2. Click **Add New** để upload tài liệu mới
3. Nhập thông tin:
   - Title (bắt buộc)
   - Categories (chọn một hoặc nhiều danh mục)
   - Document File (bắt buộc khi tạo mới)
   - Short Description
   - Full Description
   - Thumbnail Image
   - Published

### Sử dụng Shortcodes

#### Hiển thị danh sách Categories

```php
[edocman_lite_categories]
```

Tham số:
- `parent_id` - ID của parent category (mặc định: 0)
- `show_description` - Hiển thị mô tả (mặc định: 1)
- `show_image` - Hiển thị hình ảnh (mặc định: 1)

Ví dụ:
```php
[edocman_lite_categories parent_id="5" show_description="1"]
```

#### Hiển thị danh sách Documents

```php
[edocman_lite_documents category_id="1"]
```

Tham số:
- `category_id` - ID của category (mặc định: 0 - tất cả)
- `limit` - Số lượng documents hiển thị (mặc định: 10)
- `show_description` - Hiển thị mô tả (mặc định: 1)

Ví dụ:
```php
[edocman_lite_documents category_id="3" limit="5"]
```

#### Hiển thị chi tiết Document

```php
[edocman_lite_document]
```

Shortcode này sẽ tự động lấy document ID từ URL parameter `doc_id`.

Ví dụ URL: `https://yoursite.com/documents/?doc_id=123`

### Sử dụng Widget

1. Vào **Appearance > Widgets**
2. Kéo widget **Edocman Lite Categories** vào widget area
3. Cấu hình:
   - Title
   - Number of categories to show
   - Show images
   - Parent category

## Cấu trúc Database

Plugin sử dụng chung bảng database với phiên bản Full để tránh phải migrate dữ liệu:

1. `wp_edocman_categories` - Lưu thông tin categories (dùng chung với Full version)
2. `wp_edocman_documents` - Lưu thông tin documents (dùng chung với Full version)
3. `wp_edocman_document_category` - Liên kết documents với categories (dùng chung với Full version)
4. `wp_edocman_configs` - Lưu cấu hình plugin (dùng chung với Full version)

**Lợi ích:**
- Không cần migrate dữ liệu khi nâng cấp lên phiên bản Full
- Dữ liệu tạo ở Lite version có thể dùng ngay ở Full version
- Tiết kiệm thời gian và công sức quản lý

## Navigation

### Click vào Category
Khi click vào một category trong danh sách categories, trang sẽ tự động hiển thị danh sách documents thuộc category đó với breadcrumb navigation:
```
Categories > Category Name
```

### Click vào Document  
Khi click vào một document, trang sẽ hiển thị chi tiết document với:
- Full description và thông tin chi tiết
- Nút Download và View
- Breadcrumb navigation: `Categories > Category Name > Document Title`
- Nút "Back to Documents" để quay lại danh sách

## Thư mục Upload

Tài liệu được lưu trong: `/wp-content/uploads/edocman-lite/documents/`

Cấu trúc thư mục:
```
edocman-lite/
├── categories/
│   └── thumb/
└── documents/
    └── thumb/
```

## So sánh với Phiên bản Full

| Tính năng | Lite | Full |
|-----------|------|------|
| Quản lý Categories | ✅ | ✅ |
| Quản lý Documents | ✅ | ✅ |
| Upload tài liệu | ✅ | ✅ |
| View/Download | ✅ | ✅ |
| Dashboard | ❌ | ✅ |
| Configuration | ❌ | ✅ |
| User Roles | ❌ | ✅ |
| Permissions | ❌ | ✅ |
| Ajax Upload | ❌ | ✅ |
| Search | ❌ | ✅ |
| My Documents | ❌ | ✅ |
| Email Notifications | ❌ | ✅ |
| Advanced Reports | ❌ | ✅ |

## Yêu cầu hệ thống

- WordPress: 5.0 hoặc cao hơn
- PHP: 7.4 hoặc cao hơn
- MySQL: 5.6 hoặc cao hơn

## Hỗ trợ

Để được hỗ trợ hoặc báo cáo lỗi, vui lòng liên hệ:
- Website: https://joomdonation.com
- Email: support@joomdonation.com

## License

GPL v2 or later

## Tác giả

Dang Thuc Dam - https://joomdonation.com

## Changelog

### Version 1.1.0
- **[Major]** Chuyển sang sử dụng database của phiên bản Full (wp_edocman_*) thay vì bảng riêng lite
- **[Feature]** Click vào category sẽ hiển thị danh sách documents của category đó
- **[Feature]** Click vào document sẽ hiển thị trang chi tiết với nút Download và View
- **[Feature]** Thêm breadcrumb navigation để dễ dàng điều hướng
- **[Feature]** Thêm nút "Back to Documents" trong trang chi tiết
- **[Improvement]** Không cần migrate dữ liệu khi nâng cấp lên Full version

### Version 1.0.0
- Phát hành phiên bản đầu tiên
- Quản lý categories và documents cơ bản
- Shortcodes để hiển thị categories, documents và document detail
- Widget categories
- View và download tài liệu
