Changeset 3361728

Timestamp:

09/15/2025 11:44:36 AM (6 months ago)

Author:

jdahir0789

Message:

Adding first version of my plugin

Location:

text-wrapper

Files:

• assets/banner-1544x500-rtl.jpg (modified) (previous)
• assets/banner-1544x500.jpg (modified) (previous)
• assets/banner-772x250-rtl.jpg (modified) (previous)
• assets/banner-772x250.jpg (modified) (previous)
• trunk/readme.txt (modified) (1 diff)

text-wrapper/trunk/readme.txt

@@ -1 @@
-=== Text Wrapper ===
+=== Hook Locator ===
 Contributors: jdahir0789
-Tags: custom button for tinymce, custom button for wysiwyg, wrap text, wysiwyg editor custom button, text wrapper
+Tags: hooks, debug, search, actions, filters
 Requires at least: 5.0
-Tested up to: 6.7
-Stable tag: 1.1
-Version: 1.1
-Author: JD Ahir
-Text Domain: text-wrapper
-Requires PHP: 7.2
+Tested up to: 6.8
+Stable tag: 1.0
+Version: 1.0
+Author: Jaydip Ahir
+Text Domain: hook-locator
+Requires PHP: 7.4
 License: GPLv2 or later
-License URI: http://www.gnu.org/licenses/gpl-2.0.html
-
-Easily wrap selected text in WordPress editors with custom HTML tags and CSS classes for better styling and structure.
-
-=== Description ===
-
-Easily customize and style your content with the Text Wrapper plugin. Add a button to WordPress and ACF WYSIWYG editors to wrap selected text with your chosen HTML tag and CSS class. Perfect for applying consistent styles or custom behaviors without editing the HTML manually!
-
-- Easily highlight important sections of text in your posts or custom fields.
-- Add custom CSS styling to specific parts of your content.
-- Streamline workflows for developers, designers, and content editors working on styled content.
-
-=== Features ===
-1. Custom HTML Wrapping: Wrap selected text with a configurable HTML tag and class directly in the WYSIWYG editor.
-2. Highlight Management: Automatically highlight wrapped text for better visibility.
-3. ACF Compatibility: Works seamlessly with ACF WYSIWYG fields, enhancing your custom fields experience.
-4. Keyboard Shortcut: Wrap text quickly using a customizable keyboard shortcut (Ctrl+Alt+W).
-5. Settings Page: Configure your preferred HTML tag and class easily in the WordPress settings page.
-6. Visual Feedback: Toggle wrapping dynamically with real-time button activation in TinyMCE.
+License URI: https://www.gnu.org/licenses/gpl-2.0.html
+
+Professional WordPress hook analysis tool for developers. Search and analyze hook usage in plugins and themes with detailed code context.
+
+== Description ==
+
+**Hook Locator** is the ultimate WordPress development tool for analyzing hook usage across your plugins and themes. Built for developers, it provides a professional admin interface to search, analyze, and understand WordPress hook implementations.
+
+### Key Features
+
+* **Advanced Hook Search** - Find any WordPress hook across all plugins and themes
+* **Organized Directory Selection** - Separate dropdowns for plugins and themes with clean organization  
+* **Detailed Code Analysis** - View exact file locations with highlighted code context
+* **Multiple Hook Types** - Supports add_action, add_filter, do_action, apply_filters, and more
+* **Professional Interface** - Clean, modern admin UI following WordPress design standards
+* **Performance Optimized** - Efficient scanning with built-in safeguards and limits
+* **Security First** - Proper nonce verification, sanitization, and capability checks
+* **Developer Tools** - Click-to-copy code snippets, keyboard shortcuts, and export features
+
+### Perfect For
+
+* **Plugin Developers** - Debug hook conflicts and understand plugin interactions
+* **Theme Developers** - Analyze theme hook implementations and customizations  
+* **Code Auditors** - Review hook usage patterns and security implementations
+* **WordPress Learners** - Understand how WordPress hooks work in real code
+* **Site Maintainers** - Debug issues and optimize hook performance
+
+### How It Works
+
+1. **Search Interface** - Enter any hook name and select search location
+2. **Instant Results** - View all matching files with line numbers and hook types
+3. **Code Context** - Click any result to see highlighted code with surrounding lines
+4. **Analysis Tools** - Get insights about hook types, usage patterns, and best practices
+
+### WordPress Standards Compliant
+
+* **PHPCS/WPCS Compatible** - Follows all WordPress coding standards
+* **Secure Implementation** - Proper sanitization, nonces, and capability checks
+* **Performance Optimized** - Efficient file scanning with resource limits
+* **Accessibility Ready** - Keyboard navigation and screen reader compatible
+* **Translation Ready** - Full internationalization support
 
 == Installation ==
 
-1. Copy the `text-wrapper` folder into your `wp-content/plugins` folder.
-2. Activate the Text Wrapper plugin via the plugins admin page.
-3. Install and activate the plugin.
-4. Go to Settings → Text Wrapper to configure your preferred HTML tag and CSS class.
-5. In the editor, select the text you want to wrap.
-6. Click the Text Wrapper Button or use the shortcut Ctrl+Alt+W to apply the wrapper.
-7. The wrapped text is highlighted in the editor for easy identification.
+### Automatic Installation
+1. Go to **Plugins > Add New** in your WordPress admin
+2. Search for "Hook Locator"
+3. Click **Install Now** and then **Activate**
+
+### Manual Installation
+1. Download the plugin ZIP file
+2. Go to **Plugins > Add New > Upload Plugin**
+3. Choose the ZIP file and click **Install Now**
+4. Activate the plugin
+
+### Getting Started
+1. Navigate to **Tools > Hook Locator** in your WordPress admin
+2. Enter a hook name (e.g., "init", "wp_head", "save_post")
+3. Select search location (All, specific plugin, or theme)
+4. Click **Search Hooks** to see results
+5. Click **View Details** on any result for code analysis
+
+== Frequently Asked Questions ==
+
+= Does this affect my site performance? =
+
+No! Hook Locator only runs in the WordPress admin when you actively search. There's no frontend code or background processing that affects your site's performance.
+
+= What file types does it search? =
+
+Hook Locator searches only PHP files (.php) since WordPress hooks are PHP-based. It automatically skips other file types for optimal performance.
+
+= Can I search for custom hooks? =
+
+Absolutely! Hook Locator finds any hook name you specify, including custom hooks created by plugins, themes, or your own code.
+
+= Is it safe to use on production sites? =
+
+Yes, Hook Locator is completely safe for production use. It only reads files and never modifies any code. All operations are restricted to users with administrator privileges.
+
+= Does it work with multisite? =
+
+Yes, Hook Locator works perfectly with WordPress multisite installations. Each site can use it independently to analyze their specific plugins and themes.
+
+= Can I export the search results? =
+
+Currently, you can copy individual code snippets to your clipboard. Future versions may include CSV/JSON export functionality based on user feedback.
+
+= What's the difference from other hook plugins? =
+
+Hook Locator focuses on static code analysis rather than runtime hook capture. This makes it more accurate, secure, and performant while providing deeper code insights.
+
+== Screenshots ==
+
+1. **Main Search Interface** - Clean, modern search form with organized directory selection
+2. **Search Results** - Professional table showing files, line numbers, hook types, and actions  
+3. **Code Analysis** - Detailed view with highlighted target line and surrounding context
+4. **Hook Type Detection** - Color-coded badges showing different hook function types
+5. **Mobile Responsive** - Works perfectly on all devices and screen sizes
 
 == Changelog ==
 
-= 1.1 =
-* Initial Release.
+= 1.0.0 =
+* Separated plugins and themes in dropdown with optgroups
+* Much clearer code highlighting with better contrast
+* Modern, professional UI with better spacing and typography
+* Full WordPress coding standards compliance (PHPCS/WPCS)
+* Comprehensive nonce verification and sanitization
+* Proper Yoda conditions throughout codebase
+* Complete function and class documentation
+* All margin and padding issues for consistent layout
+* Optimized file scanning with better resource management
+* Complete rewrite for admin-only operation
+* Added file scanning for plugin/theme directories
+* New professional search interface with directory selection
+* Detailed code context view with syntax highlighting
+* Performance optimizations and security improvements
+* Better user interface with WordPress admin styling
+
+== Advanced Usage ==
+
+### Keyboard Shortcuts
+* **Ctrl/Cmd + K** - Focus search input
+* **Ctrl/Cmd + Enter** - Submit search form  
+* **Escape** - Clear search input
+* **Click code snippets** - Copy to clipboard
+
+### Hook Types Supported
+* `add_action()` - Register action hooks
+* `add_filter()` - Register filter hooks  
+* `do_action()` - Trigger action hooks
+* `apply_filters()` - Apply filter hooks
+* `remove_action()` - Remove action hooks
+* `remove_filter()` - Remove filter hooks
+* `has_action()` - Check for action hooks
+* `has_filter()` - Check for filter hooks
+
+### Performance Features
+* **Smart Scanning** - Skips large files and non-PHP files
+* **Resource Limits** - Maximum 1000 files per search to prevent timeouts
+* **Efficient Parsing** - Optimized regex patterns for hook detection
+* **Memory Management** - Careful memory usage to prevent server issues
+
+== Developer Information ==
+
+### Code Standards
+* **PHPCS/WPCS Compliant** - Passes all WordPress coding standards
+* **Security First** - Proper sanitization, validation, and capability checks
+* **Performance Optimized** - Efficient algorithms and resource management
+* **Accessibility Ready** - Full keyboard navigation and screen reader support
+* **Translation Ready** - Complete internationalization with proper text domains
+
+### Technical Specifications
+* **Minimum PHP:** 7.4
+* **WordPress:** 5.0+
+* **File Size Limit:** 1MB per file
+* **Scan Limit:** 1000 files per search
+* **Memory Usage:** Optimized for shared hosting
+
+### Support & Development
+* **GitHub:** Coming soon for issue reporting and contributions
+* **Documentation:** Complete inline code documentation
+* **Extensibility:** Action and filter hooks for customization
+
+== Screenshots ==
+1. screenshot-1.png
+2. screenshot-2.png
+3. screenshot-3.png
+
+== Privacy ==
+
+Hook Locator respects your privacy and follows WordPress privacy best practices:
+
+* **No Data Collection** - No personal or usage data is collected or transmitted
+* **Local Operation** - All scanning happens locally on your server
+* **No External Requests** - No data is sent to external services
+* **Admin Only** - Only users with administrator privileges can use the plugin
+* **No Tracking** - No analytics, tracking pixels, or cookies are used
+
+== Support ==
+
+Need help with Hook Locator?
+
+* **Documentation** - Check the built-in help and tooltips in the admin interface
+* **WordPress Forums** - Ask questions in the WordPress.org support forums
+* **GitHub Issues** - Report bugs and request features (coming soon)
+* **Professional Support** - Premium support available for enterprise users
+
+Hook Locator is actively maintained and supported. We're committed to keeping it updated with the latest WordPress versions and continuously improving its functionality based on user feedback.