فراخواننده فیلدهای k2 ـ(isl K2 Call)

با نصب این پلاگین ساده، می‌توانید در هر قسمت از متنتان (که با کامپوننت k2 نوشته‌شده‌باشد) فیلدهای اضافی (extrafields) را فراخوانی کنید. نام فیلد، نام مستعارش، مقداری که برای آن در نظر گرفته شده، شناسه اش و ... .

این پلاگین در کی2 نسخه 2.6.5 و جوملا 2.5 تست شده‌است

امکانات برای کاربرای عمومی:

قاعده‌ی کلی:

{isl-k2call type=TypeValue o=OutputType}

اگر نوع (type=) نوشته نشود، مقدار پیش فرض در تنظیمات پلاگین، اِعمال خوادشد؛ اگر نوع خروجی (o=OutputType) مشخص نشود، نیز همین‌طور؛ ولی نوشتن TypeValue و isl-k2call و کورشه‌ها { } الزامی است.

طرز استفاده:

طرز استفاده را با مثال توضیح می‌دهیم:

مفروضات در مثال:

فرض می‌کنیم در تنظیمات پلاگین، متغیر پیش‌فرض، نام مستعار (alias) و خروجی پیش‌فرض، مقدار (value) باشد.

پس اگر نوشته‌شود {isl-k2call ref}، عین این است که نوشته‌شود {isl-k2call alias=ref o=value}.

همچنین فرض می‌کنیم مطلبی در کامپوننت کا2 با سه فیلد اضافی زیر ایجاد شده‌است (نکته: اگر شناسه و نام مستعار فیلدها را نمی‌دانید، در منوی کا2، «فیلدهای اضافی» (extra fields) را انتخاب کنید تا در کنار هر فیلد، شناسه و نام مستعار مخصوص به آن را مشاهده کنید. برای آشنایی با نحوه ایجاد فیلدهای اضافی در کی2 کلیک کنید):

شناسه (id) نام (name) نام مستعار (alias) مقدار تعیین شده (value) (ممکن است بسته به نوع فیلد، نوشته، تصویر و ... باشد)
1 منابع و مآخذ ref کتاب حماسه حسینی شهید مطهری (رحمة الله علیه)
3 موضوع مطلب subject تحریفات عاشورا
4 لینک مطلب link http://islam313.com

در این صورت نوشته‌ها و خروجی‌ها به صورت زیر خواهدبود:

آنچه که شما به در محل دلخواه از متن، می‌نویسیدآنچه که به جای نوشته‌ی شما، به طور خودکار، نمایش داده‌خواهدشدتوضیحات
{isl-k2call ref} کتاب حماسه حسینی شهید مطهری (رحمة الله علیه) چون نوع ورودی مشخص نشده‌است، در نوشته،آنچه که معادل با نام مستعار ref باشد را نشان می‌دهد. (چون حالت پیش‌فرض را در تنظیمات پلاگین، نام مستعار (alias) نوشته‌ایم)
موضوع این مطلب: {isl-k2call id=3} موضوع این مطلب: تحریفات عاشورا در نوشته، مشخص کرده‌ایم که آنچه معادل فیلد دارای شناسه‌ی 3 هست را نشان دهد، پس موضوع مطلب را نشان خواهدداد.
{isl-k2call id=3 o=name}: {isl-k2call id=3} موضوع مطلب: تحریفات عاشورا

با اضافه کردن o=name (خروجی، name باشد) مشخص کرده ایم که به جای {isl-k2call id=3 o=name} نام فیلدی که شناسه‌ی 3 دارد نشان داده‌شود. پس به جای این عبارت نوشته: «موضوع مطلب»

به جای {isl-k2call id=3} نیز مثل مثال قبل، موضوع این مطلب (تحریفات عاشورا) نشان داده‌خواهدشد.

در سورس (به صورت کد html):

{isl-k2call link o=name}:{isl-k2call link}

لینک مطلب:http://islam313.com  

امکانات برای طراحان قالب و برنامه نویسان:

طراحان قالب و برنامه‌نویسان، پس از نصب این پلاگین به سادگی می‌توانند با استفاده از کلاس این پلاگین، فیلدهای اضافی آیتم را در صفحات php قالب کی2 فراخوانی کنند:

IslK2::k2fields($item,$key='alias',$ex='value')

که در آن $item باید متغیر نشان‌دهنده‌ی آیتم باشد و معمولا $this->item است.

پس از اینکه تابع فوق را مساوی با متغیّر خاصی قرار دادید، اطلاعات فیلدهای اضافی از طریق آن متغیر به آسانی قابل دسترسی خواهدبود. مثال(بر اساس مفروضات ابتدای این مطلب):


$extrafields = IslK2::k2fields($this->item);

echo $extrafields->ref;

حاصل: نوشته خواهدشد «کتاب حماسه حسینی شهید مطهری (رحمة الله علیه)«

 

 

از نسخه 0.8:

برای کاربران عمومی:

تنظیم mode اضافه شده است:

{isl-k2call Value mode=collectmode}

برای فعال کردن این حالت، mode را برابر all قرار دهید.

مثال:

  • {isl-k2call modified mode=all}
    کد فوق تاریخ آخرین ویرایش آیتم را نشان خواهدداد.
  • {isl-k2call id mode=all}
    این کد نیز آی دی آیتم را نشان خواهدداد.

برای توسعه دهندگان و برنامه نویسان:

همچنین تابع IslK2::k2fields() بهبود یافته و می‌تواند در دو حالت، اطلاعات مربوط به آیتم را جمع آوری کند: ساده و هوشمند

حالات مختلف را در این تابع امتحان کنید تا ببینید با آن قادرید چه کارهایی را انجام دهید.

حالت کامل تابع:

IslK2::k2fields($item,$key='alias',$out='value',$wide=0,$custom='',$type=0)

$custom یک متغیّر دلخواه است (مثل extra_fields) و در حالتی که $wide برابر با 1 باشد، کار خواهدکرد.

$type هم متغیری برای فعالسازی حالت هوشمند است. در این حالت، خروجی، محدود می شود به جداولی که دارای زیرمجموعه های $key و $out باشند. همچنین اگر در اطلاعات آیتم، گزینه ساده ای با نام $key باشد، آن گرینه نیز در خروجی خواهدآمد.

تمامی این خروجی ها در حالت آبجکت و جدول خواهندبود پس برای دیدنشان از تابع print_r استفاده کنید.

آیا این پاسخ به شما کمک کرد؟

 پرینت این مقاله

در همین زمینه

نمایش دهنده تخصصی قرآن کریم (isl Quran)

پلاگین Isl Quran، افزونه ای است برای نمایش آیات قرآن و ترجمه آن‌ها به همراه آدرس در سایت‌های...

کتابخانه Soap (1.2)

استفاده از کلاس soap، برای بسیاری از توابع php ضروری است. مخصوصاً توابع پرداخت آنلاین، پیامک و...

اسلایدشوی تصاویر (isl Slider)

بسم الله الرّحمن الرّحیم ماژول اسلایدر، افزونه‌ای است که تصاویر را به شکل اسلایدشو زیبایی به...