زمینه دلخواه آپلود فایل یا پرونده - ACF File

زمینه دلخواه آپلود فایل یا پرونده – ACF File

این مقاله آموزش استفاده از زمینه دلخواه آپلود فایل یا پرونده در افزونه Advanced Custom Fields را با ذکر مثال و نحوه نمایش به طور کامل شرح می دهد. شاید بارگذاری فایل یکی از دغدغه های همیشگی کاربران وردپرسی بوده خوشبختانه افزونه ACF این ویژگی را به افزونه خود اضافه کرده تا کاربران بدون نیاز به کدنویسی از این قابلیت بهره مند گردند.

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

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

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

تنظیمات زمینه دلخواه آپلود فایل یا پرونده ( Settings )

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

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

کتابخانه ( Library )

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

کمترین ( Minimum )

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

بیشترین ( Maximum )

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

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

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

تنظیمات زمینه دلخواه آپلود فایل یا پرونده - ACF File
زمینه دلخواه آپلود فایل یا پرونده - ACF File

نمایش زمینه دلخواه آپلود فایل یا پرونده ( Template usage )

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

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

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

<?php
$file = get_field('file');
if( $file ): ?>
    <a href="<?php echo $file['url']; ?>"><?php echo $file['filename']; ?></a>
<?php endif; ?>

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

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

    // Extract variables.
    $url = $file['url'];
    $title = $file['title'];
    $caption = $file['caption'];
    $icon = $file['icon'];

    // Display image thumbnail when possible.
    if( $file['type'] == 'image' ) {
        $icon =  $file['sizes']['thumbnail'];
    }

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

    <a href="<?php echo esc_attr($url); ?>" title="<?php echo esc_attr($title); ?>">
        <img src="<?php echo esc_attr($icon); ?>" />
        <span><?php echo esc_html($title); ?></span>
    </a>

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

نمایش فایل با فرمت بازگشت ایدی ( Return ID )

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

<?php
$file = get_field('file');
if( $file ):
    $url = wp_get_attachment_url( $file ); ?>
    <a href="<?php echo esc_html($url); ?>" >Download File</a>
<?php endif; ?>

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

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

<?php if( get_field('file') ): ?>
    <a href="<?php the_field('file'); ?>" >Download File</a>
<?php endif; ?>

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