إضافة نصوص برمجية مخصّصة

يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. المعلومات

لإضافة رمز JavaScript مخصّص أو محتوى HTML قبل علامة <body> على كل صفحة في البوابة:

  1. اختَر نشر > البوابات واختَر البوابة.
  2. انقر على الإعدادات في الصفحة المقصودة. بدلاً من ذلك، يمكنك اختيار الإعدادات في القائمة المنسدلة في شريط التنقّل العلوي.
  3. انقر على علامة التبويب النصوص البرمجية المخصّصة.

  4. في قسم النصوص البرمجية المخصّصة، أدخِل رمز JavaScript المخصّص في مربّع النص. يمكنك تضمين نصوص برمجية متعددة.

  5. انقر على حفظ.

تقدِّم الأقسام التالية أمثلة على النصوص البرمجية المخصّصة:

اطّلِع أيضًا على ضبط تتبُّع الإحصاءات.

تنفيذ نص برمجي مخصَّص أثناء حدث onLoad أو onUnload JavaScript

تحديد النصوص البرمجية المخصصة التي سيتم تنفيذها في كل صفحة في البوابة:

  • يتم التحميل في DOM باستخدام حدث JavaScript onLoad.
  • يتم نقله بعيدًا عن استخدام حدث JavaScript onUnload.

يجب تحديد الدالة المخصّصة كجزء من portal.pageEventListeners في مساحة الاسم العامة (المعلَنة في المتغيّر window).

يكون الحدثان onLoad وonUnload هما أول مَعلمتَين لهما المسار الحالي للصفحة (/quickstart، على سبيل المثال). تتلقّى الدالة onUnload كمَعلمتها الثانية القيمة المعروضة من الاستدعاء onLoad، ما يسمح بتمرير السياق بين الحدثَين. استخدِم onUnload لإزالة أدوات معالجة الأحداث التي لم تعُد مطلوبة وتنفيذ أنشطة أخرى لحذف البيانات.

مثال:

<script>
window.portal = {};
window.portal.pageEventListeners = {
  onLoad: (path) => {
    if (path === '/quickstart') {
      // Change text content of first <p> element to something
      // else. (DOM must be loaded when onLoad is called)
      document.getElementsByTagName('p')[0].textContent =
          'Welcome to the quick start! Be sure to send us your feedback.';
      // print a custom message to the console every second while user is on
      // quickstart page.
      const interval =
          window.setInterval(() => console.log('Hello'), 1000);
      return interval;
    }
    return undefined;
  },
  onUnload: (path, contextReturnedFromOnLoad) => {
    if (contextReturnedFromOnLoad != null) {
      // Stop printing custom message to console every second.
      window.clearInterval(contextReturnedFromOnLoad)

    }
  },
};
</script>

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

على سبيل المثال، يستخدم النص البرمجي التالي نص معلومات ملفات تعريف الارتباط.

<script type="text/javascript" id="cookieinfo" src="//cookieinfoscript.com/js/cookieinfo.min.js">
</script>