{"id":234869,"date":"2025-12-17T13:06:00","date_gmt":"2025-12-17T13:06:00","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/smart-word-explainer\/"},"modified":"2025-12-17T13:05:46","modified_gmt":"2025-12-17T13:05:46","slug":"smart-word-explainer","status":"publish","type":"plugin","link":"https:\/\/kk.wordpress.org\/plugins\/smart-word-explainer\/","author":20983055,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.0.0","stable_tag":"1.0.0","tested":"6.9.4","requires":"6.3","requires_php":"7.4","requires_plugins":null,"header_name":"Smart Word Explainer","header_author":"Huzaifa Al Mesbah","header_description":"Enhances content by providing definitions, pronunciation, synonyms, and more when users select words.","assets_banners_color":"","last_updated":"2025-12-17 13:05:46","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"","rating":0,"author_block_rating":0,"active_installs":0,"downloads":150,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"huzaifaalmesbah","date":"2025-12-17 13:05:46"}},"upgrade_notice":{"1.0.0":"<p>Initial release of the Smart Word Explainer plugin. Features instant word definitions, pronunciations, and a professional admin interface for easy setup and testing.<\/p>"},"ratings":[],"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"Word definition popup showing multiple meanings and pronunciation","2":"Admin interface - Quick Start guide with sample words","3":"Admin interface - Features overview with visual icons","4":"Admin interface - Plugin status and technical information","5":"Popup showing synonyms and antonyms","6":"Audio pronunciation controls in action"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[9804,8880,1385,10814,11444],"plugin_category":[47,48],"plugin_contributors":[221881],"plugin_business_model":[],"class_list":["post-234869","plugin","type-plugin","status-publish","hentry","plugin_tags-definitions","plugin_tags-dictionary","plugin_tags-language","plugin_tags-learning","plugin_tags-vocabulary","plugin_category-education-and-support","plugin_category-language-tools","plugin_contributors-huzaifaalmesbah","plugin_committers-huzaifaalmesbah"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/smart-word-explainer.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"<!--section=description-->\n<p>Smart Word Explainer is a lightweight and easy-to-use WordPress plugin that enhances the reading experience by providing instant word lookups. When a user selects a word on your website, a popup appears with:<\/p>\n\n<ul>\n<li>Word definitions<\/li>\n<li>Pronunciation guide with audio<\/li>\n<li>Synonyms and antonyms<\/li>\n<li>Usage examples<\/li>\n<\/ul>\n\n<p>This plugin helps improve content comprehension and vocabulary building for your readers without them needing to leave your website.<\/p>\n\n<h4>Features<\/h4>\n\n<ul>\n<li>Instant word lookups with a simple text selection<\/li>\n<li>Clean, modern popup design that fits any theme<\/li>\n<li>Pronunciation audio playback<\/li>\n<li>Multiple definitions organized by part of speech<\/li>\n<li>Related synonyms and antonyms<\/li>\n<li>Usage examples<\/li>\n<li>Responsive design for all screen sizes<\/li>\n<li>No API key required (uses the free Dictionary API)<\/li>\n<li>Lightweight with minimal impact on page load times<\/li>\n<li>Professional admin interface with comprehensive documentation<\/li>\n<\/ul>\n\n<h4>How It Works<\/h4>\n\n<ol>\n<li>A user selects a word on your website<\/li>\n<li>Smart Word Explainer detects the selection<\/li>\n<li>A popup appears with the word's definition, pronunciation, synonyms, and more<\/li>\n<li>The user can close the popup by clicking outside it, clicking the close button, or pressing ESC<\/li>\n<\/ol>\n\n<h4>Credits<\/h4>\n\n<p>This plugin uses the <a href=\"https:\/\/dictionaryapi.dev\/\">Free Dictionary API<\/a> to provide word definitions, pronunciations, synonyms, and antonyms. The Dictionary API is an open-source, free-to-use API that provides dictionary data for multiple languages. Special thanks to the maintainers of this excellent resource. The API is used under the terms provided at <a href=\"https:\/\/dictionaryapi.dev\/\">https:\/\/dictionaryapi.dev\/<\/a>.<\/p>\n\n<h3>Admin Interface<\/h3>\n\n<p>After activation, visit <strong>Tools \u2192 Word Explainer<\/strong> in your WordPress admin to access:<\/p>\n\n<ul>\n<li><strong>Quick Start Guide<\/strong>: Step-by-step instructions with sample words to test<\/li>\n<li><strong>Feature Overview<\/strong>: Complete list of plugin capabilities<\/li>\n<li><strong>Plugin Status<\/strong>: Technical information and system status<\/li>\n<li><strong>Troubleshooting<\/strong>: Solutions to common issues<\/li>\n<li><strong>How It Works<\/strong>: Visual workflow explanation<\/li>\n<li><strong>Support &amp; Credits<\/strong>: API information and acknowledgments<\/li>\n<\/ul>\n\n<p>The admin interface provides everything you need to understand, test, and use the plugin effectively.<\/p>\n\n<h3>How to Test the Plugin<\/h3>\n\n<p><strong>IMPORTANT FOR REVIEWERS:<\/strong> This plugin works automatically after activation. Here's how to test it:<\/p>\n\n<h4>Quick Testing Method<\/h4>\n\n<ol>\n<li><strong>Activate the Plugin<\/strong>: Install and activate through WordPress admin<\/li>\n<li><strong>Visit Admin Page<\/strong>: Go to <strong>Tools \u2192 Word Explainer<\/strong> for detailed instructions<\/li>\n<li><strong>Go to Frontend<\/strong>: Visit any page or post on your website<\/li>\n<li><strong>Select a Word<\/strong>: Use your mouse to select (highlight) any English word<\/li>\n<li><strong>View the Popup<\/strong>: A definition popup will appear instantly<\/li>\n<\/ol>\n\n<h4>Recommended Test Words<\/h4>\n\n<p>Try these words for best results:\n* <code>example<\/code> - Common word with multiple definitions\n* <code>beautiful<\/code> - Adjective with synonyms and antonyms\n* <code>technology<\/code> - Noun with pronunciation audio\n* <code>wonderful<\/code> - Word with usage examples\n* <code>computer<\/code> - Technical term with clear definitions<\/p>\n\n<h4>What You Should See<\/h4>\n\n<ul>\n<li>A clean, modern popup appears near the selected word<\/li>\n<li>The popup contains the word's definition(s), organized by part of speech<\/li>\n<li>Pronunciation with audio playback button (when available)<\/li>\n<li>Synonyms and antonyms (when available)<\/li>\n<li>Usage examples in context<\/li>\n<li>Responsive design that works on all screen sizes<\/li>\n<\/ul>\n\n<h4>Popup Controls<\/h4>\n\n<ul>\n<li>Click the <strong>\u25b6\ufe0f Listen<\/strong> button to hear pronunciation<\/li>\n<li>Click the <strong>X<\/strong> button to close the popup<\/li>\n<li>Click <strong>outside the popup<\/strong> to close it<\/li>\n<li>Press the <strong>ESC key<\/strong> to close it<\/li>\n<\/ul>\n\n<h4>Troubleshooting Testing<\/h4>\n\n<ul>\n<li><strong>No popup appears<\/strong>: Make sure you're selecting a single English word (not phrases, numbers, or special characters)<\/li>\n<li><strong>\"No definition found\"<\/strong>: This is normal for very uncommon words, proper nouns, or non-English text<\/li>\n<li><strong>Audio doesn't play<\/strong>: Some words may not have audio pronunciation available<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin files to the <code>\/wp-content\/plugins\/smart-word-explainer<\/code> directory, or install the plugin through the WordPress plugins screen directly.<\/li>\n<li>Activate the plugin through the 'Plugins' screen in WordPress.<\/li>\n<li>Visit <strong>Tools \u2192 Word Explainer<\/strong> in your WordPress admin for detailed usage instructions and testing guidance.<\/li>\n<li>That's it! The plugin works automatically on all your content.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id='does%20this%20plugin%20work%20with%20any%20theme%3F'><h3>Does this plugin work with any theme?<\/h3><\/dt>\n<dd><p>Yes, Smart Word Explainer is designed to be compatible with all WordPress themes. It uses high z-index values and specific CSS to ensure the popup appears above all other content.<\/p><\/dd>\n<dt id='do%20i%20need%20an%20api%20key%3F'><h3>Do I need an API key?<\/h3><\/dt>\n<dd><p>No, this plugin uses the free Dictionary API, so no API key is required.<\/p><\/dd>\n<dt id='will%20this%20slow%20down%20my%20website%3F'><h3>Will this slow down my website?<\/h3><\/dt>\n<dd><p>No, the plugin is very lightweight. It only loads its resources when needed and makes API requests only when a user selects a word. Results are cached to minimize repeated requests.<\/p><\/dd>\n<dt id='can%20i%20customize%20the%20appearance%20of%20the%20popup%3F'><h3>Can I customize the appearance of the popup?<\/h3><\/dt>\n<dd><p>In the current version, customization is limited. The popup uses a clean, modern design that should work well with most themes. Future versions will include more customization options.<\/p><\/dd>\n<dt id='what%20languages%20are%20supported%3F'><h3>What languages are supported?<\/h3><\/dt>\n<dd><p>Currently, the plugin only supports English words. Support for additional languages will be added in future updates.<\/p><\/dd>\n<dt id='is%20there%20a%20usage%20limit%20for%20the%20dictionary%20api%3F'><h3>Is there a usage limit for the Dictionary API?<\/h3><\/dt>\n<dd><p>The Dictionary API used by this plugin is free to use with no authentication required. While there are no officially stated limits, as with any free service, it's designed for reasonable use. The plugin includes caching to minimize requests to the API.<\/p><\/dd>\n<dt id='why%20doesn%27t%20the%20popup%20appear%20for%20some%20words%3F'><h3>Why doesn't the popup appear for some words?<\/h3><\/dt>\n<dd><p>The plugin only works with single English words. It won't trigger for:\n* Multiple words or phrases\n* Numbers or special characters\n* Very short words (1-2 characters)\n* Non-English text<\/p><\/dd>\n<dt id='can%20i%20disable%20the%20plugin%20on%20specific%20pages%3F'><h3>Can I disable the plugin on specific pages?<\/h3><\/dt>\n<dd><p>Currently, the plugin works on all frontend pages. Future versions may include options to disable it on specific pages or post types.<\/p><\/dd>\n<dt id='where%20can%20i%20find%20usage%20instructions%3F'><h3>Where can I find usage instructions?<\/h3><\/dt>\n<dd><p>After activating the plugin, visit <strong>Tools \u2192 Word Explainer<\/strong> in your WordPress admin for comprehensive usage instructions, testing guidance, and troubleshooting tips.<\/p><\/dd>\n<dt id='is%20there%20an%20admin%20interface%3F'><h3>Is there an admin interface?<\/h3><\/dt>\n<dd><p>Yes! The plugin includes a professional admin interface accessible via <strong>Tools \u2192 Word Explainer<\/strong>. It provides:\n* Step-by-step testing instructions\n* Feature overview with visual icons\n* Plugin status and technical information\n* Troubleshooting guide\n* Visual workflow explanation<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release<\/li>\n<li>Word selection detection with mouse highlighting<\/li>\n<li>Dictionary API integration for definitions and pronunciations<\/li>\n<li>Popup display with definitions, pronunciations, synonyms, and antonyms<\/li>\n<li>Audio pronunciation playback when available<\/li>\n<li>Responsive design for all screen sizes<\/li>\n<li>Client-side caching for improved performance<\/li>\n<li>Professional admin interface with comprehensive documentation<\/li>\n<li>Step-by-step testing instructions for easy evaluation<\/li>\n<li>Visual workflow explanation and troubleshooting guide<\/li>\n<li>WordPress coding standards compliance<\/li>\n<li>Internationalization ready<\/li>\n<\/ul>","raw_excerpt":"Enhance your content by providing instant word definitions, pronunciations, synonyms, and antonyms when users select words.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/kk.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/234869","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/kk.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/kk.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/kk.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=234869"}],"author":[{"embeddable":true,"href":"https:\/\/kk.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/huzaifaalmesbah"}],"wp:attachment":[{"href":"https:\/\/kk.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=234869"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/kk.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=234869"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/kk.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=234869"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/kk.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=234869"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/kk.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=234869"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/kk.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=234869"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}