Search Modal Block

The Search Modal Block enhances your WordPress site with a modern, popup search interface that’s both beautiful and functional. Built specifically for the block editor (Gutenberg), it provides a seamless way to add search functionality to any part of your content.

Key Features:

• Clean, minimal design that works with any theme
• Fully responsive layout
• Accessibility-ready with ARIA labels and keyboard navigation
• Customizable text elements:
  • Search input placeholder
  • Search button text
  • Screen reader labels
• Focus-visible support for better keyboard navigation
• Seamless integration with WordPress search

Perfect For:

• Minimalist themes needing an elegant search solution
• Sites wanting to improve their search UX
• Accessibility-focused websites
• Any WordPress site using the block editor

Development

This block is built using the WordPress Create Block tool, ensuring compatibility with modern WordPress standards and practices. The source code is available in the plugin’s /src directory.

Building from Source

To build the plugin from source:

1. Clone the repository
2. Install dependencies with npm install
3. Run npm run build to build the production files
4. For development, use npm run start to start the development server

The build process uses @wordpress/scripts to compile and minify the JavaScript and CSS files. The source code for the compiled files in the /build directory can be found in the /src directory.

Development Dependencies

• @wordpress/scripts: ^27.9.0
• @wordpress/eslint-plugin: ^21.4.0
• @wordpress/stylelint-config: ^21.41.0
• eslint: ^8.57.1

The complete source code is available on GitHub: https://github.com/philhoyt/search-modal-block

Credits

This plugin uses the following third-party libraries:

• MicroModal – A lightweight, configurable modal library for web applications.

1. Upload the plugin files to the /wp-content/plugins/ directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the ‘Plugins’ screen in WordPress.
3. Go to the block editor and search for “Search Modal Block” in the block inserter to add it to your content.

1. 

   The search modal block in the block editor with customizable settings.

2. 

   The search modal displayed on the frontend after being triggered by the search icon.

1.2.0

• WordPress 6.9
• Fixed form action URL to work correctly on subdirectory and multisite installations
• Improved accessibility with proper ARIA labels and modal title

1.1.0

• Added ability to upload custom icons for the search button
• Added icon size controls with preset sizes (S, M, L, XL) and custom size option

1.0.1

• Include assets for .org
• Include src for .org

1.0.0

• Initial release with search modal block functionality
• Customizable placeholder text, button text, and label text
• Responsive and accessible design
• Integration with WordPress search functionality
• Focus-visible support for enhanced keyboard navigation