/soil-fertilizer

Put some Bootstrap-specific extras back into Sage

Primary LanguagePHPMIT LicenseMIT

Soil-Fertilizer

A WordPress plugin that provides additional (or enhanced/removed) functionality to the Soil plugin, best to be used with Sage-based theme.

This plugin is modularlized just like Soil, so you only need to load the things you actually need. Add the necessary lines to your lib/config.php and the functionality will be there.

Requirements

Prerequisite How to check How to install
PHP >= 5.4.x php -v php.net

Modules

  • Restore the Roots Bootstrap Navwalker

    add_theme_support('sf-nav-walker');

REMINDER!!! You need to go into templates/header.php and replace the menu code with the code contained in this Gist so the menu works properly.

  • Bootstrap friendly Gallery code

    add_theme_support('sf-gallery');

This module CAN be replaced by 12 lines of less/sass and filtering default gallery style, as shown by Ben Word in this PR - sage#1421.

  • Google Analytics with support for multiple trackers

    add_theme_support('sf-google-analytics', 'UA-XXXXX-Y');

If You wish to set multiple trackers, simply use as follows:

add_theme_support('sf-google-analytics', 'UA-XXXXX-Y', 'wp_footer', ['Tracker1' => 'UA-XXXXX-X', 'Tracker2' => 'UA-XXXXX-Z', ... ]);

This module follows same tactics as Soil Google analytics (more info here).

For info on multiple trackers see Working with Multiple Tracking Objects

Support

Please feel free to open an issue if you run into problems.

Contributions

We welcome all ideas and support on how to make this better for everyone. Pull requests are more than welcome.

Coding Standards

For convenience coding standard rules, compatible with Roots guidelines are provided, along with proper .editorconfig file.

You can check if your contribution passes the styleguide by installing PHP CodeSniffer and running the following in your project directory:

phpcs --standard=ruleset.xml --extensions=php -n -s .

If You use Arcanist, there's .arclint file that includes all Lint engines used when developing this plugin.

Additonal code rules

  • Use Hakger\SoilFertilizer\ namespace
  • Use short array syntax
  • Use short echo syntax

Contributors