=== Admin Sidebar Search ===
Contributors: joselopezdeveloper
Donate link: https://paypal.me/jolo666
Tags: admin, menu, search, sidebar, productivity, keyboard, shortcut
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.1.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Live-filter the WordPress admin sidebar menus with an expandable search, recent suggestions, and an optional Ctrl/Cmd+K shortcut.

== Description ==

Admin Sidebar Search adds a compact **Search menu** control to the top of the WordPress admin sidebar.

* Click the control to expand a dark, sidebar-matched search field
* Type to live-filter top-level menus and submenus
* Press **Escape** to clear the filter and restore the full menu
* Click a filtered item to navigate (the full menu returns on the next page load)
* Recent destinations are stored in the browser and shown as suggestions when the field is empty
* Browser autocomplete is disabled on the search input
* **Enter** selects a highlighted (or first) recent suggestion; it does nothing while filtering menus

= Optional Ctrl / Cmd + K =

By default, WordPress keeps its built-in Command Palette on Ctrl/Cmd+K.

On the plugin settings page you can **opt in** to use Ctrl/Cmd+K for Admin Sidebar Search instead. That option disables the WordPress Command Palette so the shortcut opens this menu search.

= Settings =

After installation you are taken to **Settings → Admin Sidebar Search** to review options. You can also open that screen anytime from the Plugins list.

= Translations =

This plugin is translation-ready:

* Text domain: `admin-sidebar-search`
* Domain path: `/languages`
* Template file: `languages/admin-sidebar-search.pot`

To add a language, copy the `.pot` to `admin-sidebar-search-{locale}.po` (for example `admin-sidebar-search-es_ES.po`), translate the strings, compile to `.mo`, and place both files in the `languages` folder. WordPress language packs for wordpress.org installs are also supported when available.

Author: [Jose Lopez Developer](https://joselopez.co)

== Installation ==

1. Upload the `admin-sidebar-search` folder to `/wp-content/plugins/`, or install the ZIP via **Plugins → Add New**.
2. Activate the plugin through the **Plugins** screen.
3. You will be redirected to the setup / settings page.
4. Optionally enable **Use Ctrl/Cmd+K for Admin Sidebar Search**.

== Frequently Asked Questions ==

= Does this disable the WordPress Command Palette by default? =

No. That is an opt-in setting. Leave it unchecked to keep WordPress’s default Ctrl/Cmd+K behavior.

= Where are recent suggestions stored? =

In the browser’s `localStorage` for the current site. They are not stored in the WordPress database.

= Does Enter submit or navigate while filtering menus? =

Enter only activates an item in the **Recent** suggestions list. While you are typing a menu filter, Enter does nothing; click a menu item to open it.

= How do I translate this plugin? =

Use the `languages/admin-sidebar-search.pot` template with Poedit, Loco Translate, or similar. Save `.po` / `.mo` files as `admin-sidebar-search-{locale}.*` inside the `languages` directory.

== Screenshots ==

1. Search menu control in the WordPress admin sidebar.
2. Recent suggestions when the search field is open and empty.
3. Live filter matching menus and submenus (example: Import under Tools).
4. Settings page with the optional Ctrl/Cmd+K takeover.

== Changelog ==

= 1.1.1 =
* Complete translation support: Domain Path, text domain loading, POT template
* All UI strings (including JS) passed through gettext

= 1.1.0 =
* Settings page under Settings → Admin Sidebar Search
* Ctrl/Cmd+K takeover is opt-in (WordPress Command Palette stays enabled by default)
* Redirect to settings on activation
* Enter activates recent suggestions
* Renamed internal prefixes to `jl_admin_sidebar_search_`
* Author: Jose Lopez Developer (joselopez.co)

= 1.0.2 =
* Restored expandable dark UI after slug conflict with another plugin
* Unique plugin slug: admin-sidebar-search

= 1.0.0 =
* Initial release: live menu filter, recent suggestions, Escape to clear

== Upgrade Notice ==

= 1.1.1 =
Translation-ready: loads the text domain and ships a POT file in `/languages`.

= 1.1.0 =
Adds a settings page. Ctrl/Cmd+K takeover is now optional and off by default — enable it in Settings if you want that shortcut.
