wordpress-develop/tests/phpunit/tests/theme/wpTheme.php
Sergey Biryukov ddb409edca Build/Test Tools: Implement use of the void solution.
> PHPUnit 8.0.0 introduced a `void` return type declaration to the "fixture" methods – `setUpBeforeClass()`, `setUp()`, `tearDown()` and `tearDownAfterClass()`. As the `void` return type was not introduced until PHP 7.1, this makes it more difficult to create cross-version compatible tests when using fixtures, due to signature mismatches.
>
> The `Yoast\PHPUnitPolyfills\TestCases\TestCase` overcomes the signature mismatch by having two versions. The correct one will be loaded depending on the PHPUnit version being used.
>
> When using this TestCase, if an individual test, or another TestCase which extends this TestCase, needs to overload any of the "fixture" methods, it should do so by using a snake_case variant of the original fixture method name, i.e. `set_up_before_class()`, `set_up()`, `assert_pre_conditions()`, `assert_post_conditions()`, `tear_down()`, and `tear_down_after_class()`.
>
> The snake_case methods will automatically be called by PHPUnit.
>
> > IMPORTANT: The snake_case methods should not call the PHPUnit parent, i.e. do not use `parent::setUp()` from within an overloaded `set_up()` method. If necessary, DO call `parent::set_up()`.

Reference: https://github.com/Yoast/PHPUnit-Polyfills#testcases

This commit renames all declared fixture methods, and calls to parent versions of those fixture methods, from camelCase to snake_case.

Follow-up to [51559-51567].

Props jrf, hellofromTonya, johnbillion, netweb, dd32, pputzer, SergeyBiryukov.
See #46149.

git-svn-id: https://develop.svn.wordpress.org/trunk@51568 602fd350-edb4-49c9-b593-d223f7449a82
2021-08-07 10:29:41 +00:00

250 lines
8.7 KiB
PHP

<?php
/**
/**
* Test WP_Theme class.
*
* @package WordPress
* @subpackage Theme
*
* @group themes
*/
class Tests_Theme_wpTheme extends WP_UnitTestCase {
public function set_up() {
parent::set_up();
$this->theme_root = realpath( DIR_TESTDATA . '/themedir1' );
$this->orig_theme_dir = $GLOBALS['wp_theme_directories'];
$GLOBALS['wp_theme_directories'] = array( $this->theme_root );
add_filter( 'theme_root', array( $this, '_theme_root' ) );
add_filter( 'stylesheet_root', array( $this, '_theme_root' ) );
add_filter( 'template_root', array( $this, '_theme_root' ) );
// Clear caches.
wp_clean_themes_cache();
unset( $GLOBALS['wp_themes'] );
}
public function tear_down() {
$GLOBALS['wp_theme_directories'] = $this->orig_theme_dir;
wp_clean_themes_cache();
unset( $GLOBALS['wp_themes'] );
parent::tear_down();
}
// Replace the normal theme root directory with our premade test directory.
public function _theme_root( $dir ) {
return $this->theme_root;
}
public function test_new_WP_Theme_top_level() {
$theme = new WP_Theme( 'theme1', $this->theme_root );
// Meta.
$this->assertSame( 'My Theme', $theme->get( 'Name' ) );
$this->assertSame( 'http://example.org/', $theme->get( 'ThemeURI' ) );
$this->assertSame( 'An example theme', $theme->get( 'Description' ) );
$this->assertSame( 'Minnie Bannister', $theme->get( 'Author' ) );
$this->assertSame( 'http://example.com/', $theme->get( 'AuthorURI' ) );
$this->assertSame( '1.3', $theme->get( 'Version' ) );
$this->assertSame( '', $theme->get( 'Template' ) );
$this->assertSame( 'publish', $theme->get( 'Status' ) );
$this->assertSame( array(), $theme->get( 'Tags' ) );
// Important.
$this->assertSame( 'theme1', $theme->get_stylesheet() );
$this->assertSame( 'theme1', $theme->get_template() );
}
public function test_new_WP_Theme_subdir() {
$theme = new WP_Theme( 'subdir/theme2', $this->theme_root );
// Meta.
$this->assertSame( 'My Subdir Theme', $theme->get( 'Name' ) );
$this->assertSame( 'http://example.org/', $theme->get( 'ThemeURI' ) );
$this->assertSame( 'An example theme in a sub directory', $theme->get( 'Description' ) );
$this->assertSame( 'Mr. WordPress', $theme->get( 'Author' ) );
$this->assertSame( 'http://wordpress.org/', $theme->get( 'AuthorURI' ) );
$this->assertSame( '0.1', $theme->get( 'Version' ) );
$this->assertSame( '', $theme->get( 'Template' ) );
$this->assertSame( 'publish', $theme->get( 'Status' ) );
$this->assertSame( array(), $theme->get( 'Tags' ) );
// Important.
$this->assertSame( 'subdir/theme2', $theme->get_stylesheet() );
$this->assertSame( 'subdir/theme2', $theme->get_template() );
}
/**
* @ticket 20313
*/
public function test_new_WP_Theme_subdir_bad_root() {
// This is what get_theme_data() does when you pass it a style.css file for a theme in a subdirectory.
$theme = new WP_Theme( 'theme2', $this->theme_root . '/subdir' );
// Meta.
$this->assertSame( 'My Subdir Theme', $theme->get( 'Name' ) );
$this->assertSame( 'http://example.org/', $theme->get( 'ThemeURI' ) );
$this->assertSame( 'An example theme in a sub directory', $theme->get( 'Description' ) );
$this->assertSame( 'Mr. WordPress', $theme->get( 'Author' ) );
$this->assertSame( 'http://wordpress.org/', $theme->get( 'AuthorURI' ) );
$this->assertSame( '0.1', $theme->get( 'Version' ) );
$this->assertSame( '', $theme->get( 'Template' ) );
$this->assertSame( 'publish', $theme->get( 'Status' ) );
$this->assertSame( array(), $theme->get( 'Tags' ) );
// Important.
$this->assertSame( 'subdir/theme2', $theme->get_stylesheet() );
$this->assertSame( 'subdir/theme2', $theme->get_template() );
}
/**
* @ticket 21749
*/
public function test_wp_theme_uris_with_spaces() {
$theme = new WP_Theme( 'theme with spaces', $this->theme_root . '/subdir' );
// Make sure subdir/ is considered part of the stylesheet, as we must avoid encoding /'s.
$this->assertSame( 'subdir/theme with spaces', $theme->get_stylesheet() );
// Check that in a URI path, we have raw URL encoding (spaces become %20).
// Don't try to verify the complete URI path. get_theme_root_uri() breaks down quickly.
$this->assertSame( 'theme%20with%20spaces', basename( $theme->get_stylesheet_directory_uri() ) );
$this->assertSame( 'theme%20with%20spaces', basename( $theme->get_template_directory_uri() ) );
// Check that wp_customize_url() uses URL encoding, as it is a query arg (spaces become +).
$this->assertSame( admin_url( 'customize.php?theme=theme+with+spaces' ), wp_customize_url( 'theme with spaces' ) );
}
/**
* @ticket 21969
*/
public function test_theme_uris_with_spaces() {
$callback = array( $this, 'filter_theme_with_spaces' );
add_filter( 'stylesheet', $callback );
add_filter( 'template', $callback );
$this->assertSame( get_theme_root_uri() . '/subdir/theme%20with%20spaces', get_stylesheet_directory_uri() );
$this->assertSame( get_theme_root_uri() . '/subdir/theme%20with%20spaces', get_template_directory_uri() );
remove_filter( 'stylesheet', $callback );
remove_filter( 'template', $callback );
}
public function filter_theme_with_spaces() {
return 'subdir/theme with spaces';
}
/**
* @ticket 26873
*/
public function test_display_method_on_get_method_failure() {
$theme = new WP_Theme( 'nonexistent', $this->theme_root );
$this->assertSame( 'nonexistent', $theme->get( 'Name' ) );
$this->assertFalse( $theme->get( 'AuthorURI' ) );
$this->assertFalse( $theme->get( 'Tags' ) );
$this->assertFalse( $theme->display( 'Tags' ) );
}
/**
* @ticket 40820
*/
public function test_child_theme_with_itself_as_parent_should_appear_as_broken() {
$theme = new WP_Theme( 'child-parent-itself', $this->theme_root );
$errors = $theme->errors();
$this->assertWPError( $errors );
$this->assertSame( 'theme_child_invalid', $errors->get_error_code() );
}
/**
* Enable a single theme on a network.
*
* @ticket 30594
* @group ms-required
*/
public function test_wp_theme_network_enable_single_theme() {
$theme = 'testtheme-1';
$current_allowed_themes = get_site_option( 'allowedthemes' );
WP_Theme::network_enable_theme( $theme );
$new_allowed_themes = get_site_option( 'allowedthemes' );
update_site_option( 'allowedthemes', $current_allowed_themes ); // Reset previous value.
$current_allowed_themes['testtheme-1'] = true; // Add the new theme to the previous set.
$this->assertSameSetsWithIndex( $current_allowed_themes, $new_allowed_themes );
}
/**
* Enable multiple themes on a network.
*
* @ticket 30594
* @group ms-required
*/
public function test_wp_theme_network_enable_multiple_themes() {
$themes = array( 'testtheme-2', 'testtheme-3' );
$current_allowed_themes = get_site_option( 'allowedthemes' );
WP_Theme::network_enable_theme( $themes );
$new_allowed_themes = get_site_option( 'allowedthemes' );
update_site_option( 'allowedthemes', $current_allowed_themes ); // Reset previous value.
$current_allowed_themes = array_merge(
$current_allowed_themes,
array(
'testtheme-2' => true,
'testtheme-3' => true,
)
);
$this->assertSameSetsWithIndex( $current_allowed_themes, $new_allowed_themes );
}
/**
* Disable a single theme on a network.
*
* @ticket 30594
* @group ms-required
*/
public function test_network_disable_single_theme() {
$current_allowed_themes = get_site_option( 'allowedthemes' );
$allowed_themes = array(
'existing-1' => true,
'existing-2' => true,
'existing-3' => true,
);
update_site_option( 'allowedthemes', $allowed_themes );
$disable_theme = 'existing-2';
WP_Theme::network_disable_theme( $disable_theme );
$new_allowed_themes = get_site_option( 'allowedthemes' );
update_site_option( 'allowedthemes', $current_allowed_themes ); // Reset previous value.
unset( $allowed_themes[ $disable_theme ] ); // Remove deleted theme from initial set.
$this->assertSameSetsWithIndex( $allowed_themes, $new_allowed_themes );
}
/**
* Disable multiple themes on a network.
*
* @ticket 30594
* @group ms-required
*/
public function test_network_disable_multiple_themes() {
$current_allowed_themes = get_site_option( 'allowedthemes' );
$allowed_themes = array(
'existing-4' => true,
'existing-5' => true,
'existing-6' => true,
);
update_site_option( 'allowedthemes', $allowed_themes );
$disable_themes = array( 'existing-4', 'existing-5' );
WP_Theme::network_disable_theme( $disable_themes );
$new_allowed_themes = get_site_option( 'allowedthemes' );
update_site_option( 'allowedthemes', $current_allowed_themes ); // Reset previous value.
unset( $allowed_themes['existing-4'] );
unset( $allowed_themes['existing-5'] );
$this->assertSameSetsWithIndex( $allowed_themes, $new_allowed_themes );
}
}