حقل منطقي استضافة نوع دروبال

إرفاق حقول البيانات المخصصة للكيانات دروبال.

وAPI الميدان يسمح حقول البيانات المخصصة لتركيبها على الكيانات دروبال ويعتني تخزين والتحميل، والتحرير، وتقديم البيانات الميدانية. أي نوع كيان (عقدة، المستخدم، الخ) يمكن استخدام API الميدان لجعل نفسها "fieldable"، وبالتالي تسمح الحقول لضمها إليها. يمكن وحدات أخرى توفر واجهة المستخدم لإدارة الحقول المخصصة عبر متصفح الإنترنت، فضلا عن مجموعة واسعة ومرنة من نوع البيانات، عنصر النموذج، وقدرات تنسيق العرض.

ويعرف API الميدان اثنين من الهياكل الأساسية البيانات، والميدان مثيل، ومفهوم حزمة. يحدد حقل نوع معين من البيانات التي يمكن تركيبها على الكيانات. A مثيل الميدان هو الميدان تعلق على حزمة واحدة. A حزمة هو مجموعة من الحقول التي يتم التعامل معها على أنها مجموعة من الميدان إرفاق API ويرتبط إلى نوع كيان fieldable واحد.

على سبيل المثال، لنفترض أن أحد مديري الموقع يريد العقد المادة أن يكون العنوان الفرعي والصورة. باستخدام API الميدان أو وحدة نمطية UI الميدان، المسؤول بإنشاء حقل يسمى 'العنوان الفرعي' من نوع 'نص' وحقل يسمى "صورة" من نوع 'صورة'. المسؤول (مرة أخرى، من خلال UI) يخلق حالتين الميدان، واحد ربط "العنوان الفرعي" الحقل إلى "عقدة 'حزمة' المادة 'واحد ربط" الصورة "الحقل إلى" عقدة' حزمة 'المادة'. عندما يستخدم نظام عقدة مجال إرفاق API لتحميل جميع المجالات لعقدة المادة، فإنه يمر نوع كيان العقدة (والذي هو "عقدة") ونوع المحتوى (والذي هو "المادة")، وحزمة العقدة. field_attach_load () ثم تحميل "الترجمة" وحقل "صورة" لأنهم على حد سواء تعلق على 'العقدة' حزمة 'المادة'.

وتتمثل تعريفات الحقل وهو عبارة عن مجموعة من أزواج مفتاح / قيمة.

• معرف (عدد صحيح، للقراءة فقط). المعرف الأساسي من هذا المجال. يتم تعيينه تلقائيا من قبل field_create_field ().
• FIELD_NAME (سلسلة). اسم الحقل. كل اسم حقل فريد من نوعه داخل API الميدان. عندما يتم إرفاق حقل إلى كيان، يتم تخزين بيانات الحقل في كيان $ -> $ FIELD_NAME. طول الحد الأقصى هو 32 حرفا.
• نوع (سلسلة). نوع من الميدان، مثل "نص" أو "صورة". وتعرف أنواع الحقول من قبل وحدات التي تنفذ hook_field_info ().
• entity_types (مجموعة). مجموعة من أنواع الجهة التي يمكن أن تعقد الحالات في هذا المجال. إذا كان فارغ أو غير محددة، يمكن أن يكون مجال الحالات في أي نوع الكيان.
• أصل (صحيح). عدد القيم هذا المجال يمكن أن تعقد. القيم القانونية أي عدد صحيح موجب أو FIELD_CARDINALITY_UNLIMITED.
• للترجمة (صحيح). ما إذا كان الحقل للترجمة.
• مقفلة (صحيح). أم لا هو متاح لتحرير الحقل. إذا TRUE، لا يمكن للمستخدمين تغيير إعدادات الحقل أو إنشاء مثيلات جديدة من الحقل في واجهة المستخدم. افتراضات إلى FALSE.
• وحدة (سلسلة، للقراءة فقط). اسم الوحدة النمطية التي تطبق نوع الحقل.
• نشط (عدد صحيح، للقراءة فقط). TRUE إذا تم تمكين الوحدة النمطية التي تطبق نوع الحقل حاليا، FALSE خلاف ذلك.
• حذف (عدد صحيح، للقراءة فقط). TRUE إذا تم حذف هذا المجال، FALSE خلاف ذلك. يتم تجاهل الحقول حذفها من قبل الميدان إرفاق API. وجود هذه الخاصية لأن الحقول يمكن أن تكون علامة للحذف ولكن فقط دمرت في الواقع من خلال عملية جمع القمامة منفصلة.
• الأعمدة (صفيف، للقراءة فقط). مجموعة من الأعمدة API الميدان تستخدم لتخزين كل قيمة في هذا المجال. قد تعتمد لائحة العمود على إعدادات الميدان؛ أنها ليست ثابتة لكل نوع الحقل. مجال المواصفات العمود API هي بالضبط مثل مخطط مواصفات العمود API، ولكن اعتمادا على وحدة التخزين الميداني في الاستخدام، قد لا تمثل اسم العمود عمود الفعلي في قاعدة بيانات SQL.
• الفهارس (مجموعة). مجموعة من الفهارس على أعمدة البيانات، وذلك باستخدام صيغة تعريف نفس المواصفات مؤشر مخطط API. يسمح فقط الأعمدة التي تظهر في الإعداد "الأعمدة". لاحظ أن أنواع الحقول يمكن تحديد المؤشرات الافتراضية، والتي يمكن تعديلها أو إضافتها إلى عند إنشاء المجال.
• مفاتيح خارجية. (اختياري) صفيف النقابي من العلاقات، وذلك باستخدام نفس هيكل تعريف "مفاتيح الأجنبية من hook_schema (). ولكن لاحظ أن البيانات الميدانية ليست المخزنة بالضرورة في SQL. أيضا، استخدام محتمل محدودة، كما لا يمكنك تحديد حقل آخر كما والجداول SQL فقط القائمة ذات الصلة، مثل صيغ التصفية.
• ضبط (مجموعة). من الباطن مجموعة من أزواج / قيمة المفتاح من إعدادات الحقل من نوع معين. كل وحدة نوع الحقل تحدد وتوثق إعدادات المجال الخاصة بها.
• التخزين (مجموعة). وهناك مجموعة فرعية من أزواج مفتاح / قيمة تحديد الخلفية التخزين لاستخدامه في الحقل:

• نوع (سلسلة). الخلفية التخزين المستخدمة من قبل هذا المجال. وتعرف الخلفيات تخزين من قبل وحدات التي تنفذ hook_field_storage_info ().
• وحدة (سلسلة، للقراءة فقط). اسم الوحدة النمطية التي تطبق الخلفية التخزين.
• نشط (عدد صحيح، للقراءة فقط). TRUE إذا تم تمكين الوحدة النمطية التي تطبق الخلفية تخزين حاليا، FALSE خلاف ذلك.
• ضبط (مجموعة). وهناك مجموعة فرعية من أزواج مفتاح / قيمة الإعدادات. وتعرف كل الخلفيه التخزين وتوثق إعداداته الخاصة.

وتتمثل تعريفات المثال الحقل وهو عبارة عن مجموعة من أزواج مفتاح / قيمة.

• معرف (عدد صحيح، للقراءة فقط). المعرف الأساسي من هذا المثال المجال. يتم تعيينه تلقائيا من قبل field_create_instance ().
• FIELD_ID (عدد صحيح، للقراءة فقط). المفتاح الخارجي من الملعب تعلق على حزمة من هذه الحالة. يتم ملؤها تلقائيا من قبل field_create_instance ().
• FIELD_NAME (سلسلة). اسم الحقل تعلق على حزمة من هذه الحالة.
• ENTITY_TYPE (سلسلة). اسم نوع كيان يتم إرفاق المثال ل.
• حزمة (سلسلة). اسم الحزمة التي يتم إرفاق هذا المجال ل.
• تسمية (سلسلة). تسمية الذي يمكن قراءته للحقل عند استخدامها مع هذه الحزمة. على سبيل المثال، فإن التسمية أن يكون عنوان العناصر API نموذج لهذه الحالة.
• وصف (سلسلة). وصف الذي يمكن قراءته للحقل عند استخدامها مع هذه الحزمة. على سبيل المثال، فإن وصف يكون النص مساعدة من عناصر API نموذج لهذه الحالة.
• مطلوب (عدد صحيح). TRUE إذا كانت هناك حاجة إلى قيمة لهذا الحقل عند استخدامها مع هذه الحزمة، FALSE خلاف ذلك. حاليا، يتم فرض المطلوبة التي غمرت فقط خلال عمليات API نموذج، وليس من field_attach_load ()، field_attach_insert ()، أو field_attach_update ().
• default_value_function (سلسلة). اسم الوظيفة، إن وجدت، التي من شأنها أن توفر قيمة افتراضية.
• DEFAULT_VALUE (مجموعة). إذا لم يتم تعيين default_value_function، ويمكن توفير القيم ثم الثابتة.
• حذف (عدد صحيح، للقراءة فقط). TRUE إذا تم حذف هذه الحالة، FALSE خلاف ذلك. يتم تجاهل حالات حذفها من قبل الميدان إرفاق API. وجود هذه الخاصية لأن الحالات يمكن أن تكون علامة للحذف ولكن فقط دمرت في الواقع من خلال عملية جمع القمامة منفصلة.
• ضبط (مجموعة). من الباطن مجموعة من أزواج / قيمة المفتاح من إعدادات سبيل المثال حقل من نوع معين. كل وحدة نوع الحقل تحدد وتوثق إعدادات المثال الخاصة بها.
• القطعة (مجموعة). وهناك مجموعة فرعية من أزواج مفتاح / قيمة تحديد المدخلات القطعة API نموذج للحقل عند استخدامها من قبل هذه الحزمة:

• نوع (سلسلة). نوع القطعة، مثل text_textfield. يتم تعريف أنواع عنصر واجهة المستخدم من قبل وحدات التي تنفذ hook_field_widget_info ().
• ضبط (مجموعة). من الباطن مجموعة من أزواج / قيمة المفتاح من إعدادات القطعة من نوع معين. كل وحدة حقل نوع القطعة وتحدد وتوثق إعدادات القطعة الخاصة به.
• الوزن (تعويم). وزن القطعة نسبة إلى عناصر أخرى في أشكال كيان تحرير.
• وحدة (سلسلة، للقراءة فقط). اسم الوحدة النمطية التي تطبق نوع القطعة.

• CRUD الميدان API. إنشاء والتحديثات، وحذف المجالات، حزم (المعروف أيضا باسم "أنواع المحتوى")، والحالات. وحدات تستخدم هذا API، في كثير من الأحيان في hook_install ()، لإنشاء هياكل البيانات المخصصة.

• الميدان إرفاق API. يربط أنواع كيان إلى API الميدان. الميدان إرفاق تحميل وظائف API وتخزين وتوليد هياكل API نموذج، عرض، وأداء مجموعة متنوعة من المهام الأخرى للبيانات ميدانية متصلة الكيانات الفردية. أنواع كيان Fieldable مثل العقدة والمستخدم تستخدم هذا API لجعل أنفسهم fieldable.

• معلومات الحقل API. يعرض معلومات حول كافة المجالات، وحالات، والحاجيات، والمعلومات ذات الصلة التي تحددها أو مع API الميدان.

• API التخزين الميدان. يوفر نظام التخزين الخلفية للتوصيل البيانات الميدانية الفعلية. تطبيق الافتراضي، field_sql_storage.module. البيانات الميدانية مخازن في قاعدة البيانات SQL المحلية.

• API الميدان حذف البيانات كبيرة الحجم. ينظف بعد عمليات حذف مجمعة مثل field_delete_field () وfield_delete_instance ().

• API لغة الميدان. يقدم الدعم متعدد اللغات الأصلية للAPI الميدان.

مقالات ذات صلة

إرجاع مجموعة renderable لقيمة حقل واحد. المعلمات $ ENTITY_TYPE. نوع الكيان $. مثلا "العقدة" أو "المستخدم". $ الكيان. الكيان يحتوي على الحقل لعرضهم. يجب أن لا يقل عن ...

عندما نذهب إلى المسار / المشرف / هيكل / أنواع / إدارة / من المادة / المجالات واستخدام خيار إضافة حقل جديد أو إضافة خيار الحقل الموجود، لا أن إنشاء حقل أو إنشاء المثال حقل أو مجال نعلق ...

أرسلت بواسطة tejaspmehta يوم 18 أغسطس 2011 في 06:25 أستخدمه CCK + المشاهدات لخلق طلب واحد في D7. لقد التالية CCK. فئة التصنيف الفرعي (حقل واحد لديه مرجعية عقدة لفئة) ...

ويوفر هذا المشروع الإصدارات D7 من 'node_reference "و" user_reference "أنواع الحقول، التي كانت جزءا من حزمة CCK في D6، في التكافؤ الوظيفي مع نظرائهم D6. نرى...

تحتوي هذه الحزمة على حد سواء وقت / زمن نوع الحقل حقل تاريخ مرونة وAPI التسجيل التي يمكن استخدامها وحدات أخرى. تتطلب الإصدارات D5 وD6 من حقل تاريخ أدوات البناء المحتوى ...