وردپرس نسخه 3,0+کلیه توابع و کد های لازم برای کدنویسی قالب وردپرس
توابع پیوست ها
Get Attachment Link get_attachment_link();
این تابع آدرس صفحه فایل پیوست شده را بر می گرداند.
<?php get_attachment_link(id); ?>
id
نوع: عدد صحیح
آیدی فایل پیوست شده
Is Attachment is_attachment();
این تابع شرطی بررسی می کند که آیا صفحه ای که کاربر در حال مشاهده است صفحه یک فایل پیوست شده است یا نه. فایل هایی که با استفاده از آپلودر موجود در صفحه ویرایش نوشته بارگذاری شده باشند، پیوست حساب می شوند. پیوست ها می توانند در صفحه ای مخصوص به خود نمایش داده شوند. این یک تابع بولی است که خروجی آن True (بله) یا False (خیر) است.
<?php is_attachment(); ?>
این تابع پارامتری ندارد.
The Attachment Link the_attachment_link();
خروجی تابع یک پیوند به فایل پیوست است. این پیوند یا دارای (1) یک تصویر بندانگشتی یا در اندازه اصلی - در صورت وجود - یا دارای (2) نماد نوع فایل پیوست شده - در صورت وجود - است یا (3) عنوان پیوست است.
<?php the_attachment_link(id, fullsize, permalink); ?>
id
نوع: عدد صحیح
آیدی پیوست مورد نظر. اختیاری؛ به صورت پیش فرض آیدی نوشته فعلی.
fullsize
نوع: بولی · مقدار پیش فرض: False
اگر روی True تنظیم شود، عکس پیوست شده در اندازه اصلی نمایش خواهد یافت و اگر روی False تنظیم شود، تصویر بندانگشتی عکس نمایش داده می شود. اگر روی Flase تنظیم شده باشد و تصویر بندانگشتی پیدا نشود، عکس در اندازه اصلی نمایش می یابد.
پیوند یکتا
نوع: بولی · مقدار پیش فرض: False
پیوند به صفحه پیوست (True) و یا پیوند مستقیم به فایل پیوست شده (False).
Attachment Is Image wp_attachment_is_image();
این تابع مشخص می کند که فایل پیوست شده عکس است یا خیر. اگر پیوست عکس باشد True و اگر نباشد False برگردانده می شود.
<?php wp_attachment_is_image($post_id); ?>
&post_id
نوع: عدد صحیح
آیدی نوشته.
Get Attachment Image wp_get_attachment_image();
در صورت وجود، عکس پیوست شده را در قالب یک عنصر HTML بر می گرداند. در غیر این صورت خروجی یک رشته خالی است.
<?php echo wp_get_attachment_image($attachment_id, $size, $icon); ?>
$attachment_id
نوع: عدد صحیح
آیدی پیوست مورد نظر. معمولا وارد کردن این پارامتر لازم است. اما اگر این دستور را درون یک حلقه پیوست (مثلا در صفحه پیوست) استفاده می کنید نیازی به وارد کردن این پارامتر نیست.
$size
نوع: رشته | آرایه · مقدار پیش فرض: Thumbnail (اندازه کوچک)
اندازه تصویری که برای یک پیوست نمایش داده می شود. به دو صورت می توان این پارامتر را مقدار دهی کرد: (1) کلمات کلیدی (رشته) که عبارتند از thumbnail (بندانگشتی)، medium (متوسط)، large (بزرگ) و Full (اندازه اصلی) (2) یک آرایه دو عنصری که عنصر اول نماینده عرض و عنصر دوم نماینده ارتفاع بر حسب پیکسل می باشد. مثال: array(32,32) همانند نسخه 2.5 وردپرس، این پارامتر تأثیری در اندازه آیکن های نماینده نوع فایل ندارد. استفاده از این پارامتر اختیاری است.
$icon
نوع: بولی · مقدار پیش فرض: False
استفاده از یک آیکن برای نمایش نوع فایل پیوست شده. اختیاری
Get Attachment Image Sourcewp_get_attachment_image_src();
عکس نماینده ی فایل پیوست را در صورت وجود بر می گرداند. در غیر این صورت، مقدار بازگشتی False خواهد بود.
<?php wp_get_attachment_image_src($attachment_id, $size, $icon); ?>
$attachment_id
نوع: عدد صحیح
آیدی پیوست مورد نظر.
$size
نوع: رشته | آرایه · مقدار پیش فرض: Thumbnail (اندازه کوچک)
اندازه تصویری که برای یک پیوست نمایش داده می شود. به دو صورت می توان این پارامتر را مقدار دهی کرد: (1) کلمات کلیدی (رشته) که عبارتند از thumbnail (بندانگشتی)، medium (متوسط)، large (بزرگ) و Full (اندازه اصلی) (2) یک آرایه دو عنصری که عنصر اول نماینده عرض و عنصر دوم نماینده ارتفاع بر حسب پیکسل می باشد. مثال: array(32,32) همانند نسخه 2.5 وردپرس، این پارامتر تأثیری در اندازه آیکن های نماینده نوع فایل ندارد. استفاده از این پارامتر اختیاری است.
$icon
نوع: بولی · مقدار پیش فرض: False
استفاده از یک آیکن برای نمایش نوع فایل پیوست شده. اختیاری
Get Attachment MetaDatawp_get_attachment_metadata();
مشخصات فایل پیوست مورد نظر را فراخوانی می کند. در صورت مواجهه با خطا، مقدار False برگردانده می شود.
<?php wp_get_attachment_metadata($post_id, $unfiltered) ?>
$post_id
نوع: عدد صحیح
(اجباری) آیدی پیوست مورد نظر.
$unfiltered
نوع: بولی | آرایه · مقدار پیش فرض: False
اگر مقدار آن True باشد، فیلترها اعمال نخواهند شد.