قوانین HTML در پوسته های IPS

[وحید نامنی 11294]

به طور عادی، در زبان HTML قابلیت استفاده از دستورات شرطی وجود ندارد. در برنامه های پیشرفته ای مثل IPS نیاز است تا در مورد نحوه نمایش اطلاعات خروجی تصمیم گیری شود. این عمل از طریق PHP در Backend سیستم قابل انجام است اما در بسیاری از مواقع انجام این کار در Backend مناسب نیست چرا که باید در Backend پردازش داده ها صورت گیرد و در خود پوسته نحوه نمایش تصمیم گیری شود.

به همین دلیل در پوسته های IPS، زبان HTML ارتقا داده شده و امکان استفاده از تگ های خاص و دستورات شرطی محیا گردیده است که آن را تبدیل به HTML Logic کرده است.

- قوانین پایه

تگ ها منطقی

ساختار کلی

{{if $condition}} ... {{else}} ... {{endif}}

مثال :

{{if !$condition}}
{{if ( $color == 'green' && $size == 'big' ) || $condition}}
{{if count( $value ) > 2}}

متغیر ها

استفاده از مقدار loop ها و دیگر توابع IPS

مثال :

{$value}

استفاده از مقدار خروجی افزونه ها

{pluginName="value"}

- قوانین کاربردی

در ادامه چند دستور کاربردی رایج، جهت آشنایی بیشتر آورده شده است.

اگر کاربر عضو باشد

{{if member.member_id}}
	<!-- پیغام شما به کاربران عضو -->
{{endif}}

اگر کاربر مهمان باشد

{{if !member.member_id}}
	<!-- this will show if the user is a guest -->
{{endif}}

نمایش پیام تنها به چند کاربر خاص با استفاده از id کاربری

{{if in_array( member.member_id, array( 5, 28, 472 ) )}}
	<!-- نمایش پیغام اگر شناسه کاربر ۵،۸ یا ۴۷۲ باشد -->
{{endif}}

اگر کاربر در گروه خاصی باشد

{{if member.inGroup('2')}}
	<!-- نمایش پیام به تمامی کاربرانی که شناسه گروه آن ها ۲ است -->
{{endif}}

اگر کاربر مدیریت کل باشد

{{if member.isAdmin()}}
	<!-- نمایش پیغام به مدیران کل -->
{{endif}}

اگر کاربر محروم شده، باشد

{{if member.isBanned()}}
	<!-- نمایش پیغام به کاربران محروم شده -->
{{endif}}

چند شرط در یک دستور

{{if member.member_id == 3}}
	<!-- نمایش پیغام تنها در صورتی که شناسه کاربر ۳ بود -->
{{elseif member.member_id == 9}}
	<!-- نمایش پیغام تنها در صورتی که شناسه کاربر ۹ بود -->
{{else}}
	<!-- نمایش پیغام در صورتی که هیچکدام از شرایط قبل برقرار نبود -->
{{endif}}

اگر کاربر بیش از x ارسال داشت

{{if member.member_posts > 3}}
	<!-- نمایش پیغام به کاربرانی که بیش از ۳ ارسال دارند -->
{{endif}}

اگر کاربر کمتر از x ارسال داشت

{{if member.member_posts < 3}}
	<!-- نمایش پیغام به کاربرانی که کمتر از ۳ ارسال دارند -->
{{endif}}

اگر کاربر دقیقا x ارسال داشت

{{if member.member_posts == 3}}
	<!-- نمایش پیغام به کاربرانی که دقیقا ۳ ارسال دارند -->
{{endif}}

اگر صفحه ای که کاربر قرار دارد بخشی از برنامه x است

اسم برنامه ها از طریق متغیر app key قابل تشخیص است.

app key برای برنامه Pages برابر با cms و برای فروشگاه برابر با nexus می باشد.

{{if request.app == 'forums'}}
	<!-- نمایش پیغام در هر صفحه ای که بخشی از انجمن ها باشد -->
{{endif}}

اگر صفحه ای که کاربر قرار دارد جزیی از هیچ برنامه ای نیست

مثل نمایه، صفحه عضویت و ...

{{if request.app == 'core'}}
	<!-- نمایش پیغام در صفحاتی که متعلق به هیچ برنامه ای نیست -->
{{endif}}

اگر یک تنظیم دارای مقدار خاصی است

بیش از ۱۰۰۰ تنظیم تنها برای برنامه core وجود دارد. برنامه های forums و ... هر کدام بیش از چند هزار تنظیم دارند!

{{if settings.reputation_enabled}}
	<!-- نمایش پیغام در صورتی که اعتبار دهی همانند پسند فعال باشد -->
{{endif}}

اگر متغیر در قالب، دارای متغیر x است

منظور از قالب بخش template بوده و منظور پوسته که با واژه theme شناخته می شود نیست.

{{if $myVariable == 'some_value'}}
	<!-- نمایش پیام -->
{{endif}}

اگر id انجمن برابر با x باشد

{{if request.app == 'forums' && request.module == 'forums' && request.id == 3}}
	<!-- اگر صفحه ای که کاربر قرار دارد در برنامه انجمن ها بوده و شناسه انجمن برابر با ۳ باشد -->
{{endif}}

موفق باشید