الاستمارات

يتم ادراج الاستمارات في الصفحات النموذجية باستخدام علامة بسيطة، فيتكفل SPIP بعدها بإدارة تصرف هذه الاستمارة (الذي لا يخلو من التعقيد) بالعتماد على البيئة الموجودة فيها واعدادات المجال الخاص.

وظائف التفاعلية

– #FORMULAIRE_RECHERCHE

انها استمارة محرك البحث المدمج في SPIP. ونعرض تفاصيلها في مقال حلقات البحث.

– #FORMULAIRE_FORUM

انها استمارة تتحكم بالواجهة التي تتيح ارسال مشاركات الى المنتديات العامة. تعتمد هذه الاستمارة اذاً على حلقة #FORUMS ولكن يمكن استخدامها في كل الحلقات التي تدعم المنتديات:

• حلقة ARTICLES (المقالات)
• حلقة RUBRIQUES (الأقسام)
• حلقة BREVES (الأخبار)
• حلقة SITES او SYNDICATION (المواقع المرخصة)

وبالطبع، فتعتمد الاستمارة على الخيار المحدد للمنتديات اي المراقبة الاستباقية او البعدية او بالاشتراك.

[SPIP 1.8.2] افتراضياً، عندما يرسل الزائر المشاركة، يتم نقله الى صفحة العنصر [1] الذي ردّ عليه. يمكن اختيار نقل الزائر الى صفحة أخرى بإضافة متغير الى عنوان URL في هذه العلامة. مثلاً:

• تنقل [(#FORMULAIRE_FORUM{'spip.php?page=thanks'})] الزائر الى صفحة spip?page=thanks.

لمحة تاريخية: في ما يتعلق بالإصدارات السابقة الإصدار [SPIP 1.9]، يجب كتابة thanks.php3.

حتى الإصدار [SPIP 1.9]، كانت ملفات SPIP تحمل لاحقة .php3 وليس .php.

• تأخذ [(#FORMULAIRE_FORUM{#SELF})] الى الصفحة التي تحتوي استمارة المنتدى (انظر علامة SELF# الذات->art2245]

في الحالة الخاصة حيث سمحنا باستخدام المفاتيح في المنتديات، يمكن جعل تصرف الاستمارة اكثر دقة باستخدام متغيرات التخصيص.

– #FORMULAIRE_SIGNATURE

تعرض هذه العلامة استمارة تسمح لزوار الموقع بتوقيع العرائض المرتبطة بالمقالات. يتم اذا، وضع هذه الاستمارة في حلقة #ARTICLE.

ملاحظة: يتطلب توقيع العرائض تصديق اجباري على التواقيع بواسطة البريد الالكتروني. لذلك لا تنفع هذه الاستمارة الا اذا كان جهاز خدمة الموقع يدعم ارسال البريد آلياً باستخدام PHP.

– #FORMULAIRE_SITE

تم إدخالها في [SPIP 1.4] وتعرض هذه الاستمارة واجهة تتيح لزوار الموقع اقتراح مواقع مبوبة. وتظهر هذه المواقع في وضعية «مقترحة» في المجال الخاص بانتظار التصديق عليها من قبل احد المدراء.

ولا تظهر هذه الاستمارة الا اذا قمت بتفعيل خيار «إدارة دليل للمواقع» في قسم اعداد الموقع في المجال الخاص واذا قمت بإعطاء خيار «من يمكنه اقتراح مواقع مبوبة» قيمة «زوار الموقع العمومي».

وبما ان المواقع المبوبة في SPIP ترتبط فقط بالاقسام، لا يمكن وضع هذه الاستمارة الا في حلقة RUBRIQUES.

– #FORMULAIRE_ECRIRE_AUTEUR

[SPIP 1.4]اذا تم وضعها في حلقة AUTEURS (اي مولفون)، تعرض هذه العلامة استمارة تتيح ارسال بريد الى مؤلف المقال. ويسمح ذلك بالكتابة الى المؤلفين دون الحاجة لعرض عناوينهم البريدية في الموقع العمومي.

[SPIP 1.8.2] اذا وضعنا الاستمارة داخل حلقة ARTICLES مقال، تتيح إرسال بريد الكتروني مباشرة الى جميع مؤلفي هذا المقال.

[SPIP 1.8.2] اذا وضعنا الاستمارة داخل حلقة FORUMS منتدى، تتيح إرسال بريد الكتروني مباشرة الى مؤلف المشاركة اذا كان هذا الأخير مسجلاً في الموقع.

التسجيل والتثبت

– #FORMULAIRE_INSCRIPTION

مما لا شك فيه ان هذه هي اهم علامة لأنها تعرض استمارة تتيح تسجيل محررين جدد. ولا تعرض هذه الاستمارة الا اذا كنت قد سمحت بالتسجيل الآلي من الموقع العمومي (في حال لم تسمح يذلك، لا تعرض هذه العلامة اي شيء).

ويتطلب التسجيل ارسال معلومات الاتصال (اي المعرف وكلمة المرور) بالبريد الالكتروني لذا لا تعمل هذه الاستمارة الا اذا كان جهاز خدمة الموقع يدعم ارسال البريد الآلي بواسطة PHP.

– [(#FORMULAIRE_INSCRIPTION{6forum})]

هذه العلامة هي نظيرة العلامة السابقة وهي مخصصة لتسجيل الزوار الراغبون في المساركة في المنتديات (المحصورة بالزوار المسجلين). ويمكن تحديد هذا الخيار في المجال الخاص في إعداد الموقع/التفاعلية/ الوصعية الافتراضية لتشغيل المنتديات العامة. المتغير «6forum»يعود الى تسمية وضعية المؤلف المطلوبة لدى التسجيل.

بعد التصديق، تظهر رسالة تنبه الزائر: «تم ارسال معرّفك الجديد عبر البريد.»

– #LOGIN_PRIVE

لا تقل اهمية هذه العلامةعن سابقتها اذ انها تعرض الاستمارة التي تتحكم بالوصول الى المجال الخاص (اي المجال «ecrire/» في الموقع).

مهم: يجب ان تكون هذه العلامة موجودة في الصفحة النموذجية التي تناديها spip.php?page=login، اي افتراضياً في الصفحة login.html. والحال انه لدى محاولة الدخول المباشر الى المجال «ecrire/»، سيقوم SPIP بإعادة توجيهك الى spip.php?page=login.

لمحة تاريخية: في ما يتعلق بالإصدارات السابقة الإصدار SPIP ١.٩، الصفحة النموذجية هي التي تسترجعها spip_login.php3، أي قياسياً الصفحة المسماة spip_login.html.

بشكل عام، وحتى SPIP ١.٩، كانت عناوين URL العائدة للصفحات التي ينتجها SPIP على شكل http://mysite.net/xxx.php3 وليس http://mysite.net/spip.php?page=xxx.

– #LOGIN_PUBLIC

SPIP 1.4 ان استخدام هذه العلامة محدد. فهي تعرض استمارة تتيح للمستخدمين التعريف بنفسهم وهم باقون في الموقع العمومي (اي دون الدخول الى المجال الخاص). وتتيح هذه العلامة خاصة، تثبيت الزوار في المواقع التي تقدم منتديات مراقبة بالاشتراك. كما انها قد تستخدم كأساس لحصر زيارة بعض اجزاء الموقع العمومي مع ان ذلك لا يخلو من التعقيد حالياً ويتطلب مزيد من التطوير والتوثيق قبل استخدامه بشكل عادي. على اي حال هناك مثال حول هذا الاستخدام المتطور لاحقاً في هذا المقال.

افتراضياً، يقوم #LOGIN_PUBLIC بإنشاء «حلقة حول نفسه»، اي، بمعنى آخر، ان الاستمارة تعود الى الصفحة الموجودة فيها. على انه يمكن تحديد صفحة اخرى تؤدي اليها الاستمارة بعد ملئها، هكذا:

[(#LOGIN_PUBLIC|spip.php?page=mapage)]

هناك كتابة أخرى ممكنة (وهي الوحيدة لممكنة في SPIP ٢، اذ يكفي إضافة عنوان URL كمتغير وليس عبر مرشح. مما يعطي:

 [(#LOGIN_PUBLIC{#URL_PAGE{mapage}})]

لمحة تاريخية: في ما يتعلق بالإصدارات السابقة الإصدار SPIP ١.٩، كان يجب كتابة mypage.php3 وليس spip.php?page=mypage.

بشكل عام، وحتى SPIP ١.٩، كانت عناوين URL للصفحات التي ينتجها SPIP على شكل http://mysite.net/xxx.php3 وليس http://mysite.net/spip.php?page=xxx .

اذا كان موقعك يقدم تسجيلاً آلياً للدخول الى المجال الخاص، تكون بيانات الدخول الى الموقع العمومي هي نفسها للدخول الى المجال الخاص. في المقابل، اذا كنت قد منعت التسجيل الآلي للدخول الى المجال الخاص، يجب ان يكون هناك مقال واحد على الاقل يملك منتدى مراقب «بالاشتراك» لتفعيل هذه العلامة. حينها يمكن لـSPIP توفير معلومات التصال بالموقع العمومي دون امكان الدخول الى المجال الخاص.

– #URL_LOGOUT [SPIP 1.5] هو نظير #LOGIN_PUBLIC، اذ يعطي عنوان URL يتيح الخروج لزائر معرّف.
لاحظ ان كون #URL_LOGOUT علامة «ديناميكية»، ستعيد دائماً نتيجة بحيث تكون الأجزاء الشرطية (علامات SPIP: التركيب اللغوي) من العلام دائماً ظاهرة. هكذا تعيد كتابة من نوع [<a href="(#URL_LOGOUT)">خروج</a>] علامة html للرابط <a href="">خروج</a> عندما لا يكون الزائر معرّفاً. أدناه نتحدث حول العرض الشرطي لرابط الخروج.

[SPIP 1.8.2] يمكن إضافة متغير الى هذه العلامة لتحديد عنوان الرجوع بعد الخروج. مثلاِ: تعيد [(#URL_LOGOUT{spip.php?page=sommaire})] الى الصفحة الأولى.

لمحة تاريخية: في ما يتعلق بالإصدارات السابقة الإصدار SPIP ١.٩، كان يجب كتابة [(#URL_LOGOUT{sommaire.php3})] وليس [(#URL_LOGOUT{spip.php?page=sommaire})].

بشكل عام، وحتى SPIP ١.٩، كانت عناوين URL للصفحات التي ينتجها SPIP على شكل http://mysite.net/xxx.php3 وليس http://mysite.net/spip.php?page=xxx .

نعرض هنا مثال بسيط لكنه كامل عن استخدام هاتين العلامتين. على انه يجب استخدام القليل من برمجة PHP لاختيار القيمة {{$auteur_session}} التي تحدد هل هناك مؤلف متصل ام لا. فإذا كلن الملف متصلاً، يمكن الحصول على (وحتى التأكد من) وضعه، ومعرّفه الخ. من خلال قيمة $auteur_session[‘statut’]...

لاحظ ان المحتوى مؤمن في هذه الصفحة النموذجية فقط. فإذا كان لديك صفحة لطباقة المقال مثلاً وهي لا تتأكد من $auteur_session، يمكن لأي كان (بما في ذلك محركات البحث) الوصول الى هذا المحتوى الذي تحاول حمايته.

<?php if ($auteur_session) { ?>

انت مثبت <a href=’#URL_LOGOUT’>انقر هنا للخروج</a>

...المحتوى المحمي هنا...

<?php } else { ?>

<h2>هذا الجزء محصور الوصول</h2>
#LOGIN_PUBLIC

<?php } ?>

منذ SPIP ٢.٠، لم يعد من النافع استخدام اوامر php في الصفحات النموذجية. صار من الممكن كتابة:

[(#LOGIN_PUBLIC|non)
  [<a href="(#SESSION|oui)
    #URL_LOGOUT">خروج</a>
  ]
]

لعرض اتمارة الدخول او رابط الخروج حسب وضعية الزائر (معرّف او غير معرّف).

اوراق الانماط

يمكن ادخال تعديلات مهمة على واجهة الاستمارات بواسطة اوراق الأنماط.