LinkSaz (Vuzmatri) self-updates

Version: 2.0.0 · WordPress: 6.2+ · PHP: 8.0+

Safe internal link suggestions and application for WordPress — plugin-only, no VPS or external LinkSaz backend required.

فارسی

What it does

LinkSaz scans your published content, suggests high-quality internal links, lets you review and queue them, then applies them into post content with snapshots so you can roll back if needed.

Optional AI (OpenAI, OpenRouter, or any OpenAI-compatible API) runs from your WordPress site using your API key. Content is never sent to Vuzmatri servers.

Scan → Suggestions (PENDING)
  → Queue (QUEUED)
  → Preflight → Apply (APPLIED)
  → Rollback (ROLLED_BACK)

Suggestion statuses: PENDING · QUEUED · REJECTED · APPLIED · FAILED · ROLLED_BACK

Features

• Dashboard — overview and analysis controls
• Suggestions — review, preview, accept to queue, or reject
• Apply Queue — preflight checks, apply links into content
• History — applied links and rollback
• Settings — language, engine, quality, AI, link policy, uninstall
• Getting Started — first-run onboarding (Local vs AI, optional first scan)
• Local engine (v2) — keywords, taxonomy, BM25-style scoring, content index (default)
• Legacy engine (v1) — title-based matching
• AI mode — chat suggestions + optional embeddings; falls back to local on failure
• Link policy matrix — control which post types may link to which
• Bilingual admin UI — English / فارسی with RTL when Persian is selected
• SEO helpers — optional Yoast / Rank Math focus keyword
• WooCommerce-aware — supports product in the policy matrix

Requirements

Installation

From a release ZIP (recommended)

1. Download linksaz-connector-2.0.0.zip from the Releases page.
2. In WordPress: Plugins → Add New → Upload Plugin.
3. Activate LinkSaz (Vuzmatri).
4. Complete Getting Started, then open LinkSaz in the admin menu.

Expected path after install:

wp-content/plugins/linksaz-connector/vuzmatri-connector.php

From source

1. Copy this repository folder to wp-content/plugins/linksaz-connector/.
2. Activate the plugin (main file: vuzmatri-connector.php).
3. linksaz-connector.php is a legacy entry that loads the main file; it is not a second plugin.

Quick start

1. Choose Local analysis (or configure AI and run Test Connection).
2. Run a scan from the dashboard / onboarding.
3. Open Suggestions, preview candidates, send approved ones to the queue.
4. Open Apply Queue, run apply (preflight validates before writing).
5. Use History to roll back an applied change if needed.

Default link policy

Only product → post is disallowed by default. You can switch to a custom From→To matrix in Settings.

Settings overview

AI stays disabled until Test Connection succeeds. Keys are stored with AES-256-GCM using WordPress salts (AUTH_KEY / SECURE_AUTH_KEY) and are never shown in full in the UI.

Architecture (developers)

linksaz-connector/
├── vuzmatri-connector.php      # Plugin headers + bootstrap entry
├── linksaz-connector.php       # Legacy loader
├── uninstall.php
├── assets/                     # Admin CSS/JS
├── includes/
│   ├── bootstrap.php
│   ├── class-vuzmatri-*.php    # Core logic
│   ├── data/                   # EN/FA stopwords
│   └── views/                  # Admin screens
├── languages/                  # Persian admin strings
└── tests/                      # CLI self-checks

Key classes: Vuzmatri_Plugin, Admin, Scanner, Analyzer, Ai_Provider, Suggestions, Preview, Validator, Apply, Rollback, Db, Security, Link_Policy, Content_Index, Scoring, I18n.

Database tables (with your $wpdb prefix):

• vuzmatri_suggestions
• vuzmatri_snapshots
• vuzmatri_content_index
• vuzmatri_term_stats

Schema version constant: VUZMATRI_DB_VERSION = 1.4.0.

Tests

From the plugin directory (PHP CLI):

php tests/run-all-checks.php

Individual checks live under tests/*-check.php. These are lightweight self-checks; full staging QA (scan quality, apply/rollback, AJAX batches) is still recommended.

Uninstall

• By default, uninstall keeps database tables and options.
• If Delete data on uninstall is enabled in Settings, uninstall drops plugin tables, deletes related options (including the encrypted AI key), and clears scheduled corpus jobs.
• Uninstall does not automatically remove links already written into post content. Use Rollback in History before uninstalling if you need that.

Deactivation clears analysis locks/transients and unschedules the daily corpus rebuild cron; it does not drop tables.

Security

• Admin and AJAX actions require manage_options and WordPress nonces.
• AI API keys are encrypted at rest when OpenSSL is available.
• Local mode keeps analysis on your site; AI mode sends excerpts only to the provider you configure.
• Apply path validates live content and policy before mutation; snapshots support rollback.
• Duplicate copies of the same plugin family are detected to avoid double-loading.

Privacy

• No telemetry to Vuzmatri is required for core operation.
• In AI mode, selected content excerpts are sent to your chosen provider (OpenAI, OpenRouter, or custom endpoint). Review that provider’s privacy policy.

Links

• Website: vuzmatri.com
• Persian documentation: README.fa.md

Changelog

2.0.0

• Standalone plugin-only mode (no external LinkSaz backend)
• Local v2 analysis engine with content index and scoring
• Optional AI providers (OpenAI / OpenRouter / custom)
• Suggestions → queue → apply → rollback workflow
• Bilingual admin (EN / FA) and configurable link policy