المساعدة
تسجيل الدخول

تعديل التعليمات البرمجية للقالب

يمكنك تعديل التعليمات البرمجية لقالبك لإجراء تغييرات تفصيلية على متجرك الإلكتروني باستخدام محرر التعليمات البرمجية. تحتوي معظم الملفات التي يتكون منها القالب على Liquid، لغة قوالب Shopify. تحتوي ملفات القوالب أيضًا على HTML، وCSS، وJSON، وJavaScript. لا تُعدّل التعليمات البرمجية لقالب إلا إذا كنت على دراية بلغتَي HTML وCSS، ولديك فهم أساسي لـ Liquid.

لا يمكنك تعديل التعليمات البرمجية لقالبك إلا بعد شرائه. ويتضمن ذلك استخدام أداة إنشاء التعليمات البرمجية بالذكاء الاصطناعي (AI) في محرر القوالب. إذا كنت تستخدم إصدارًا تجريبيًا من قالب مدفوع، فستحتاج إلى شرائه قبل أن تتمكن من إجراء تغييرات على التعليمات البرمجية.

يعرض محرر التعليمات البرمجية دليلًا لملفات قالبك، ومساحة لعرض الملفات وتعديلها. عند النقر على ملف في الدليل، فإنه يُفتح في محرر التعليمات البرمجية. يمكنك فتح عدة ملفات وتعديلها في نفس الوقت. ويمكنك أيضًا فتح عدة ملفات ومراجعتها في نفس الوقت.

تخطيط محرر التعليمات البرمجية للقالب

في هذه الصفحة

تعديل التعليمات البرمجية لقالبك

يمكنك استخدام محرر التعليمات البرمجية لتعديل ملفات قالبك.

الخطوات:

أجهزة الكمبيوتر المكتبية

  1. من لوحة تحكم مسؤول Shopify، انتقل إلى المتجر الإلكتروني > القوالب.

  2. انقر على قائمة أفقية > تعديل التعليمات البرمجية.

الهواتف المحمولة

  1. من تطبيق Shopify، اضغط على أيقونة القائمة.

  2. في قسم قنوات المبيعات، اضغط على المتجر الإلكتروني.

  3. اضغط على إدارة القوالب.

  4. اضغط على قائمة أفقية > تعديل التعليمات البرمجية.

حفظ التغييرات

عند تعديل ملف، تُعرض نقطة بجوار اسم علامة التبويب للإشارة إلى وجود تغييرات غير محفوظة. انقر على زر حفظ لحفظ تغييراتك. يمكنك أيضًا إدخال ⌘ + S في نظام Mac أو Ctrl + S في نظام Windows لحفظ التغييرات.

محرر تعليمات برمجية جزئي يوضح ملفًا غير محفوظ بجوار زر الحفظ

تنسيق التعليمات البرمجية للقالب

لإصلاح المسافة البادئة للتعليمات البرمجية، افتح لوحة الأوامر (Command Palette) باستخدام ⌘ + Shift + P في Mac أو Ctrl + Shift + P في Windows وأدخل format، ثم حدد تنسيق المستند.

الخطوات:

  1. من لوحة تحكم مسؤول Shopify، انتقل إلى المتجر الإلكتروني > القوالب.

  2. انقر على قائمة أفقية > تعديل التعليمات البرمجية.

  3. افتح الملف الذي تريد تنسيقه.

  4. أدخل ⌘ + P في نظام Mac أو Ctrl + P في نظام Windows.

  5. في لوحة الأوامر، أدخل format، ثم اضغط على Enter في لوحة المفاتيح.

  6. احفظ الملف.

لوحة الأوامر مع تحديد خيار تنسيق الكود

تتبع تغييرات الملف

لاستعادة ملف قالب مُعدَّل إلى إصدار سابق، استخدم عرض المخطط الزمني لهذا الملف.

يستعيد عرض المخطط الزمني ملفًا حاليًا واحدًا في كل مرة. فهو لا يستعيد قالبًا بأكمله، ولا يمكنه استرداد ملفات القالب المحذوفة. سجل المخطط الزمني محدود، لذلك قد لا تتوفر الإصدارات الأقدم.

تستبدل الاستعادة محتويات الملف بالكامل، بما في ذلك التغييرات التي قد ترغب في الاحتفاظ بها. قبل استعادة أي ملف، انسخ محتويات الملف الحالي في مكان آمن إذا كنت ترغب في الاحتفاظ بأي تغييرات.

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

الخطوات:

  1. من لوحة تحكم مسؤول Shopify، انتقل إلى المتجر الإلكتروني > القوالب.

  2. انقر على قائمة أفقية > تعديل التعليمات البرمجية.

  3. افتح الملف الحالي الذي ترغب في مراجعته أو استعادته.

  4. اختياري: إذا كنت ترغب في الاحتفاظ بأي تغييرات حالية، فانسخ محتويات الملف الحالي في مكان آمن قبل الاستعادة.

  5. في عرض المخطط الزمني، انقر على إدخال في المخطط الزمني لمقارنة الاختلافات.

  6. لاستبدال محتويات الملف بالكامل بالإصدار السابق المحدد، انقر بزر الماوس الأيمن على إدخال المخطط الزمني، ثم حدد استعادة المحتويات.

  7. انقر على استعادة.

Theme Check

يتضمن محرر الأكواد ميزة Theme Check، وهي ميزة تساعد على منع الأخطاء من خلال تقديم ملاحظات فورية أثناء كتابة الكود، بدلاً من اكتشاف الأخطاء في قالبك المباشر.

في محرر الأكواد، يمكن لميزة Theme Check تحديد الأخطاء التالية في الكود المُعدَّل:

  • البرامج النصية التي تحظر التحليل، والتي يمكن أن تبطئ واجهة المتجر
  • عدم التناسق بين ملفات الترجمة، مثل مفاتيح الترجمة المفقودة أو الترجمات غير المتطابقة في ملف الإعدادات المحلية (locale file)
  • النماذج المفقودة

يُشار إلى الأخطاء بخط أحمر أسفل الكود. لعرض الخطأ، مرّر مؤشر الماوس فوق الخط المميّز.

البحث والاستبدال في محرر الأكواد

يمكنك البحث داخل محرر الأكواد بإحدى الطريقتين التاليتين:

  • البحث في كود ملف معين.
  • البحث في كود جميع الملفات في القالب.

يمكنك أيضًا استبدال الكود في ملف معين أو في حالات متعددة عبر جميع ملفات القالب. كما يمكنك البحث عن ملف بالاسم من أجل فتح ملف.

البحث داخل ملف

يمكنك البحث في الكود بملف معين، واستبدال الكود. استخدم مفاتيح الأسهم لمراجعة كل حالة من الكود.

واجهة مستخدم البحث داخل ملف في محرر الأكواد

بعد البحث عن كود، يمكنك استبدال الكود في ملف.

الخطوات:

  1. من لوحة تحكم مسؤول Shopify، انتقل إلى المتجر الإلكتروني > القوالب.

  2. انقر على قائمة أفقية > تعديل التعليمات البرمجية.

  3. افتح الملف الذي تريد البحث فيه.

  4. أدخِل ⌘ + F على جهاز Mac أو Ctrl + F على نظام تشغيل Windows.

  5. في حقل البحث، أدخِل مصطلح البحث الخاص بك.

  6. اختياري: لاستبدال الكود، أكمل الإجراءات التالية:

  • في النافذة المنبثقة للبحث، انقر على أيقونة سهم متجه لليمين.
  • في حقل استبدال، أدخِل الكود البديل. يمكنك النقر على الحفاظ على حالة الأحرف لمطابقة حالة أحرف الكود البديل مع الحالة الحالية.
  • انقر على أيقونة استبدال لاستبدال حالة واحدة في كل مرة، أو انقر على أيقونة استبدال الكل لاستبدال جميع الحالات دفعة واحدة.

البحث عبر جميع الملفات

انقر على زر البحث في الشريط الجانبي الأيسر للبحث عبر جميع ملفات القالب. تعرض النتائج كل حالة من حالات مصطلح البحث الخاص بك والملف الذي تظهر فيه.

اللوحة الجانبية للبحث في محرر الأكواد

الخطوات:

  1. من لوحة تحكم مسؤول Shopify، انتقل إلى المتجر الإلكتروني > القوالب.

  2. انقر على قائمة أفقية > تعديل التعليمات البرمجية.

  3. انقر على أيقونة البحث لفتح لوحة البحث.

  4. في حقل البحث، أدخِل مصطلح البحث الخاص بك.

  5. اختياري: لاستبدال الكود، أكمل الإجراءات التالية:

  • في النافذة المنبثقة للبحث، انقر على أيقونة سهم متجه لليمين.
  • في حقل استبدال، أدخِل الكود البديل.
  • استبدل حالة واحدة في كل مرة، أو جميع الحالات دفعة واحدة.

خيارات البحث المتقدمة

لتضييق نطاق نتائج البحث، استخدم واحدًا أو أكثر من خيارات البحث التالية:

  • يؤدي خيار مطابقة حالة الأحرف إلى إرجاع مصطلحات البحث التي تتطابق مع حالة الأحرف. على سبيل المثال، إذا أدخلت product، فسيقوم البحث بتمييز أي حالات لكلمة "product" أو "Product". إذا حددت مطابقة حالة الأحرف، فسيقوم البحث بتمييز حالات product فقط.
  • يؤدي خيار مطابقة الكلمة بالكامل إلى إرجاع مصطلحات البحث التي تتطابق مع الكلمة بالكامل، ويستبعد التطابقات الجزئية. على سبيل المثال، إذا أدخلت cart، فسيقوم البحث بتمييز حالات "cart" ولكن ليس "carton".
  • يؤدي خيار استخدام التعبير النمطي إلى إرجاع نتائج البحث التي تتطابق مع التعبير النمطي (regex). التعبير النمطي هو سلسلة من الأحرف تحدد نمط مطابقة في النص.

في لوحة البحث، يمكنك أيضًا تحديد الملفات والمجلدات لتضمينها أو استبعادها من نتائج البحث.

انقر على قائمة أفقية لفتح القائمة المتقدمة. يمكنك إدخال أي مسار ملف أو مجلد في حقلي ملفات للتضمين أو ملفات للاستبعاد. لإضافة أكثر من ملف أو مجلد واحد، افصل بينها بمسافة وفاصلة. على سبيل المثال، للبحث عن ملفات في مجلد الأقسام (sections)، أدخِل ./sections في حقل ملفات للتضمين.

يمكنك أيضًا البحث داخل مجلد معين من عرض دليل الملفات. انقر بزر الماوس الأيمن على مجلد، ثم حدد بحث في المجلد... من القائمة المنسدلة.

إدارة ملفات القالب

يمكنك إدارة الملفات في كود القالب. يمكنك حذف الملفات، وإضافة ملفات جديدة، وإعادة تسمية الملفات، واستعادة ملفات الكود الحالية المُعدَّلة من عرض المخطط الزمني الخاص بها عند توفر إصدار سابق. لا تحتوي ملفات الأصول، مثل الصور، وCSS، وJavaScript، والخطوط الموجودة في مجلد assets، على سجل للمخطط الزمني.

فتح ملف قالب

لفتح ملف قالب، انقر على مجلد، ثم انقر على اسم الملف من المستكشف. يمكنك أيضًا البحث عن الملفات بالاسم أو الامتداد، ثم فتح الملف.

الخطوات:

  1. من لوحة تحكم مسؤول Shopify، انتقل إلى المتجر الإلكتروني > القوالب.

  2. انقر على قائمة أفقية > تعديل التعليمات البرمجية.

  3. أدخل ⌘ + P في نظام Mac أو Ctrl + P في نظام Windows.

  4. أدخِل اسم الملف في شريط البحث وحدد الملف، أو حدد ملفًا من قائمة تم فتحها مؤخرًا.

إضافة ملف قالب جديد

لإضافة ملف، حدد مجلدًا، وانقر على أيقونة ملف جديد، ثم أدخِل اسم الملف وامتداد الملف.

يمكن أن تتضمن أسماء الملفات أحرفًا من A إلى Z وأرقامًا من 0 إلى 9، ولا يمكن أن تتضمن مسافات. افصل بين الكلمات باستخدام شرطات (-) أو شرطات سفلية (_). يتم تحديد امتداد الملف بواسطة نقطة . ونوع الامتداد. على سبيل المثال، .liquid أو .css.

الخطوات:

  1. من لوحة تحكم مسؤول Shopify، انتقل إلى المتجر الإلكتروني > القوالب.

  2. انقر على قائمة أفقية > تعديل التعليمات البرمجية.

  3. انقر على المجلد الذي تريد إضافة ملف جديد إليه.

  4. انقر بزر الماوس الأيمن على اسم المجلد وحدد ملف جديد... من القائمة المنسدلة.

  5. أدخل اسمًا جديدًا للملف.

  6. اضغط على Enter في لوحة المفاتيح.

رفع أصل جديد

يمكنك رفع أصل جديد، مثل أيقونة أو ملف صورة، إلى مجلد assets في محرّر التعليمات البرمجية.

الخطوات:

  1. من لوحة تحكم مسؤول Shopify، انتقل إلى المتجر الإلكتروني > القوالب.

  2. انقر على قائمة أفقية > تعديل التعليمات البرمجية.

  3. انقر بزر الماوس الأيمن على مجلد assets.

  4. انقر على رفع....

  5. حدد الملف الذي تريد رفعه.

  6. انقر على فتح.

إعادة تسمية ملف قالب

يمكنك النقر بزر الماوس الأيمن على ملف لإعادة تسميته. تأكد من عدم تعديل أو إزالة امتداد الملف. يتم تحديد امتداد الملف بنقطة . ونوع الامتداد. على سبيل المثال، .liquid أو .css. يمكن أن تتضمن أسماء الملفات الأحرف من A إلى Z، والأرقام من 0 إلى 9، ولا يمكن أن تتضمن مسافات. افصل بين الكلمات بشرطات أو شرطات سفلية. إذا كان اسم الملف غير صالح، فلن يتم حفظ اسم الملف الجديد.

الخطوات:

  1. من لوحة تحكم مسؤول Shopify، انتقل إلى المتجر الإلكتروني > القوالب.

  2. انقر على قائمة أفقية > تعديل التعليمات البرمجية.

  3. انقر بزر الماوس الأيمن على ملف وحدد إعادة تسمية... من القائمة المنسدلة.

  4. أدخل اسمًا جديدًا للملف.

  5. اضغط على Enter في لوحة المفاتيح.

حذف ملف قالب

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

الخطوات:

  1. من لوحة تحكم مسؤول Shopify، انتقل إلى المتجر الإلكتروني > القوالب.

  2. انقر على قائمة أفقية > تعديل التعليمات البرمجية.

  3. انقر بزر الماوس الأيمن على ملف وحدد حذف نهائيًا من القائمة المنسدلة.

  4. انقر على حذف.