Responsive Navigation Block

This Plugin allows you to display and apply alternative styling to different navigation menus based on the screen size using the WordPress Navigation block.

 Video Walkthrough

Features

• Two new Navigation Block (variations) for:
  • Mobile
  • Desktop
• Style your menu differently depending on screen size.
• Use a different menu for each screen size.
• Customize the “breakpoint” (where you switch between mobile and desktop).
• Automatically switch editor to “mobile” preview when editing the mobile navigation.

Usage

This Plugin creates two block variations from the Navigation block which will be automatically hidden/shown at the configured screensize (breakpoint):

• Navigation (Mobile) – will be displayed only on smaller screen sizes.
• Navigation (Desktop) – will be displayed only on larger screen sizes.

This affords the ability to independently style mobile vs desktop navigation and even allows for completely different menus to be used.

The Plugin should be used as follows:

• Install and Activate the plugin – two new block variations will be automatically registered for “Mobile” and “Desktop”.
• Go to the Editor and remove any existing Navigation block.
• Add the “Desktop Navigation” block – style and configure the menu for “desktop” as required.
• Add the “Mobile Navigation” block – style and configure the menu for “mobile” as required.
• View the front of your website and resize your browser to see the navigations swap out at the appropriate breakpoint/screensize.

Alternatively you can transform the default Navigation block to either Mobile or Desktop variations via the block’s interface.

Support

Please see FAQs. If you still have an issue please:

• check Github for existing Issue reports.
• (if none) then file a new Issue on Github

Privacy Statement

Responsive Navigation does not:

• use cookies.
• send data to any third party.
• include any third party resources.

Contributing

Contributions to this Plugin are welcome. Please fork the Github repository and submit a PR for review.

Development Setup

This Plugin uses the @wordpress/scripts package.

• Check out the Github repo into the wp-content/plugins directory of a WordPress installation.
• cd into the Plugin’s directory install the dependencies with npm i.
• Running npm start will start the @wordpress/scripts package in watch mode ready to compile the JavaScript on modification.
• PHP files can be edited in the usual manner.

Testing

The Plugin has e2e test coverage for the key features courtesey of @wordpress/scripts and Playwright.

To run the tests – in your terminal of choice:

• npm run build.
• npm run wp-env start.
• Run the tests: npm run test:e2e

Releasing

Releasing the Plugin to the WordPress.org Plugin repo is the prerogative of the Plugin owner (@get_dave). The process is as follows:

Test the Plugin

• Commit all changes to trunk branch.
• Push changes to trunk (only) – git push origin trunk.
• In Github:
  • Actions
  • Select the Build Release Zip action.
  • Select the Run workflow dropdown and run the workflow to generate a zip file.
  • When action completes download the generated Plugin zip artifact.
  • Manually install and test the .zip.

Deploy to WP.org

• When ready to deploy.
• Bump Plugin version and tag release – npm run bump-version.
• Push trunk and tags – git push origin trunk --tags
• Deployment to WP.org will be handled automatically.

No installation instructions provided.