> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plato.ae/llms.txt
> Use this file to discover all available pages before exploring further.

# قيم الحقل

> أرسل قيم الحقل CMS بالشكل الذي تتوقعه Plato.

تأتي مفاتيح الحقول CMS من مخطط قاعدة البيانات في Plato CMS.

استخدم مفتاح الحقل، وليس تسمية العرض، في طلبات API.

## حقول النص

نص غير مترجم:

```json theme={null}
{
  "values": {
    "sku": "BURGER-CLASSIC"
  }
}
```

النص المترجم:

```json theme={null}
{
  "values": {
    "name": {
      "en": "Classic Burger",
      "ar": "Classic Burger"
    }
  }
}
```

إذا قمت بإرسال سلسلة عادية إلى حقل مترجم، فسيقوم Plato بتخزينها باللغة الإنجليزية.

## أرقام

تقبل حقول الرقم وشريط التمرير والتقييم القيم الرقمية:

```json theme={null}
{
  "values": {
    "price": 38,
    "rating": 4.5
  }
}
```

## القيم المنطقية

تبديل الحقول وحقول مربع الاختيار بدون خيارات تقبل القيم المنطقية:

```json theme={null}
{
  "values": {
    "published": true
  }
}
```

## حدد وحدد متعدد

عادةً ما تقبل حقول التحديد المفردة قيمة خيار واحدة:

```json theme={null}
{
  "values": {
    "status": "published"
  }
}
```

تقبل حقول الأنماط متعددة التحديد مصفوفة:

```json theme={null}
{
  "values": {
    "tags": ["featured", "summer"]
  }
}
```

استخدم قيم الخيارات الثابتة من مخطط CMS.

## التواريخ والأوقات

تتم تسوية حقول التاريخ والوقت مع سلاسل ISO.

```json theme={null}
{
  "values": {
    "startsAt": "2026-06-17T10:00:00.000Z"
  }
}
```

## JSON

تقبل حقول JSON الكائنات أو المصفوفات أو الأرقام أو السلاسل أو القيم المنطقية أو `null`.

```json theme={null}
{
  "values": {
    "metadata": {
      "source": "website",
      "featured": true
    }
  }
}
```

إذا قمت بإرسال JSON كسلسلة، فيجب أن تكون صالحة JSON.

## حقول الملفات والصور

تقوم حقول الملفات والصورة بتخزين مراجع الملفات.

بالنسبة للحقول ذات الملف الفردي، أرسل قيمة واحدة:

```json theme={null}
{
  "values": {
    "heroImage": "file_id_or_url"
  }
}
```

بالنسبة للحقول متعددة الملفات، أرسل مصفوفة:

```json theme={null}
{
  "values": {
    "gallery": ["file_1", "file_2"]
  }
}
```

## القيم الفارغة

استخدم `null` أو سلسلة فارغة لمسح معظم الحقول ذات القيمة الفردية.

تصبح الحقول متعددة القيم مصفوفة فارغة عند مسحها.

تصبح الحقول المنطقية `false` عند مسحها.