Configuration

• Introduction
• Theme Configuration
  • Soil
  • theme.json

Introduction

All of the configuration for Sage lives inside of app/setup.php. Each option is documented allowing for you to easily familiarize yourself with the options configured out of the box.

Theme Configuration

Configuration specific to WordPress resides in the app/setup.php file. In this file, you will find the default enqueued stylesheets and scripts, the supported theme features added with add_theme_support, and the registration hooks for navigation menus and sidebars.

By default, Sage is configured to:

• Enqueue app.css and app.js on the frontend.
• Enqueue editor.css and editor.js in the Gutenberg editor.
• Add theme support for common functionality.
• Register a default navigation menu called primary_navigation.
• Register a primary and footer Sidebar widget area.

Soil

Also seen in setup.php is out of the box theme support for Soil (opens new window) (recently updated!), a WordPress plugin containing a collection of modules applying theme-agnostic front-end modifications including:

• Cleaner WordPress markup
• Disable REST API
• Disable asset versioning
• Disable trackbacks
• Google Analytics integration
• Move all Javascript to the footer
• Cleaner NavWalker for navigation menus
• Prettier search URLs converting from /?s=query to /search/query/
• Root relative URLs

theme.json

Sage ships with a starter theme.json for you to start customizing.

theme.json guides

• https://developer.wordpress.org/block-editor/how-to-guides/themes/theme-json/
• https://fullsiteediting.com/lessons/adding-full-site-editing-features-to-classic-themes/