=== Sugata（姿） – Organization JSON-LD Schema for Company Websites ===
Contributors: mukuro696
Tags: structured data, json-ld, schema, seo, organization
Requires at least: 6.2
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Clean Organization & WebSite JSON-LD structured data for company sites. Lightweight and free, AI search & LLM ready, easy to validate.

== Description ==

Sugata (姿, meaning "figure" or "presence") helps WordPress company sites output their organization information as accurate **JSON-LD structured data (Schema.org)** — content that search engines and AI search / LLM systems can read.

Many SEO plugins are either too complex or rely on automatic generation, which makes it surprisingly hard to express your own, company-specific information correctly. Sugata focuses on **"learn less, set up faster"**, so that even small businesses without a dedicated web person can configure the Organization schema without getting lost.

The result is a clear "presence" for your company in digital space — a form that search engines and AI can correctly understand as *who this company is*.

Structured data is infrastructure: it helps machines understand your site, but whether and how it appears in search results or AI answers is decided by Google and other services. Sugata's job is to express your information correctly — what happens next is up to them.

**Note:** Sugata is aimed at companies in Japan, so the admin interface is shown in Japanese by default. As of 1.1.0 it is also available in English (and can be translated into other languages), based on your site's language setting.

= Free features =

* Settings page for company information (Organization) — a single admin menu screen
* Company name / legal name / alternate name / description / site URL / logo / founding date / email / phone
* Japanese Corporate Number (法人番号, 13 digits) output as Organization `identifier` — a strong signal for uniquely identifying the company
* Multiple official social/related URLs (sameAs) — signals that help search engines and AI identify your company
* Address (PostalAddress) and contact point (ContactPoint)
* WebSite schema (site name & URL) output on the front page, for the "site name" feature in search results
* Output written to the front page `<head>` as `application/ld+json` (Organization is front-page only, following Google's recommendation)
* Empty fields are excluded — clean JSON-LD
* Live preview of the generated JSON-LD, with one-click copy
* One-click links to Google Rich Results Test and Schema.org Validator
* Notice — and a highlight on the overlapping fields (company name, logo, sameAs, WebSite) — when another SEO plugin (Yoast SEO, Rank Math, etc.) may output the same Organization/WebSite schema, so you can avoid duplicate output
* One-click "Import from WordPress" (site title, tagline, logo) into empty fields
* Each entity gets an `@id` (#organization / #website) and WebSite references Organization as its publisher

= Roadmap =

* Multiple locations / departments (branches, sales offices)
* Product / Service schema with repeatable "specification" fields
* Automatic structuring of category pages (CollectionPage)
* Input assistance and validation

== Installation ==

1. Upload and activate the plugin.
2. Open the "Sugata" menu in the admin.
3. Enter your company name (required) and any other information you know, then save.
4. View your site source and check the `<script type="application/ld+json">` in the `<head>`.
5. Validate with Google's Rich Results Test or the Schema Markup Validator.

== Frequently Asked Questions ==

= Can I leave fields other than the company name empty? =

Yes. Only the company name (name) is required; everything else is optional. Empty fields are not included in the JSON-LD output.

= On which pages is the data output? =

Organization and WebSite are output in the `<head>` of the front page. Google recommends placing company information on the homepage (or a single page that describes the organization), so there is no need to include it on every page.

= Is the admin interface available in English? =

Yes. As of 1.1.0, the interface source strings are English and Japanese is provided as a translation, so the admin screen is shown in English or Japanese depending on your site's language. The plugin is fully translation-ready (text domain `sugata`), so other languages can be added on translate.wordpress.org.

= Does Sugata replace Yoast SEO or Rank Math? =

No. Sugata focuses only on Organization and WebSite JSON-LD for company sites and works alongside your existing SEO plugin. If another plugin already outputs the same Organization or WebSite schema, choose one source to avoid duplicate output.

= Does structured data guarantee rich results or higher rankings? =

No. Sugata outputs valid JSON-LD so that search engines and AI can understand your company information, but whether and how it appears in search results or AI answers is decided by Google and other services.

= What schema types does Sugata support? =

Organization and WebSite first. LocalBusiness and more detailed company profiles may be added based on feedback.

= Is it free? =

Yes. The basic Organization and WebSite JSON-LD output is free.

== Screenshots ==

1. Company information (Organization) settings page (Japanese UI): input status at the top, per-field help, and the "Import from WordPress" button.
2. Live preview of the generated JSON-LD — Organization and WebSite (Japanese UI).
3. The same settings page in English — the admin UI follows your site's language.
4. Live preview of the generated JSON-LD (English UI).

== Changelog ==

= 1.2.0 =
* Added a one-click Copy button to the JSON-LD preview.
* Added quick links to the Google Rich Results Test and the Schema.org Validator for your front page.
* Added a notice — plus a highlight on the commonly-overlapping fields (company name, logo, sameAs, WebSite) — when another SEO plugin (Yoast SEO, Rank Math, All in One SEO, SEOPress) is active and may also output Organization/WebSite schema, to help you avoid duplicate output.

= 1.1.3 =
* Improved discoverability: the plugin title now states its purpose (Organization JSON-LD schema for company sites), and the readme adds FAQ entries on working alongside SEO plugins, avoiding duplicate output, and rich-results expectations. No functional changes.

= 1.1.2 =
* Documentation: shortened the readme short description to fit WordPress.org's 150-character limit (the previous one was being truncated), and added English-UI screenshots (the admin interface is available in English as of 1.1.0). No code changes.

= 1.1.1 =
* Documentation: updated the readme and FAQ to reflect that, after 1.1.0, the admin interface is available in English as well as Japanese (the previous "Japanese only" note and FAQ answer were outdated). No code changes.

= 1.1.0 =
* Internationalization: the plugin's interface strings are now English in the source, with Japanese provided as a bundled translation (languages/sugata-ja.mo). Japanese (ja) sites are unaffected and still display in Japanese; other locales now fall back to English, and the plugin can be translated into any language on translate.wordpress.org.

= 1.0.2 =
* Revised the Japanese interface strings to follow the WordPress Japanese translation style guide (half-width parentheses with surrounding spaces, and half-width spaces between Latin words and Japanese text). No functional changes.

= 1.0.1 =
* Admin styles are now loaded as a proper stylesheet via wp_enqueue_style (assets/admin.css) instead of an inline <style> block, following the WordPress.org plugin guidelines.

= 1.0.0 =
* First public release. Organization & WebSite JSON-LD with a friendly Japanese settings screen (corporate number, multiple social URLs, overseas-friendly address, @id linking, import from WordPress, honest copy, AI search / LLM positioning).
