زمینه دلخواه آپلود عکس - ACF Image

زمینه دلخواه آپلود عکس – ACF Image

زمینه دلخواه آپلود عکس برای بارگذاری تصاویر دلخواه در وردپرس است، بارگذاری تصاویر به طور پیشفرض در وردپرس موجود است چه از بخش رسانه ها و چه تصاویر شاخص. گاها ما نیاز به بارگذاری و فراخوانی تصویر و یا تصاویری غیر از تصاویر پیشفرض داریم، برای مثال اگر بخواهیم از چند تصویر شاخص استفاده کنیم و یا هر مطلب ما دارای یک عکس پس زمینه متفاوت باشد، و بسیاری موارد دیگر.

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

با استفاده از زمینه دلخواه آپلود عکس امکان ایجاد زمینه ای برای بارگذاری با محدودیت حجم « کمترین و بیشترین حجم آپلودی » امکان پذیر است، یکی دیگر از تنظیمات این زمینه محدودیت بارگذاری بر اساس نوع تصویر بوده که یک ویژگی مفید است. این قابلیت ها از نسخه 5.1.9 به افزونه Advanced Custom Fields اضافه شده، و در نسخه های قبل تر در دسترس نیست.

تنظیمات زمینه دلخواه آپلود عکس ( Settings )

مقدار بازگشت ( Return Format )

مقدار برگشتی، مقداریست که در هنگام نمایش زمینه در قالب نمایش داده می شود. این مقدار می تواند مقدار آرایه، لینک و یا ایدی تصویر بارگذاری شده باشد.

اندازه پیش نمایش ( Preview Size )

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

کتابخانه ( Library )

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

کمترین ( Minimum )

این قسمت برای اعتبارسنجی کم ترین حجم مجاز برای بارگذاری عکس بر اساس اعداد صحیح است. برای مثال تصوریر نباید از 1 مگابایت کمتر باشد البته امکان اعتبارسنجی بر اساس کیلوبایت نیز مجاز است برای مثال '400 KB'

بیشترین ( Maximum )

اعتبارسنجی بیشترین حجم مجاز برای بارگذاری عکس بر اساس اعداد صحیح، برای مثال 20 مگابایت

انواع مجاز فایل ( Allowed file types )

اعتبارسنجی نوع فایل قابل بارگذاری، در این قسمت فرمت فایل های مجاز برای آپلود وارد می شود. فرمت ها با استفاده از کاما انگلیسی از هم جدا می شود ,

برای پذیرش تمامی فرمت ها می توانید این بخش را خالی بگذارید.

تنظیمات زمینه دلخواه آپلود عکس - ACF Image
تنظیمات زمینه دلخواه آپلود عکس – ACF Image
زمینه دلخواه آپلود عکس - ACF Image
زمینه دلخواه آپلود عکس – ACF Image

نمایش زمینه دلخواه آپلود عکس در قالب ( Template usage )

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

نمایش عکس بر اساس ایدی ( Return ID )

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

<?php 
$image = get_field('image');
$size = 'full'; // (thumbnail, medium, large, full or custom size)
if( $image ) {
    echo wp_get_attachment_image( $image, $size );
}
?>

نمایش عکس با فرمت بازگشت آرایه ( Return Array )

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

<?php 
$image = get_field('image');
if( !empty( $image ) ): ?>
    <img src="<?php echo esc_url($image['url']); ?>" alt="<?php echo esc_attr($image['alt']); ?>" />
<?php endif; ?>

در مثال زیر عنوان و دیگر اطلاعات تصویر هم نمایش داده می شود.

<?php
$image = get_field('image');
if( $image ):

    // Image variables.
    $url = $image['url'];
    $title = $image['title'];
    $alt = $image['alt'];
    $caption = $image['caption'];

    // Thumbnail size attributes.
    $size = 'thumbnail';
    $thumb = $image['sizes'][ $size ];
    $width = $image['sizes'][ $size . '-width' ];
    $height = $image['sizes'][ $size . '-height' ];

    // Begin caption wrap.
    if( $caption ): ?>
        <div class="wp-caption">
    <?php endif; ?>

    <a href="<?php echo esc_url($url); ?>" title="<?php echo esc_attr($title); ?>">
        <img src="<?php echo esc_url($thumb); ?>" alt="<?php echo esc_attr($alt); ?>" />
    </a>

    <?php 
    // End caption wrap.
    if( $caption ): ?>
        <p class="wp-caption-text"><?php echo esc_html($caption); ?></p>
        </div>
    <?php endif; ?>
<?php endif; ?>

نمایش عکس با فرمت بازگشت لینک ( Return URL )

مثال زیر نحوه نمایش تصویر انتخاب شده بر اساس مقدار بازگشت لینک را نشان می دهد.

<?php if( get_field('image') ): ?>
    <img src="<?php the_field('image'); ?>" />
<?php endif; ?>

زمینه های افزونه Advanced Custom Fields