# Configuration

# 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/

Page authors:

Ben Word
Sponsor us on GitHub to help us grow 🌱