کتابخانه کد و توابع اختصاصی بیسکو وب

<?php
/**
 * محاسبه خودکار زمان تقریبی مطالعه بر اساس تعداد کلمات متن فارسی/انگلیسی
 * نحوه استفاده: [reading_time] یا فراخوانی تابع bisco_get_reading_time() در پوسته
 */
function bisco_get_reading_time( $post_id = null ) {
    $post = get_post( $post_id );
    if ( ! $post ) {
        return '';
    }

    $content = strip_shortcodes( $post->post_content );
    $clean_content = wp_strip_all_tags( $content );

    // شمارش کلمات برای متون فارسی و یونیکد
    $word_count = count( preg_split( '/\s+/u', trim( $clean_content ) ) );

    // سرعت میانگین مطالعه: ۲۰۰ کلمه در دقیقه
    $reading_time = ceil( $word_count / 200 );

    if ( $reading_time < 1 ) {
        $reading_time = 1;
    }

    return sprintf( '%d دقیقه', $reading_time );
}

add_shortcode( 'reading_time', function() {
    $time = bisco_get_reading_time( get_the_ID() );
    return '<span class="bisco-reading-time"><i class="dashicons dashicons-clock"></i> زمان مطالعه: ' . esc_html( $time ) . '</span>';
} );

<?php
/**
 * شورت‌کد نمایش تاریخ آخرین به‌روزرسانی نوشته
 * نحوه استفاده: [last_updated]
 */
function bisco_last_updated_date_shortcode() {
    $modified_time = get_the_modified_time( 'U' );
    $created_time  = get_the_time( 'U' );

    // اگر نوشته حداقل ۱ روز بعد از ایجاد آپدیت شده باشد تاریخ ویرایش را نشان بده
    if ( $modified_time > ( $created_time + DAY_IN_SECONDS ) ) {
        $date_format = get_option( 'date_format' );
        $updated_date = get_the_modified_date( $date_format );

        return '<span class="bisco-last-updated">آخرین به‌روزرسانی: ' . esc_html( $updated_date ) . '</span>';
    }

    return '';
}
add_shortcode( 'last_updated', 'bisco_last_updated_date_shortcode' );

<?php
/**
 * شورت‌کد نمایش سال جاری (میلادی یا هجری شمسی)
 * نحوه استفاده: [current_year] یا [current_year calendar="jalali"]
 */
function bisco_current_year_shortcode( $atts ) {
    $atts = shortcode_atts( array(
        'calendar' => 'gregorian', // 'jalali' یا 'gregorian'
    ), $atts );

    if ( 'jalali' === $atts['calendar'] && function_exists( 'jdate' ) ) {
        return jdate( 'Y' );
    }

    return date( 'Y' );
}
add_shortcode( 'current_year', 'bisco_current_year_shortcode' );

<?php
/**
 * ساخت شورت‌کد باکس پیام و هشدار سفارشی
 * نحوه استفاده در متن: [bisco_alert type="success"]متن پیام شما[/bisco_alert]
 */
function bisco_alert_box_shortcode( $atts, $content = null ) {
    $atts = shortcode_atts( array(
        'type' => 'info', // پیش‌فرض: info, warning, success, error
    ), $atts, 'bisco_alert' );

    $type_class = sanitize_html_class( $atts['type'] );
    $output = '<div class="bisco-alert-box alert-' . esc_attr( $type_class ) . '">';
    $output .= do_shortcode( $content );
    $output .= '</div>';

    return $output;
}
add_shortcode( 'bisco_alert', 'bisco_alert_box_shortcode' );

<?php
/**
 * ثبت تاکسونومی سفارشی برای نمونه‌کارها (دسته‌بندی پروژه‌ها)
 */
function bisco_register_portfolio_taxonomy() {
    $labels = array(
        'name'              => 'دسته‌بندی پروژه‌ها',
        'singular_name'     => 'دسته پروژه',
        'search_items'      => 'جستجوی دسته‌ها',
        'all_items'         => 'همه دسته‌ها',
        'parent_item'       => 'دسته مادر',
        'parent_item_colon' => 'دسته مادر:',
        'edit_item'         => 'ویرایش دسته',
        'update_item'       => 'به‌روزرسانی دسته',
        'add_new_item'      => 'افزودن دسته جدید',
        'new_item_name'     => 'نام دسته جدید',
        'menu_name'         => 'دسته‌ها',
    );

    $args = array(
        'hierarchical'      => true, // به صورت دسته‌بندی والد/فرزند باشد (مانند دسته پست‌ها)
        'labels'            => $labels,
        'show_ui'           => true,
        'show_admin_column' => true, // نمایش ستون دسته در جدول ادمین
        'query_var'         => true,
        'show_in_rest'      => true, // نمایش در پنل سایدبار گوتنبرگ
        'rewrite'           => array( 'slug' => 'project-type' ),
    );

    register_taxonomy( 'project_type', array( 'portfolio' ), $args );
}
add_action( 'init', 'bisco_register_portfolio_taxonomy' );

<?php
/**
 * ثبت پست تایپ سفارشی نمونه کارها (Portfolio) با استانداردهای مدرن وردپرس
 */
function bisco_register_portfolio_cpt() {
    $labels = array(
        'name'               => 'نمونه کارها',
        'singular_name'      => 'نمونه کار',
        'menu_name'          => 'نمونه کارها',
        'add_new'            => 'افزودن نمونه کار',
        'add_new_item'       => 'افزودن نمونه کار جدید',
        'edit_item'          => 'ویرایش نمونه کار',
        'new_item'           => 'نمونه کار جدید',
        'view_item'          => 'مشاهده نمونه کار',
        'search_items'       => 'جستجوی نمونه کارها',
        'not_found'          => 'هیچ نمونه کاری یافت نشد',
        'not_found_in_trash' => 'در زباله‌دان موردی یافت نشد',
    );

    $args = array(
        'labels'              => $labels,
        'public'              => true,
        'has_archive'         => true,
        'publicly_queryable'  => true,
        'show_ui'             => true,
        'show_in_menu'        => true,
        'show_in_rest'        => true, // فعال‌سازی ویرایشگر گوتنبرگ و REST API
        'query_var'           => true,
        'rewrite'             => array( 'slug' => 'portfolio', 'with_front' => false ),
        'capability_type'     => 'post',
        'hierarchical'        => false,
        'menu_position'       => 5,
        'menu_icon'           => 'dashicons-portfolio',
        'supports'            => array( 'title', 'editor', 'thumbnail', 'excerpt', 'revisions' ),
    );

    register_post_type( 'portfolio', $args );
}
add_action( 'init', 'bisco_register_portfolio_cpt' );

<?php
/**
 * هدایت صفحات پیوست تصاویر به نوشته والد یا صفحه اصلی با ریدایرکت ۳۰۱
 * جهت حذف محتوای بی‌کیفیت (Thin Content) و بهبود سئوی تکنیکال
 */
function bisco_redirect_attachment_pages() {
    if ( is_attachment() ) {
        global $post;
        if ( ! empty( $post->post_parent ) && is_numeric( $post->post_parent ) ) {
            $parent_url = get_permalink( $post->post_parent );
            wp_safe_redirect( $parent_url, 301 );
            exit;
        } else {
            // در صورتی که عکس والدی نداشته باشد، به صفحه اصلی ریدایرکت شود
            wp_safe_redirect( home_url( '/' ), 301 );
            exit;
        }
    }
}
add_action( 'template_redirect', 'bisco_redirect_attachment_pages' );

<?php
/**
 * غیرفعال‌سازی تغییر مقیاس خودکار تصاویر با ابعاد بیش از ۲۵۶۰ پیکسل در وردپرس
 */
add_filter( 'big_image_size_threshold', '__return_false' );

<?php
/**
 * جلوگیری از تولید سایزهای غیرضروری تصاویر در وردپرس
 */
function bisco_disable_unused_image_sizes( $sizes ) {
    // حذف سایزهای پیش‌فرض بی‌استفاده وردپرس
    unset( $sizes['medium_large'] ); // 768px
    unset( $sizes['1536x1536'] );    // 2x Medium Large
    unset( $sizes['2048x2048'] );    // 2x Large

    return $sizes;
}
add_filter( 'intermediate_image_sizes_advanced', 'bisco_disable_unused_image_sizes' );

<?php
/**
 * ثبت ابعاد اختصاصی تصاویر متناسب با طراحی قالب
 */
function bisco_setup_custom_image_sizes() {
    // سایز کارت وبلاگ با نسبت تصویر ۱۶:۹ و برش دقیق
    add_image_size( 'bisco-blog-card', 640, 360, true );

    // سایز اسلایدر بزرگ صفحه اصلی
    add_image_size( 'bisco-hero-banner', 1200, 500, array( 'center', 'center' ) );
}
add_action( 'after_setup_theme', 'bisco_setup_custom_image_sizes' );

// نمایش سایز جدید در ویرایشگر وردپرس برای انتخاب دستی نویسندگان
add_filter( 'image_size_names_choose', function( $sizes ) {
    return array_merge( $sizes, array(
        'bisco-blog-card' => 'کارت وبلاگ (۶۴۰ در ۳۶۰)',
    ) );
} );

<?php
/**
 * لغو بارگذاری اسکریپت‌های جاوااسکریپت فرم تماس در صفحات بدون فرم
 */
function bisco_remove_unneeded_plugin_js() {
    // اگر صفحه دارای فرم تماس نیست، اسکریپت آن لغو شود
    if ( ! is_page( 'contact' ) ) {
        wp_dequeue_script( 'contact-form-7' );
    }

    // لغو اسکریپت‌های ووکامرس در وبلاگ
    if ( ! is_woocommerce() && ! is_cart() && ! is_checkout() ) {
        wp_dequeue_script( 'wc-add-to-cart' );
    }
}
add_action( 'wp_enqueue_scripts', 'bisco_remove_unneeded_plugin_js', 100 );

<?php
/**
 * حذف استایل‌های اضافی افزونه فرم تماس ۷ در صفحاتی به جز برگه تماس
 */
function bisco_remove_unneeded_plugin_css() {
    // اگر در برگه تماس یا لندینگ فرم نیستیم، استایل را حذف کن
    if ( ! is_page( array( 'contact', 'request-quote' ) ) ) {
        wp_dequeue_style( 'contact-form-7' );
    }

    // حذف استایل افزونه wp-block-library در صورت عدم استفاده از گوتنبرگ در فرانت
    if ( ! is_singular( 'post' ) ) {
        wp_dequeue_style( 'wp-block-library' );
        wp_dequeue_style( 'wp-block-library-theme' );
    }
}
add_action( 'wp_enqueue_scripts', 'bisco_remove_unneeded_plugin_css', 99 );