مجموعه توابع پیوست وردپرس

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

این تابع آدرس صفحه فایل پیوست شده را بر می گرداند.

<?php get_attachment_link(id); ?>

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

این تابع شرطی بررسی می کند که آیا صفحه ای که کاربر در حال مشاهده است صفحه یک فایل پیوست شده است یا نه. فایل هایی که با استفاده از آپلودر موجود در صفحه ویرایش نوشته بارگذاری شده باشند، پیوست حساب می شوند. پیوست ها می توانند در صفحه ای مخصوص به خود نمایش داده شوند. این یک تابع بولی است که خروجی آن True (بله) یا False (خیر) است.

<?php is_attachment(); ?>

این تابع پارامتری ندارد.

خروجی تابع یک پیوند به فایل پیوست است. این پیوند یا دارای (۱) یک تصویر بندانگشتی یا در اندازه اصلی – در صورت وجود – یا دارای (۲) نماد نوع فایل پیوست شده – در صورت وجود – است یا (۳) عنوان پیوست است.

<?php the_attachment_link(id, fullsize, permalink); ?>

id

نوع: عدد صحیح

آیدی پیوست مورد نظر. اختیاری؛ به صورت پیش فرض آیدی نوشته فعلی.

—————————————————————————————–

fullsize

نوع: بولی · مقدار پیش فرض: False

اگر روی True تنظیم شود، عکس پیوست شده در اندازه اصلی نمایش خواهد یافت و اگر روی False تنظیم شود، تصویر بندانگشتی عکس نمایش داده می شود. اگر روی Flase تنظیم شده باشد و تصویر بندانگشتی پیدا نشود، عکس در اندازه اصلی نمایش می یابد.

—————————————————————————————–

پیوند یکتا

نوع: بولی · مقدار پیش فرض: False

پیوند به صفحه پیوست (True) و یا پیوند مستقیم به فایل پیوست شده (False).

این تابع مشخص می کند که فایل پیوست شده عکس است یا خیر. اگر پیوست عکس باشد True و اگر نباشد False برگردانده می شود.

<?php wp_attachment_is_image($post_id); ?>

post_id$  – آیدی نوشته.

نوع: عدد صحیح

در صورت وجود، عکس پیوست شده را در قالب یک عنصر HTML بر می گرداند. در غیر این صورت خروجی یک رشته خالی است.

<?php echo wp_get_attachment_image($attachment_id, $size, $icon); ?>

$attachment_id

نوع: عدد صحیح

آیدی پیوست مورد نظر. معمولا وارد کردن این پارامتر لازم است. اما اگر این دستور را درون یک حلقه پیوست (مثلا در صفحه پیوست) استفاده می کنید نیازی به وارد کردن این پارامتر نیست.

—————————————————————————————–

$size

نوع: رشته | آرایه · مقدار پیش فرض: Thumbnail (اندازه کوچک)

اندازه تصویری که برای یک پیوست نمایش داده می شود. به دو صورت می توان این پارامتر را مقدار دهی کرد: (۱) کلمات کلیدی (رشته) که عبارتند از thumbnail (بندانگشتی)، medium (متوسط)، large (بزرگ) و Full (اندازه اصلی) (۲) یک آرایه دو عنصری که عنصر اول نماینده عرض و عنصر دوم نماینده ارتفاع بر حسب پیکسل می باشد. مثال: array(32,32) همانند نسخه ۲٫۵ وردپرس، این پارامتر تأثیری در اندازه آیکن های نماینده نوع فایل ندارد. استفاده از این پارامتر اختیاری است

—————————————————————————————–

$icon

نوع: بولی · مقدار پیش فرض: False

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

عکس نماینده ی فایل پیوست را در صورت وجود بر می گرداند. در غیر این صورت، مقدار بازگشتی False خواهد بود.

<?php wp_get_attachment_image_src($attachment_id, $size, $icon); ?>

$attachment_id

نوع: عدد صحیح

آیدی پیوست مورد نظر.

—————————————————————————————–

$size

نوع: رشته | آرایه · مقدار پیش فرض: Thumbnail (اندازه کوچک)

اندازه تصویری که برای یک پیوست نمایش داده می شود. به دو صورت می توان این پارامتر را مقدار دهی کرد: (۱) کلمات کلیدی (رشته) که عبارتند از thumbnail (بندانگشتی)، medium (متوسط)، large (بزرگ) و Full (اندازه اصلی) (۲) یک آرایه دو عنصری که عنصر اول نماینده عرض و عنصر دوم نماینده ارتفاع بر حسب پیکسل می باشد. مثال: array(32,32) همانند نسخه ۲٫۵ وردپرس، این پارامتر تأثیری در اندازه آیکن های نماینده نوع فایل ندارد. استفاده از این پارامتر اختیاری است.

—————————————————————————————–

$icon

نوع: بولی · مقدار پیش فرض: False

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

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

<?php wp_get_attachment_metadata($post_id, $unfiltered) ?>

$post_id

نوع: عدد صحیح

(اجباری) آیدی پیوست مورد نظر.

—————————————————————————————–

$unfiltered

نوع: بولی | آرایه · مقدار پیش فرض: False

اگر مقدار آن True باشد، فیلترها اعمال نخواهند شد.