{"id":13448083,"url":"https://github.com/roots/soil","last_synced_at":"2025-09-27T10:31:59.723Z","repository":{"id":4127879,"uuid":"5239532","full_name":"roots/soil","owner":"roots","description":"WordPress plugin which contains a collection of modules to apply theme-agnostic front-end modifications","archived":true,"fork":false,"pushed_at":"2024-01-16T15:14:13.000Z","size":293,"stargazers_count":1019,"open_issues_count":20,"forks_count":176,"subscribers_count":84,"default_branch":"main","last_synced_at":"2025-04-24T05:26:37.393Z","etag":null,"topics":["wordpress-plugin"],"latest_commit_sha":null,"homepage":"https://roots.io/plugins/soil/","language":"PHP","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/roots.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"roots"}},"created_at":"2012-07-31T00:09:58.000Z","updated_at":"2025-03-14T03:57:58.000Z","dependencies_parsed_at":"2023-07-05T20:16:50.154Z","dependency_job_id":"82fa8810-68b8-425b-96dc-feac881a4d6a","html_url":"https://github.com/roots/soil","commit_stats":{"total_commits":243,"total_committers":49,"mean_commits":4.959183673469388,"dds":0.6131687242798354,"last_synced_commit":"e8e15c29f01414f86610445be8f7274b8b9a73b8"},"previous_names":[],"tags_count":28,"template":false,"template_full_name":null,"purl":"pkg:github/roots/soil","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roots%2Fsoil","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roots%2Fsoil/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roots%2Fsoil/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roots%2Fsoil/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/roots","download_url":"https://codeload.github.com/roots/soil/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roots%2Fsoil/sbom","scorecard":{"id":784659,"data":{"date":"2025-08-11","repo":{"name":"github.com/roots/soil","commit":"b9d615591ba0182d279e31f539cccae52910b108"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3.3,"checks":[{"name":"Code-Review","score":2,"reason":"Found 7/27 approved changesets -- score normalized to 2","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Maintained","score":0,"reason":"project is archived","details":["Warn: Repository is archived."],"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE.md:0","Info: FSF or OSI recognized license: MIT License: LICENSE.md:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":0,"reason":"Project has not signed or included provenance with any releases.","details":["Warn: release artifact 4.1.1 not signed: https://api.github.com/repos/roots/soil/releases/73363721","Warn: release artifact 4.1.0 not signed: https://api.github.com/repos/roots/soil/releases/73350997","Warn: release artifact 4.0.5 not signed: https://api.github.com/repos/roots/soil/releases/46851780","Warn: release artifact 4.0.4 not signed: https://api.github.com/repos/roots/soil/releases/31095358","Warn: release artifact 4.0.3 not signed: https://api.github.com/repos/roots/soil/releases/30937644","Warn: release artifact 4.1.1 does not have provenance: https://api.github.com/repos/roots/soil/releases/73363721","Warn: release artifact 4.1.0 does not have provenance: https://api.github.com/repos/roots/soil/releases/73350997","Warn: release artifact 4.0.5 does not have provenance: https://api.github.com/repos/roots/soil/releases/46851780","Warn: release artifact 4.0.4 does not have provenance: https://api.github.com/repos/roots/soil/releases/31095358","Warn: release artifact 4.0.3 does not have provenance: https://api.github.com/repos/roots/soil/releases/30937644"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":-1,"reason":"internal error: error during branchesHandler.setup: internal error: githubv4.Query: Resource not accessible by integration","details":null,"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 15 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-23T05:46:12.203Z","repository_id":4127879,"created_at":"2025-08-23T05:46:12.203Z","updated_at":"2025-08-23T05:46:12.203Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":277218995,"owners_count":25781447,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-27T02:00:08.978Z","response_time":73,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["wordpress-plugin"],"created_at":"2024-07-31T05:01:35.117Z","updated_at":"2025-09-27T10:31:59.384Z","avatar_url":"https://github.com/roots.png","language":"PHP","readme":"# Soil\n[![Packagist](https://img.shields.io/packagist/v/roots/soil.svg?style=flat-square)](https://packagist.org/packages/roots/soil)\n[![Packagist Downloads](https://img.shields.io/packagist/dt/roots/soil.svg?style=flat-square)](https://packagist.org/packages/roots/soil)\n![Build Status](https://github.com/roots/soil/workflows/Compatibility%20Checks/badge.svg)\n[![Project Status: Unsupported – The project has reached a stable, usable state but the author(s) have ceased all work on it.](https://www.repostatus.org/badges/latest/unsupported.svg)](https://www.repostatus.org/#unsupported)\n\nA WordPress plugin which contains a collection of modules to apply theme-agnostic front-end modifications.\n\n\u003e [!CAUTION]\n\u003e This plugin is no longer maintained. Use [Acorn Prettify](https://github.com/roots/acorn-prettify) instead.\n\n## Requirements\n\n\u003ctable\u003e\n  \u003cthead\u003e\n    \u003ctr\u003e\n      \u003cth\u003ePrerequisite\u003c/th\u003e\n      \u003cth\u003eHow to check\u003c/th\u003e\n      \u003cth\u003eHow to install\u003c/th\u003e\n    \u003c/tr\u003e\n  \u003c/thead\u003e\n  \u003ctbody\u003e\n    \u003ctr\u003e\n      \u003ctd\u003ePHP \u0026gt;= 5.6.x\u003c/td\u003e\n      \u003ctd\u003e\u003ccode\u003ephp -v\u003c/code\u003e\u003c/td\u003e\n      \u003ctd\u003e\n        \u003ca href=\"http://php.net/manual/en/install.php\"\u003ephp.net\u003c/a\u003e\n      \u003c/td\u003e\n    \u003c/tr\u003e\n  \u003c/tbody\u003e\n\u003c/table\u003e\n\n## Installation\n\nYou can install this plugin via the command-line or the WordPress admin panel.\n\n### via Command-line\n\nIf you're [using Composer to manage WordPress](https://roots.io/using-composer-with-wordpress/), add Soil to your project's dependencies.\n\n```sh\ncomposer require roots/soil\n```\n\nThen activate the plugin via [wp-cli](http://wp-cli.org/commands/plugin/activate/).\n\n```sh\nwp plugin activate soil\n```\n\n### via WordPress Admin Panel\n\n1. Download the [latest zip](https://github.com/roots/soil/releases/latest) of this repo.\n2. In your WordPress admin panel, navigate to Plugins-\u003eAdd New\n3. Click Upload Plugin\n4. Upload the zip file that you downloaded.\n\n## Modules\n\n* **Cleaner WordPress markup**\u003cbr\u003e\n  `add_theme_support('soil', 'clean-up');`\n\n* **Disable REST API**\u003cbr\u003e\n  `add_theme_support('soil', 'disable-rest-api');`\n\n* **Disable asset versioning**\u003cbr\u003e\n  `add_theme_support('soil', 'disable-asset-versioning');`\n\n* **Disable trackbacks**\u003cbr\u003e\n  `add_theme_support('soil', 'disable-trackbacks');`\n\n* **Google Analytics**\u003cbr\u003e\n  `add_theme_support('soil', ['google-analytics' =\u003e 'UA-XXXXX-Y']);`\n\n* **Move all JS to the footer**\u003cbr\u003e\n  `add_theme_support('soil', 'js-to-footer');`\n\n* **Cleaner walker for navigation menus**\u003cbr\u003e\n  `add_theme_support('soil', 'nav-walker');`\n\n* **Convert search results from `/?s=query` to `/search/query/`**\u003cbr\u003e\n  `add_theme_support('soil', 'nice-search');`\n\n* **Root relative URLs**\u003cbr\u003e\n  `add_theme_support('soil', 'relative-urls');`\n\nAnd in a format you can copy \u0026 paste into your theme:\n```php\n/**\n * Enable features from Soil when plugin is activated\n * @link https://roots.io/plugins/soil/\n */\nadd_theme_support('soil', [\n    'clean-up',\n    'disable-rest-api',\n    'disable-asset-versioning',\n    'disable-trackbacks',\n    'google-analytics' =\u003e 'UA-XXXXX-Y',\n    'js-to-footer',\n    'nav-walker',\n    'nice-search',\n    'relative-urls'\n]);\n```\n\n### Module options\n\nSoil 4 introduced support for options on some modules.\n\n\u003cdetails\u003e\n\u003csummary\u003eFull annotated list of features and options\u003c/summary\u003e\n\n```php\n\n/**\n * Enable features from Soil when plugin is activated\n * @link https://roots.io/plugins/soil/\n */\nadd_theme_support('soil', [\n    /**\n     * Clean up WordPress\n     */\n    'clean-up' =\u003e [\n        /**\n         * Obscure and suppress WordPress information.\n         */\n        'wp_obscurity',\n\n        /**\n         * Disable WordPress emojis.\n         */\n        'disable_emojis',\n\n        /**\n         * Disable Gutenberg block library CSS.\n         */\n        'disable_gutenberg_block_css',\n\n        /**\n         * Disable extra RSS feeds.\n         */\n        'disable_extra_rss',\n\n        /**\n         * Disable recent comments CSS.\n         */\n        'disable_recent_comments_css',\n\n        /**\n         * Disable gallery CSS.\n         */\n        'disable_gallery_css',\n\n        /**\n         * Clean HTML5 markup.\n         */\n        'clean_html5_markup',\n    ],\n\n    /**\n     * Disable WordPress REST API\n     */\n    'disable-rest-api',\n\n    /**\n     * Remove version query string from all styles and scripts\n     */\n    'disable-asset-versioning',\n\n    /**\n     * Disables trackbacks/pingbacks\n     */\n    'disable-trackbacks',\n\n    /**\n     * Google Analytics\n     */\n    'google-analytics' =\u003e [\n        /**\n         * This is to go live with GA.\n         *\n         * This should probably be false in non-production.\n         */\n        'should_load' =\u003e false,\n\n        /**\n         * Google Analytics ID\n         *\n         * This is also known as your \"property ID\" or \"measurement ID\"\n         *\n         * Format: UA-XXXXX-Y\n         */\n        'google_analytics_id' =\u003e null,\n\n        /**\n         * Optimize container ID\n         *\n         * Format: OPT-A1B2CD (previously: GTM-A1B2CD)\n         *\n         * @link https://support.google.com/optimize/answer/6262084\n         */\n        'optimize_id' =\u003e null,\n\n        /**\n         * Anonymize user IP addresses.\n         *\n         * This might be required depending on region.\n         *\n         * @link https://github.com/roots/soil/pull/206\n         */\n        'anonymize_ip',\n    ],\n\n    /**\n     * Moves all scripts to wp_footer action\n     */\n    'js-to-footer',\n\n    /**\n     * Cleaner walker for wp_nav_menu()\n     */\n    'nav-walker',\n\n    /**\n     * Redirects search results from /?s=query to /search/query/, converts %20 to +\n     *\n     * @link http://txfx.net/wordpress-plugins/nice-search/\n     */\n    'nice-search',\n\n    /**\n     * Convert absolute URLs to relative URLs\n     *\n     * Inspired by {@link https://web.archive.org/web/20180529232418/http://www.456bereastreet.com/archive/201010/how_to_make_wordpress_urls_root_relative/}\n     */\n    'relative-urls',\n]);\n```\n\u003c/details\u003e\n\n## Contributing\n\nContributions are welcome from everyone. We have [contributing guidelines](https://github.com/roots/guidelines/blob/master/CONTRIBUTING.md) to help you get started.\n\n## Community\n\nKeep track of development and community news.\n\n* Participate on the [Roots Discourse](https://discourse.roots.io/)\n* Follow [@rootswp on Twitter](https://twitter.com/rootswp)\n* Read and subscribe to the [Roots Blog](https://roots.io/blog/)\n* Subscribe to the [Roots Newsletter](https://roots.io/subscribe/)\n* Listen to the [Roots Radio podcast](https://roots.io/podcast/)\n","funding_links":["https://github.com/sponsors/roots"],"categories":["PHP"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froots%2Fsoil","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Froots%2Fsoil","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froots%2Fsoil/lists"}