MediaWiki 拡張機能マニュアル

VisualData リリースの状態: 安定Category:Stable extensions/ja
実装	フック Category:Hook extensions/ja, 特別ページ Category:Special page extensions/ja
説明	VisualData is a full-fledged metadata management framework based on json-schema able to easily record, organize and query collection of data on your wiki.
作者	thomas-topway-it (thomas-topway-itトーク)
最新バージョン	1.0.9 (2025-02-07)
互換性の方針	master は後方互換性を維持しています。
MediaWiki	1.35+Category:Extensions with manual MediaWiki version/ja
データベースの変更	はい
ライセンス	GNU 一般公衆利用許諾書 2.0 以降
ダウンロード	拡張機能をダウンロード Git [?]: リポジトリを参照 (Phabricator · GitHub) Gerrit コード レビュー Git コミット ログ Download source tarball Category:Extensions in Wikimedia version control/ja
例	Wikisphere
パラメーター $wgVisualDataTrackingCategoryForms $wgVisualDataCreateJobsWarningLimit $wgVisualDataDisableSlotsNavigation $wgVisualDataQueryProcessorPrintoutsLimit $wgVisualDataEditDataNamespaces $wgVisualDataDisableSidebarLink $wgVisualDataTrackingCategoryJsonData $wgVisualDataTrackingCategoryButtons $wgVisualDataDisableVersionCheck $wgVisualDataMaptilerApiKey $wgVisualDataTrackingCategoryQueries $wgVisualDataDebugPath
追加する権限 visualdata-caneditdata visualdata-canmanageschemas
使用するフック AfterImportPage Category:AfterImportPage extensions/ja AlternateEdit Category:AlternateEdit extensions/ja ArticleUndelete Category:ArticleUndelete extensions/ja BeforeInitialize Category:BeforeInitialize extensions/ja BeforePageDisplay Category:BeforePageDisplay extensions/ja ContentAlterParserOutput Category:ContentAlterParserOutput extensions/ja ContentGetParserOutput Category:ContentGetParserOutput extensions/ja EditPage::showEditForm:initial Category:EditPage::showEditForm:initial extensions/ja LoadExtensionSchemaUpdates Category:LoadExtensionSchemaUpdates extensions/ja MediaWikiServices Category:MediaWikiServices extensions/ja MultiContentSave Category:MultiContentSave extensions/ja OutputPageParserOutput Category:OutputPageParserOutput extensions/ja PageDeleteComplete Category:PageDeleteComplete extensions/ja PageRenderingHash Category:PageRenderingHash extensions/ja PageSaveComplete Category:PageSaveComplete extensions/ja ParserAfterTidy Category:ParserAfterTidy extensions/ja ParserFirstCallInit Category:ParserFirstCallInit extensions/ja ParserPreSaveTransformComplete Category:ParserPreSaveTransformComplete extensions/ja RandomPageQuery Category:RandomPageQuery extensions/ja RevisionFromEditComplete Category:RevisionFromEditComplete extensions/ja ScribuntoExternalLibraries Category:ScribuntoExternalLibraries extensions/ja SidebarBeforeOutput Category:SidebarBeforeOutput extensions/ja SkinBuildSidebar Category:SkinBuildSidebar extensions/ja SkinTemplateNavigation::Universal Category:SkinTemplateNavigation::Universal extensions/ja
translatewiki.net で翻訳を利用できる場合は、VisualData 拡張機能の翻訳にご協力ください

VisualData is a full-fledged metadata management framework based on json-schema able to easily record, organize and query collection of data on your wiki.

It is characterized by a strong emphasis on the UI/UX side and aims to present itself as a lightweight or modern alternative to Semantic MediaWiki and Cargo.

Key-features

• Based on json-schema and slots
• forms and pop-up forms auto-generated from json-schema
• Integrated SchemaBuilder to easily create json-schema compliant schemas, with nested items and OOUI widgets
• Forms are validated with industry-standard ajv-validator
• SMW's style inline queries and result formats
• Can import/store/query large amount of data (with hierarchical structure) in specific articles/the entire wiki, and to rebuild them in minutes
• completed with an uninstall script: test the extension and opt-out if it doesn't meet your requirements!

check out live demos and Release notes for the latest improvements

UI 要素

• A sidebar section where to access all special pages offered by the extension
  

• The action tab "Edit data" by which to assign schemas to article and fill-in them through automatically generated OOUI forms
  

• and a namespace tab where to access the slot with json-data registered within an article through the extension
  

The visibility of each of them can be managed using the global parameters below.

インストール

• ダウンロードして、ファイルを extensions/ フォルダー内の VisualData という名前のディレクトリ内に配置します。
• run composer install --no-dev in the extension folder. This will install the required libraries^[1]
• 以下のコードを LocalSettings.php の末尾に追加します

wfLoadExtension( 'VisualData' );

• Run php maintenance/run.php update (this will install the required tables)
• 完了 – ウィキの Special:Version に移動して、拡張機能が正しくインストールされたことを確認します。

Make sure to run

php maintenance/run.php ./extensions/VisualData/maintenance/RebuildData.php

after each update of the extension when indicated in the Release notes. This will drop/recreate the tables based on the data stored on the wiki

Main sections

この拡張機能は、以下の利用者権限を作成します。 They can be both included manually in the LocalSettings.php or to be managed through the interface (special page Special:UserRights). Sysops and bureaucrats are assigned with the complete set of permissions by default.

$wgGroupPermissions['*']["visualdata-caneditdata"] = true;
$wgGroupPermissions['*']["visualdata-canmanageschemas"] = false;

$wgVisualDataDisableSidebarLink = false;
$wgVisualDataDisableSlotsNavigation = false;
$wgVisualDataCreateJobsWarningLimit = 0;
$wgVisualDataEditDataNamespaces =  [ 0, 4, 2226, 2230 ];
$wgVisualDataTrackingCategoryJsonData = false;
$wgVisualDataTrackingCategoryForms = false;
$wgVisualDataTrackingCategoryQueries = false;
$wgVisualDataTrackingCategoryButtons = false;
$wgVisualDataMaptilerApiKey = '';

// @Attention the same namespace is also used by Extension:JsonConfig and Extension:LinkedWiki
define("NS_DATA", 2220);
define("NS_DATA_TALK", 2221);
$wgExtraNamespaces[NS_DATA] = "Data";
$wgExtraNamespaces[NS_DATA_TALK] = "Data_talk";

グループ

グループ	Can edit data	Can manage schemas
sysop, bureaucrat
visualdata-admin
visualdata-editor		N

グローバル パラメーター

既知の問題点

• in some MediaWiki versions and configurations, the ResourceLoader may generate syntax errors when bundling the Javascript files. In this case please use $wgResourceLoaderDebug = true; in LocalSettings.php, this will include separately each file and should solve the problem.
• rename of schemas and properties must be kept in synch with property and schema names hardcoded in parser functions. This will be solved implementing a query and form builder (see #Roadmap)
• queries require that the first printout exists, otherwise the row will not show. This could be solved using DUAL keyword
• the SchemaBuilder and the form processor do not yet support the directives oneOf, anyOf and support for the $ref keyword

ロードマップ

• handle visibility for content-blocks (Forms)
• handle visibility based on multiselect input widgets (check if has items)
• add oneOf, anyOf and allOf support to form generator and SchemaBuilder (the SchemaBuilder will contain a select on the schema main panel)
• add tuple and $ref keyword to SchemaBuilder (properties panel, besides 'add field', 'add content block', etc.)
• add additional properties to SchemaBuilder (additional panel)
• add query and form builder: this will store queries and forms as json schemas so that rename of schemas or properties can be updated within such schemas, not in the wikitext. The parser function will add queries and forms by their names or code
• UI for bulk-edit of json data in the BrowseData special page
• Ajax navigation for datatables, SearchPanes and SearchBuilder

Additionally:

• version control for schemas and related data, so that edits of the schema constrain to the data related to the previous data structure
• version control notice shown through Extension:Echo and/or complying better design practice
• partial editing of schemas and field operations like Firebase's ArrayUnion, ArrayRemove, etc.
• preload json-ld/schema.org entities as json-schemas
• associate json-ld/schema.org vocabulary to user-defined schemas

Release notes

Extension:VisualData/Release notes

サポートとバグ

Please post error messages in the Talk page of the extension or use Phabricator for technical contributions. Updates will be occasionally posted on the MediaWiki's Wikitech mailing list.

For professional support please write at the email address posted here

関連項目

• Extension:ContactManager (A demo wiki-application built on top of VisualData)
• Extension:Semantic MediaWiki
• Extension:Cargo
• Extension:PageForms
• Extension:FlexForm
• Manual:MediaWikiのデータ管理法 – An overview and comparison

• Demos on Wikisphere
• json-schema
• json-editor demo
• json-schema creator
• schema store
• php-json-schema-model-generator

Test it out !

WikiSphere