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

اليوم ، يستمر التحول مع وصول WordPress REST API.

في هذا البرنامج التعليمي ، سوف أطلعك على ماهية واجهة برمجة تطبيقات WordPress REST وأريك كيفية استخدامها.

ولكن من قبل ، إذا لم تقم بتثبيت WordPress ، فاكتشف كيفية تثبيت ملف بلوق وورد في 7 خطوات et كيفية العثور عليها، وتثبيت وتفعيل موضوع ورد على بلوق 

ثم دعنا نعود إلى سبب وجودنا هنا

ما هي واجهة برمجة تطبيقات REST

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

نظرًا لطبيعة موضوع هذا البرنامج التعليمي ، فإن المعرفة الجيدة بلغة PHP و WordPress ضرورية.

ماذا نحتاج لهذا البرنامج التعليمي

لبدء استخدام REST API ، ستحتاج إلى المكون الإضافي REST API بالإضافة إلى أحدث إصدار من WordPress. لديك ؟ وإلا، ترى لماذا.  ستكون معرفة WordPress HTTP API أيضًا شركات جيدة لإجراء مكالمات عن بُعد.

اكتشاف من خلال النقر على هذا الرابط كيفية تثبيت (إضافة) البرنامج المساعد على وورد

كمشروع لهذا البرنامج التعليمي نحن سيخلق تثبيت محلي من وورد من خلالها سنقوم باسترداد المقالات من موقعنا على الإنترنت من خلال واجهة برمجة تطبيقات REST. تأكد من تثبيت البرنامج المساعد REST API وتنشيطه على موقع الإنتاج.

الآن ، قم بإنشاء القطعة في التثبيت المحلي الخاص بك. هنا هو الكود الأساسي:

/**
 * Plugin Name: REST API Widget Essai
 * Plugin URI: http://le-site-de-votre-widget-ici.com
 * Description: Ce widget récupère des articles à l'aide de l'API REST
 * Version: 1.0
 * Author: Votre nom
 * Author URI: http://votre-site.com
 */

class Mes_Articles_Widget extends WP_Widget {

    public function __construct() {
        $widget_details = array(
            'classname' => 'widget-essai-rest-api',
            'description' => 'Un widget qui récupère des articles à l'aide de l'API REST depuis un autre site'
        );

        parent::__construct( 'widget-essai-rest-api', 'REST API Widget Essai', $widget_details );

    }

    public function form( $instance ) {
        $title = ( !empty( $instance['title'] ) ) ? $instance['title'] : '';
        ?>

        <p>
            <label for="<?php echo $this->get_field_name( 'title' ); ?>">Title: </label>
            <input class="widefat" id="<?php echo $this->get_field_id( 'title' ); ?>" name="<?php echo $this->get_field_name( 'title' ); ?>" type="text" value="<?php echo esc_attr( $title ); ?>" />
        </p>

        <?php
    }
    public function widget( $args, $instance ) {
        echo $args['before_widget'];
        if( !empty( $instance['title'] ) ) {
            echo $args['before_title'] . apply_filters( 'widget_title', $instance['title'], $instance, $this->id_base ) . $args['after_title'];
        }
        // le code fonctionnel du widget ici
        echo $args['after_widget'];
    }
}
add_action( 'widgets_init', function(){
     register_widget( 'Mes_Articles_Widget' );
});

في دليل البرنامج المساعد لموقعك المحلي ، قم بإنشاء مجلد باسم التطبيق المصغر للتجارب بقية-API. في هذا المجلد ، قم بإنشاء ملف باسم التطبيق المصغر للتجارب بقية-api.php والصق الكود أعلاه.

اكتشف بالمناسبة كيفية إدارة واستعادة إصدار WordPress مع VersionPress

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

سوف نضع المزيد من التركيز على الوظيفة القطعة ()، لأنه بداخله تم بناء عرض القطعة. لذلك ، سنقوم بإجراء المكالمات باستخدام واجهة برمجة تطبيقات HTTP داخل هذه الوظيفة.

استرجاع المقالات

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

تسامي الصور التوضيحية الخاصة بك عن طريق اكتشاف كيفية إنشاء صور تفاعلية على مدونة ووردبريس

المسار الأساسي لـ WordPress REST API هو دائمًا / الفسفور الابيض بين سلمان / الفسفور الابيض / v2 /. وبالتالي، فإن المسار الكامل http://votre-domaine.com/wp-json/wp/v2/.

المسار المستخدم لاسترداد العناصر هو /المشاركات. ما الذي يجعل الطريق الكامل للمقالات هو http://votre-domaine.com/wp-json/wp/v2/posts.

يمكن أن يحتوي كل مسار على عدد من الإنهاءات ، متمايزة بواسطة طريقة HTTP المستخدمة. وبالتالي يمكن أن يكون مسار المقال / المشاركات / 291. هذا 3 طريق النهايات:

للحصول على : لاسترجاع المقال
ضع : لتحديث المقال
حذف : لحذف المقال.

باستخدام HTTP API وإنهاء GET ، يتم استرداد المقالات إلى سطر واحد من التعليمات البرمجية:

$response = wp_remote_get( 'http://mysite.com/wp-json/wp/v2/posts/' );

جعل مقالاتك شعبية من خلال اكتشاف كيفية إضافة أزرار المشاركة على وورد

إذا كان الجواب هو كائن WP_Error، ننهي تنفيذ وظيفتنا القطعة ()إذا لم يكن الأمر كذلك ، فإننا نقوم بفحص محتوى نص الإجابة مع الوظيفة wp_remote_retrieve_body البحث عن المقالات المشفرة بتنسيق JSON. هذا ما تبدو عليه الوظيفة القطعة ()  :

 public function widget( $args, $instance ) {
    $response = wp_remote_get( 'http://mysite.com/wp-json/wp/v2/posts/' );

    if( is_wp_error( $response ) ) {
        return;
    }

    $posts = json_decode( wp_remote_retrieve_body( $response ) );

    if( empty( $posts ) ) {
        return;
    }   
    echo $args['before_widget'];

    if( !empty( $instance['title'] ) ) {
        echo $args['before_title'] . apply_filters( 'widget_title', $instance['title'], $instance, $this->id_base ) . $args['after_title'];
    }
    if( !empty( $posts ) ) {
        echo '<ul>';
        foreach( $posts as $post ) {
            echo '<li><a href="' . $post->link. '">' . $post->title->rendered . '</a></li>';
        }
        echo '</ul>';
    }
    echo $args['after_widget'];
}

ما هو مثير للاهتمام في هذا المثال هو أنه من خلال استبدال الوظيفة wp_remote_get خلاف ذلك ، سيكون هذا المثال خارج نطاق WordPress. هذا يعني أنه يمكننا الاستعلام عن جوهر WordPress من أي نظام أساسي آخر ، سواء كان Joomla أو Prestashop أو Drupal أو Android أو IOS.

المضي قدما من خلال اكتشاف هذه ملحقات 8 WordPress لتحويل موقع الويب الخاص بك إلى تطبيق محمول

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

اذهب إلى أبعد من ذلك مع REST API

يشكل الاستعلام عن نواة WordPress بغرض التفاعل مع البيانات 90٪ من استخدامه. ولكن لا تزال هناك بعض المجالات التي سيكون من المثير للاهتمام استكشافها: التخزين المؤقت الاستجابة والمصادقة واكتشاف الخدمة.

التخزين المؤقت استجابة

عند استرداد معلومات مثل المقالات الموجودة في مثالنا ، فمن الممارسات الجيدة تخزينها مؤقتًا ، أي نسخها في مكان ما على الجهاز الطرفي المتصل لتجنب المكالمات الأخرى لنفس المعلومات إلى الخادم. توجد طرق مختلفة لتحقيق ذلك بما في ذلك CACHE JP REST APIو مخبأ الإضافات, والعابرين.

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

انظر أيضا هذه 7 plugins ووردبريس ملحقات لتحسين التخزين المؤقت لموقع الويب الخاص بك

ثم يتم استرداد المعلومات من قاعدة البيانات المحلية حتى انتهاء صلاحيتها حيث يتم استدعاؤها من موقع الويب البعيد. فيما يلي نسخة معدلة من عنصر واجهة المستخدم الخاص بنا والتي تتضمن مفهوم عابر (مع وظيفة جديدة):

public function get_remote_posts() {
    $posts = get_transient( 'remote_posts' );
    if( empty( $posts ) ) {
        $response = wp_remote_get( 'http://votre-domaine.com/wp-json/wp/v2/posts/' );
        if( is_wp_error( $response ) ) {
            return array();
        }

        $posts = json_decode( wp_remote_retrieve_body( $response ) );

        if( empty( $posts ) ) {
            return array();
        }

        set_transient( 'remote_posts', $posts, HOUR_IN_SECONDS );
    }

    return $posts;
}

public function widget( $args, $instance ) {
    $posts = $this->get_remote_posts();

    if( empty( $posts ) ) {
        return;
    }
    
    echo $args['before_widget'];

    if( !empty( $instance['title'] ) ) {
        echo $args['before_title'] . apply_filters( 'widget_title', $instance['title'], $instance, $this->id_base ) . $args['after_title'];
    }

    echo '<ul>';
    foreach( $posts as $post ) {
        echo '<li><a href="' . $post->link. '">' . $post->title->rendered . '</a></li>';
    }
    echo '</ul>';

    echo $args['after_widget'];

}

المصادقة

عند العمل مع الموارد الخارجية ، من المستحسن أن تحدد هويتك. يتم ذلك من خلال عملية المصادقة. تمنحك واجهة برمجة تطبيقات REST طريقتين لتعريف نفسك: المصادقة الأساسية و OAuth.

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

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

$headers = array (
    'Authorization' => 'Basic ' . base64_encode( 'username:password' ),
);

$response = wp_remote_request( 'http://votre-domaine.com/wp-json/wp/v2/posts/1234/', array(
    'method' => 'DELETE',
    'headers' => $headers
));

انظر أيضا كيفية إضافة مصادقة عامل مزدوج على وورد

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

أوث : هذه الطريقة ، لا تزال غامضة من وجهة نظر الوثائق تتطلب تثبيت البرنامج المساعد وتنشيطه OAuth1. يتضمن تنفيذ أسلوب المصادقة هذا التثبيت والاستخدام المشترك لـ WP-CLI، سطر أوامر لـ WordPress و العميل الفسفور الابيض CLI.

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

اكتشاف الخدمة

جزء من تعلم أي API أصبح على دراية بخياراتها. لذا أوصيك بفحص الجزء الموجود اكتشاف الخدمة من وثائق WordPress REST API.

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

تذكر أن هذا العمل قيد التنفيذ وهو بالفعل مثير للاهتمام للغاية.

من يستخدم WordPress REST API؟

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

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

الفسفور الابيض البحث لايف هو مكون إضافي مجاني يستخدم API لوظائف البحث الخاصة به.

editus هو مكون إضافي ممتاز يستخدم واجهة برمجة التطبيقات لوظائف تحرير الواجهة الأمامية.

D'أومجرد اللعب من يستخدم هذا الشيء؟ يقوم أشخاص وشركات أخرى بتطبيق WordPress REST API لبناء تطبيقات الهاتف المحمول.

على الرغم من شبابها ، فإن WordPress REST API تحمل وعدًا كبيرًا كميزة رئيسية في تحويل WordPress إلى نظام أساسي لتطوير التطبيقات.

هل تستخدم أيضًا واجهة برمجة تطبيقات WordPress REST؟  نود أن يكون لديك انطباعاتك حول هذا الموضوع.

كيف تجد الفرص التي يوفرها؟ شاركنا بردود أفعالك في قسم التعليقات.

اكتشف أيضًا بعض الإضافات المتميزة لبرنامج WordPress  

يمكنك استخدام ملفات أخرى الإضافات وورد لإضفاء مظهر عصري ولتحسين التعامل مع مدونتك أو موقعك على الويب.

نحن نقدم لك هنا بعض الإضافات WordPress المتميزة التي سوف تساعدك على القيام بذلك.

1. وورد في نهاية المطاف إعادة توجيه

يعد المكون الإضافي "WordPress Ultimate Redirect" هو الحل الوحيد الذي تحتاجه لإدارة جميع عمليات إعادة التوجيه و / أو 404 و / أو ترحيل الموقع و / أو تغيير المجال أو احتياجات النقل.

هناك مكونات إضافية تقوم بما يفعله البرنامج المساعد ، ولكن ليس كلها في نفس الوقت. يوفر هذا المكون الإضافي جميع وظائف إعادة التوجيه 404 المعتادة ، بالإضافة إلى "إعادة التوجيه التلقائي إلى أقرب تطابق لعنوان URL" المفضل لدينا.

تحميل | عرض | استضافة المواقع

2. Leadeo

هل تعلم أن استخدام مقطع فيديو على صفحتك المقصودة يمكن أن يحسن التحويلات بأكثر من 80٪. كذلك على صفحات المبيعات التي تحتوي على أكثر من 46٪. يمكن أن تساعدك Leadeo في الحصول على المزيد من العملاء المتوقعين والمبيعات من الأشخاص الذين يشاهدون الفيديو على مدونتك.

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

نظرًا لأن الفيديو يثير الاهتمام المتوقع ، يتم تقديم:

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

ويتم عرض كل هذه الإجراءات على يمين الفيديو فقط.

تحميل | عرض | استضافة المواقع

3. CommentPress

CommentPress هو مكون إضافي قوي ووردبريس مدمج يتيح لك إدراج وتعديل وحذف التعليقات بسرعة وسهولة. يستخدم CommentPress Ajax و jQuery و PHP لمنح الزوار القدرة على إدراج التعليقات دون الحاجة إلى إعادة تحميل الصفحة.

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

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

تحميل | عرض | استضافة المواقع

الموارد الموصى بها

تعرف على الموارد الأخرى الموصى بها لمساعدتك في بناء وإدارة موقع الويب الخاص بك.

• كيفية ربط موقع الويب الخاص بك مع ووردبريس برقية
• كيفية إضافة التمرير اللانهائي إلى مدونة WordPress
• كيفية إضافة أسئلة وأجوبة على مدونة وورد
• كيفية تصحيح وسائل الإعلام التي لم يعد يعمل على وورد

وفي الختام

هنا! هذا كل شيء في هذا البرنامج التعليمي. نأمل أن يكون هذا البرنامج التعليمي قد أوضح لك كيفية استخدام WordPress REST API. لا تتردد في شارك هذه المقالات مع أصدقائك على الشبكات الاجتماعية المفضلة لديك. 

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

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

...