===  Albanian SEO — The Local Search Engine | Optimizimi SEO në Shqip ===
Contributors: seoal
Tags: seo, sitemap, schema, local seo, bilingual
Requires at least: 5.7
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Bilingual (Albanian/English) local SEO: setup wizard, SEO audit dashboard, schema, XML sitemaps, analytics and a live editor panel.

== Description ==

Albanian SEO is a lightweight, high-performance SEO plugin built for the Albanian and Kosovo market. The entire admin interface switches instantly between Albanian and English with a single toggle — independent of the WordPress site locale.

= Key features =

* **Real-time bilingual (Albanian / English)** — pick the language in the wizard; the whole interface flips instantly.
* **Setup wizard** — five skippable steps; the first step is the language choice.
* **Dashboard with SEO audit** — a score computed from real, on-site checks, graded A to F.
* **Analytics** — real metrics from your site (content growth, indexable pages, SEO completeness, keyword coverage) with an activity chart and content-by-type breakdown.
* **Core SEO settings** — Site Identity, Title Formats, Breadcrumbs, Hero & Branding, Business Info, Social, Image SEO, Schema Manager, Crawling, Indexing, Bulk overview, Author Archives, Integrations.
* **Local schema (JSON-LD)** — LocalBusiness / Organization / Person with address, phone (+355 / +383), opening hours, geo; plus WebSite + SearchAction, Article and BreadcrumbList.
* **Meta, Open Graph & Twitter Cards** — dynamic titles with tokens, descriptions, canonical, per-post overrides.
* **XML sitemap index** — /sitemap_index.xml with per-type child sitemaps (posts, pages, categories, custom post types), pagination, and a styled browser view.
* **IndexNow** — instantly notify Bing/Yandex on publish or update (opt-in).
* **Block-editor SEO panel** — a full-screen panel bound to post meta (General / Analysis / Schema / Social / Advanced).
* **AI Tools (bring-your-own-key)** — optional content briefs and metadata generation supporting xAI (Grok), OpenAI, and Anthropic; output is generated in your chosen language.

== Installation ==

1. Upload the `theseoal-albanian-seo` folder to `/wp-content/plugins/`, or install the ZIP from Plugins > Add New > Upload Plugin.
2. Activate the plugin through the **Plugins** menu.
3. The setup wizard opens automatically — choose your language and follow the steps (or skip).
4. Visit **Settings > Permalinks** once and click **Save** so the sitemap and llms.txt routes register.
5. (Optional) For AI Tools, select your preferred provider and add your API key under the plugin's **Settings**.

== Frequently Asked Questions ==

= Can I use it in both Albanian and English? =
The interface shows in the language you choose. You can change it anytime from the plugin's **Settings**. It does not depend on the WordPress site locale.

= Do the +355 and +383 phone numbers work? =
Yes. Numbers are validated and the country (Albania / Kosovo) is detected automatically for local schema.

= Are the AI Tools required? =
No. They are entirely optional and only work if you select an AI provider and enter your API key. Everything else works without any external account.

= Does the sitemap work right after activation? =
Visit **Settings > Permalinks** once and click Save so the rewrite rules register, then open `/sitemap_index.xml`.

== External services ==

This plugin can connect to the third-party services listed below. None of them are contacted automatically without explicit opt-in action from the site administrator. No user data leaves your site by default.

* **xAI / Grok (api.x.ai)**
  - **Used for:** AI-powered SEO content briefs and metadata generation when xAI/Grok is selected as the AI provider. Only activated when the site owner enters an xAI API key.
  - **Data sent:** User-provided keywords and topic context prompts (text only) sent via secure server-to-server HTTP request.
  - **Privacy policy:** https://x.ai/legal/privacy-policy
  - **Terms of service:** https://x.ai/legal/terms-of-service

* **OpenAI (api.openai.com)**
  - **Used for:** AI-powered SEO content briefs and metadata generation when OpenAI is selected as the AI provider. Only activated when the site owner enters an OpenAI API key.
  - **Data sent:** User-provided keywords and topic context prompts (text only) sent via secure server-to-server HTTP request.
  - **Privacy policy:** https://openai.com/policies/privacy-policy/
  - **Terms of service:** https://openai.com/policies/terms-of-use/

* **Anthropic (api.anthropic.com)**
  - **Used for:** AI-powered SEO content briefs and metadata generation when Anthropic is selected as the AI provider. Only activated when the site owner enters an Anthropic API key.
  - **Data sent:** User-provided keywords and topic context prompts (text only) sent via secure server-to-server HTTP request.
  - **Privacy policy:** https://www.anthropic.com/legal/privacy
  - **Terms of service:** https://www.anthropic.com/legal/consumer-terms

* **IndexNow (api.indexnow.org)**
  - **Used for:** Instant URL submission to IndexNow-compatible search engines (Bing, Yandex, Seznam). Opt-in only, enabled via settings or triggered manually by the site owner.
  - **Data sent:** Your site's published URL(s), site hostname, and a locally generated IndexNow key.
  - **Privacy policy:** https://www.indexnow.org/
  - **Terms of service:** https://www.indexnow.org/documentation

* **Google Analytics 4 (googletagmanager.com)**
  - **Used for:** Loading the standard GA4 gtag.js script on the site's front end. Only activated when the site owner enters a valid GA4 Measurement ID in settings.
  - **Data sent:** Standard, non-personally identifiable site navigation events and technical metadata collected by Google Analytics.
  - **Privacy policy:** https://policies.google.com/privacy
  - **Terms of service:** https://marketingplatform.google.com/about/analytics/terms/us/

== Screenshots ==

1. Setup wizard step 1 — language selection (Albanian or English) and setup initialisation.
2. Setup wizard step 2 — Site Identity & Sitemap setup in Albanian.
3. Main dashboard — site SEO audit with letter grading (A to F) and status checks in Albanian.
4. Main dashboard — site SEO audit and quick access links in English.
5. Core SEO settings — organized sidebar navigation for Site Identity, Schema, Crawling, Indexing, and Integrations.
6. Plugin settings — interface language toggle, XML sitemap toggle, and AI provider configuration (Anthropic/OpenAI/xAI).

== Changelog ==

= 1.0.0 =
First public release.
* Real-time bilingual interface (Albanian / English) with a language switcher.
* Setup wizard with a language-first step.
* Dashboard SEO audit (graded score) and an Analytics page with real on-site metrics.
* Core SEO: Site Identity, Title Formats, Breadcrumbs, Hero & Branding, Business Info, Social, Image SEO, Schema Manager, Crawling, Indexing, Bulk overview, Author Archives, Integrations (verification + GA4).
* XML sitemap index with per-type child sitemaps and a styled browser view.
* IndexNow (automatic/manual), robots meta and robots.txt controls, and LLMs.txt (requires the free Rankal LLMs.txt plugin).
* Optional AI Tools (bring-your-own-key xAI, OpenAI, Anthropic): content briefs and metadata generator.
* Block-editor SEO panel bound to post meta.
* JSON-LD schema (LocalBusiness/Organization/Person, WebSite + SearchAction, Article, BreadcrumbList), Open Graph and Twitter Cards.

== Upgrade Notice ==

= 1.0.0 =
First release. After activating, visit Settings > Permalinks once so the sitemap and llms.txt routes register.