soil

Soil

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

  Prerequisite
  How to check
  How to install






  PHP >= 5.6.x
  php -v
  
    php.net

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.

Full annotated list of features and options

…

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