Skip to content

Commit 6af1eea

Browse files
committed
wrote clean readme file
1 parent 0d0dddd commit 6af1eea

1 file changed

Lines changed: 59 additions & 2 deletions

File tree

README.md

Lines changed: 59 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,59 @@
1-
# lke-plugins
2-
Plugins for Linkurious Enterprise
1+
# Data-table plugin for Linkurious Enterprise
2+
3+
This Linkurious Enterprise plugin allow displaying the result of a
4+
query (or query template) as a table.
5+
6+
## Configuration
7+
8+
These are the configuration keys that need to be set in the plugin
9+
configuration, via the Linkurious Configuration.
10+
11+
- `entityType` (**required**, `"edge"` or `"node"`): whether to display
12+
nodes or edges in the table (e.g. `"node"`).
13+
- `itemType` (**required**, string): name of the node-category or
14+
edge-type to display in the table (e.g. `"COMPANY"`).
15+
- `properties` (**optional**, array): property names to include in the
16+
table (e.g. `["name", "age", "date_of_birth"]`). Defaults to all
17+
properties of the configured `itemType`.
18+
- `basePath` (**optional**, string): URL path in which the plugin will
19+
be deployed (e.g. `"my-plugin"`). Defaults to plugin name.
20+
21+
Full configuration example:
22+
```json
23+
{
24+
"data-table": {
25+
"basePath": "table",
26+
"entityType": "node",
27+
"itemType": "Company",
28+
"properties": ["name", "address", "vat_number"]
29+
}
30+
}
31+
```
32+
33+
## Options
34+
35+
These are the options that this plugin accepts as URL parameters:
36+
37+
- `queryId` (**required**, integer): query to run (e.g. `queryId=26`).
38+
- `sourceKey` (**required**, string): Key of the data-source to run the
39+
query on (e.g. `sourceKey=b16e9ed5`).
40+
- `limit` (**optional**, integer): maximum number of results to display
41+
(e.g. `limit=1000`).
42+
- `param_number_PARAM NAME` (**optional**, number): *for query
43+
templates*, any numerical parameter of the template (e.g.
44+
`param_number_my%20number=123`).
45+
- `param_string_PARAM NAME` (**optional**, string): *for query
46+
templates*, any string parameter of the template (e.g.
47+
`param_string_my%20param=abc`).
48+
- `param_ids_PARAM NAME` (**optional**, comma-separated list): *for
49+
query templates*, any edgeset/nodeset parameter of the template (e.g.
50+
`param_ids_my%20id%20list=1,2,3`).
51+
52+
Full URL example (line breaks for readability):
53+
```
54+
https://linkurious.example.com/plugins/data-table
55+
?queryId=26
56+
&sourceKey=b16e9ed5
57+
&limit=1000
58+
&param_string_city=Paris
59+
```

0 commit comments

Comments
 (0)