Allow is_page_template() to accept an array of templates to check.

[morganestes]

Currently, is_page_template() takes an optional single template name to check. This would also allow for an array of strings to check.

Before:

if ( is_page_template( 'page-one.php' ) || is_page_template( 'page-two.php' ) || is_page_template( 'page-four.php' ) ) { 
    throw_hhg( false );
 }

After:

if ( is_page_template( array( 'page-one.php' , 'page-two.php',  'page-three.php' ) ) ) {
    throw_hhg( true );
}

Related: #15061

[tyxla]

Adding a unit test for the is_page_template() array parameter case. Also, adding a unit test for the is_page_template() string parameter case.

[tyxla]

Great idea. Personally I find that useful - it would help avoiding repetitive is_page_template() calls, making such checks shorter. I'd definitely use that often in my projects.

I've just added a patch that contains 2 unit tests for is_page_template() with the 2 parameter types.

[DrewAPicture]

docs fixes

[DrewAPicture]

31271.2.diff​ makes the docs adjustments.

[DrewAPicture]

Accounts for 'default'

[helen]

Seems like it would be nice to get some tests going for the default case. Would also highly recommend wrapping in_array( 'default', $template, true ) && ! $page_template in parens so it's clear what the grouping is, rather than trickily relying on operator precedence.

[DrewAPicture]

Tests for 'default'

[DrewAPicture]

31271.4.diff​ adds tests for 'default'.

[helen]

In 31754:

Allow is_page_template() to accept an array, as many other conditional tags do.

props morganestes, tyxla, DrewAPicture.
fixes #31271.