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

أنت تعرض مستندات 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>