دليل القوالب والدوال اجراء تغييرات خاصة على قالبك

دليل القوالب والدوال

اجراء تغييرات خاصة على قالبك امر بسيط, فقط تحتاج لمعرفة كيف تستخدم دوال المدونة الخاصه. هذه الدوال تعمل مع HTML في قالبك. لترى مثال كيف تعمل الدوال في المدونه, يمكنك فتح احد القوالب.

كيف تعمل الدوال

بداية الدوال تكون <% ونهايتها %>. يمكن استخدامها لعرض معلومات وبيانات مختلفه في مدونتك. على سبيل المثال, وضع <%Title%> في قالبك سوف يعرض عنوان او اسم المدونه. اما الدوال التي تكون بدايتها <> ونهايتها </&gt. اي بيانات بينهم يتم تعديلهم بكشل خاص, او يتم عرضها اكثر من مره. مثلاً وضع, placing <Entry><%EntryTitle%></Entry> سوف يعرض عنوان كل مقالة في مدونتك.

قائمة الدوال

في مايلي قائمة كاملة بكل الدوال والوسوم المتوفره لك:

• 
  
  <%Title%>
  هذه الدالة تعرض اسم المدونه, والذي تذكره في ملفك الشخصي. يمكنك استخدامها في اي مكان من القالب, وضعها بين دوال <title></title> .
  
  


• 
  
  <%Description%>
  هذه الدالة تعرض النبذه المختصره عن مدونتك, والتي ذكرتها في ملفك الشخصي.
  
  


• 
  
  <%Avatar%>
  هذه الدالة تطبع عنوان الصورة الشخصية, والذي حددته في تعديل ملفك الشخصي. عموماً, هي تستخدم داخل وسم <img> , على سبيل المثال:
  <img src="<%Avatar%>" border="0">
  
  


• 
  
  <%Email%>
  هذه الدالة تطبع بريدك الالكتروني, والذي ادخلته في ملفك الشخصي.
  
  


• 
  
  <%MainPageURL%>
  هذه الدالة تعرض عنوان (URL) مدونتك. استخدمها لتوفير رابط للعودة الى الصفحة الرئيسية لمدونتك لكي يعود الزائر عبرها بعد قرائة اي مقاله. على سبيل المثال:
  <a href="<%MainPageURL%>">Home</a>
  
  


• 
  
  <%ProfileURL%>
  هذه الدالة تطبع عنوان (URL) ملفك الشخصي. استخدمها لتوفير رابط الى ملفك الشخصي. على سبيل المثال:
  <a href="<%ProfileURL%>">My Profile</a>
  
  


• 
  
  <%ArchiveURL%>
  هذه الدالة تطبع عنوان (URL) صفحة ارشيف مدونتك. تستخدم لتوفير رابط للارشيف حيث يتصفح زوار المدونه المقالات القديمة. مثلاً:
  <a href="<%ArchiveURL%>">Archives</a>
  
  


• 
  
  <IfMainPage> </IfMainPage>
  اي شي بين هذه الوسوم سوف يعرض فقط في الصفحة الرئيسية للمدونة.
  
  


• 
  
  <IfEntryPage> </IfEntryPage>
  اي شي بين هذه الوسوم سوف يعرض فقط في الصفحة الخاصة باي مقالة.
  
  


• 
  
  <IfArchivePage> </IfArchivePage>
  اي شي بين هذه الوسوم سوف يعرض فقط في ارشيف المدونة.
  
  









<%ArchiveInfo%>
استخدم هذه الدالة بين وسوم <IfArchivePage></IfArchivePage> . وستطبع قائمة الارشيف.





• 
  
  <RecentEntry> </RecentEntry>
  في اغلب المدونات, المقالات الجديدة تظهر كقائمة بروابط احدث ماتم كتابته في المدونه. هذه الدالة ستطبع HTML لكل مقالة وتتكرر حتى تصل الى العدد الذي حددته لاحدث المقالات في الخيارات العامة. بداخلها, يمكنك ادارج اي او كل الدوال التالية:
  
  









<%RecentEntryTitle%>
هذه الدالة تطبع عنوان المقالة الجديدة, مربوطة برابطها الدائم.









<%RecentEntryDate%>
هذه الدالة تطبع تاريخ المقالة الجديدة, مربوطة برابطها الدائم.









<%RecentEntryTime%>
هذه الدالة تطبع وقت المقالة الجديدة, مربوطة برابطها الدائم.





• 
  
  <Entry> </Entry>
  هذة الوسوم ربما هي الاكثر اهمية. يتم استخدامها لعرض المقالات في مدونتك. لكل مقالة, اي شي بين هذة الوسوم سيتم طباعته مرة واحده - لذا اذا كتبت خمس مقالات, فان HTML ودوال المدونة وسط هذه الوسوم سيتم طباعتها خمس مرات. تذكر, من خلال الخيارات العامة تحدد كم مقالة تظهر في الصفحة الواحدة. وفيما يلي الدوال التي يمكن استخدامها بين هذة الوسوم:
  
  









<%EntryTitle%>
هذو الدالة تطبع عنوان المقالة.









<%EntryAuthor%>
هذة الدالة تطبع اسم كاتب المقالة (اي. اسمك او اسم العرض حسب ملفك الشخصي).









<%EntryDate%>
هذة الدالة تطبع تاريخ المقالة حسب نمط التاريخ الذي اخترته في الخيارات العامة.









<%EntryTime%>
هذة الدالة تطبع وقت المقالة حسب نمط الوقت الذي اخترته في الخيارات العامة.









<%EntryBody%>
هذة الدالة تطبع محتوى المقالة.









<%EntryURL%>
هذة الدالة تطبع الرابط المباشر للمقالة. تستخدم للربط بصفحة المقالة ليتم استعراضها لوحدها كاملاً, مثلاً:
<a href="<%EntryURL%>">Permanent Link</a>









<SendThisLink> </SendThisLink>
اي شي بين هذا الوسم سيتم ربطة بصفحة ارسل هذا الرابط. في هذة الصفحة, سيتمكن زوار مدونتك من ارسال بريد الى اي شخص يحوي رابط للمقالة المختاره.









<IfCommentsAllowed> </IfCommentsAllowed>
هذة الوسوم توضع بين <Entry> </Entry> . اي شي بين هذة الوسوم سوف يظهر فقط اذا كان التعليق متاحاً (كما اخترت في صفحة خيارات التعليق). في الاسفل الوسوم والدوال التي يمكنك استخدامها داخلها:












<IfCommentPostAllowed> </IfCommentPostAllowed>
حسب إعداداتك (في صفحة خيارات التعليق), بعض الزوار يمكنهم استعراض التعليقات لكن لايمكنهم إضافتها. اي شي بين هذة الوسوم سيتم عرضه فقط للمستخدمين المتاح لهم إضافة تعليق.









<%CommentPostURL%>
هذه الدالة تطبع عنوان (URL) اضافة التعليقات على المقالة. اذا اردت من الزوار التعليق على مقالاتك, يجب ان توفر هذا الرابط. مثلاً:
<a href="<%CommentPostURL%>">Post Comment</a>









<%EntryCommentCount%>
هذة الدالة تطبع عدد التعليقات على المقالة. يمكنك عرضها قبل او بعد المقالة. مثلاً:
<%EntryCommentCount%> تعليق.









<Comment> </Comment>
في حال عرض تعليقات المقالات, سيتم عرضهم باستخدام محتوى الدوال. فاذا كان هناك ثلاث تعليقات على المقالة, فان محتوى هذة الدالة سيتم عرضة ثلاث مرات - مرة لكل تعليق. اي شي بين هذة الوسوم سيتم عرضة فقط في حال وجود تعليق او اكثر على المقالة. فيما يلي الوسوم والدوال التي يمكن استخدامها بين هذة الوسوم:












<CommentEdit> </CommentEdit>
إذا كنت تسمح للمستخدمين بتعديل تعليقاتهم, يجب ان توفر لهم رابط يضغطونه اذا قرروا ذلك. محتوى هذة الوسوم سيظهر فقط في حال كنت تسمح للمستخدمين بتعديل تعليقاتهم. وككاتب في مدونتك, سترى ايضاَ هذا الرابط. مثال:
<CommentEdit>Edit</CommentEdit>









<CommentDelete> </CommentDelete>
إذا كنت تسمح للمستخدمين بحذف تعليقاتهم, يجب ان توفر لهم رابط يضغطونه اذا قرروا ذلك. محتوى هذة الوسوم سيظهر فقط في حال كنت تسمح للمستخدمين بحذف تعليقاتهم. وككاتب في مدونتك, سترى ايضاَ هذا الرابط. مثال:
<CommentDelete>Delete</CommentDelete>









<%CommentTitle%>
هذة الدالة تطبيع عنوان التعليق.









<%CommentAuthor%>
هذة الدالة تطبع اسم كاتب التعليق مع رابط الى ملفة الشخصي.









<%CommentAuthorAvatar%>
هذة الدالة تطبع الامتداد الى صورة الكاتب الشخصية في حال كان لدية واحده.









<%CommentAuthorIP%>
اذا كنت اخترت تسجيل رقم اي بي كاتب التعليق في صفحة خيارات التعليق, هذة الدالة تعرض رقم ايبي كاتب التعليق لك انت فقط.









<%CommentDate%>
هذة الدالة تطبع تاريخ التعليق حسب نمط التاريخ الذي حددته في الخيارات العامة.









<%CommentTime%>
هذة الدالة تطبع وقت التعليق حسب نمط الوقت الذي حددته في الخيارات العامة.









<%CommentBody%>
هذة الدالة تطبع محتوى التعليق.









<%CommentURL%>
هذة الدالة تطبع الرابط الثابت للتعليق.





• 
  
  <IfPages> </IfPages>
  محتوى هذة الدالة سيتم عرضة فقط في حال كان لديك اكثر من صفحة في مدونتك. غالباً, تستخدم هذة الدالة لعرض قائمة تصفح يستخدمها الزوار للتنقل بين صفحات مدونتك.
  
  









<EarlierLink> </EarlierLink>
هذة الدالة ستربط اي شي وسطها بصفحات سابقة (اقدم) في مدونتك. ان لم يكن هناك صفحات اقدم, فان محتوى الدالة لن يتم ربطة.









<LaterLink> </LaterLink>
هذة الدالة ستربط اي شي وسطها بصفحات تالية (احدث) في مدونتك. ان لم يكن هناك صفحات احدث, فان محتوى الدالة لن يتم ربطة.









<%CurrentPage%>
هذة الدالة ستطبع عدد الصفحات الحالي.









<%TotalPages%>
هذة الدالة ستطبع إجمالي عدد صفحات مدونتك.