{"id":40639861,"url":"https://github.com/verygoodplugins/wp-clean-admin","last_synced_at":"2026-01-21T08:02:08.396Z","repository":{"id":309621439,"uuid":"1036973142","full_name":"verygoodplugins/wp-clean-admin","owner":"verygoodplugins","description":"Chrome extension that cleans WordPress admin menus by hiding non-core items. Perfect for clean screenshots and screencasts.","archived":false,"fork":false,"pushed_at":"2025-08-12T23:04:10.000Z","size":10,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-12T23:31:26.603Z","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":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/verygoodplugins.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"zenodo":null}},"created_at":"2025-08-12T21:38:46.000Z","updated_at":"2025-08-12T23:04:13.000Z","dependencies_parsed_at":"2025-08-12T23:31:30.915Z","dependency_job_id":"e210b19e-d3a9-442d-aa03-3ec4e9d3f8b4","html_url":"https://github.com/verygoodplugins/wp-clean-admin","commit_stats":null,"previous_names":["verygoodplugins/wp-clean-admin"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/verygoodplugins/wp-clean-admin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/verygoodplugins%2Fwp-clean-admin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/verygoodplugins%2Fwp-clean-admin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/verygoodplugins%2Fwp-clean-admin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/verygoodplugins%2Fwp-clean-admin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/verygoodplugins","download_url":"https://codeload.github.com/verygoodplugins/wp-clean-admin/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/verygoodplugins%2Fwp-clean-admin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28629922,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-21T04:47:28.174Z","status":"ssl_error","status_checked_at":"2026-01-21T04:47:22.943Z","response_time":86,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":"2026-01-21T08:02:04.278Z","updated_at":"2026-01-21T08:02:08.389Z","avatar_url":"https://github.com/verygoodplugins.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# WP Admin Menu Cleaner\n\nA lightweight Chrome extension that cleans up the WordPress admin menu by hiding non-core items while preserving the current page's menu item. Perfect for clean screenshots, screencasts, and focused WordPress admin demos.\n\n![Clean WordPress admin menu](.github/screenshots/wp-clean-admin.jpg)\n\n## ✨ Features\n\n- **Smart Menu Cleaning**: Hides plugin and theme menu items while keeping WordPress core menus\n- **Current Page Awareness**: Always shows the menu item for the page you're currently viewing\n- **Submenu Support**: Cleans both top-level and submenu items\n- **Persistent Across Navigation**: No flash or re-hiding when navigating between admin pages\n- **Easy Toggle**: Simple on/off switch via extension popup\n- **Zero Configuration**: Works out of the box with sensible defaults\n- **Lightweight**: Minimal performance impact\n\n## 🎯 What Gets Hidden\n\nThe extension hides all non-core WordPress admin menu items **except**:\n\n### Always Visible (Core Items)\n- Dashboard\n- Posts  \n- Media\n- Pages\n- Comments\n- Appearance\n- Plugins\n- Users\n- Tools\n- Settings\n- Profile\n- Updates\n\n### Contextually Visible\n- Current page menu item (e.g., if you're on a plugin settings page, that plugin's menu stays visible)\n- Parent menu items for editor screens (post.php, post-new.php map back to Posts/Pages)\n\n## 📦 Installation\n\n### From Chrome Web Store\n[Install WP Admin Menu Cleaner](https://chromewebstore.google.com/detail/wp-admin-menu-cleaner/hjcofmagkkcnnghnnfpbingafegjaihd)\n\n### Manual Installation (Developer Mode)\n\n1. **Download or Clone**\n   ```bash\n   git clone https://github.com/verygoodplugins/wp-clean-admin.git\n   cd wp-clean-admin\n   ```\n\n2. **Load in Chrome**\n   - Open `chrome://extensions/`\n   - Enable **Developer mode** (toggle in top right)\n   - Click **Load unpacked**\n   - Select the `wp-clean-admin` folder\n\n3. **Start Using**\n   - Visit any WordPress admin URL (`/wp-admin/`)\n   - The extension activates automatically\n   - Use the extension popup to toggle on/off\n\n## 🚀 Usage\n\n### Basic Usage\n1. Navigate to any WordPress admin page\n2. The extension automatically hides non-core menu items\n3. Your current page's menu item remains visible\n\n### Toggle Control\n- Click the extension icon in Chrome's toolbar\n- Use the **Clean menu** toggle to enable/disable\n- Changes apply instantly to the current tab\n\n### Perfect For\n- **Screenshots**: Clean, professional WordPress admin screenshots\n- **Screencasts**: Focused tutorials without plugin clutter\n- **Client Demos**: Show core WordPress functionality without distractions\n- **Documentation**: Consistent admin interface across different WordPress sites\n\n## 🛠️ Technical Details\n\n### Files Structure\n```\nwp-clean-admin/\n├── manifest.json     # Chrome extension manifest (MV3)\n├── content.js        # Main cleaning logic\n├── popup.html        # Toggle interface\n└── README.md         # This file\n```\n\n### How It Works\n1. **Content Script**: Runs on all `/wp-admin/*` pages\n2. **Menu Detection**: Identifies WordPress admin menu structure\n3. **Smart Filtering**: Compares menu items against core WordPress slugs\n4. **Current Page Logic**: Detects current page and preserves its menu item\n5. **Dynamic Updates**: Uses MutationObserver to handle menu changes\n\n### Browser Compatibility\n- Chrome (Manifest V3)\n- Edge (Chromium-based)\n- Other Chromium browsers\n\n## 🔧 Development\n\n### Local Development\n```bash\n# Clone the repository\ngit clone https://github.com/verygoodplugins/wp-clean-admin.git\ncd wp-clean-admin\n\n# Load in Chrome for testing\n# chrome://extensions/ → Developer mode → Load unpacked\n```\n\n### Customization\nTo modify which menu items are considered \"core\", edit the `CORE_MENU_SLUGS` set in `content.js`:\n\n```javascript\nconst CORE_MENU_SLUGS = new Set([\n  'index.php',                 // Dashboard\n  'edit.php',                  // Posts\n  // Add your custom items here\n  'admin.php?page=my-plugin',  // Custom plugin page\n]);\n```\n\n## 📝 License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n## 🤝 Contributing\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## 🐛 Issues \u0026 Support\n\nFound a bug or have a feature request? Please [open an issue](https://github.com/verygoodplugins/wp-clean-admin/issues).\n\n## 📸 Screenshots\n\n### Before and After\n![WordPress admin with plugin clutter](.github/screenshots/store-screenshot-1-before-after.jpg)\n\n---\n\n**Another [Very Good Plugin](https://verygoodplugins.com) made with ❤️ for the WordPress community**","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fverygoodplugins%2Fwp-clean-admin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fverygoodplugins%2Fwp-clean-admin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fverygoodplugins%2Fwp-clean-admin/lists"}