=== IntelliLink Craft - Smart Internal Linking & Auto-Linker ===
Contributors: sonofgod80
Donate link: https://www.paypal.com/donate?hosted_button_id=5MGAYLG6QTUZG
Upgrade link: https://www.levelnetwork.it/en/intellilink-craft-smart-internal-auto-linker-pro.php
Tags: internal linking, auto-linking, smart links, automated seo, broken links
Requires at least: 6.5
Tested up to: 7.0.1
Stable tag: 1.0.5
Requires PHP: 7.2
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

An intelligent, secure, and lightweight internal linking assistant that scans content and suggests contextual internal links to improve SEO.

== Description ==

**Boost Your SEO and Organic Traffic with the Smartest Internal Linking Assistant for WordPress!**

Are you tired of manually searching for old posts to interlink? Do you want to distribute "link juice" (PageRank) perfectly across your content but don't have the time?

**IntelliLink Craft** is your personal, automated SEO assistant. It analyzes your content in real-time as you write and suggests highly contextual internal links that search engines (and your readers) will love. 

By building a strong internal link architecture, you help Google crawl your site faster, index your pages better, and drastically reduce bounce rates by keeping visitors engaged longer.

**Why Choose IntelliLink Craft?**
Unlike other heavy plugins, IntelliLink Craft is built for **speed and performance**. It seamlessly integrates into your workflow, completely eliminating the friction of manual internal linking.

**ZERO-CONFIG SEO INTEGRATION**
Already using RankMath, Yoast SEO, SEOPress, or All in One SEO? Perfect! IntelliLink automatically syncs with them to fetch your Focus Keywords. You won't have to lift a finger to configure it.

== Third-Party Service Disclosure ==

This plugin supports connecting to third-party artificial intelligence services to generate SEO keyword suggestions:
* **OpenAI API** (https://api.openai.com) - Privacy Policy: https://openai.com/policies/privacy-policy
* **Google Gemini API** (https://generativelanguage.googleapis.com) - Privacy Policy: https://policies.google.com/privacy
* **Anthropic Claude API** (https://api.anthropic.com) - Privacy Policy: https://www.anthropic.com/legal/privacy

Please note:
1. These integrations are completely optional. The plugin operates fully on local data and standard WordPress APIs without using these services.
2. In the free version, the plugin does not make direct external calls to these APIs; they are only accessed if the optional PRO add-on is installed, or via the native WordPress 7.0+ AI Client (`wp_ai_client_prompt`) if configured by the administrator.
3. No user or visitor data is sent to these third-party services. Only the post/page content is sent to generate keyword recommendations when the administrator explicitly clicks the "Suggest Keywords" button in the WordPress dashboard.
4. You must have your own API keys/credentials for these services, which are stored securely in your WordPress database.

= Build a Flawless SEO Link Architecture in Minutes =

*   **Seamless SEO Sync**: Automatically imports Focus Keywords from RankMath, Yoast SEO, SEOPress, and All in One SEO. No setup required!
*   **Lightning Fast Content Scanner**: Get smart internal link suggestions directly in the Gutenberg or Classic Editor while you write.
*   **Smart Contextual Highlights**: The plugin highlights the exact sentence where a link fits best, ensuring your content reads naturally to humans and search engines.
*   **High-Performance Architecture**: Uses native WordPress Transients for caching. Zero database bloat and zero impact on frontend loading speeds.
*   **Advanced Category Siloing**: Boost your topic authority by restricting link suggestions strictly within the same category (Perfect for Silo SEO Strategies).
*   **Wikipedia-Style Smart Tooltips**: Increase Click-Through Rates (CTR) with beautiful frontend hover tooltips displaying the target post's excerpt and featured image.
*   **WooCommerce & CPT Ready**: Fully supports linking across WooCommerce products, portfolios, and any Custom Post Type.
*   **Built-in Link Health Analytics**: Track your inbound and outbound internal links directly from the WordPress posts table.
*   **Over-Optimization Protection**: Detects multiple keyword occurrences and applies standard SEO warnings to keep your link profile natural and safe from Google penalties.

== Premium Features (PRO) ==

Take your internal linking strategy to the absolute next level with **IntelliLink Craft PRO**. The PRO add-on automates tedious tasks, actively prevents missing opportunities, and includes AI-powered tools.

= PRO Features include: =

*   **AI Target Keywords Generation:** Automatically generate highly relevant Target Keywords using top-tier AI models (OpenAI, Google Gemini, Anthropic Claude).
*   **Frontend Auto Linker System:** Define global keyword-to-link rules. The plugin will automatically transform matching text into links on the frontend for your visitors, dynamically and securely.
*   **Total Automation System:** Automatically generate global Auto-Linking rules whenever you define Target Keywords for a post to build your site's link graph.
*   **Editor Auto-Insert Links:** Skip the copy-pasting. Click a button to safely inject internal links directly into your Gutenberg or Classic Editor content. (Safely disables itself in complex page builders like Elementor/Divi).
*   **Global Link Opportunities:** A powerful dashboard tool that scans your entire website against your target keywords, highlighting historic posts where you missed internal linking opportunities.
*   **Global Post Exclusions:** Exclude specific Post IDs, full URLs, or entire Custom Post Types from the Auto-Linking engine to preserve precise site structures.
*   **Excluded Zones (CSS Bypass):** Define specific CSS classes or IDs to bypass the Auto-Linking engine. Perfect for preventing unwanted links inside specific shortcodes, tables, or custom widgets.
*   **Advanced Rule Management:** Easily manage massive databases of Auto-Linking rules with powerful search, pagination, and bulk deletion capabilities.
*   **Advanced Site Health Data:** Discover broken links, find "Orphan Pages" (pages with zero internal links pointing to them), and analyze deeper link metrics.
*   **Priority Support:** Direct, priority assistance from our developers.

**Ready to Upgrade to PRO?** 
Get your license and unlock the PRO automated SEO toolbox: [Visit LevelNetwork.it to upgrade to PRO](https://www.levelnetwork.it/en/intellilink-craft-smart-internal-auto-linker-pro.php)

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/intellilink-craft-smart-internal-linking-auto-linker` directory, or install the plugin through the WordPress "Add New Plugin" screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Open a post or page and scroll down to the new **IntelliLink Craft** meta box to start optimizing!

== Frequently Asked Questions ==

= Is this core plugin really free? =
Yes! The core version is 100% free, highly functional, and has absolutely no limits on how many posts you can scan, or how many target keywords you can save.

= Will the Auto-Linker slow down my website rendering? =
No. The Frontend Auto Linker relies on an optimized processing engine causing minimal impact on your database or page load times. The text parsing is done efficiently during the page render.

= What happens if I use Elementor, Divi, or other Page Builders? =
The backend keyword Scanner works perfectly with any builder! However, the 'Auto-Insert' button in the builder safely disables itself to prevent breaking complex HTML structures. You can still use the standard "Copy HTML" button. Also, the frontend Auto Linker operates on the public frontend output, no matter what builder you use.

= How does the Category Siloing feature help my SEO? =
Category Siloing is an advanced SEO technique that keeps link equity (power) focused within a specific topic cluster (category). By enabling this, IntelliLink will only suggest links to other posts within that same exact category, helping Google understand your topic authority.

= Can I prevent Auto-Linking on specific pages or inside specific paragraphs? =
Absolutely. With the PRO version, you can globally exclude specific Pages/URLs. Furthermore, using "Excluded Zones", you can tell the plugin to ignore text inside specific CSS classes (e.g., inside sliders, pricing tables, or custom widgets) so your layout is never compromised.

= Does it support WooCommerce or Custom Post Types? =
Yes! Out of the box, it supports Posts and Pages. You can easily enable scanning and linking for WooCommerce Products, Portfolios, or any other Custom Post Type from the IntelliLink settings panel.

= What is the Total Automation System? =
The Total Automation System (available in the PRO version) completely automates the creation of internal links. When you save a Target Keyword for a post, the plugin instantly creates a global Auto-Linking Rule for that keyword pointing to that post. Additionally, if you have an AI Provider configured, it will use WP-Cron to generate synonyms in the background silently, meaning you build your entire site's link graph just by defining keywords.

== Screenshots ==

1. **Dashboard:** The global settings overview for IntelliLink Craft, showing connection status and basic setups.
2. **Post Editor Scanner:** The scan link interface within the WordPress post editor, highlighting context and suggestions.
3. **Link Health Data:** View inbound/outbound connection data natively in your posts list table.
4. **Auto-Linker (PRO):** A look at the frontend auto-linking rules manager.
5. **Global Opportunities (PRO):** Find where your keywords are mentioned across your entire site and link them with one click.

== Changelog ==

= 1.0.5 =
* FEATURE: Added WP-Cron background processing for AI Synonym generation within the Total Automation System (PRO).
* ENHANCEMENT: Excluded existing manually configured keywords from the Global Opportunities AI suggestions to reduce false positives (PRO).
* ENHANCEMENT: Increased the Top Target URLs dashboard chart limit from 5 to 10 for better analytics visibility (PRO).
* FIX: Resolved synchronization issues between backend counts and frontend rendering when calculating link frequencies.

= 1.0.4 =
* FEATURE: Added zero-config integration for RankMath, Yoast SEO, SEOPress, and All in One SEO (auto-fetches focus keywords).
* PERFORMANCE: Implemented Transient API caching for Smart Tooltips to eliminate database load on the frontend.
* SECURITY: Improved data sanitization when saving target keywords from the post editor.

= 1.0.3 =
* REFACTOR: Refactored plugin architecture to completely separate Free and PRO logic in compliance with WordPress.org Plugin Directory guidelines (moved Auto-Linking database structures and global Opportunities dashboard to the separate PRO add-on).
* REFACTOR: Renamed main classes to use the common 'ILCraft' prefix to prevent potential namespace conflicts.
* ENHANCEMENT: Removed deprecated 'load_plugin_textdomain()' call in favor of automatic translation loading by WordPress.org.
* ENHANCEMENT: Refactored sidebar promotional layout and inline elements to be fully non-intrusive and compliant.

= 1.0.2 =
* FEATURE: Added "Global Post Exclusions" setting to easily exclude specific Post IDs, URLs, or Post Types from Auto-Linking (PRO).
* FEATURE: Added Advanced Rule Management in the Auto-Linking dashboard: search, pagination, and bulk delete operations (Delete Selected/Delete All) (PRO).
* ENHANCEMENT: Updated the "Getting Started" guide with the latest automation and exclusion features.
* ENHANCEMENT: General security and sanitization improvements.

= 1.0.1 =
* FEATURE: Support for Custom Post Types (WooCommerce, Portfolio, etc.) configurable from Advanced Settings.
* FEATURE: Added statistics columns to standard WordPress edit tables (Target Keywords, Inbound/Outbound links).
* FEATURE: Introduced Category Siloing constraint logic for cleaner internal link architectures.
* FEATURE: Introduced Total Automation System logic (PRO).
* FEATURE: Added Wikipedia-style Smart Tooltips for frontend links.
* FEATURE: Added color picker customization for Auto-Links styling (PRO).
* FEATURE: Added Excluded Zones (CSS Class/ID) settings to bypass Auto-Linking (PRO).
* ENHANCEMENT: Smart content sanitization during scanning and auto-linking to avoid breaking your site layout (ignores text inside headings, buttons, existing links, etc.).

= 1.0.0 =
* Initial release of the core IntelliLink Craft plugin.