Title: Semantic Italia
Author: dtditalia
Published: <strong>2026年5月6日</strong>
Last modified: 2026年5月7日

---

プラグインを検索

![](https://ps.w.org/design-italia-semantic/assets/banner-772x250.png?rev=3524632)

![](https://ps.w.org/design-italia-semantic/assets/icon-256x256.png?rev=3524632)

# Semantic Italia

 作者: [dtditalia](https://profiles.wordpress.org/dtditalia/)

[ダウンロード](https://downloads.wordpress.org/plugin/design-italia-semantic.1.0.0.zip)

 * [詳細](https://ja.wordpress.org/plugins/design-italia-semantic/#description)
 * [レビュー](https://ja.wordpress.org/plugins/design-italia-semantic/#reviews)
 *  [インストール](https://ja.wordpress.org/plugins/design-italia-semantic/#installation)
 * [開発](https://ja.wordpress.org/plugins/design-italia-semantic/#developers)

 [サポート](https://wordpress.org/support/plugin/design-italia-semantic/)

## 説明

**Semantic Italia** transforms content published with the official WordPress themes
of the Italian Department for Digital Transformation — _Design Comuni Italia_ (DCI)
and _Design Scuole Italia_ (DSI) — into structured data in **JSON-LD** format, aligned
with the ontologies of the [schema.gov.it](https://schema.gov.it) catalog.

The generated graphs conform to the Italian Public Administration semantic framework:
every entity (service, place, event, public official, document, organizational unit)
is represented using standardized classes and properties, enabling interoperability
with other systems and publication as **Linked Open Data**.

#### Main Features

 * JSON-LD export via REST API (`/wp-json/comuni/v1/graph`, `/wp-json/scuole/v1/
   graph`)
 * Automatic detection of the active domain (DCI / DSI / both)
 * Official IPA identifier (`urn:x-italian-pa:code`) for the `cov:PublicOrganization`
   node
 * Two-level precomputed cache (WP transient + WP option) with asynchronous rebuild
   via WP-Cron
 * Built-in protection against excessive requests (per-IP and global rate limiting)
 * Admin page with cache status panel and editable IPA code field

#### REST Endpoints

**DCI (Municipalities)**

 * `GET /wp-json/comuni/v1/graph` — Full graph
 * `GET /wp-json/comuni/v1/graph/persona-pubblica`
 * `GET /wp-json/comuni/v1/graph/luoghi`
 * `GET /wp-json/comuni/v1/graph/servizi`
 * `GET /wp-json/comuni/v1/graph/unita-organizzative`
 * `GET /wp-json/comuni/v1/graph/eventi`
 * `GET /wp-json/comuni/v1/graph/dataset`

**DSI (Schools)**

 * `GET /wp-json/scuole/v1/graph` — Full graph
 * `GET /wp-json/scuole/v1/graph/luoghi`
 * `GET /wp-json/scuole/v1/graph/servizi`
 * `GET /wp-json/scuole/v1/graph/eventi`
 * `GET /wp-json/scuole/v1/graph/documenti`
 * `GET /wp-json/scuole/v1/graph/strutture`

#### Ontologies Used

All classes and properties are aligned with the [schema.gov.it](https://schema.gov.it)
catalog:
 cpv:, `cov:`, `cpsv:`, `cpev:`, `poi:`, `clv:`, `dcatapit:`, `dct:`, `
l0:`, `foaf:`, `proj:`, `ti:`

#### Requirements

This plugin requires one of the following official WordPress themes:

 * [Design Comuni Italia](https://github.com/italia/design-comuni-wordpress-theme)
 * [Design Scuole Italia](https://github.com/italia/design-scuole-wordpress-theme)

## インストール

 1. Upload the `semantic-italia` folder to the `/wp-content/plugins/` directory
 2. Activate the plugin from the WordPress _Plugins_ page
 3. Upon activation, the plugin automatically detects the active domain (DCI/DSI) and
    the IPA code
 4. Go to _Settings  Semantic Italia_ to verify the configuration

## FAQ

### Does the plugin work without the official themes?

No. The plugin reads the `_dci_*` (Design Comuni Italia) and `_dsi_*` (Design Scuole
Italia) meta fields registered by the official themes. Without an active theme the
endpoints will return an empty graph.

### How is the IPA code determined?

Upon activation, the plugin matches the `home_url()` domain against the IPA index
included in `data/ipa-index.json`. If the domain is found, the code is saved and
used as the `@id` of the `cov:PublicOrganization` node in the format `urn:x-italian-
pa:code`. If not found automatically, it can be entered manually from the administration
page.

### How do I update the IPA code?

Go to _Settings  Semantic Italia_ and edit the **IPA Code** field. Saving automatically
clears the cache.

### How does the cache work?

The plugin precomputes JSON-LD graphs and stores them on two levels: a WordPress
transient (expires after 1 hour, configurable) and a WP option (persistent). Rebuild
happens automatically in the background via WP-Cron when content is modified, without
slowing down post saves.

### How do I configure rate limiting?

Parameters are configurable via WordPress filters in the theme’s `functions.php`:

    ```
    add_filter( 'desiitse_rl_max_requests', fn() => 30 );
    add_filter( 'desiitse_rl_window_seconds', fn() => 60 );
    add_filter( 'desiitse_rl_global_rps', fn() => 50 );
    ```

## 評価

このプラグインにはレビューがありません。

## 貢献者と開発者

Semantic Italia はオープンソースソフトウェアです。以下の人々がこのプラグインに貢献
しています。

貢献者

 *   [ dtditalia ](https://profiles.wordpress.org/dtditalia/)

[“Semantic Italia” をあなたの言語に翻訳しましょう。](https://translate.wordpress.org/projects/wp-plugins/design-italia-semantic)

### 開発に興味がありますか ?

[コードを閲覧](https://plugins.trac.wordpress.org/browser/design-italia-semantic/)
するか、[SVN リポジトリ](https://plugins.svn.wordpress.org/design-italia-semantic/)
をチェックするか、[開発ログ](https://plugins.trac.wordpress.org/log/design-italia-semantic/)
を [RSS](https://plugins.trac.wordpress.org/log/design-italia-semantic/?limit=100&mode=stop_on_copy&format=rss)
で購読してみてください。

## 変更履歴

#### 1.0.0

 * Initial public release

## メタ

 *  バージョン **1.0.0**
 *  最終更新日 **5か月前**
 *  有効インストール数 **10未満**
 *  WordPress バージョン ** 6.0またはそれ以降 **
 *  検証済み最新バージョン: **6.9.10**
 *  PHP バージョン ** 8.0またはそれ以降 **
 *  言語
 * [English (US)](https://wordpress.org/plugins/design-italia-semantic/)
 * タグ
 * [JSON-LD](https://ja.wordpress.org/plugins/tags/json-ld/)[linked data](https://ja.wordpress.org/plugins/tags/linked-data/)
   [open data](https://ja.wordpress.org/plugins/tags/open-data/)[rest-api](https://ja.wordpress.org/plugins/tags/rest-api/)
   [semantic web](https://ja.wordpress.org/plugins/tags/semantic-web/)
 *  [詳細を表示](https://ja.wordpress.org/plugins/design-italia-semantic/advanced/)

## 評価

レビューはまだ送信されていません。

[Your review](https://wordpress.org/support/plugin/design-italia-semantic/reviews/#new-post)

[すべてのレビューを見る](https://wordpress.org/support/plugin/design-italia-semantic/reviews/)

## 貢献者

 *   [ dtditalia ](https://profiles.wordpress.org/dtditalia/)

## サポート

意見や質問がありますか ?

 [サポートフォーラムを表示](https://wordpress.org/support/plugin/design-italia-semantic/)