توابع wp_customize_support_script() در وردپرس

wp customize support script
11 آذر 1403

تثبیت پشتیبانی از افزونه های سفارشی در وردپرس

شما ممکن است زمانی بخواهید که یک مجموعه از امکانات و تنظیمات سفارشی را برای سایت وردپرسی خود اضافه کنید. به همین خاطر، وردپرس ابزارهایی را در اختیار شما قرار می‌دهد که به شما این امکان را می‌دهد تا با استفاده از کدهای جاوااسکریپتی، به راحتی درون‌ریزی‌هایی برای خواهد کاربر فراهم کنید. تابع wp_customize_support_script() یکی از این ابزارهاست که به شما اجازه می‌دهد تا پشتیبانی از API سفارشی‌سازی وردپرس را فعال کنید.

خصصی کردن بخش های سفارشی سایت، به سادگی و بدون نیاز به کد نویسی زیاد، مزایای زیادی دارد. به عنوان مثال شما می‌توانید به راحتی آیکون‌ها، رنگ‌ها و دیگر کریپت‌های ظاهری سایت خود را به کار ببرید. استفاده از wp_customize_support_script() به شما این امکان را می‌دهد تا در صفحه شخصی‌سازی (Customizer) وردپرس، این قابلیت‌ها را اضافه کنید و کاربرانتان هم می‌توانند به آسانی از آن‌ها استفاده کنند.

همچنین با استفاده از این تابع، می‌توانید اطمینان حاصل کنید که تایید می‌کنید هر یک از ویژگی‌ها و تنظیمات شما به درستی با API سفارشی‌سازی وردپرس کار می‌کند. این بدان معنی است که شما می‌توانید نظارت دقیقی بر روی همه‌چیز داشته باشید و هرگونه تغییری که در نحوه عملکرد سایت شما به وجود می‌آید، هم در تیب شخصی‌سازی و هم در پیش‌نمایش زنده، به روز می‌شود.

در ادامه، کدی را معرفی می‌کنیم که نشان می‌دهد چگونه می‌توانید از wp_customize_support_script() در تم وردپرس خود استفاده کنید. این کد همواره در زمانی که می‌خواهید ویژگی‌های جدیدی به پنل شخصی‌سازی اضافه کنید، می‌تواند به کار شما بیاید.

function my_customize_register( $wp_customize ) {
$wp_customize->add_section( 'my_section', array(
'title' => __( 'My Section', 'textdomain' ),
'priority' => 30,
) );

$wp_customize->add_setting( 'my_setting', array(
'default' => 'Default Value',
'sanitize_callback' => 'sanitize_text_field',
) );

$wp_customize->add_control( 'my_control', array(
'label' => __( 'My Control', 'textdomain' ),
'section' => 'my_section',
'settings' => 'my_setting',
'type' => 'text',
) );
}
add_action( 'customize_register', 'my_customize_register' );

function my_customize_preview_js() {
wp_enqueue_script( 'my_customize_preview', get_template_directory_uri() . '/js/customize-preview.js', array( 'customize-preview' ), '', true );
}
add_action( 'customize_preview_init', 'my_customize_preview_js' );

توضیح کد

function my_customize_register( $wp_customize )
این خط تابعی به نام my_customize_register را تعریف می‌کند که با استفاده از شئ $wp_customize، زیرمجموعه‌ها و تنظیمات سفارشی را به شما اجازه می‌دهد تا اضافه کنید.

$wp_customize->add_section( 'my_section', array(...))
به کمک این خط، یک بخش جدید به نام 'my_section' به پنل شخصی‌سازی اضافه می‌کنیم. می‌توانید عنوان و اولویت این بخش را مشخص کنید.

$wp_customize->add_setting( 'my_setting', array(...))
این خط تنها یک تنظیم جدید به نام 'my_setting' به آن بخش اضافه می‌کند و هزینه پیش‌فرض آن را مشخص می‌کند.

$wp_customize->add_control( 'my_control', array(...))
اصطلاحاً کنترلر را به بخش و تنظیم مشخص شده وصل می‌کند. این کنترلرز در پنل شخصی‌سازی به کاربر نمایش داده خواهد شد و به عنوان ورودی متنی طراحی شده است.

add_action( 'customize_register', 'my_customize_register' )
این خط به وردپرس می‌گوید که تابع 'my_customize_register' را در زمان بارگذاری شخصی‌ساز فراخوانی کند.

function my_customize_preview_js()
این تابع به منظور بارگذاری اسکریپت‌هایی است که پیش‌نمایش زنده تنظیمات سفارشی شما را روی صفحه نمایش می‌دهد. این یک تجربه کاربری بهتری ایجاد می‌کند.

add_action( 'customize_preview_init', 'my_customize_preview_js' )
و در آخر، این خط اطمینان می‌دهد که تابع ‘my_customize_preview_js’ هنگامی که پیش‌نمایش در حال بارگذاری است، فراخوانی شود.

سوالات متداول

؟

wp_customize_support_script() چیست و چه کاربردی دارد؟

؟

چگونه می‌توانم از wp_customize_support_script() در پروژه‌ام استفاده کنم؟

؟

آیا wp_customize_support_script() فقط برای تم‌های وردپرس کار می‌کند؟

؟

خودم می‌توانم ویژگی‌های جدیدی به پنل شخصی‌سازی اضافه کنم؟