{"id":16050181,"url":"https://github.com/getdave/responsive-navigation-block","last_synced_at":"2025-03-17T21:31:13.904Z","repository":{"id":251912135,"uuid":"786764127","full_name":"getdave/responsive-navigation-block","owner":"getdave","description":"WordPress Plugin that allows you to show different navigation menus based on the screen size using the Navigation block.","archived":false,"fork":false,"pushed_at":"2024-11-08T11:03:51.000Z","size":3247,"stargazers_count":9,"open_issues_count":2,"forks_count":2,"subscribers_count":3,"default_branch":"trunk","last_synced_at":"2025-03-16T14:52:47.580Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/getdave.png","metadata":{"files":{"readme":"readme.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"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}},"created_at":"2024-04-15T09:00:39.000Z","updated_at":"2025-03-09T14:20:22.000Z","dependencies_parsed_at":"2024-09-13T21:13:48.889Z","dependency_job_id":"d212946f-5060-4451-abfd-4b0f7cd34c21","html_url":"https://github.com/getdave/responsive-navigation-block","commit_stats":null,"previous_names":["getdave/responsive-navigation-block"],"tags_count":16,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getdave%2Fresponsive-navigation-block","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getdave%2Fresponsive-navigation-block/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getdave%2Fresponsive-navigation-block/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getdave%2Fresponsive-navigation-block/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/getdave","download_url":"https://codeload.github.com/getdave/responsive-navigation-block/tar.gz/refs/heads/trunk","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244112831,"owners_count":20400011,"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","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":[],"created_at":"2024-10-09T00:42:52.451Z","updated_at":"2025-03-17T21:31:13.897Z","avatar_url":"https://github.com/getdave.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Responsive Navigation Block\n\n-   Stable tag: 1.0.9\n-   Tested up to: 6.6\n-   License: GPL-2.0-or-later\n-   Tags: navigation, menus, responsive, blocks, mobile\n-   Contributors: get_dave\n-   Source code: https://github.com/getdave/responsive-navigation-block\n\n![](.wordpress-org/banner-1544x500.png)\n\nComplete control over your navigation menus based on screen size including styles and menu items.\n\n## Description\n\nThis Plugin allows you to display and apply alternative styling to different navigation menus based on the screen size using the WordPress Navigation block.\n\n[![Active Installs](https://img.shields.io/wordpress/plugin/installs/getdave-responsive-navigation-block?logo=wordpress\u0026logoColor=%23fff\u0026label=Active%20Installs\u0026labelColor=%2323282D\u0026color=%2323282D)](https://wordpress.org/plugins/getdave-responsive-navigation-block/) [![Playground Demo Link](https://img.shields.io/wordpress/plugin/v/getdave-responsive-navigation-block?logo=wordpress\u0026logoColor=%23fff\u0026label=Playground%20Demo\u0026labelColor=%233858e9\u0026color=%233858e9)](https://playground.wordpress.net/?blueprint-url=https://raw.githubusercontent.com/getdave/responsive-navigation-block/refs/heads/trunk/.wordpress-org/blueprints/blueprint.json)\n\n### Video Walkthrough\n\n[youtube https://www.youtube.com/watch?v=R5kzAaEsDMg]\n\n### Features\n\n-   Two new Navigation Block (variations) for:\n    -   Mobile\n    -   Desktop\n-   Style your menu differently depending on screen size.\n-   Use a different menu for each screen size.\n-   Customize the \"breakpoint\" (where you switch between mobile and desktop).\n-   Automatically switch editor to \"mobile\" preview when editing the mobile navigation.\n\n### Usage\n\nThis Plugin creates two block variations from the Navigation block which will be **automatically hidden/shown at the configured screensize** (breakpoint):\n\n-   Navigation (Mobile) - will be displayed only on smaller screen sizes.\n-   Navigation (Desktop) - will be displayed only on larger screen sizes.\n\nThis affords the ability to **independently style mobile vs desktop navigation** and even allows for **completely different menus** to be used.\n\nThe Plugin should be used as follows:\n\n-   Install and Activate the plugin - two new block variations will be automatically registered for \"Mobile\" and \"Desktop\".\n-   Go to the Editor and remove any existing Navigation block.\n-   Add the \"Desktop Navigation\" block - style and configure the menu for \"desktop\" as required.\n-   Add the \"Mobile Navigation\" block - style and configure the menu for \"mobile\" as required.\n-   View the front of your website and resize your browser to see the navigations swap out at the appropriate breakpoint/screensize.\n\nAlternatively you can transform the default Navigation block to either `Mobile` or `Desktop` variations via the block's interface.\n\n### Support\n\nPlease see FAQs. If you still have an issue please:\n\n-   check [Github for existing Issue reports](https://github.com/getdave/responsive-navigation-block/issues).\n-   (if none) then file a new Issue on Github\n\n### Privacy Statement\n\nResponsive Navigation does _not_:\n\n-   use cookies.\n-   send data to any third party.\n-   include any third party resources.\n\n## Frequently Asked Questions\n\n### Why is this plugin necessary?\n\nThe built in WordPress Navigation block provides limited control over its display on smaller screens. Whilst [efforts are underway to implement solutions to this natively within WordPress](https://github.com/WordPress/gutenberg/issues/43852#issuecomment-1884949063) they are currently still in development.\n\nUntil a solution arrives in WordPress Core, this Plugin exists to provide a workaround solution that requires minimal user configuration.\n\nThis Plugin was based upon a technique which I originally documented in my [YouTube Video: Use a different MENU on MOBILE with the Navigation block in WORDPRESS block editor](https://www.youtube.com/watch?v=dY3f8sHcAPA).\n\n### Can I adjust the breakpoint?\n\nBy default, the \"breakpoint\" at which the mobile navigation will switch to show the desktop navigation is `782px`. This aligns with the default configuration of the built in Wordpress Navigation block. To change this you can:\n\n-   Go to the WP Admin Dashboard.\n-   Go to `Settings -\u003e Responsive Navigation`.\n-   Configure the breakpoint value and the required unit. Save.\n-   The breakpoint will be adjusted to match your new configuration.\n\nNote that you can use relative units such as `em`, `rem` and `vw`.\n\n### Styling of my mobile menu doesn't work\n\nDue to complications with the way the default WordPress Navigation block works you are advised to use the following settings to control the styling of your mobile navigation:\n\n-   Mobile overlay\n    -   background color - `Styles -\u003e Color -\u003e Submenu \u0026 overlay background`.\n    -   text color - `Styles -\u003e Color -\u003e Submenu \u0026 overlay text`.\n-   Mobile menu toggle button (\"hamburger\"):\n    -   icon color - `Styles -\u003e Color -\u003e Text`.\n    -   background color - `Styles -\u003e Color -\u003e Background`.\n\nStyles for Desktop Navigation can be applied using the standard controls.\n\n## Contributing\n\nContributions to this Plugin are welcome. Please fork the Github repository and submit a PR for review.\n\n### Development Setup\n\nThis Plugin uses the [@wordpress/scripts package](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-scripts/).\n\n-   Check out the Github repo into the `wp-content/plugins` directory of a WordPress installation.\n-   `cd` into the Plugin's directory install the dependencies with `npm i`.\n-   Running `npm start` will start the `@wordpress/scripts` package in watch mode ready to compile the JavaScript on modification.\n-   PHP files can be edited in the usual manner.\n\n### Testing\n\nThe Plugin has e2e test coverage for the key features courtesey of @wordpress/scripts and Playwright.\n\nTo run the tests - in your terminal of choice:\n\n-   `npm run build`.\n-   `npm run wp-env start`.\n-   Run the tests: `npm run test:e2e`\n\n### Releasing\n\nReleasing the Plugin to the WordPress.org Plugin repo is the prerogative of the Plugin owner (@get_dave). The process is as follows:\n\n#### Test the Plugin\n\n-   Commit all changes to `trunk` branch.\n-   Push changes to `trunk` (only) - `git push origin trunk`.\n-   In Github:\n    -   Actions\n    -   Select the [`Build Release Zip` action](https://github.com/getdave/responsive-navigation-block/actions/workflows/build-release-zip.yml).\n    -   Select the `Run workflow` dropdown and run the workflow to generate a zip file.\n    -   When action completes download the generated Plugin zip artifact.\n    -   Manually install and test the .zip.\n\n#### Deploy to WP.org\n\n-   When ready to deploy.\n-   Bump Plugin version and tag release - `npm run bump-version`.\n-   Push trunk and tags - `git push origin trunk --tags`\n-   Deployment to WP.org will be handled automatically.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgetdave%2Fresponsive-navigation-block","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgetdave%2Fresponsive-navigation-block","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgetdave%2Fresponsive-navigation-block/lists"}