آموزش:پلاگین SIGE   

از دانشنامه جوملا فارسی - مامبو فارسی
پرش به: ناوبری، جستجو

مقدمه

قبل از هرچیز یک توضیح اجمالی درباره پلاگین‌ها شاید ضرر نداشته باشد. چون در صورت دانستن این مطلب و توضیح شما قادر خواهید بود تا از هر پلاگینی استفاده نمایید.

پلاگین‌ها عموماً نرم‌افزارهای کوچکی هستند که کاربردشان در عملگرهای خودکار و نیمه‌خودکار هست. در واقع ممکن هست یک پلاگین بصورت کاملاً خودکار عمل کند (پلاگین ورود از شناسه Gmail یا OpenID به جوملا که بصورت پیشفرض روی جوملا هست) یا یک پلاگین به یک خط دستور در جایی که نیاز داریم کاری را اعمال کند. (پلاگین تصاویر در زیر ویرایشگر جوملا و یا ادامه مطلب که پیشفرض در جوملا وجود دارند).

پلاگین‌ها به چند دسته تقسیم می‌شوند:

پلاگین‌های ویرایشگر – کلیدهای ویرایشگر – ارتباط‌دهنده های خارج از سایت – جستجو و ... که هر کدام در جایی استفاده می‌شوند. مثلاً پلاگین صفحه‌بندی در جوملا از دسته پلاگین‌های محتوایی هست که محتوا و مطالب را با استفاده از این پلاگین می‌توانیم صفجه‌بندی کنیم.

پلاگین‌های خودکار مانند پلاگین جستجوی مطالب بدون اینکه ما کدی در جایی بکار ببریم کاربر هنگامی که از منو یا ماژول جستجو استفاده کند این پلاگین مطالب ما را پیمایش می‌کند و یافته‌ها را برای کاربر به نمایش در می‌آورد.

یا برای مثالی دیگر پلاگین Cache با توجه به روشن بودن ذخیره‌ساز صفحات سایت را خودکار ذخیره سازی و کش می‌کند.

پس پلاگین‌ها می‌توانند امکانات فوق العاده قدرتمندی باشند که شاید با یک کامپوننت نتوان چنین استفاده‌ای را داشت یا حتی زمان زیادی را از ما طلب کند ! اما با یک پلاگین می‌توانیم کارهای خودکار را انجام دهیم !

پلاگین‌ها قابلیت‌های فراوانی دارند که هرگاه استفاده از آنها را بیاموزیم به توانایی‌های پلاگین‌ها پی خواهیم برد !


پلاگین گالری تصاویر SIGE

این پلاگین از دسته پلاگین‌های محتوایی هست. یعنی در محتوا کاربرد دارد و برای استفاده از آن باید از قطعه کدی در محتوا استفاده کرد تا جوملا آن هدف را اجرایی کند. حال ممکن است این هدف نمایش تصایر یک پوشه باشد (این پلاگین) یا نمایش یک فایل تصویری ( پلاگین All Video) یا ایجاد ادامه مطلب (از پلاگین‌های پیشفرض جوملا) یا حتی قرار دادن یک ماژول در یک مطلب (از پلاگین‌های پیشفرض جوملا) !

SIGE در واقع به ما امکان نمایش تصاویری را می‌دهد با شمایل و افکت‌های خاص در مطالب.

قابلیت اسلاید تصاویر – توضیح برای هر تصویر – ساخت خودکار تصاویر بندانگشتی به حالت‌های مختلف (افقی – زوم شده – عمودی – آکاردئونی و ...) اما برای اینکه همه این وظایف را این پلاگین به درستی انجام دهد باید ما طبق اصول پلاگین‌های محتوایی از قظعه کدی برای فراخوانی این پلاگین استفاده کنیم.

نصب پلاگین

برای نصب وارد مدیریت جوملا شده و در منوی افزونه‌ها ← نصب را انتخاب کرده و پلاگین را نصب نمایید.


Plugin sige 1.png


سپس به مدیریت پلاگین‌ها رفته و پلاگین SIGE را منتشر نمایید. در ادامه پارامترهای این پلاگین توضیح داده خواهد شد.


Plugin sige 2.png


قطعه کد پایه برای این پلاگین به شرح زیر خواهد بود :


{gallery}آدرس پوشه و یا تصویر مورد نظر برای نمایش{/gallery}


همانطور که می‌بینید تا اینجا هیچ تفاوتی با دیگر پلاگین‌ها از این دسته ندارد ! اما باید توجه داشت که در صورت فعال بودن پلاگین SIGE در مدیریت پلاگین‌ها این کد انجام وظیفه می‌کند و در غیر اینصورت این کد در محتوا به همین شکل خام نمایش داده خواهد شد ! پس قبل از هر کاری باید به تنظیمات پلاگین رفت و کارهایی را انجام داد !

مدیریت پلاگین SIGE

برای این کار ابتدا باید به مدیریت پلاگین‌ها در جوملا رفت. نام پلاگین مربوطه را یافته و بر روی نام آن یکبار کلیک چپ نمود تا وارد تنظیمات این پلاگین شویم.

پس وارد شدن به تنظیمات در سمت راست توضیحاتی را مشاهده می‌کنیم که وضعیت پلاگین را باید برای فعال شدن آن بر روی فعال قرار دهیم. در غیر اینصورت پلاگین عمل نخواهد کرد.

اما در پارامترهای این پلاگین تنظیمات اصلی را خواهیم داشت که پلاگین تصاویر بندانگشتی (Thumbnails) را به چه شکلی ایجاد کند یا تصاویر را ذخیره سازی برای استفاده‌های بعدی داشته باشد یا خیر و یا اینکه پس از کلیک کردن بر روی تصاویر به شکلی به کاربران نمایش داده شود !

این پارامترها به زبان فارسی ترجمه شده‌اند و توضیح آن در هر پارامتر نوشته شده. به همین دلیل از توضیح این پارامترها بصورت اختصاصی در این آموزش خودداری می‌کنیم. چرا که این پلاگین به زبان فارسی ترجمه شده و در افزونه‌های جوملا فارسی منتشر شده است.

اما این پلاگین در استفاده تگ معرفی شده در پیشتر این آموزش قابلیت‌های دیگری نیز دارد که در ادامه این آموزش سعی می‌کنیم این پارامترهای ویژه را توضیح دهیم.

پارامترهای محتوایی

طریقه قرار دادن تصاویر در این پلاگین بسیار ساده هست. اما ممکن است شما نیاز به تنظیمات خاص برای تصاویر خود و یا گالری خود داشته باشید که می‌توانید با استفاده از این پارامترها در تگ فراخوانی پلاگین استفاده کنید.

تگ فراخوانی پلاگین و تصاویر به شرح زیر است :


{gallery}folder{/gallery}


که بجای عبارت folder می‌توانید با توجه به تنظیماتی که در مدیریت پلاگین برای پوشه تصاویر این پلاگین مشخص کردید این آدرس را معین کنید.

در تنظیمات پلاگین امکان اینکه این آدرس را برای تگ پلاگین کامل بنویسید و یا اینکه پوشه مادر آنرا، پلاگین بطور خودکار قبل از عبارت folder قرار دهد را دارید. پس دستور کلی برای فراخوانی تصاویر در محتوا مشخص شد. اما این دستور تمام تصاویر یک پوشه معرفی شده را در محتوای ما لیست می‌کند ! شاید ما نیاز به نمایش یک تصویر از این پوشه باشیم و یا نیازمند توضیحاتی برای هر تصویر و یا اینکه تصویر بندانگشتی به اندازه خاصی باشد و یا ... . در برخی صفحات شاید ما بخواهیم تصاویر بندانگشتی افقی اندازه شوند و یا در برخی محتواها بخواهیم تصاویر با اندازه خاصی لیست شوند و ... . در این زمانها از پارامترهای خاص پلاگین بهره خواهیم گرفت.


معرفی پارامترها

در واقع این کدها همان پارامترهایی هستند که ما در تنظیمات و مدیریت پلاگین فوق نیز مشاهده کردیم. اما همانطور که پیشتر بیان شد شاید در برخی از صفحات نیاز به تنظیمات خاصی از این پلاگین داشته باشیم و می‌توانیم برای صفحه مورد نظر خود این پارامترها را اختصاصی تنظیم کنیم. در زیر برخی از این پارامترها به فارسی توضیح داده شده‌اند:


  • width – عرض تصاویر بندانگشتی
  • height – ارتفاع تصاویر بندانگشتی
  • gap_v – فاصله عمودی میانی تصاویر
  • gap_h – فاصله افقی میانی تصاویر
  • quality – کیفیت تصاویر در پسوند JPG – اعداد 1 تا 100 مورد قبول خواهند بود
  • quality_png – کیفیت تصاویر در پسوند PNG – اعداد 1 تا 9 مورد قبول خواهند بود
  • displayarticle – نمایش نام محتوا – عدد 1 یعنی بله و عدد 0 یعنی خیر
  • thumbs – ساخت و ذخیره تصاویر بندانگشتی – 1 یعنی بله و عدد 0 یعنی خیر
  • limit_quantity – تعداد نمایش تصاویر
  • noslim – غیرفعال کردن افکت لایت باکس – 1 یعنی بله و 0 یعنی خیر
  • root – شروع پوشه تصاویر از ریشه جوملا – 1 یعنی بله و 0 یعنی خیر


اما چگونه باید از این پارامترها استفاده کرد ؟

این پارامترها را در همان دستور فراخوانی پلاگین باید استفاده کرد، اما با استفاده از یک کامای انگلیسی , و برای هر پارامتر یک مساوی و مقدار مورد نظر را درج کنیم. مثال :


{gallery}imagefolder,width=100,height=100,gap_h=20,gap_v=20{/gallery}


لیست کامل پارامترهای موجود به شرح زیر خواهند بود :

  • width – عرض تصاویر بندانگشتی
  • height – ارتفاع تصاویر بندانگشتی
  • gap_v – فاصله عمودی میانی تصاویر
  • gap_h – فاصله افقی میانی تصاویر
  • quality – کیفیت تصاویر در پسوند JPG – اعداد 1 تا 100 مورد قبول خواهند بود
  • quality_png – کیفیت تصاویر در پسوند PNG – اعداد 1 تا 9 مورد قبول خواهند بود
  • displaynavtip - Show navigation tip - 1 = yes, 0 = no
  • displayarticle – نمایش نام محتوا – عدد 1 یعنی بله و عدد 0 یعنی خیر
  • thumbs – ساخت و ذخیره تصاویر بندانگشتی – 1 یعنی بله و عدد 0 یعنی خیر
  • limit - Activate limiting - 1 = yes, 0 = no
  • limit_quantity – تعداد نمایش تصاویر
  • noslim – غیرفعال کردن افکت لایت باکس – 1 یعنی بله و 0 یعنی خیر
  • random – چیدمان تصاویر - 1 = تصادفی, 2 = ascending, 3 = descending, 4 = ascending by modified date, 5 = descending by modified date
  • root – شروع پوشه تصاویر از ریشه جوملا – 1 یعنی بله و 0 یعنی خیر
  • ratio - Maintain aspect ratios of the images - 1 = yes, 0 = no
  • caption - Display captions - 1 = yes, 0 = no
  • iptc - Title and description of IPTC data - 1 = yes, 0 = no
  • iptcutf8 - IPTC data is already UTF8-encoded - 1 = yes, 0 = no
  • print – نمایش کلید چاپ در لایت باکس – 1 بله صفر خیر
  • count - Set count variable manually - example: 5
  • single – نمایش یک تصویر خاص از پوشه معرفی شده
  • single_gallery – نمایش تصاویر دیگر در پوشه در صورتی که تصویر خاصی معرفی شده بود – 1 بله – صفر خیر
  • salign – چینش تصویر خاص – right – left – center
  • connect - Connect images in other syntax calls - example: bildset
  • download – نمایش کلید دانلود برای تصویر – 1 بله – صفر خیر
  • list – نمایش تصاویر بصورت لیست – 1 بله صفر خیر
  • crop – فعال سازی برش‌دهنده خودکار – 1 بله صفر خیر
  • crop_factor – میزان زوم کردن روی تصویر برای بندانگشتی ساختن
  • thumbdetail - Choose image section for thumbnail - 0 = 1:1, 1 = top left, 2 = top right, 3 = bottom left, 4 = bottom right
  • watermark - Enable watermark function - 1 = yes, 0 = no
  • watermarkposition - Position of the watermark - 0 = centered, 1 = top left, 2 = top right, 3 = bottom left, 4 = bottom right
  • watermark_trans - Transparency of the watermark - 0 to 100 - 0 = opaque, 100 - completely transparent
  • encrypt - Encryption method - 0 = ROT13 - very weak, but fast. 1= MD5 - safe, fast. 2 = SHA1 - very safe, slower than MD5
  • image_info - Show image name or IPTC data - 1 = yes, 0 = no
  • image_link – قرار دادن یک لینک برای تصاویر
  • image_link_new – باز شدن لینک در یک پنجره جدید – 1 بله صفر خیر
  • column_quantity – تعداد تصاویر در هر خط از چیدمان تصاویر بندانگشتی
  • css_image - Enable CSS Image Tooltip - 1 = yes, 0 = no
  • css_image_half - Half the size in tooltip - 1 = yes, 0 = no
  • copyright - Link to the author - 1 = yes, 0 = no
  • word - Link the gallery with a word - example: Gallery
  • watermarkimage - Set a different watermark image (image has to be located in plugins/content/sige/plugin_sige) - example: watermark-new.png
  • calcmaxthumbsize - Calculate maximum size of all thumbnails - 1 = yes, 0 = no
  • fileinfo – خواندن نام دلخواه تصاویر از فایل TXT یک یعنی بله صفر یعنی خیر – این فایل با نام captions.txt در کنار تصاویر باید قرار بگیرد.
  • turbo - Activate turbo mode - 1 = yes, 0 = no
  • resize_images – قابلیت تغییر اندازه تصاویر در اندازه نهایی – 1 بله – صفر خیر
  • width_image – حداکثر اندازه عرض تصاویر در اندازه نهایی
  • height_image – حداکثر اندازه ارتفاع تصاویر در اندازه نهایی
  • ratio_image - Maintain aspect ratios of the original images - 1 = yes, 0 = no
  • images_new – جایگزینی تصاویر کوچک شده در اندازه نهایی نمایش – 1 بله و صفر خیر

امیدواریم از این پلاگین نهایت استفاده را ببرید.



تهیه آموزش: مهدی. - تیم جوملا فارسی

Indent support.png
هر گونه سوال و یا مشکلی در این رابطه دارید، می‌توانید در انجمن تخصصی تیم جوملا فارسی جستجو کرده و در صورت عدم دریافت نتیجه مورد نظر، سوال جدیدی را مطرح کنید.
8.pngاستفاده از مطالب دانشنامه جوملا فارسی - مامبو فارسی با ذکر منبع ( دانشنامه جوملا فارسی ) و لینک مستقیم به http://docs.joomlafarsi.com بلامانع است.