در ادامه مطلب قبلی
که تعدادی از تگهای پلاگاين Paginate
را شرح دادم در اين بخش هم تعدادی ديگری از تگها را توضيح میدهم.
اينجا توضيحاتی در
مورد کليات اين پلاگاين داده ام.
تگهای شرطی
با استفاده از تگهای شرطی میتوان براساس اينکه کاربر در چه صفحهای قراردارد،
متن خاصی را نمايش داد. به علت اينکه تتگهای شرطی پلاگاين paginate کد php توليد
میکنند، با استفاده از علامت «_» از تگهای شرطی خود MT متمايز شدهاند. اين مسئله
بهاين معنی است که بهجای تگ <MTElse> بايد از تگ <MTPaginateElse_> استفاده کنيد.
جدول نيز نشان میدهد هر کدام از تگهای شرطی در چه صفحاتی مثبت (true) میشوند:
- MTPaginateIfFirstPage_
متون داخل يک تگ فقط در صورتی صفحه، اولين صفحه يا تنها صفحه باشد، نمايش پيدا
میکنند.
- MTPaginateIfLastPage_
متون داخل يک تگ فقط در صورتی صفحه، آخرين صفحه يا تنها صفحه باشد، نمايش پيدا
میکنند.
- MTPaginateIfMiddlePage_
متون داخل يک تگ فقط در صورتی که چندين صفحه وجود داشته باشد و صفحه يک صفحه
ميانی باشد (اولين و آخرين صفحه نباش)، نمايش پيدا میکنند.
- MTPaginateIfPreviousPage_
متون داخل يک تگ فقط در صورتی که چندين صفحه وجود داشته باشد و صفحه دارای صفحه
قبلی باشد (اولين صفحه نباشد)، نمايش پيدا میکنند.
- MTPaginateIfNextPage_
متون داخل يک تگ فقط در صورتی که چندين صفحه وجود داشته باشد و صفحه دارای صفحه
بعدی باشد (آخرين صفحه نباشد)، نمايش پيدا میکنند.
- MTPaginateIfAllPages_
متون داخل يک تگ فقط در صورتی صفحه، صفحهای باشد که همه مطالب صفحات را نمايش
میدهد، نمايش پيدا میکنند.
- MTPaginateIfPageHeader_
متون داخل يک تگ فقط در صورتی بخش جاری اولين بخش صفحه باشد، نمايش پيدا میکنند.
- MTPaginateIfPageFooter_
متون داخل يک تگ فقط در صورتی بخش جاری آخرين بخش صفحه باشد، نمايش پيدا میکنند.
- MTPaginateElse_
از اين تگ تنها میتوان داخل ديگر تگهای شرطی اين پلاگاين استفاده کرد. در
صورتی که نتيجه تگ شرطی اصلی منفی باشد متون داخل اين تگ نمايش داده میشوند.
در مثال زير اگر کاربر در صفحهای باشد که همه مطلب صفحات را نمايش میشود متن
«شما همه مطالب را مشاهده میکنيد» نمايش داده میشود و در غير اين صورت متن «شما
تنها بخشی از مطالب را مشاهده میکنيد» نمايش داده میشود:
<MTPaginateIfAllPages_>
<p> شما همه مطالب را مشاهده میکنيد </p>
<MTPaginateElse_>
<p> شما تنها بخشی از مطالب را مشاهده میکنيد </p>
</MTPaginateIfAllPages_>
تگ MTPaginateContent
نوشتههايی که مايليد صفحه صفحه شوند در داخل اين تگ قرار میگيرند. شما با استفاده
از خصوصيات زير میتوانيد طريقه صفحهصفحه شدن مطالب را تعيين کنيد:
- max_words="n"
اين خصوصيت تعيين میکند در هر صفحه حداکثر چند کلمه میتواند وجود داشته باشد.
مقدار پيشفرض 400 است.
- max_bytes="n"
اين خصوصيت تعيين میکند هر صفحه حداکثر چند بايت میتواند باشد. در صورت تعيين
اين خصوصيت، خصوصيت “max_words” ناديده گرفته خواهد شد.
- max_sections="n"
اين خصوصيت تعيين میکند در هر صفحه حداکثر چند بخش وجود داشته باشد (شما میتوانيد
بهصورتی که بعدا توضيح داده خواهد شد، محتويات خود را بخشبندی کنيد). در صورت
تعيين اين خصوصيت، خصوصيات “max_words” و “max_bytes” ناديده گرفته خواهند شد.
- section_start_tag="p"
اين خصوصيت تعيين میکند کدام تگ برای شروع هر بخش در نظر گرفته شود. هر وقت نياز
به اينجاد صفحه جديد وجود داشت، شکستی بين بخشها صورت خواهد گرفت. در مثال زير هر
پاراگراف (که در HTML با تگ p مشخص میشود) در يک بخش قرار میگيرد:
<MTPaginateContent section_start_tag="p">
....
</MTPaginateContent>
- section_start="section start"
اين خصوصيت تعيين میکند چه جملهای در متن شروع هر بخش را مشخص کند. هر وقت نياز
به اينجاد صفحه جديد وجود داشت، شکستی بين بخشها صورت خواهد گرفت. در صورت تعيين
اين خصوصيت، مقدار خصوصيت section_start_tag ناديده گرفته خواهد شد. برای اين که
شکسته شدن صفحه قبل از متن “<div class=”section”>” اتفاق بيفتد از کد زير بايد
استفاده کنيد: )از کد HTML نمیتوان به طور مستقيم استفاده کنيد. علامت “<” بايد
تبديل به “<” و علامت “>” بايد تبديل به
“>” شود.)
- section_break="text"
اين خصوصيت تعيين میکند چه جملهای در متن بخشها را از هم جدا میکند. هر وقت
نياز به اينجاد صفحه جديد وجود داشت، شکستی بين بخشها صورت خواهد گرفت. متن نشان
دهنده فواصل بين بخشها (که توسط اين خصوصيت تعيين شده است) در متن اصلی نمايش داده
نخواهد شد. به طور پيشفرض مقدار اين خصوصيت “__MTPAGINATE_SECTION_BREAK__” است.
اين به اين معنی است که هر جا در متن اين را بنويسيد، يک بخش جديد به وجود میآيد.
برای تعيين “<p>----</p>” به عنوان جدا کننده هر بخش از کد زير بايد استفاده کرد:
<MTPaginateContent section_break="<p>----</p>">
...
</MTPaginateContent>
- page_break="text"
اين خصوصيت تعيين میکند چه جملهای در متن باعث ايجاد يک صفحه جديد شود. اين جمله
در متن نمايش پيدا نمیکند. به طور پيشفرض جمله “__MTPAGINATE_PAGE_BREAK__” در
متن باعث ايجاد صفحه جديد میشود. برای تعيين “<p>====</p>” به عنوان جدا کننده
صفحه از کد زير بايد استفاده کرد:
<MTPaginateContent page_break="<p>====</p>">
...
</MTPaginateContent>
تگ MTPaginateSectionBreak
اين تگ فاصله بين بخشها را تعيين میکند. هر وقت نياز به ايجاد صفحه جديد وجود
داشت، شکستی بين بخشها صورت خواهد گرفت. برای مثال در کد زير بعد از هر مطلب يک
بخش جديد ايجاد میشود (در واقع هر مطلب در يک بخش قرار میگيرد):
<MTPaginateContent max_bytes="1000">
<MTEntries lastn="20">
<p>
<b><a href="<$MTEntryPermalink$>"><$MTEntryTitle$></a></b>
<$MTEntryExcerpt$>
</p>
<$MTPaginateSectionBreak$>
</MTEntries>
</MTPaginateContent>
تگ MTPaginatePageBreak
اين محل شکسته شدن صفحه را تعيين میکند. در مثال زير بعد از هر مطلب يک صفحه جديد
ايجاد میشود:
<MTPaginateContent max_bytes="1000">
<MTEntries lastn="20">
<p>
<b><a href="<$MTEntryPermalink$>"><$MTEntryTitle$></a></b>
<$MTEntryExcerpt$>
</p>
<$MTPaginatePageBreak$>
</MTEntries>
</MTPaginateContent>
