Month Wallpaper
This section covers the API endpoints for managing month wallpapers in the admin panel.
List Month Wallpapers
GET /v1/admin/month-wallpapers
Returns a paginated list of all month wallpapers.
Query Parameters
| Parameter | Type | Description |
|---|---|---|
search_text | string | Search wallpapers by name |
filter[displayed] | boolean | Filter by display status |
filter[selected] | boolean | Filter by selected status |
filter[trashed] | boolean | Include trashed wallpapers |
sort | string | Sort by field (prefix with - for descending) |
per_page | integer | Number of items per page. Defaults to 10 |
Response
{
"success": true,
"message": "تم جلب البيانات بنجاح.",
"data": {
"current_page": 1,
"first_page_url": "http://192.168.0.139:8080/v1/admin/month-wallpapers?page=1",
"from": 1,
"last_page": 5,
"last_page_url": "http://192.168.0.139:8080/v1/admin/month-wallpapers?page=5",
"links": [
{
"url": null,
"label": "« السابق",
"active": false
},
{
"url": "http://192.168.0.139:8080/v1/admin/month-wallpapers?page=1",
"label": "1",
"active": true
},
{
"url": "http://192.168.0.139:8080/v1/admin/month-wallpapers?page=2",
"label": "2",
"active": false
},
{
"url": "http://192.168.0.139:8080/v1/admin/month-wallpapers?page=3",
"label": "3",
"active": false
},
{
"url": "http://192.168.0.139:8080/v1/admin/month-wallpapers?page=4",
"label": "4",
"active": false
},
{
"url": "http://192.168.0.139:8080/v1/admin/month-wallpapers?page=5",
"label": "5",
"active": false
},
{
"url": "http://192.168.0.139:8080/v1/admin/month-wallpapers?page=2",
"label": "التالي »",
"active": false
}
],
"next_page_url": "http://192.168.0.139:8080/v1/admin/month-wallpapers?page=2",
"path": "http://192.168.0.139:8080/v1/admin/month-wallpapers",
"per_page": 10,
"prev_page_url": null,
"to": 10,
"total": 50,
"month_wallpapers": [
{
"id": "29686010-c814-11ef-a3ca-6d6121278541",
"name": "الثراء",
"date": "2025-01-01",
"custom_date": "2025 Jan",
"poster": "http://192.168.0.139:8080/storage/28581/خلفية-شهر-جانوري-2025_مقاس-موقع.png",
"displayed": true,
"selected": true,
"created_at": "2025-01-01 00:00:00"
},
{
"id": "6cc01ba0-afca-11ef-836a-21c4ad7cf941",
"name": "الاستعداد للعام القادم",
"date": "2024-12-01",
"custom_date": "2024 Dec",
"poster": "http://192.168.0.139:8080/storage/27423/الخلفية-ديسمبر-مقاس-موقع.png",
"displayed": true,
"selected": false,
"created_at": "2025-01-01 00:00:00"
},
{
"id": "d1f86e20-9942-11ef-8f9d-5f93bd39f83b",
"name": "التحرر من الصدمات",
"date": "2024-11-02",
"custom_date": "2024 Nov",
"poster": "http://192.168.0.139:8080/storage/26380/خلفية-شهر-نوفمبر-مقاس-الموقع.png",
"displayed": true,
"selected": false,
"created_at": "2025-01-01 00:00:00"
},
{
"id": "12f95180-7f77-11ef-86be-8b2e3a150a7d",
"name": "التنظيف",
"date": "2024-10-01",
"custom_date": "2024 Oct",
"poster": "http://192.168.0.139:8080/storage/25421/خلفية-شهر-اكتوبر_للموقع.png",
"displayed": true,
"selected": false,
"created_at": "2025-01-01 00:00:00"
},
{
"id": "23f3d890-67e3-11ef-8637-4909f3700c02",
"name": "العظمة",
"date": "2024-09-01",
"custom_date": "2024 Sep",
"poster": "http://192.168.0.139:8080/storage/24913/خلفية-شهر-سبتمبر_للموقع.png",
"displayed": true,
"selected": false,
"created_at": "2025-01-01 00:00:00"
},
{
"id": "5f178830-4f8c-11ef-b179-f34a7c921611",
"name": "المتعة 2024",
"date": "2024-08-01",
"custom_date": "2024 Aug",
"poster": "http://192.168.0.139:8080/storage/24338/خلفية-شهر-أوغست-(للموقع).png",
"displayed": true,
"selected": false,
"created_at": "2025-01-01 00:00:00"
},
{
"id": "d13c0490-37b8-11ef-bcaa-91b121b8f551",
"name": "توازن الأنوثة والذكورة",
"date": "2024-07-01",
"custom_date": "2024 Jul",
"poster": "http://192.168.0.139:8080/storage/23765/خلفية-شهر-جولاي(للموقع).png",
"displayed": true,
"selected": false,
"created_at": "2025-01-01 00:00:00"
},
{
"id": "982a2090-1f70-11ef-9310-1b28c69bbdfe",
"name": "تشافي العلاقات",
"date": "2024-06-01",
"custom_date": "2024 Jun",
"poster": "http://192.168.0.139:8080/storage/23198/خلفية-شهر-جون_مقاس-الموقع.png",
"displayed": true,
"selected": false,
"created_at": "2025-01-01 00:00:00"
},
{
"id": "64ed5cf0-07ad-11ef-8298-1792e40913e9",
"name": "تطوير الجسد المشاعري",
"date": "2024-05-01",
"custom_date": "2024 May",
"poster": "http://192.168.0.139:8080/storage/22688/خلفية-مايو2024-(مقاس-الموقع).png",
"displayed": true,
"selected": false,
"created_at": "2025-01-01 00:00:00"
},
{
"id": "43b064c0-f357-11ee-a622-0f9a8a30aab7",
"name": "الحظ",
"date": "2024-04-02",
"custom_date": "2024 Apr",
"poster": "http://192.168.0.139:8080/storage/22269/2024خلفية-الحظ-(1).png",
"displayed": true,
"selected": false,
"created_at": "2025-01-01 00:00:00"
}
]
},
"status_code": 200
}
Create Month Wallpaper
POST /v1/admin/month-wallpapers
Create a new month wallpaper.
Request Body
| Parameter | Type | Description | Validation Rules |
|---|---|---|---|
name | string | Wallpaper name | Required, 3-255 characters |
date | string | Wallpaper date | Required, format: Y-m-d |
displayed | boolean | Display status | Optional |
selected | boolean | Selected status | Optional |
poster | file | Wallpaper image | Required, max: 1MB, types: jpeg,png,jpg |
Response
{
"success": true,
"message": "تم حفظ البيانات بنجاح.",
"data": {
"id": "73ab5da0-058f-11f0-baac-bd138513ec3b",
"name": "student",
"date": "1974-01-11",
"custom_date": "1974 Jan",
"poster": "/storage/29006/Screenshot-from-2025-02-24-13-39-01.png",
"displayed": true,
"selected": null,
"created_at": "2025-03-20 16:30:12"
},
"status_code": 200
}
Get Month Wallpaper
GET /v1/admin/month-wallpapers/{id}
Retrieve details of a specific month wallpaper.
Response
{
"success": true,
"message": "تم جلب البيانات بنجاح.",
"data": {
"id": "29686010-c814-11ef-a3ca-6d6121278541",
"name": "الثراء",
"date": "2025-01-01",
"custom_date": "2025 Jan",
"poster": "http://192.168.0.139:8080/storage/28581/خلفية-شهر-جانوري-2025_مقاس-موقع.png",
"displayed": true,
"selected": true,
"created_at": "2025-01-01 10:43:59"
},
"status_code": 200
}
Update Month Wallpaper
PATCH /v1/admin/month-wallpapers/{id}
Update an existing month wallpaper.
Request Body
| Parameter | Type | Description | Validation Rules |
|---|---|---|---|
name | string | Wallpaper name | Optional, 3-255 characters |
date | string | Wallpaper date | Optional, format: Y-m-d |
displayed | boolean | Display status | Optional |
selected | boolean | Selected status | Optional |
poster | file | Wallpaper image | Optional, max: 1MB, types: jpeg,png,jpg |
Response
{
"success": true,
"message": "تم تحديث البيانات بنجاح.",
"data": {
"id": "73ab5da0-058f-11f0-baac-bd138513ec3b",
"name": "student",
"date": "1974-01-11",
"custom_date": "1974 Jan",
"poster": "/storage/29006/Screenshot-from-2025-02-24-13-39-01.png",
"displayed": true,
"selected": false,
"created_at": "2025-03-20 16:30:12"
},
"status_code": 200
}
Bulk Update Month Wallpapers
PATCH /v1/admin/month-wallpapers
Update or delete multiple month wallpapers at once.
Request Body
| Parameter | Type | Description | Validation Rules |
|---|---|---|---|
ids | array | Array of wallpaper UUIDs to update | Required |
ids.* | string | UUID format | Required |
selected | boolean | Set selected status for all wallpapers | Optional, true/false |
delete | boolean | Delete all specified wallpapers | Optional, true/false |
Response
{
"success": true,
"message": "تم تحديث البيانات بنجاح.",
"data": null,
"status_code": 200
}
Delete Month Wallpapers
DELETE /v1/admin/month-wallpapers
Delete one or more month wallpapers.
Request Body
| Parameter | Type | Description | Validation Rules |
|---|---|---|---|
ids | array | Array of wallpaper UUIDs to delete | Required |
ids.* | string | UUID format | Required |
confirm_deletion | boolean | Set to true for permanent deletion | Optional |
Response
{
"success": true,
"message": "تم حذف البيانات بنجاح.",
"data": null,
"status_code": 200
}
Authorization
All month wallpaper endpoints require admin authorization. The user must have the appropriate permissions to perform these operations.
Notes
- When a wallpaper is marked as selected, any previously selected wallpaper will be automatically unselected
- The poster image must be less than 1MB in size
- Supported image formats are JPEG, PNG, and JPG