استخدام المتغيرات - البناء - وثائق Carrd
استخدام المتغيرات
يتطلب Pro Plus أو أعلى
تجعل المتغيرات من الممكن دمج المحتوى الديناميكي في نص الموقع، وروابط URL، وقيم النماذج، والمزيد. يتكون المتغير عادةً من اسم وقيمة احتياطية اختيارية:
{{name|fallback}}
جزء name من المتغير هو الاسم الفريد المرتبط بالمحتوى (أو القيمة) الذي تحاول تضمينه، بينما جزء fallback هو احتياطي اختياري في حالة كانت القيمة فارغة أو لم يكن المتغير موجودًا. على سبيل المثال، المتغير {{url.name}} في السطر التالي من النص:
Welcome, {{url.first_name}}!
... سيتم توسيعه إلى قيمة url.first_name، والتي في هذه الحالة هي معلمة URL first_name:
Welcome, Cayce!
وبالمثل، سيتم توسيع المتغير {{url.first_name|friend}} أيضًا إلى محتويات معلمة URL first_name، ولكن إذا كانت فارغة أو غير موجودة، فسيتم توسيعها إلى القيمة الاحتياطية friend:
Welcome, friend!
المتغيرات المدعومة
فيما يلي قائمة بجميع المتغيرات المدعومة حاليًا من قبل Carrd. يمكن استخدام المتغيرات ذات النطاق العالمي في أي مكان يتم دعم المتغيرات فيه. جميع المتغيرات الأخرى يمكن استخدامها فقط ضمن نطاقاتها المحددة.
تتطلب بعض المتغيرات تفاعل المستخدم قبل أن تتمكن من التوسع. على سبيل المثال، متغيرات النماذج مثل
{{email}}،{{form01.email}}، أو{{form01_response.confirmation_id}}ستتوسع فقط بعد أن يقوم المستخدم بإرسال النموذج المحدد.
| النطاق | المتغير | الوصف |
|---|---|---|
| عالمي | {{url.parameter_name}} | محتويات معلمة URL parameter_name. الاستخدامات الشائعة تشمل إضافة معلمات UTM (مثل utm_source وutm_medium) إلى الروابط الصادرة، وملء حقول النماذج ديناميكيًا بالقيم الافتراضية. |
| عالمي | {{client.date}} | تاريخ العميل المحلي بتنسيق رقمي (مثل 1/3/22). |
| عالمي | {{client.time}} | وقت العميل المحلي بتنسيق HH:MM (مثل 12:34 PM). |
| عالمي | {{client.fulldate}} | تاريخ العميل المحلي بتنسيق نصي (مثل January 3, 2022). |
| عالمي | {{client.fulltime}} | وقت العميل المحلي بتنسيق HH:MM:SS (مثل 12:34:56 PM). |
| عالمي | {{client.timestamp}} | اسم مستعار لـ client.utc_timestamp. |
| عالمي | {{client.utc_date}} | تاريخ UTC بتنسيق رقمي (مثل 1/3/22). |
| عالمي | {{client.utc_time}} | وقت UTC بتنسيق HH:MM (مثل 12:34 PM). |
| عالمي | {{client.utc_fulldate}} | تاريخ UTC بتنسيق نصي (مثل January 3, 2022). |
| عالمي | {{client.utc_fulltime}} | وقت UTC بتنسيق HH:MM:SS (مثل 12:34:56 PM). |
| عالمي | {{client.utc_timestamp}} | وقت UTC كطابع زمني Unix (مثل 1641213240). |
| عالمي | {{form.fieldId}} | يتوسع إلى قيمة حقل fieldId في النموذج الأخير المرسل. يتطلب تمكين تصدير المتغيرات على النموذج. |
| عالمي | {{form_response.key}} | يتوسع إلى قيمة key من استجابة النقطة النهائية الأخيرة للنموذج الأخير المرسل. يتطلب تمكين كل من تصدير المتغيرات وإرجاع استجابات النقطة النهائية على النموذج. يتم تسطيح الاستجابات ذات المفاتيح متعددة المستويات تلقائيًا. |
نموذج الاتصال
| المتغير | الوصف |
|---|---|
{{name}} | قيمة حقل الاسم في هذا النموذج. |
{{email}} | قيمة حقل البريد الإلكتروني في هذا النموذج. |
{{message}} | قيمة حقل الرسالة في هذا النموذج. |
{{company}} | قيمة حقل اسم الشركة في هذا النموذج. |
{{phone}} | قيمة حقل رقم الهاتف في هذا النموذج. |
{{subject}} | قيمة حقل الموضوع في هذا النموذج. |
{{consent}} | قيمة حقل الموافقة المطلوبة في هذا النموذج. |
نموذج التسجيل
| المتغير | الوصف |
|---|---|
{{email}} | قيمة حقل البريد الإلكتروني في هذا النموذج. |
{{fname}} | قيمة حقل الاسم الأول (أو حقل الاسم إذا كان يستخدم حقل اسم واحد). |
{{lname}} | قيمة حقل اسم العائلة في هذا النموذج. |
{{company}} | قيمة حقل اسم الشركة في هذا النموذج. |
{{phone}} | قيمة حقل رقم الهاتف في هذا النموذج. |
{{consent}} | قيمة حقل الموافقة المطلوبة في هذا النموذج. |
نموذج مخصص
| المتغير | الوصف |
|---|---|
{{fieldId}} | قيمة حقل fieldId في هذا النموذج. |
العناصر المدعومة
حاليًا، يتم دعم المتغيرات من قبل العناصر التالية:
| نوع العنصر | أين |
|---|---|
| الأزرار | التسميات، روابط URL |
| تضمين | الكود |
| النموذج | تسميات الأزرار، رسائل "عند الاكتمال"، روابط URL، والكود، رسائل "عند النجاح"، روابط URL، والكود، رسائل "عند الفشل"، روابط URL، والكود، كود حدث "عند الإرسال"، كود حدث "عند النجاح"، كود حدث "عند الفشل"، قيم الإدخال (المخصص)، تسميات الإدخال (المخصص) |
| المعرض | النص البديل، التسميات التوضيحية، روابط URL |
| الأيقونات | روابط URL |
| الصورة | النص البديل، روابط URL |
| الروابط | التسميات، روابط URL |
| القائمة | العناصر |
| الجدول | العناوين، الصفوف |
| النص | المحتوى |