neo4j-labs
diff --git a/‎.github/workflows/master-deployment.yml
Lines changed: 2 additions & 2 deletions b/‎.github/workflows/master-deployment.yml
Lines changed: 2 additions & 2 deletions
diff --git a/‎Dockerfile
Lines changed: 1 addition & 1 deletion b/‎Dockerfile
Lines changed: 1 addition & 1 deletion
diff --git a/‎changelog.md
Lines changed: 13 additions & 0 deletions b/‎changelog.md
Lines changed: 13 additions & 0 deletions
diff --git a/‎docs/modules/ROOT/images/graph3d.png
52.4 KB b/‎docs/modules/ROOT/images/graph3d.png
52.4 KB
diff --git a/‎docs/modules/ROOT/images/graph3dvirtual.png
71.7 KB b/‎docs/modules/ROOT/images/graph3dvirtual.png
71.7 KB
diff --git a/‎docs/modules/ROOT/nav.adoc
Lines changed: 1 addition & 0 deletions b/‎docs/modules/ROOT/nav.adoc
Lines changed: 1 addition & 0 deletions
diff --git a/‎docs/modules/ROOT/pages/developer-guide/deploy-a-build.adoc
Lines changed: 1 addition & 1 deletion b/‎docs/modules/ROOT/pages/developer-guide/deploy-a-build.adoc
Lines changed: 1 addition & 1 deletion
diff --git a/‎docs/modules/ROOT/pages/user-guide/extensions/advanced-visualizations.adoc
Lines changed: 1 addition & 1 deletion b/‎docs/modules/ROOT/pages/user-guide/extensions/advanced-visualizations.adoc
Lines changed: 1 addition & 1 deletion
diff --git a/‎docs/modules/ROOT/pages/user-guide/reports/graph.adoc
Lines changed: 1 addition & 1 deletion b/‎docs/modules/ROOT/pages/user-guide/reports/graph.adoc
Lines changed: 1 addition & 1 deletion
diff --git a/‎docs/modules/ROOT/pages/user-guide/reports/graph3d.adoc
Lines changed: 137 additions & 0 deletions b/‎docs/modules/ROOT/pages/user-guide/reports/graph3d.adoc
Lines changed: 137 additions & 0 deletions
diff --git a/‎docs/modules/ROOT/pages/user-guide/reports/index.adoc
Lines changed: 1 addition & 0 deletions b/‎docs/modules/ROOT/pages/user-guide/reports/index.adoc
Lines changed: 1 addition & 0 deletions
diff --git a/‎gallery/tsconfig.json
Lines changed: 2 additions & 8 deletions b/‎gallery/tsconfig.json
Lines changed: 2 additions & 8 deletions
diff --git a/‎package.json
Lines changed: 4 additions & 1 deletion b/‎package.json
Lines changed: 4 additions & 1 deletion
diff --git a/‎public/style.css
Lines changed: 8 additions & 3 deletions b/‎public/style.css
Lines changed: 8 additions & 3 deletions
diff --git a/‎release-notes.md
Lines changed: 10 additions & 19 deletions b/‎release-notes.md
Lines changed: 10 additions & 19 deletions
diff --git a/‎src/application/ApplicationActions.ts
Lines changed: 2 additions & 0 deletions b/‎src/application/ApplicationActions.ts
Lines changed: 2 additions & 0 deletions
diff --git a/‎src/application/ApplicationReducer.ts
Lines changed: 2 additions & 0 deletions b/‎src/application/ApplicationReducer.ts
Lines changed: 2 additions & 0 deletions
diff --git a/‎src/application/ApplicationSelectors.ts
Lines changed: 1 addition & 0 deletions b/‎src/application/ApplicationSelectors.ts
Lines changed: 1 addition & 0 deletions
@@ -79,7 +79,7 @@ jobs:
           context: .
           file: ./Dockerfile
           push: true
-          tags: ${{ secrets.DOCKER_HUB_LABS_USERNAME }}/neodash:latest,${{ secrets.DOCKER_HUB_LABS_USERNAME }}/neodash:2.4.1
+          tags: ${{ secrets.DOCKER_HUB_LABS_USERNAME }}/neodash:latest,${{ secrets.DOCKER_HUB_LABS_USERNAME }}/neodash:2.4.2
   build-docker-legacy:
     needs: build-test
     runs-on: neodash-runners
@@ -103,7 +103,7 @@ jobs:
           context: .
           file: ./Dockerfile
           push: true
-          tags: ${{ secrets.DOCKER_HUB_USERNAME }}/neodash:latest,${{ secrets.DOCKER_HUB_USERNAME }}/neodash:2.4.1
+          tags: ${{ secrets.DOCKER_HUB_USERNAME }}/neodash:latest,${{ secrets.DOCKER_HUB_USERNAME }}/neodash:2.4.2
   deploy-gallery:
     runs-on: neodash-runners
     strategy:
 
@@ -43,4 +43,4 @@ USER nginx
 EXPOSE $NGINX_PORT
 
 HEALTHCHECK cmd curl --fail "http://localhost:$NGINX_PORT" || exit 1
-LABEL version="2.4.1"
+LABEL version="2.4.2"
@@ -1,3 +1,16 @@
+## NeoDash 2.4.2
+This is a release with a large amount of quality of life improvements, as well as some new features:
+
+- Visualize graphs in 3D with the new 3D graph report. [#737](https://github.com/neo4j-labs/neodash/pull/737)
+- Improved dashboard management sidebar and handling of drafts. [#734](https://github.com/neo4j-labs/neodash/pull/734)
+- Added parameter select setting for autopopulating first selector value. [#746](https://github.com/neo4j-labs/neodash/pull/746)
+- Improved UX for editing page names & dashboard titles. [#743](https://github.com/neo4j-labs/neodash/pull/743)
+- Unified common settings for each report type. [#724](https://github.com/neo4j-labs/neodash/pull/724)
+- Title of the browser tab NeoDash runs on is now automatically set to the dashboard name.  [#708](https://github.com/neo4j-labs/neodash/pull/708)
+- Fixed issue where invisible table columns were not handled correctly. [#695](https://github.com/neo4j-labs/neodash/pull/695)
+- Miscellaneous bug fixes, style improvements & stability fixes. [#744](https://github.com/neo4j-labs/neodash/pull/744)
+
+
 ## NeoDash 2.4.1
 This is a patch release following 2.4.0. It contains several new features for self-hosted (standalone) NeoDash deployments, as well as a variety of UX improvements for dashboard editors.
 
 
@@ -9,6 +9,7 @@
 *** xref:user-guide/reports/bar-chart.adoc[Bar Chart]
 *** xref:user-guide/reports/pie-chart.adoc[Pie Chart]
 *** xref:user-guide/reports/line-chart.adoc[Line Chart]
+*** xref:user-guide/reports/graph3d.adoc[3D Graph]
 *** xref:user-guide/reports/sunburst.adoc[Sunburst]
 *** xref:user-guide/reports/circle-packing.adoc[Circle Packing]
 *** xref:user-guide/reports/choropleth.adoc[Choropleth]
 
@@ -37,7 +37,7 @@ Depending on the webserver type and version, this could be different directory.
 As an example - to copy the files to an nginx webserver using `scp`:
 
 ```bash
-scp neodash-2.4.1 username@host:/usr/share/nginx/html
+scp neodash-2.4.2 username@host:/usr/share/nginx/html
 ```
 
 NeoDash should now be visible by visiting your (sub)domain in the browser.
 
@@ -5,7 +5,7 @@ For specific use-cases, these visualizations may convey information that a simpl
 To use advanced visualizations, enable them in the **Extensions Window**. This makes them selectable inside reports, as well as add examples to the Example window.
 
 The following visualizations are part of this extension:
-
+- A link:../../reports/graph3d[3D Graph] to visualize a graph in three dimensions.
 - A link:../../reports/sankey[Sankey Chart] to visualize flows.
 - Three charts to plot hierarchical data (link:../../reports/sunburst[Sunburst], link:../../reports/circle-packing[Circle Packing], link:../../reports/treemap[Treemap])
 - A link:../../reports/gauge-chart[Gauge Chart] to show percentages.
 
@@ -26,7 +26,7 @@ RETURN p, a, m
 
 image::graph.png[Basic Graph]
 
-== Virtual Graph (apoc is required)
+== Virtual Graph
 
 ....
 MATCH (p:Person)-[:ACTED_IN]->(m:Movie)<-[:ACTED_IN]-(p2:Person)
 
@@ -0,0 +1,137 @@
+= 3D Graph
+
+link:../../extensions/advanced-visualizations[label:Advanced&nbsp;Visualization[]]
+
+The 3D graph report extends the default graph visualization with another dimension.
+It supports most of the features & customizations for the regular (2D) graph, including rule-based styling and report actions.
+Users can explore the 3D graph by zooming and panning through 3D space.
+
+
+== Examples
+
+=== Basic Graph
+
+....
+MATCH (p:Person)-[a:ACTED_IN]->(m:Movie)
+WHERE m.title = 'The Matrix'
+RETURN p, a, m
+....
+
+image::graph3d.png[Basic 3D Graph]
+
+== Virtual Graph
+
+....
+MATCH (p:Person)-[:ACTED_IN]->(m:Movie)<-[:ACTED_IN]-(p2:Person)
+WHERE m.title = "The Matrix"
+RETURN p, p2, apoc.create.vRelationship(p, "KNOWS", {}, p2)
+....
+
+image::graph3dvirtual.png[Virtual 3D Graph]
+
+== Advanced Settings
+
+[width="100%",cols="12%,2%,3%,83%",options="header",]
+|===
+|Name |Type |Default Value |Description
+|Node Color Scheme |List |neodash |The color scheme to use for the node
+labels. Colors are assigned automatically (consequitevely) to the
+different labels returned by the Cypher query.
+
+|Node Label Color |Text |black |The color of the labels drawn on the
+nodes.
+
+|Node Label Font Size |Number |3.5 |Size of the labels drawn on the
+nodes.
+
+|Node Size |Number |2 |Default size of a node in the graph
+visualization. This size is applied if no custom size styling is defined
+and no Rule-Based styling is active.
+
+|Node Size Property |Text |size |Optionally, the name of the node
+property to map to the node size. This lets you define sizes on a
+node-specific level, if you have a property that directly maps to the
+numeric size value.
+
+|Node Color Property |Text |color |Optionally, the name of the node
+property to map to the node color. This lets you define colors on a
+node-specific level, if you have a property that directly maps to the
+HTML color value.
+
+|Relationship Color |Text |#a0a0a0 |The color used for drawing the
+relationship arrows in the visualization.
+
+|Relationship Width |Text |1 |The (default) width of the relationship
+arrows in the visualization.
+
+|Relationship Label Color |Text |#a0a0a0 |The color of the labels
+(relationship type) drawn next to the relationship arrows.
+
+|Relationship Label Font Size |Text |2.75 |The font size of the labels
+(relationship type) drawn next to the relationship arrows.
+
+|Relationship Color Property |Text |color |Optionally, the name of the
+relationship property to map to the arrow color. This lets you define
+colors on a relationship-specific level, if you have a property that
+directly maps to the HTML color value.
+
+|Relationship Width Property |Text |width |Optionally, the name of the
+relationship property to map to the arrow width. This lets you define
+widths on a relationship-specific level, if you have a property that
+directly maps to the width value.
+
+|Animated Particles on Relationships |on/off |off |If enabled, draw
+relationships with animated particles on them, moving in the direction
+of the relationship.
+
+|Arrow head size |Number |3 |Use this to set the length of the arrow head, size is adjusted automatically.
+If 0, no arrow will be drawn.
+
+|Background Color |Text |#fafafa |The background color of the
+visualization.
+
+|Layout (experimental) |List |force-directed |tree-top-down |tree-bottom-up |tree-left-right |tree-right-left |radial | Use this to switch from
+the main (force-directed) layout to one of the experimental layouts
+(tree, radial). For the experimental layouts, make sure
+your graph is a DAG (directed acyclic graph).
+
+| Graph Depth Separation | Number | 30 | Specify the level distance for the tree layout. 
+This setting controls the separation between different levels in the tree hierarchy. Adjusting this value impacts the overall spacing of the tree layout in your graph visualization.
+
+|Enable graph exploration |on/off |on |Enables basic exploration functionality for the graph. Exploration can be done by right clicking on a node, and choosing 'Expand' to choose a type to traverse. Data is retrieved real-time and not cached in the visualization.
+
+|Enable graph editing |on/off |off |Enables editing of nodes and relationships in the graph from the right-click context menu. In addition, lets users create new relationships with existing types/property keys as present in the database.
+
+|Show pop-up on Hover |on/off |on |if enabled, shows a pop-up when a
+user hovers over one of the nodes/relationships in the visualization.
+The pop-up contains the label and properties of the node/relationship.
+
+|Show properties on Click |on/off |on |if enabled, opens up a window
+when a user clicks on one of the nodes/relationships in the
+visualization. The window contains the label and properties of the
+node/relationship.
+
+|Drilldown Link |Text (URL) |(no value) |Specifying a URL here will
+display a floating button on the top right of the visualization. This
+button can be used to drilldown into a different tool (e.g. Bloom) so
+that the graph can be explored further. Dynamic Dashboard Parameters
+(e.g. $neodash_person_name) can be used in these links as well.
+
+|Hide Selections |on/off |off |If enabled, hides the property selector
+(footer of the visualization).
+
+|Override no data message |Text |Query returned no data. |Override the message displayed to the user when their query returns no data.
+
+|Auto-run query |on/off |on |when activated automatically runs the query
+when the report is displayed. When set to `off', the query is displayed
+and will need to be executed manually.
+|Report Description |markdown text | | When specified, adds another button the report header that opens a pop-up. This pop-up contains the rendered markdown from this setting. 
+|===
+
+== Rule-Based Styling
+
+Using the link:../#_rule_based_styling[Rule-Based Styling] menu, the
+following style rules can be applied to the graph: 
+
+- The background color of a node. 
+- The label color of a node.
@@ -93,6 +93,7 @@ pages:
 - link:bar-chart[Bar Chart]
 - link:pie-chart[Pie Chart] 
 - link:line-chart[Line Chart] 
+- link:graph3d[3D Graph]
 - link:sunburst[Sunburst]
 - link:circle-packing[Circle Packing] 
 - link:treemap[Treemap]
 
@@ -1,11 +1,7 @@
 {
   "compilerOptions": {
     "target": "es5",
-    "lib": [
-      "dom",
-      "dom.iterable",
-      "esnext"
-    ],
+    "lib": ["dom", "dom.iterable", "esnext"],
     "allowJs": true,
     "skipLibCheck": true,
     "esModuleInterop": true,
@@ -20,7 +16,5 @@
     "noEmit": true,
     "jsx": "react-jsx"
   },
-  "include": [
-    "src"
-  ],
+  "include": ["src"]
 }
@@ -1,6 +1,6 @@
 {
   "name": "neodash",
-  "version": "2.4.1",
+  "version": "2.4.2",
   "description": "NeoDash - Neo4j Dashboard Builder",
   "neo4jDesktop": {
     "apiVersion": "^1.2.0"
@@ -81,6 +81,7 @@
     "react-cool-dimensions": "^2.0.7",
     "react-dom": "^17.0.2",
     "react-force-graph-2d": "^1.23.8",
+    "react-force-graph-3d": "^1.24.1",
     "react-gauge-chart": "^0.4.1",
     "react-grid-layout": "^1.3.4",
     "react-leaflet": "^3.2.5",
@@ -97,6 +98,8 @@
     "remark-gfm": "^3.0.1",
     "reselect": "^4.1.8",
     "tailwindcss": "^3.3.2",
+    "three": "^0.159.0",
+    "three-spritetext": "^1.8.1",
     "use-neo4j": "^0.3.13",
     "yaml": "^2.2.1"
   },
 
@@ -95,7 +95,8 @@
 }
 
 .react-resizable-handle {
-  bottom: 1px !important;
+  bottom: 4px !important;
+  right: -2px !important;
   opacity: 0.5;
   color: rgb(222, 222, 222);
 }
@@ -165,7 +166,7 @@
   white-space: pre;
   background-position: 0px -11px;
   padding-right: 0px !important;
-  margin-top: 0px !important;
+  margin-top: 0px;
   padding-left: 30px;
   padding-top: 0px !important;
   padding-bottom: 0px !important;
@@ -216,7 +217,7 @@
 }
 
 .card-view .MuiTablePagination-root {
-  margin-top: -40px;
+  margin-top: 0px;
 
 }
 
@@ -253,3 +254,7 @@
   display: none;
 }
 /* End Gantt chart workaround */
+
+.markdown-widget a {
+  text-decoration: underline;
+}
@@ -1,20 +1,11 @@
-## NeoDash 2.4.1
-This is a patch release following 2.4.0. It contains several new features for self-hosted (standalone) NeoDash deployments, as well as a variety of UX improvements for dashboard editors.
-
-
-Included:
-- Improvements to customizability of the bar chart (styling, legend customization, report actions). [#689](https://github.com/neo4j-labs/neodash/pull/689)
-- Improved dashboard settings interface, fixed alignment for table download button. [#729](https://github.com/neo4j-labs/neodash/pull/729)
-- Adjusted ordering of suggested labels/properties for parameter selectors. [#728](https://github.com/neo4j-labs/neodash/pull/728)
-- Better handling of date parameters when saving/loading dashboards. [#727](https://github.com/neo4j-labs/neodash/pull/727)
-- Fixed incorrect z-index issue for form creation modals. [#726](https://github.com/neo4j-labs/neodash/pull/726)
-- Adjusted filtering tooltip on tables to avoid hiding result data. [#712](https://github.com/neo4j-labs/neodash/pull/712)
-- Fixed uncontrolled component issue for dashboard import modal. [#711](https://github.com/neo4j-labs/neodash/pull/711)
-- Adjusted font color of graph context popups to use theme colors. [#699](https://github.com/neo4j-labs/neodash/pull/699)
-- Adjust sidebar database selector to only show active databases. [#698](https://github.com/neo4j-labs/neodash/pull/698)
-- Incorporated logging functionality for self-hosted NeoDash deployments. [#705](https://github.com/neo4j-labs/neodash/pull/705)
-- Improved dashboard management in standalone-mode deployments. [#705](https://github.com/neo4j-labs/neodash/pull/705)
-- Added Docker parameter for overriding the app's logo & custom header.  [#705](https://github.com/neo4j-labs/neodash/pull/705)
-- Changed the dashboard 'save' action to a logical merge, rather than a delete + create, allowing to persist labels across saves. [#705](https://github.com/neo4j-labs/neodash/pull/705)
-- Docker: Updated Alpine base image to mitigate CVE-2023-38039 & CVE-2023-4863. [#705](https://github.com/neo4j-labs/neodash/pull/705)
+## NeoDash 2.4.2
+This is a release with a large amount of quality of life improvements, as well as some new features:
 
+- Visualize graphs in 3D with the new 3D graph report. [#737](https://github.com/neo4j-labs/neodash/pull/737)
+- Improved dashboard management sidebar and handling of drafts. [#734](https://github.com/neo4j-labs/neodash/pull/734)
+- Added parameter select setting for autopopulating first selector value. [#746](https://github.com/neo4j-labs/neodash/pull/746)
+- Improved UX for editing page names & dashboard titles. [#743](https://github.com/neo4j-labs/neodash/pull/743)
+- Unified common settings for each report type. [#724](https://github.com/neo4j-labs/neodash/pull/724)
+- Title of the browser tab NeoDash runs on is now automatically set to the dashboard name.  [#708](https://github.com/neo4j-labs/neodash/pull/708)
+- Fixed issue where invisible table columns were not handled correctly. [#695](https://github.com/neo4j-labs/neodash/pull/695)
+- Miscellaneous bug fixes, style improvements & stability fixes. [#744](https://github.com/neo4j-labs/neodash/pull/744)
@@ -150,6 +150,7 @@ export const setStandaloneEnabled = (
   standaloneDashboardURL: string,
   standaloneUsername: string,
   standalonePassword: string,
+  standalonePasswordWarningHidden: boolean,
   standaloneAllowLoad: boolean,
   standaloneLoadFromOtherDatabases: boolean,
   standaloneMultiDatabase: boolean,
@@ -167,6 +168,7 @@ export const setStandaloneEnabled = (
     standaloneDashboardURL,
     standaloneUsername,
     standalonePassword,
+    standalonePasswordWarningHidden,
     standaloneAllowLoad,
     standaloneLoadFromOtherDatabases,
     standaloneMultiDatabase,
 
@@ -195,6 +195,7 @@ export const applicationReducer = (state = initialState, action: { type: any; pa
         standaloneDashboardURL,
         standaloneUsername,
         standalonePassword,
+        standalonePasswordWarningHidden,
         standaloneAllowLoad,
         standaloneLoadFromOtherDatabases,
         standaloneMultiDatabase,
@@ -211,6 +212,7 @@ export const applicationReducer = (state = initialState, action: { type: any; pa
         standaloneDashboardURL: standaloneDashboardURL,
         standaloneUsername: standaloneUsername,
         standalonePassword: standalonePassword,
+        standalonePasswordWarningHidden: standalonePasswordWarningHidden,
         standaloneAllowLoad: standaloneAllowLoad,
         standaloneLoadFromOtherDatabases: standaloneLoadFromOtherDatabases,
         standaloneMultiDatabase: standaloneMultiDatabase,
 
@@ -94,6 +94,7 @@ export const applicationGetStandaloneSettings = (state: any) => {
     standaloneDashboardURL: state.application.standaloneDashboardURL,
     standaloneUsername: state.application.standaloneUsername,
     standalonePassword: state.application.standalonePassword,
+    standalonePasswordWarningHidden: state.application.standalonePasswordWarningHidden,
     standaloneAllowLoad: state.application.standaloneAllowLoad,
     standaloneLoadFromOtherDatabases: state.application.standaloneLoadFromOtherDatabases,
     standaloneMultiDatabase: state.application.standaloneMultiDatabase,
Original file line number	Diff line number	Diff line change
`@@ -95,7 +95,8 @@`
`95`	`95`	`}`
`96`	`96`
`97`	`97`	`.react-resizable-handle {`
`98`		`- bottom: 1px !important;`
	`98`	`+ bottom: 4px !important;`
	`99`	`+ right: -2px !important;`
`99`	`100`	`opacity: 0.5;`
`100`	`101`	`color: rgb(222, 222, 222);`
`101`	`102`	`}`
`@@ -165,7 +166,7 @@`
`165`	`166`	`white-space: pre;`
`166`	`167`	`background-position: 0px -11px;`
`167`	`168`	`padding-right: 0px !important;`
`168`		`- margin-top: 0px !important;`
	`169`	`+ margin-top: 0px;`
`169`	`170`	`padding-left: 30px;`
`170`	`171`	`padding-top: 0px !important;`
`171`	`172`	`padding-bottom: 0px !important;`
`@@ -216,7 +217,7 @@`
`216`	`217`	`}`
`217`	`218`
`218`	`219`	`.card-view .MuiTablePagination-root {`
`219`		`- margin-top: -40px;`
	`220`	`+ margin-top: 0px;`
`220`	`221`
`221`	`222`	`}`
`222`	`223`
`@@ -253,3 +254,7 @@`
`253`	`254`	`display: none;`
`254`	`255`	`}`
`255`	`256`	`/* End Gantt chart workaround */`
	`257`	`+`
	`258`	`+.markdown-widget a {`
	`259`	`+ text-decoration: underline;`
	`260`	`+}`