====== data Plugin ======

---- plugin ----
description: Add and query structured data in your wiki
author     : Andreas Gohr
email      : andi@splitbrain.org
type       : syntax, action, helper
lastupdate : 2024-01-30
compatible : 2024-01-30, Anteater, Frusterick, Manners, Greebo, Hogfather
depends    : sqlite
conflicts  : fckg  #please create an issue report as well!
similar    : fields, pagemod, strata, struct
tags       : database, sqlite, data, tags, tables, listing

downloadurl: https://github.com/splitbrain/dokuwiki-plugin-data/zipball/master
sourcerepo : https://github.com/splitbrain/dokuwiki-plugin-data
bugtracker : https://github.com/splitbrain/dokuwiki-plugin-data/issues
donationurl: http://donate.dokuwiki.org/data
screenshot_img: 
----

This plugin allows you to add structured data to any DokuWiki page. Think about this data as additional named attributes. Those attributes can then be queried and aggregated. The plugin is similar to what was done here for the [[repository|repository plugin]] but its internals are very different to it.

:!: You might want to consider using the spiritual successor to this plugin: [[plugin:struct|struct Plugin]]

===== Download and Installation =====

Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.

==== Changes ====

[[https://travis-ci.org/splitbrain/dokuwiki-plugin-data|{{  https://travis-ci.org/splitbrain/dokuwiki-plugin-data.png?nocache|Build Status}}]]

{{rss>https://github.com/splitbrain/dokuwiki-plugin-data/commits/master.atom date}}

==== Updating from versions prior to 2013-02-06 ====

Be sure to update the [[sqlite]] plugin and follow its instructions on sqlite version upgrades.

==== Updating from versions prior to 2010-03-22 ====

Since 2010-03-22, the data plugin uses the [[sqlite|sqlite helper plugin]]. Therefore, the database file location and structure changed. If you want to keep your old database, you have to perform the following steps prior to upgrading the data plugin:

  - Install the [[sqlite]] plugin
  - Move the file ''data/cache/dataplugin.sqlite'' to ''data/meta/data.sqlite''
  - Perform the following SQL statements on the database (for example using the sqlite plugin’s admin page)<code sql>
CREATE TABLE opts (opt,val);
CREATE UNIQUE INDEX idx_opt ON opts(opt);
INSERT INTO opts VALUES ('dbversion', 1);</code>
  - Upgrade the data plugin

If you upgraded the data plugin before these steps, a blank ''data.sqlite'' has been created and you have to copy the ''data/cache/dataplugin.sqlite'' over the existing ''data/meta/data.sqlite''.

===== Plugin Syntax =====

This plugin depends on multiple parts, each having a similar syntax. The syntax defines a block with various key/value pairs configuring the behaviour of the plugin part. The following parts are available:

^ Part           ^ Function^
| [[#Data Entry (Input)|Data Entry]]         | Input   | 
| [[#Data Table (Output)|Data Table]]        | Output  | 
| [[#Data List (Output)|Data List]]          | Output  | 
| [[#Related Pages (Output)|Related Pages]]  | Output  | 
| [[#Tag Cloud (Control)|Tag Cloud]]         | Control | 

==== Data Entry (Input) ====

This part is used to add structured data to a page. All data entered here is tied to the page. So **you can use it only once on a page**((any additional ''dataentry'' on the same page would overwrite any preceding dataentry on this page and so - while many dataentry blocks on one page may be displayed - only the values of the last one would be stored in the SQLite database and could be retrieved as an output by e.g. a ''datatable'')). Let's start with an example:



{{tag>[list of tags]}}
 меня есть строки для ввода информации в таблицы и вывода. Как мне сделать, что бы при вводе или выводе логина, содержащий {{:icons:16:balloon-left.png?|balloon-left.png.}}символы "<" и ">", заменить их на "&lt" и "&gt"?

[[http://example.com|Ссылка на оригинальную статью]]

<code php index.php>Вставить код PHP</code>
<code css style.css>Вставить код CSS</code>
<code js script.js>Вставить код JS</code>
<html><iframe height="350" style="width: 100%;" scrolling="no" title="Untitled" src="./demo/code-docs/pages/getting_started/getting_started_em.html" frameborder="no" loading="lazy" allowtransparency="true" allowfullscreen="true"></iframe></html>
<details><summary>«См.подробности»</summary>Скрытый блок текста</details>
8-O
:&18:
{{:adapter_c300_m2_pci-e_nvme.png?|}}
[[wp>wp]]
{{stars>3/5}}
{{:icons:16:application-dock.png?|application-dock.png.}}
<code css lib/tpl/dokuwiki/css/content.less>
/*____________ images ____________*/
/* голубая рамка при наведении*/
/* embedded images (styles are already partly set in lib/styles/all.css) */


.dokuwiki img.media:hover{
background:#FDFDFB;
border:1px solid #8DDCEF;
-moz-box-shadow:0 0 10px 2px #B9E9F7;
-webkit-box-shadow:0 0 10px 4px #B9E9F7;
box-shadow:0 0 10px 4px #B9E9F7;}

.dokuwiki img.media {
    margin: .2em 0;
	background: none repeat scroll 0 0 #F8F7F1;
border: 1px solid #00a8e1; /*#FFFFFF по умолчанию*/
box-shadow: 0 0 5px 2px #DDDDDD;
}
</code>
Пример 
{{:dokuwiki_img_media_hover_1.png?|}}
тень при наведении курсора
{{:dokuwiki_img_media_hover_2.png?|}}