This WordPress plugin will help you achieve a distraction free view for your pages, posts and custom post types.
👉🏻 Not a developer? Running WordPress? Download WP Distraction Free View on WordPress.org.
Welcome to the GitHub repository for "WP Distraction Free View" WordPress Plugin. This is the core repository and heart of an ecosystem of active development. Here you can browse the source, look at open issues, and contribute to the project.
Happy Coding!
This repository is not suitable for support. Please don't use GitHub issues for non-development related support requests. Don't get us wrong, we're more than happy to help you! However, to get the support you need please use the following channels:
- WP.org Support Forums - for all free users.
- Documentation - for all admins (coming soon).
If you're looking to contribute or actively develop on the plugin, Welcome! We're glad you're here. Please ⭐️ this repository and fork it to begin local development.
Most of us are using Local by Flywheel to develop on WordPress, which makes set up quick and easy. If you prefer Docker, VVV, or another flavor of local development that's cool too!
To get started developing on the WP Distraction Free View, you will need to perform the following steps:
- Create a new WordPress site with any URL
cd
into your local plugins directory:/path/to/wp-content/plugins/
- Fork this repository from GitHub and then clone that into your plugins directory in a new
wp-distraction-free-view
directory - Run
npm install
to get the necessary npm packages - Activate the plugin in WordPress
- Run
npm run watch
to start the watch process which will build the sass and script files
That's it. You're now ready to start development.
Available commands
Command | Description |
---|---|
npm run watch |
Live reloads JS and SASS files. Typically you'll run this command before you start development. It's necessary to build the JS/CSS however if you're working strictly within PHP it may not be necessary to run. |
npm run dev |
Runs a one time build for development. No production files are created. |
npm run production |
Builds the minified production files for release. |
Development Notes
- Ensure that you have
SCRIPT_DEBUG
enabled within your wp-config.php file. Here's a good example of wp-config.php for debugging:// Enable WP_DEBUG mode define( 'WP_DEBUG', true ); // Enable Debug logging to the /wp-content/debug.log file define( 'WP_DEBUG_LOG', true ); // Loads unminified core files define( 'SCRIPT_DEBUG', true );
- Commit the
package.lock
file. Read more about why here. - Your editor should recognize the
.eslintrc
and.editorconfig
files within the Repo's root directory. Please only submit PRs following those coding style rulesets.