دليل بسيط لواجهة برمجة تطبيقات WooCommerce

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

في هذه المقالة ، سنقدم WooCommerce REST API ، ونتحدث عن كيفية ارتباطها بواجهة برمجة تطبيقات WordPress الخاصة. سنناقش أيضًا سبب رغبتك في استخدام هذه التقنية القوية ، وكيفية البدء.

دعنا نقفز مباشرة!

تقديم WooCommerce REST API

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

لفهم كيفية عمل هذه الميزة الرئيسية ، ستحتاج إلى التعرف على مصطلحين:

• نقل الدولة التمثيلي (REST). هذا موضوع معقد ، ولكن لأغراض هذه المقالة ، فإن REST هي نوع من "خدمات الويب" التي تتيح لك الوصول إلى عناصر معينة من صفحة الويب.
• واجهة برمجة التطبيقات (API). على النقيض من واجهة المستخدم الرسومية (GUI) ، تعد هذه في الأساس مجموعة من أدوات ربط الشفرات والمرشحات التي تتيح لك العمل مع نقاط الوصول. بشكل عام ، ستقوم بترميزها في بعض الملفات المستندة إلى WordPress.

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

كيف ترتبط WooCommerce API بواجهة برمجة تطبيقات WordPress REST

عندما تم تقديمه لأول مرة ، كانت WooCommerce API كيانًا واحدًا. بمعنى آخر ، تم تصميمه فقط للوصول إلى "نقاط نهاية" WooCommerce ، ولم يؤثر على أي عناصر أخرى في WordPress.

ومع ذلك ، بمجرد تقديم WordPress REST API ، تم دمج نقاط نهاية WooCommerce لإنشاء `` go-to '' شامل للوصول إلى WordPress تحت الغطاء. ومع ذلك ، لا يزال هناك توثيق لـ WooCommerce API. إذا قرأت مقدمة هذا المستند ، فسيتم توضيح تاريخ واجهة برمجة التطبيقات بشكل عام.

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

لماذا قد ترغب في استخدام WooCommerce API

قد ترى بالفعل لماذا WooCommerce REST API هو سهم مثير وقوي في جعبة متجرك. فيما يلي بعض الأسباب التي تجعلك تفكر في استخدامه:

• لديك وظائف مخصصة لتنفيذها. إذا لم تتمكن من العثور على ما تحتاجه من خلال المكونات الإضافية أو السمات أو مقتطفات التعليمات البرمجية الإضافية ، فقد يكون إنشاء الوظيفة بنفسك خيارًا.
• يمكن للعملاء الحصول على واجهة أمامية مخصصة. باستخدام الميزات الأوسع لواجهة برمجة تطبيقات WordPress REST ، يمكنك فصل الواجهة الأمامية لموقعك من النهاية الخلفية. يتيح لك هذا الاستفادة من قوة WordPress تحت الغطاء ، أثناء إنشاء تخطيطات الصفحة وتصميماتها باستخدام لغة أخرى.
• يمكن لفريقك استخدام نهايات خلفية مخصصة. تمامًا كما قد يحصل عملاؤك على تجربة واجهة أمامية فريدة ، يمكنك سحب أجزاء مختلفة من WooCommerce لإنشاء لوحة معلومات خلفية مخصصة. يمكنك تضمين أي مقاييس أو بيانات تقريبًا ، مما يؤدي بشكل أساسي إلى إنشاء واجهة المستخدم الخاصة بك ونظام التحليلات.

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

ما يمكنك تحقيقه باستخدام واجهة برمجة تطبيقات WooCommerce (4 أمثلة)

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

1. إنشاء المنتجات وتحديثها وحذفها

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

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

2. أوامر العملية والملاحظات المرتبطة بها

إذا كانت المنتجات هي شريان الحياة لمتجرك ، فإن الطلبات هي وقود الصواريخ. على هذا النحو ، توفر WooCommerce API الكثير لمساعدتك في إدارة الطلبات والملاحظات. من الناحية العملية ، يمكن الوصول إلى كل خاصية موجودة في WooCommerce ، إلى جانب خصائص الفوترة والشحن والبيانات الوصفية ذات الصلة.

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

تعد ملاحظات طلب تحديث الدُفعة استخدامًا مفيدًا آخر لهذا الجانب من واجهة برمجة التطبيقات. يمكن أن يساعدك أخذ مجموعة من طلبات عيد الميلاد ، وتقسيمها بناءً على حالة كل منها ، وتنظيم JSON الناتج في جدول بيانات على تسليم الطلبات بشكل أسرع وأكثر كفاءة.

3. ضبط معدلات الضرائب وفئاتها

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

• معدلات الضرائب: هذا هو المكان الذي يتم فيه تسجيل النسبة المئوية الفعلية ، إلى جانب بعض البيانات التعريفية الأخرى.
• فئات الضرائب: هي نطاقات واسعة من الضرائب التي يتم تطبيق المعدلات عليها.

على سبيل المثال ، يمكنك إنشاء معدل ضريبة بنسبة 20٪ يتم تطبيقه على فئة "السعر القياسي". في الواقع ، تعد القدرة على تحديث معدلات الضرائب دفعة استخدامًا جيدًا لواجهة برمجة تطبيقات WooCommerce. من الأمثلة الفريدة على ذلك الإعداد حيث يتم إنشاء معدل أو فئة ضريبية بناءً على سمة عميل معينة. يعد هذا مثاليًا للمواقف التي تحتاج فيها إلى "تأهيل" العميل قبل تسجيله أو إرساله إلى عملية السداد.

4. تعيين مناطق الشحن والمواقع والطرق

إذا سبق لك أن حاولت العمل مع الشحن في WooCommerce ، فسوف تفهم ما يمكن أن يكون عليه حقل ألغام. إذا أخطأت في أي عنصر ، فإن العميل يتأثر مباشرة في منطقة ناضجة للتعليقات والمراجعات السيئة. لحسن الحظ ، يمكن لـ WooCommerce API العمل مع جميع نقاط النهاية المرتبطة بالشحن ، مثل المناطق والمواقع والطرق.

عند المقارنة بالجوانب الأخرى لواجهة برمجة التطبيقات ، لا يوجد الكثير من السمات للعمل معها هنا. ومع ذلك ، لا يزال هناك الكثير من الخيارات المتاحة لمساعدتك في التعامل مع بيانات متجرك. بينما سترغب غالبًا في "تعيين ونسيان" معلومات الشحن (نظرًا لتعقيدها وتأثيرها على تجربة المستخدم) ، لا تزال هناك بعض التطبيقات العملية.

على سبيل المثال ، من المحتمل أن تكون على دراية بلوائح COVID-19 الحالية على مستوى الولاية والدولة. مع وضع ذلك في الاعتبار ، يمكنك التفكير في استخدام مجموعة من نقاط النهاية لتقييد الشحن إلى مواقع معينة على أساس مؤقت. بالإضافة إلى ذلك ، يمكنك إخطار المستخدمين بأي تأخيرات في وقت الشراء. يمكن أن يحدث هذا على شاشة الخروج ، أو من خلال الاتصال الجماهيري.

كيف تبدأ استخدام WooCommerce API

تعمل WooCommerce REST API عبر نظام رقمي قائم على المفتاح لمنح الوصول والأذونات. تتكون عملية المصادقة هذه من خطوتين مميزتين:

• تنشئ WooCommerce مفتاحين: مفتاح المستهلك والمفتاح السري . إنها مصنوعة من سلاسل عشوائية من الشخصيات ، ومن المستحيل عمليًا كسرها.
• عندما تريد إجراء "اتصال" بواجهة برمجة تطبيقات REST ، فسيتعين عليك تقديم هذه المفاتيح كدليل على المصادقة.

هذه العملية مباشرة ، لكن الحصول على هذه المفاتيح (واستخدام واجهة برمجة التطبيقات نفسها) يتطلب منك التوجه إلى لوحة معلومات WooCommerce - تحديدًا إلى WooCommerce> الإعدادات> شاشة متقدمة . ستحتاج إلى البحث عن رابط REST API في الأعلى ، وانتقل إلى تلك الشاشة ، ثم انقر فوق الزر Create an API key :

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

أخيرًا ، حدد زر إنشاء مفتاح API ، وانتظر حتى يقوم WordPress بعمله. سترى مفتاح المستهلك والمفتاح السري هنا ، ورمز QR لمزيد من المصادقة ، ورابط لإلغاء الوصول إلى واجهة برمجة التطبيقات في المستقبل. من المهم نسخ المفاتيح الآن ، حيث لا يمكنك استردادها لاحقًا.

في هذه المرحلة ، تكون جاهزًا لبدء البرمجة. إذا كان هذا شيئًا جديدًا بالنسبة لك ، فإن التعاقد مع مطور للمساعدة يعد فكرة جيدة. ومع ذلك ، إذا كنت تريد القفز إلى نفسك ، فيمكنك استخدام "عميل API" مثل Postman أو Insomnia للقيام بالكثير من الرفع الثقيل:

لإلقاء نظرة واقعية على كيفية استخدام WooCommerce API ، يمكنك التحقق من مدونات المطورين حول هذا الموضوع. على سبيل المثال ، يقدم James Kemp من IconicWP رؤى مفيدة حول كيفية اتصال تطبيق ويب PHP وعدد قليل من التعليمات البرمجية بمتجر للتجارة الإلكترونية ومعالجة بياناته.

استنتاج

عندما يتعلق الأمر باختيار نظام أساسي ملائم لكل من المستخدمين والمطورين ، يمكن القول إن WordPress هو رقم واحد. بالإضافة إلى ذلك ، تعد WooCommerce صديقة لأصحاب المتاجر الذين يريدون البساطة والقوة والمرونة. جزء مما يجعلها قابلة للتكيف هي WooCommerce REST API. على الرغم من أن هذا كان في يوم من الأيام كيانًا منفصلاً ، فقد تم دمجه الآن في واجهة برمجة تطبيقات WordPress REST الرئيسية.

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

هل تفكر في استخدام WooCommerce API لمتجرك ، وإذا كان الأمر كذلك ، ما أكثر ما يثيرك بشأنه؟ واسمحوا لنا أن نعرف في قسم التعليقات أدناه!

رصيد الصورة المميز: monkographic / shutterstock.com