تابع apply_filters_ref_array وردپرس

View Larger Image

تابع Apply_filters_ref_array() تقریباً شبیه تابع apply_filter() عمل می کند . یکی از تفاوت های اصلی توابع apply_filter() و apply_filters_ref_array() تعداد پارامترهای است که دریافت می کنند . در تابع apply_filter() امکان ارسال یک یا چند پارامتر وجود دارد ، در حالی که در تابع apply_filters_ref_array() آرایه ای از پارامترها ارسال می شود .

هر دو پارامتر ارسال شده به تابع apply_filters_ref_array() الزامی هستند . نکته مهمی که باید در نظر بگیرید این است که پارامتر $args باید به صورت مرجع (refrence) به تابع ارسال شود .

<?php
	apply_filters_ref_array( $tag, $args );
?>

<?php

apply_filters_ref_array( $tag, $args );

$tag – نام قلاب فیلتر

$args – آرایه ای از آرگومان های ارسال شده به فیلترهای ثبت شده برای قلاب

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

وردپرس دارای قلاب فیلتری به نام posts_results است که به شما امکان می دهد اینکار را به آسانی انجام دهید .

کد زیر مربوط به هسته وردپرس در مورد قلاب فیلتر posts_results است .

<?php
	$this->posts = apply_filters_ref_array(
		‘posts_results’, array( $this->posts, &$this )
	);
?>

<?php

$this->posts = apply_filters_ref_array(

‘posts_results’, array( $this->posts, &$this )

);

این قلاب آرایه ای از اشیاء نوشته ها را به هر فیلتر ثبت شده روی آن ارسال می کند .

با استفاده از مثال زیر ، شما به صورت کامل این آرایه از اشیاء نوشته ها (posts object) را بازنویسی می کنید و آن را با مجموعه سفارشی خود جایگزین می کنید .

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

شما این لیست اشیاء مطالب را به نوع مطلب ” برگه (page) ” در صفحه اصلی سایت تغییر می دهید .

در کد زیر از کلاس wpdb که در فصل 6 ” امنیت افزونه “ بررسی می شود ، استفاده شده است .

<?php
	add_filter( 'posts_results', 'rwpp_custom_home_page_posts' );

	function rwpp_custom_home_page_posts( $results ) {

		global $wpdb, $wp_query;

		/* Check if viewing the home page. */
		if ( is_home() ) {

		/* Posts per page. */
		$per_page = get_option( 'posts_per_page' );

		/* Get the current page. */
		$paged = get_query_var( 'paged' );

		/* Set the $page variable. */
		$page = ( ( 0 == $paged || 1 == $paged ) ? 1 : absint( $paged ) );

		/* Set the number of posts to offset. */
		$offset = ( $page - 1 ) * $per_page . ', ';

		/* Set the limit by the $offset and number of posts to show. */
		$limits = 'LIMIT '. $offset . $per_page;

		/* Get results from the database. */
		$results = $wpdb->get_results( "
		SELECT SQL_CALC_FOUND_ROWS $wpdb->posts.*
		FROM $wpdb->posts
		WHERE 1=1
		AND post_type = 'page'
		AND post_status = 'publish'
		ORDER BY post_title ASC
		$limits
		" );
		}
		return $results;
	}
?>

<?php

add_filter( 'posts_results', 'rwpp_custom_home_page_posts' );

function rwpp_custom_home_page_posts( $results ) {

global $wpdb, $wp_query;

/* Check if viewing the home page. */

if ( is_home() ) {

/* Posts per page. */

$per_page = get_option( 'posts_per_page' );

/* Get the current page. */

$paged = get_query_var( 'paged' );

/* Set the $page variable. */

$page = ( ( 0 == $paged || 1 == $paged ) ? 1 : absint( $paged ) );

/* Set the number of posts to offset. */

$offset = ( $page - 1 ) * $per_page . ', ';

/* Set the limit by the $offset and number of posts to show. */

$limits = 'LIMIT '. $offset . $per_page;

/* Get results from the database. */

$results = $wpdb->get_results( "

SELECT SQL_CALC_FOUND_ROWS $wpdb->posts.*

FROM $wpdb->posts

WHERE 1=1

AND post_type = 'page'

AND post_status = 'publish'

ORDER BY post_title ASC

$limits

" );

}

return $results;

}

آشنایی با قلاب های فیلتر – Filter Hooks در وردپرستابع remove_filter وردپرس

پیشنهاد می کنیم برای دریافت آخرین مطالب کانال تلگرام کانی تمزرا دنبال کنید .

درباره اسماعیل ابراهیمی

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