ساخت ابزارک در وردپرس

قسط داریم امروز به آموزش ساخت ابزارک اختصاصی در وردپرس بپردازیم .ابزارک ها یا ویجت ها (Widget) در کل یک شبه کلمه است که فرایند اجرای ابزارک در اسم مخصوص آن ابزارک توصیف میکند

چگونه یک ابزارک جدید ثبت کنیم ؟

کد های زیر را باید در فایل functions.php در قالب سایتتون اضافه کنید

<?php
/**
 * Register our sidebars and widgetized areas.
 *
 */
function arphabet_widgets_init() {

	register_sidebar( array(
		'name'          => 'Home right sidebar',
		'id'            => 'home_right_1',
		'before_widget' => '<div>',
		'after_widget'  => '</div>',
		'before_title'  => '<h2 class="rounded">',
		'after_title'   => '</h2>',
	) );

}
add_action( 'widgets_init', 'arphabet_widgets_init' );
?>

نحوه ی نشان دادن اسم یک ابزارک جدید

شما میتوانید اسم جدید ابزارک را به دو صورت به قالبتون اضافه کنید و نمایش دهید :

– با اضافه کردن مستقیم کد زیر به فایل sidebar.php در قالبتون
– با اضافه کردن یک تابع سفارشی در فایل fuctions.php  در قالبتون

در اینجا یک نمونه از کد نشان داده شده  که یک راه معمول برای اضافه کردن اسم جدید ابزارک  تان به یک قالب والد یا فرزند است:

<?php if ( is_active_sidebar( 'home_right_1' ) ) : ?>
	<div id="primary-sidebar" class="primary-sidebar widget-area" role="complementary">
		<?php dynamic_sidebar( 'home_right_1' ); ?>
	</div><!-- #primary-sidebar -->
<?php endif; ?>

کد بالا را می توان به فایل sidebar.php اضافه کرد. ان بررسی میکند که آیا اسم جدید ابزارک انتشار یافته است (یعنی فعال است) و سپس محتوای ابزارک را در صورت  فعال بودن ان را نمایش میدهد .

این تابع است که خروجی ابزارک را به نمایش می گذارد :

<?php dynamic_sidebar( 'home_right_1' ); ?>

کد بالا، ابزارک ثبت شده با مقدار ای دی   1 ‘home_right_نمایش می دهد. هنگامی که ابزارکی را در سایت خود نمایش می دهید به یاد داشته باشید که «home_right_1» را با مقدار معینی  که هنگام ابزارک خود ثبت نام کرده اید تعویض کنید.

برای کسب اطلاعات بیشتر، لطفا به ابزارک های  API مراجعه کنید تا نحوه برنامه نویسی و نمایش ابزارک ها و اسم های ابزارک را بیاموزید

ساخت یک ابزارک جدید با تابع سفارشی در function.php

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

توجه: شما همچنین باید یک اسم ابزارک جدید را با استفاده از همان شناسه به عنوان آنچه که در نوار کناری پویا استفاده می کنید را ذکر کنید .
که در این مثال از before-post استفاده شده است.

function wpsites_before_post_widget( $content ) {
	if ( is_singular( array( 'post', 'page' ) ) && is_active_sidebar( 'before-post' ) && is_main_query() ) {
		dynamic_sidebar('before-post');
	}
	return $content;
}
add_filter( 'the_content', 'wpsites_before_post_widget' );

کد بالا یک اسم ی  ابزارک جدید را قبل از همه پست ها و صفحات تک در هر تم با استفاده از filter the_contentنمایش می دهد، با این حال توصیه می شود که از hook مخصوص خاص خود استفاده کنید، البته درصورتیکه تم شما دربرگیرنده ی آنها باشد.(برای فهم بهتر مطلب حتما تست شود )

توجه: شما همچنین باید یک اسم ی  ابزارک جدید را با استفاده از همان شناسه ثبت کنید همانند آنچه که در نوار کناری پویا استفاده می کنید و در این مورد مثال قبل از before-post استفاده شده است.

register_sidebar( array(
	'id'          => 'before-post',
	'name'        => 'Before Posts Widget',
	'description' => __( 'Your Widget Description.', 'text_domain' ),
) );

منبع : مخزن وردپرس (ساخت ابزارک) Widgetizing Themes