توابع وردپرس – توابع پیوست ها
سلام
با معرفی و آموزش توابع وردپرس در خدمتتون هستیم، در این مطلب می پردازیم به توابع بخش پیوست ها در وردپرس.
آموزش:
- تابع get_attachment_link
این تابع آدرس صفحه فایل پیوست شده را بر می گرداند.
|
۱ |
<?php get_attachment_link(id); ?> |
توضیحات پارامترها:
id: از نوع عدد صحیح است.
کار: آی دی فایل پیوست شده را بر میگرداند.
- تابع is_attachment
این تابع شرطی بررسی می کند که آیا صفحه ای که کاربر در حال مشاهده است، صفحه یک فایل پیوست شده است یا نه. فایل هایی که با استفاده از آپلودر موجود در صفحه ویرایش نوشته بارگذاری شده باشند، پیوست حساب می شوند. پیوست ها می توانند در صفحه ای مخصوص به خود نمایش داده شوند. این یک تابع بولی است که خروجی آن True (بله) یا False (خیر) است.
|
۱ |
<?php is_attachment(); ?> |
این تابع فاقد پارامتر است.
- تابع the_attachment_link
خروجی تابع یک پیوند به فایل پیوست است. این پیوند یا دارای (۱) یک تصویر بندانگشتی یا در اندازه اصلی – در صورت وجود – یا دارای (۲) نماد نوع فایل پیوست شده – در صورت وجود – است یا (۳) عنوان پیوست است.
|
۱ |
<?php the_attachment_link(id, fullsize, permalink); ?> |
توضیحات پارامترها:
id:
نوع: از نوع عدد صحیح است.
کار : آیدی پیوست مورد نظر. اختیاری؛ به صورت پیش فرض آیدی نوشته فعلی.
fullsize:
نوع: از نوع بولین است و مقدار پیشفرض False است.
کار: اگر روی True تنظیم شود، عکس پیوست شده در اندازه اصلی نمایش خواهد یافت و اگر روی False تنظیم شود، تصویر بندانگشتی عکس نمایش داده می شود. اگر روی Flase تنظیم شده باشد و تصویر بندانگشتی پیدا نشود، عکس در اندازه اصلی نمایش می یابد.
permalink:
نوع: از نوع بولین است و مقدار پیشفرض False است.
کار: پیوند به صفحه پیوست (True) و یا پیوند مستقیم به فایل پیوست شده (False).
- تابع wp_attachment_is_image
این تابع مشخص می کند که فایل پیوست شده عکس است یا خیر. اگر پیوست عکس باشد True و اگر نباشد False برگردانده می شود.
|
۱ |
<?php wp_attachment_is_image($post_id); ?> |
توضیحات پارامترها:
post_id$:
نوع: عدد صحیح
کار: آیدی نوشته را برمیگرداند.
- تابع wp_get_attachment_image
در صورت وجود، عکس پیوست شده را در قالب یک عنصر HTML بر می گرداند. در غیر این صورت خروجی یک رشته خالی است.
|
۱ |
<?php echo wp_get_attachment_image($attachment_id, $size, $icon); ?> |
توضیحات پارامتر ها:
attachment_id$:
نوع: عدد صحیح
کار: آیدی پیوست مورد نظر، معمولا وارد کردن این پارامتر لازم است. اما اگر این دستور را درون یک حلقه پیوست (مثلا در صفحه پیوست) استفاده می کنید نیازی به وارد کردن این پارامتر نیست.
size$:
نوع: از نوع رشته|آرایه است و مقدار پیشفرض Thumbnail(اندازه کوچک) است.
کار: اندازه تصویری که برای یک پیوست نمایش داده می شود. به دو صورت می توان این پارامتر را مقدار دهی کرد: (۱) کلمات کلیدی (رشته) که عبارتند از thumbnail (بندانگشتی)، medium (متوسط)، large (بزرگ) و Full (اندازه اصلی) (۲) یک آرایه دو عنصری که عنصر اول نماینده عرض و عنصر دوم نماینده ارتفاع بر حسب پیکسل می باشد. مثال: array(32,32) همانند نسخه ۲.۵ وردپرس، این پارامتر تأثیری در اندازه آیکن های نماینده نوع فایل ندارد. استفاده از این پارامتر اختیاری است.
icon$:
نوع: از نوع بولین است و مقدار پیشفرض False است.
کار:استفاده از یک آیکن برای نمایش نوع فایل پیوست شده(این پارامتر اختیاری است).
- تابع wp_get_attachment_image_src
عکس نماینده ی فایل پیوست را در صورت وجود بر می گرداند. در غیر این صورت، مقدار بازگشتی False خواهد بود.
|
۱ |
<?php wp_get_attachment_image_src($attachment_id, $size, $icon); ?> |
توضیحات پارامترها:
attachment_id$:
نوع: عدد صحیح.
کار:آیدی پیوست مورد نظر.
size$:
نوع: از نوع رشته|آرایه است و مقدار پیشفرض Thumbnail(اندازه کوچک) است.
کار: اندازه تصویری که برای یک پیوست نمایش داده می شود. به دو صورت می توان این پارامتر را مقدار دهی کرد: (۱) کلمات کلیدی (رشته) که عبارتند از thumbnail (بندانگشتی)، medium (متوسط)، large (بزرگ) و Full (اندازه اصلی) (۲) یک آرایه دو عنصری که عنصر اول نماینده عرض و عنصر دوم نماینده ارتفاع بر حسب پیکسل می باشد. مثال: array(32,32) همانند نسخه ۲.۵ وردپرس، این پارامتر تأثیری در اندازه آیکن های نماینده نوع فایل ندارد. استفاده از این پارامتر اختیاری است.
icon$:
نوع: از نوع بولین است و مقدار پیشفرض False است.
کار:استفاده از یک آیکن برای نمایش نوع فایل پیوست شده(این پارامتر اختیاری است).
- تابع wp_get_attachment_metadata
مشخصات فایل پیوست مورد نظر را فراخوانی می کند. در صورت مواجهه با خطا، مقدار False برگردانده می شود.
|
۱ |
<?php wp_get_attachment_metadata($post_id, $unfiltered) ?> |
توضیحات پارامترها:
post_id$:
نوع: عدد صحیح.
کار: آیدی پیوست مورد نظر(اجباری).
unfiltered$:
نوع: از نوع بولین است و مقدار پیشفرض False است.
کار: اگر مقدار آن True باشد، فیلترها اعمال نخواهند شد.
معرفی توابع بخش پیوست ها در وردپرس به پایان رسید.
مشکلی یا سوالی در رابطه با این مطلب داشتید، در سایت بپرسید ، پاسخگوی سوالات شما هستیم.
موفق باشید.
ارسال نظر
شما باید وارد شوید یا عضو شوید تا بتوانید نظر ارسال کنید