معلمات سلسلة الاستعلام¶
يمكنك استخدام معلمات سلسلة الاستعلام لتخصيص السلوك السياقي لملحق WebView وتكوينه. يتم تطبيق المعلمات التي تكررها كلما قام المستخدم بتشغيل الإضافة أو إعادة تحميلها.
| المعلمة | الوصف | القيم الممكنة |
|---|---|---|
theme | نسق cTrader | light, dark |
symbol | الرمز النشط (الحالي) | EURUSD, GBPJPY, USDCAD, etc |
lang | لغة عميل cTrader | ar, cs, de, el, en, es, fr, hu, id, it, ja, ko, ms, pl, pt, ru, sk, sl, sr, th, tr, vi, zh |
platform | المنصة التي يتم تشغيل cTrader عليها | web, windows, macos, android, ios |
placement | موضع نافذة الإضافة | wl_bs, so_bs, so_eb, chart, asp_b, asp_t, tw_t, custom_w |
id | معرّف الإضافة الفريد للحماية من النسخ | مثال، 17238، 26047، 18359، وما إلى ذلك. |
أوصاف المواضع ¶
| الموضع | الوصف | المنصة | استخدام الرمز النشط (symbol) في سلسلة الاستعلام؟ |
|---|---|---|---|
wl_bs | لوحة أسفل علامات تبويب Trade | android، ios | لا |
so_bs | لوحة أسفل نظرة عامة على الرمز | android، ios | نعم |
so_eb | كتلة مضمنة لنظرة عامة على الرمز | android، ios | نعم |
chart | منطقة الرسم البياني | web، windows، macos | لا |
asp_b | كتلة ASP | web، windows، macos | نعم |
asp_t | علامة تبويب ASP | web، windows، macos | نعم |
tw_t | علامة تبويب Trade Watch | web، windows، macos | لا |
custom_w | نافذة مخصصة | web، windows، macos | لا |
ملاحظة
لحماية ملكيتك الفكرية ومنع النسخ، يمكنك تنفيذ آلية تتطلب من الإضافة تكرار معرّفها الفريد (id) عبر معلمة GET عند التشغيل. تحقق من صحة id في كل مرة يتم فيها تشغيل الإضافة، وامنع تنفيذ الإضافة إذا كان id الخاص بها لا يتطابق مع القيمة المتوقعة.
أمثلة ¶
مثال بسيط (بدون رمز)
https://example.com/ctrader_web_app_plugin?theme=dark&lang=en&platform=web&placement=chart&id=abc123
Mobile، النسق الفاتح، البرتغالية وEURUSD كرمز نشط
https://example.com/ctrader_web_app_plugin?theme=light&symbol=EURUSD&lang=pt&platform=android&placement=wl_bs&id=def456
Desktop مع كتلة ASP، النسق الداكن، الألمانية وGBPJPY كرمز نشط
https://example.com/ctrader_web_app_plugin?theme=dark&symbol=GBPJPY&lang=de&platform=windows&placement=asp_b&id=xyz789