Sage 9 folder structure

jamiechong · June 27, 2017, 9:19pm

I’m looking at Sage 9 for the first time and I’m trying to wrap my head around the folder structure. Inside /themes/sage/ there is no style.css, functions.php, etc. These files are in resources. How does Wordpress know that!? Yet somehow it works. What’s the obvious thing I’m missing?

QWp6t · June 27, 2017, 9:22pm

We’re not doing anything fancy. WordPress simply supports that.

jamiechong · June 27, 2017, 9:25pm

I’ll have to search for Wordpress docs on that then. Which file is the entry point?

ben · June 28, 2017, 1:01am

resources/functions.php

jasperfrumau · July 1, 2017, 5:20am

Yeah, I think that is shown at wp-includes/class-wp-theme.php . See:

github.com

WordPress/WordPress/blob/master/wp-includes/class-wp-theme.php#L1045


	public function get_theme_root() {
		return $this->theme_root;
	}


	/**
	 * Returns the URL to the directory of the theme root.
	 *
	 * This is typically the absolute URL to wp-content/themes. This forms the basis
	 * for all other URLs returned by WP_Theme, so we pass it to the public function
	 * get_theme_root_uri() and allow it to run the {@see 'theme_root_uri'} filter.
	 *
	 * @since 3.4.0
	 *
	 * @return string Theme root URI.
	 */
	public function get_theme_root_uri() {
		if ( ! isset( $this->theme_root_uri ) ) {
			$this->theme_root_uri = get_theme_root_uri( $this->stylesheet, $this->theme_root );
		}
		return $this->theme_root_uri;
	}

WordPress does already scan one level deep.
Also see https://github.com/roots/sage/issues/1870 . Good discussion on the way WordPress scans for files and how Roots has come up with a way to load files from more than one level deep for files in resources/views. @ben mentioned this SO thread in the solved Roots Sage issue : https://wordpress.stackexchange.com/questions/249984/page-template-in-two-level-deep-folder/250024#250024 that explains things rather well too.