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

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

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

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

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

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

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

يمكنك أيضًا الاطّلاع على مقالة ضبط تتبُّع الإحصاءات.

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

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

  • يتم تحميل كل صفحة في نموذج العناصر في المستند (DOM) باستخدام حدث JavaScript‏ onLoad.
  • يتم الانتقال إلى صفحة أخرى باستخدام حدث JavaScript‏ onUnload.

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

يتلقّى كلٌّ من الحد0/} وonUnload المسار الحالي للصفحة (/quickstart مثلاً) كمعلَمة أولى.onLoad تتلقّى الدالة 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، لذا اختَر الخيار الذي يلبي متطلبات الامتثال المحدّدة لديك.

على سبيل المثال، يستخدم النص البرمجي التالي Cookie Info Script.

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