العلامات المحددة لدى إعداد الموقع
يتم تحديد قيمة هذه العلامات في المجال الخاص لدى اعداد الموقع.
– #NOM_SITE_SPIP تعرض اسم الموقع.
– #URL_SITE_SPIP تعرض عنوان الموقع ولا تشمل رمز / في آخر العنوان مما يتيح لك انشاء وصلة من نوع #URL_SITE_SPIP/sommaire.php3.
– #DESCRIPTIF_SITE_SPIP (منذ SPIP ١.٩) تعرض وصف الموقع الذي يتم ادخاله في صفحة الاعداد العام للموقع.
– #EMAIL_WEBMASTER (منذ SPIP 1.5) تعرض عنوان البريد الالكتروني الخاص بمسؤول الموقع. افتراضياً، يأخذ SPIP عنوان الشخص الذي قام بتثبيت الموقع (اي المدير الاول).
– #LOGO_SITE_SPIP (منذ الاصدار ١.٨، ١.٨.١ من SPIP) تعرض شعار الموقع. منذ SPIP ١.٩ تسترجع هذه العلامة شعار الموقع صفر. ويجب التمييز بين هذا الشعار وشعار أصل الموقع المعروف بالشعار القياسي للأقسام اي شعار القسم صفر.
– #CHARSET (منذ SPIP 1.5) تعرض طقم الحروف المستخدم في الموقع. افتراضيآً تأخذ قيمة iso-8859-1 وهو طقم لاتيني معروف بإسم «iso-latin» [1].
– #LANG اي اللغة (منذ SPIP 1.7، SPIP 1.7.2) حين تستخدم خارج حلقات ARTICLES وRUBRIQUES وBREVES وAUTEURS، تسترجع لغة الموقع الاساسية.
– #LANG_DIR وLANG_LEFT<-]#LANG_LEFT و#LANG_RIGHT اي اتجاه اللغة (منذ SPIP 1.7، SPIP 1.7.2): هذه العلامات تحدد اتجاه الكتابة للغة في السياق الحالي (مثلاً للمقال الذي نعرضه). انظر المقال تطوير موقع متعدد اللغات لمزيد من المعلومات.
– #MENU_LANG (و#MENU_LANG_ECRIRE) اي قائمة اللغة (منذ SPIP 1.7، SPIP 1.7.2) تنشئ وتعرض قائمة باللغات تتيح للزائر الحصول على الصفحة الحالية باللغة التي يختارها. وتعرض العلامة الاولى قائمة بلغات الموقع بينما تعرض الثانية قائمة بلغات المجال الخاص (وتستخدم في صفحة الدخول الى المجال الخاص).
علامات تصميم الصفحات
– أدخل SPIP 1.8.2 علامة #DOSSIER_SQUELETTE (اي مجلد الصفحات النموذجية) للتمكن من تطوير صفحات نموذجية يمكن نقلها وتبديلها بسهولة. وتتيح هذه العلامة الحصول على مسار المجلد الذي يحتوي الصفحات المستخدمة.
يمكننا اذن وضع الملفات المرافقة للصفحات النموذجية (اوراق الأنماط وملفات جافاسكريبت...) في مجلد هذه الصفحات ويكفي توزيع هذا المجلد لتبادل الصفحات النموذجية. فمثلاً اذا اردنا ادراج ورقة انماط تأتي من مجلد الصفحات النموجية، نكتب:
<link rel="stylesheet" href="#DOSSIER_SQUELETTE/mon_style.css" type="text/css" />
منذ SPIP ١.٩، تحل علامة #CHEMIN مكان #DOSSIER_SQUELETTE وتحسّنها. وتعرض #CHEMIN{xxx} المسار الكامل نحو الملف xxx اينما وجد.
<link rel="stylesheet" href="#CHEMIN{mon_style.css}" type="text/css" />
– #PUCE (منذSPIP 1.5) تعرض ما تشاهده في اول هذا السطر.
– #FORMULAIRE_ADMIN (منذ SPIP 1.5) هي علامة اختيارية تتيح عرض ازرار الادارة («اعادة تحديث الصفحة»، الخ.) في الصفحات النموذجية. عندما يقوم احد المدراء بتصفح الموقع العمومي، واذا كانت هذه العلامة موجودة، يتم استبدالها بأزرار الادارة والا فتظهر هذه الازرار في اسفل الصفحة.
منذ الاصدار ١.٨، ١.٨.١ من SPIP، يمكن تعديل ورقة الانماط spip_admin.css للتحكم في موقع هذه الازرار.
– #DEBUT_SURLIGNE و#FIN_SURLIGNE علامتان تدلان SPIP على المكان في الصفحة حيث يجب تلوين الكلمات التي تم العثور عليها. أنظر حلقات البحث.
– اما العلامة #INSERT_HEAD (منذ SPIP 1.9.1)، فيجب ان توضع بين علامتي <head> و</head> في الصفحات النموذجية. انها تتيح للنظام، وللملحقات اذا وجدت، إضافة محتوى بين علامتي <head> و</head>.
العلامات التقنية
تحذير: هذه العلامات تتوجه الى مستخدمي SPIP المتمرسين.
– العلامة #REM لا تعرض اي شيء: تستخدم لإدخال ملاحظات وتعليقات على برمجة الصفحات النموذجية هكذا: [(#REM) هذا تعليق. ]. ولا تظهر هذه التعليقات في برمجة الصفحات في الموقع العمومي.
– #SELF (منذ الاصدار ١.٨، ١.٨.١ من SPIP)، تسترجع عنوان URL للصفحة المطلوبة ولكن بعد «تنظيفها» من المتغيرات الخاصة بمعالجة SPIP. مثلاً، اذا كان لدينا صفحة بعنوان URL: spip.php?article25&var_mode=recalcul، تسترجع علامة SELF# العنوان: spip.php?article25.
على سبيل المثال، اذا اردنا انشاء استمارة:
<form action='#SELF' method='get'>
ملاحظة: لا تتوافق علامة #SELF التي تدل الى عنوان الصفحة، مع الإدراجات <INCLURE()> (الا اذا كانت فترة الإدراج $delais تساوي صفراً.
– #URL_PAGE (منذ SPIP ١.٩) تسترجع عنوان URL من نوع «page» (راجع عناوين URL في SPIP نحو الصفحة الداخلة في المتغير والتي يمكن استخدامها كرابط. على سبيل المثال، للوصول الى الصفحة التي انتجتها الصفحة النموذجة my_page.html، الموجودة في مجلد الصفحات النموذجية، تقوم #URL_PAGE{my_page} آلياً بإنتاج عنوان URL التالي: spip.php?page=my_page. يُسمح بإدراج متغير ثان لإضافة قيم أخرى على عنوان URL. مثلاً، تنتج علامة #URL_PAGE{my_page,id_article=#ID_ARTICLE} عنوان URL التالي: spip.php?page=my_page&id_article=XXX.
– [(#ENV{xxxx,zzzz})] (منذ الاصدار ١.٨، ١.٨.١ من SPIP)، تتيح الوصول الي المتغير xxxx الذي تم تمريره في استفسار HTTP. اما zzzz، فهو جزء اختياري يتيح استرجاع قيمة حتى في حال عدم وجود المتغير xxxx. هناك تفسير مفصل لهذه العلامة على Spip-Contrib.
افتراضياً، يتم ترشيح العلامة ENV# بواسطة htmlspecialchars. واذا اردنا الحصول على النتيجة الخام، يمكن استخدام النجمة «*» كما هو الحال في العلامات الاخرى: [(#ENV*{xxxx})].
على سبيل المثال، اذا اردنا الحد من قائمة المؤلفين المعروضين:
<BOUCLE_authors(AUTEURS) {name == #ENV{letter,^A}}>
تسترجع قائمة بالمؤلفين الذين تناسب اسماؤهم التركيب المنتظم الذي تم تمريره في عنوان URL بواسطة المتغير letter (liste_auteur.php3?letter=^Z) او المؤلفين الذين تبدأ اسماؤهم بحرف «A» اذا كان لا يوجد متغير في عنوان URL.
– ترتبط العلامة #SPIP_CRON (منذ الاصدار ١.٨، ١.٨.١ من SPIP) بإدارة الحسابات التي ينفذها SPIP دورياً (الاحصاءات والفهرسة لمحرك البحث وترخيص المواقع الخ.).
اذا لم تكن هذه العلامة موجودة في الموقع، يقوم محرك SPIP بإنجاز حساباته، في الوقت المناسب، بعد ان يكون قد ارسل صفحة الى الزائر. ولكن للأسف لا يسمح PHP بإغلاق الاتصال في آخر الصفحة، وفي بعض الاحيان، قد يؤدي ذلك ببعض الزوار قليلي الحظ (وهم الذين يتسبب قدومهم الى الموقع بتنفيذ عملية معقدة مثل الترخيص) الى الانتظار طويلاً لتحميل الصفحة.
وتتيح علامة #SPIP_CRON تجنب هذه المشكلة: فيكمن دورها في انتاج علامة <div> غير مرئية تحتوي على خاصية خلفية «background» تطلب spip_background.php3. ويقوم هذا السكريبت بتنفيذ الحسابات اللازمة «في الخلفية» ويسترجع صورة شفافة بأبعاد ١x١ نقطة. وتتيح هذه الفكرة تجنب اي ابطاء وذلك بنقل هذا الابطاء المحتمل الى سكريبت فرعي.
ملاحظة: هذه العلامة ليست استراتيجية ولا يؤثر وجودها او غيابها على تواصل حساب المهمات الدورية في الموقع.
– تم ادخال العلامة #SET{متغير,قيمة} ومكملتها #GET{متغير} في SPIP 1.9.1. وترصد علامة #SET{xxx,yyy} قيمة yyy لمتغير xxx (خاصة بالصفحة النموذجية الناتجة). ويمكن استرجاع هذه القيمة بواسطة علامة #GET{xxx}. اما المتغيرات التي انشأت بهذه الطريقة، فلا يمكن تمريرها الى الصفحات النموذجية المدرجة.
تنبيه! اذا رصدنا قيمة لمتغير في الجزء الاختياري «قبل» في حلقة ما، لا يمكن استرجاع هذه القيمة في الحلقة نفسها. ويعود ذلك الى الطريقة التي يعالج فيها SPIP الصفحات النموذجية.
– تتيح العلامة #HTTP_HEADER{معامل} (منذ SPIP ١.٩) تعديل ترويسة HTTP الخاصة بالصفحة التي يسترجعها SPIP. مثلاً: #HTTP_HEADER{Content-Type: text/css}. تنبيه! يؤدي استخدام هذه العلامة الى اخفاء أزرار الإدارة. لا يمكن استخدام هذه العلامة في صفحات نموذجية مدرجة بواسطة أمر <INCLURE>.
– تقوم علامة #EVAL{معامل} (منذ SPIP ١.٩) بتقييم وحساب عبارة PHP الموجودة داخل الهلالين. مثلاً، تعرض علامة #EVAL{1+1} نتيجة العملية الحسابية: ٢ وتعرض #EVAL{_DIR_IMG_PACK} مسار المجلد ecrire/img_pack/. تنبيه، ننصح بشدة بعدم الافراط في استخدام هذه العلامة.
– العلامة #CACHE{فترة} تسمح بتحديد الفترة التي تتم بعدها إعادة حساب الصفحة النموذجية. الفترة محسوبة بالثواني. ويمكن كتابة الفترة على شكل عملية حسابية، مثلاً: #CACHE{24*3600}.
– العلامة #SQUELETTE وجدت منذ SPIP 1.9.1 وتعرض مسار الصفحة النموذجية الحالية.
– العلامة #VAL{argument} منذ SPIP ٢.٠ تسترجع المتغير argument الموجود بين الهلالين.