=== FAQ Magic === Contributors: creatorseo, clinton101 Tags: FAQ, JSON-LD, Schema, AI, SEO Requires at least: 5.1 Tested up to: 6.8 Stable tag: 1.2.0 Requires PHP: 7.4 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html Generate FAQ schema (JSON-LD) automatically and display your FAQs in a styled layout or accordion for better SEO. == Description == FAQ Magic is a lightweight plugin that helps you create structured Page and FAQ content for your WordPress posts and pages. **Features** * Add FAQs via a simple meta box in the post editor. * Automatically generate WebPage schema (JSON-LD) for better AI and search engine visibility. * Automatically generate FAQ schema (JSON-LD) for better AI and search engine visibility. * Use the free AI Suggest feature to generate Page title and page description AI. * Display FAQs on the front end with the `[faqm_magic]` shortcode. * Choose between standard layout or accordion toggle style for these FAQ's. * Update settings page in Tools → FAQ Magic for schema and display options. **Background** Search Engines and AI crawlers rely on structured information on your page in order to more effectively index the page for SEO and AI tools. The addition of FAQ's into the page provides more detail about the page for visitors and for AI or search engines to determine what the page is all about. The benefit to you is that your website is more likely to be found by people using AI or searching the web. == Installation == 1. Upload the plugin files to the `/wp-content/plugins/faq-magic/` directory, or install the plugin through the WordPress plugins screen directly. 2. Activate the plugin through the **Plugins** screen in WordPress. 3. Go to **Tools → FAQ Magic** to configure the settings. 4. Edit any post/page and add FAQs using the **FAQ Magic Schema Generator** meta box. 5. Insert `[faqm_magic]` shortcode into your post/page content to display FAQs. == Frequently Asked Questions == = How do I add FAQs? = Edit a post or page, scroll to the "FAQ Magic Schema Generator" meta box, and use the interface to add questions and answers. = How do I display FAQs on my site? = Use the `[faqm_magic]` shortcode inside your content. You can also add attributes, for example: `[faqm_magic title="My FAQs" class="custom-faq"]` = Will this improve my SEO? = Yes. This plugin generates valid FAQPage JSON-LD schema that can help search engines display rich FAQ snippets in search results. = Is there a benefit for AI indexing? = Yes. This plugin generates valid JSON-LD schema for the page and for the FAQ's. These help AI Bots to discover and use your site information. = If AI bots use my information, will I get the credit? = Yes. AI results usually cite the source in the results when these come from the web. = Can I switch between standard layout and accordion? = Yes. In the plugin settings, you can toggle between normal FAQ blocks and an accordion view. = Will this Plugin work with any theme? = Yes, the plugin is theme independent. = Can the AI suggestions be switched off? = Yes, the AI suggestions are optional and can be switched off in the settings menu. = Does the AI suggestions write any information to my web page or database? = No the AI Suggestions transfer directly to your input form and will only be accepted if you choose to use (submit) these. = Why is there a setting 'Remove all metadata from every post on uninstall'? = A lot of work may be involved by the user in setting up FAQ's and Page information. If the plugin is uninstalled for some reason, the user is given the option not to lose this work (the default). = Is this plugin available in other languages? = Sorry! this will be available in the next version, and we are working on it already. The first version could not include internationalization due to the need to get this to market due to demand for these essential AI features. == Screenshots == 1. Settings for the plugin. 2. The FAQ Magic meta box in the post editor. 3. Parts of the FAQ Magic meta box (WebPage Tab). 4. Parts of the FAQ Magic meta box (FAQ Tab). 5. Steps to add the Webpage Schema. 6. The hidden Webpage Schema on your page. 7. Steps to submit a new frequently asked question. 8. The hidden Webpage Schema with FAQ's. 9. Adding a shortcode. 10. Standard FAQ layout on the front-end. 11. Accordion FAQ layout on the front-end. == External services == This plugin connects to an external service provided by Hub5050 (https://hub5050.com) in order to provide AI-generated suggestions for the "WebPage" form fields (specifically the suggested title and description for a page schema). The service is optional and is free to all users. === What the service is and what it is used for === The service is an API endpoint hosted at hub5050.com, which returns suggested values for the "Name" (title) and "Description" fields used in the WebPage JSON-LD schema. This feature is optional and is triggered only when the user clicks the "🤖 AI Suggest" button in the plugin's metabox. === What data is sent and when === When the "🤖 AI Suggest" button is clicked, the plugin sends: - The URL of the page being edited (base64 encoded). - A fixed code string ("zmGSn") which identifies which Hub5050 service to use. No personal data, user information, or other identifiers are ever sent. The page URL is used only to generate suggested content and is not stored on Hub5050 servers. The request is only made when the button is clicked. The values returned are shown in the form for the user to review and edit or discard. Nothing is saved automatically on the site. === Control over this feature === This AI Suggest feature can be disabled from the plugin’s settings page. When disabled, no data is ever sent to hub5050.com. === Service provider === This service is provided by Hub5050 (https://hub5050.com), owned and operated by the plugin author. - Terms of Service: https://hub5050.com/terms/ - Privacy Policy: https://hub5050.com/privacy/ - Specific information: https://hub5050.com/faq-magic-terms-and-privacy-policy/ == Changelog == = 1.2.0 = * AI Suggest service added to suggest the Title and Description for the WebPage schema. = 1.1.0 = * Production release with schema generation, meta box, shortcode, and accordion/standard layouts. * JSON-LD webpage schema functionality for every page on the site included * Basic FAQ shortcode provided with JSON-LD integration = 0.1.1 = * Test release with schema generation, meta box, shortcode, and accordion/standard layouts. * Launch version checks = 0.0.1 = * Pilot testing September 2025 == Upgrade Notice == = 0.1.1 = Input field addition