Files
wordpress-develop/tests/phpunit/tests/theme/wpTheme.php
T
Sergey Biryukov e4947e935d Docs: Some documentation and test improvements for WP_Theme_JSON and WP_Theme_JSON_Resolver classes:
* Add missing `@since` tags.
* Update some DocBlocks per the documentation standards.
* Rename test files and classes per the naming conventions.
* Fix some code alignment issues reported by WPCS.

Follow-up to [50959], [50960].

See #52991, #53175.

git-svn-id: https://develop.svn.wordpress.org/trunk@50967 602fd350-edb4-49c9-b593-d223f7449a82
2021-05-24 13:24:05 +00:00

248 lines
8.6 KiB
PHP

<?php
/**
/**
* Test WP_Theme class.
*
* @package WordPress
* @subpackage Theme
*
* @group themes
*/
class Tests_Theme_wpTheme extends WP_UnitTestCase {
function setUp() {
parent::setUp();
$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'] );
}
function tearDown() {
$GLOBALS['wp_theme_directories'] = $this->orig_theme_dir;
wp_clean_themes_cache();
unset( $GLOBALS['wp_themes'] );
parent::tearDown();
}
// Replace the normal theme root directory with our premade test directory.
function _theme_root( $dir ) {
return $this->theme_root;
}
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() );
}
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
*/
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
*/
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
*/
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 );
}
function filter_theme_with_spaces() {
return 'subdir/theme with spaces';
}
/**
* @ticket 26873
*/
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
*/
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
*/
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
*/
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
*/
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
*/
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 );
}
}