README

👁 Packagist
👁 Packagist Downloads
👁 Build Status
👁 Project Status: Unsupported – The project has reached a stable, usable state but the author(s) have ceased all work on it.

A WordPress plugin which contains a collection of modules to apply theme-agnostic front-end modifications.

Caution

This plugin is no longer maintained. Use Acorn Prettify instead.

Requirements

Installation

You can install this plugin via the command-line or the WordPress admin panel.

via Command-line

If you're using Composer to manage WordPress, add Soil to your project's dependencies.

composer require roots/soil

Then activate the plugin via wp-cli.

wp plugin activate soil

via WordPress Admin Panel

1. Download the latest zip of this repo.
2. In your WordPress admin panel, navigate to Plugins->Add New
3. Click Upload Plugin
4. Upload the zip file that you downloaded.

Modules

• Cleaner WordPress markup
  add_theme_support('soil', 'clean-up');

• Disable REST API
  add_theme_support('soil', 'disable-rest-api');

• Disable asset versioning
  add_theme_support('soil', 'disable-asset-versioning');

• Disable trackbacks
  add_theme_support('soil', 'disable-trackbacks');

• Google Analytics
  add_theme_support('soil', ['google-analytics' => 'UA-XXXXX-Y']);

• Move all JS to the footer
  add_theme_support('soil', 'js-to-footer');

• Cleaner walker for navigation menus
  add_theme_support('soil', 'nav-walker');

• Convert search results from /?s=query to /search/query/
add_theme_support('soil', 'nice-search');

• Root relative URLs
  add_theme_support('soil', 'relative-urls');

And in a format you can copy & paste into your theme:

/**
 * Enable features from Soil when plugin is activated
 * @link https://roots.io/plugins/soil/
 */
add_theme_support('soil', [
 'clean-up',
 'disable-rest-api',
 'disable-asset-versioning',
 'disable-trackbacks',
 'google-analytics' => 'UA-XXXXX-Y',
 'js-to-footer',
 'nav-walker',
 'nice-search',
 'relative-urls'
]);

Module options

Soil 4 introduced support for options on some modules.

Contributing

Contributions are welcome from everyone. We have contributing guidelines to help you get started.

Community

Keep track of development and community news.

• Participate on the Roots Discourse
• Follow @rootswp on Twitter
• Read and subscribe to the Roots Blog
• Subscribe to the Roots Newsletter
• Listen to the Roots Radio podcast