From 2f02ac6858daa09427ea16f2849d9b1fbfe17d3f Mon Sep 17 00:00:00 2001 From: beromir <45039929+beromir@users.noreply.github.com> Date: Wed, 6 Oct 2021 00:31:45 +0200 Subject: [PATCH 1/2] [DOCS] Update the README.md. --- README.md | 59 ++++++++++++++++++++++++++++++++++++++++--------------- 1 file changed, 43 insertions(+), 16 deletions(-) diff --git a/README.md b/README.md index 9a3f66b..3d21a78 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# Ray Package for Neos CMS +# Ray Helper for Neos CMS Debug your Neos site with the Ray app. Ray is a debugger app from Spatie. You can find more information about Ray on https://myray.app/. @@ -13,7 +13,7 @@ Then run `composer update` in your project root. ## Requirements You need to have the Ray app installed and a valid license. -You can download the app here: https://myray.app. +You can download the app here: https://spatie.be/docs/ray/v1/the-ray-desktop-app/download-the-free-demo. ## Configuration Create the configuration file `ray.php` in your Neos site root directory. @@ -21,17 +21,46 @@ Configuration options: https://spatie.be/docs/ray/v1/configuration/framework-agn Configuration options when you use Docker: https://spatie.be/docs/ray/v1/environment-specific-configuration/docker. ## Usage +You can use all Ray functions from https://spatie.be/docs/ray/v1/usage/framework-agnostic-php-project. +Reference list (just the PHP specific functions): https://spatie.be/docs/ray/v1/usage/reference. + +To use the functions, you must add them as key-value pairs in Fusion. +If the function does not require any parameters, you can use `null`, `false` or an empty string as the value. +To pass parameters, add them as a value. + +```html +valueToDebug = 'Show this text in the Ray app.' +valueToDebug.@process.debug = Beromir.Ray:Debug { + // Show a label in the Ray app + label = 'Text' + // Colorize the output + red = '' + // Show the output as large text + large = '' +} +``` + +```html +valueToDebug = 'Show this text in the Ray app.' +valueToDebug.@process.debug = Beromir.Ray:Debug { + // Show a label in the Ray app + label = 'Text' + // Only send a payload once when in a loop + once = ${node} +} +``` + **Debug a Fusion expression:** ```html valueToDebug = 'Show this text in the Ray app.' -valueToDebug.@process.debug = Beromir.Ray:Ray +valueToDebug.@process.debug = Beromir.Ray:Debug ``` Alternative ways: ```html // Debug the current node -debug = Beromir.Ray:Ray { - debugValues = ${node} +debug = Beromir.Ray:Debug { + value = ${node} } renderer = afx` @@ -41,15 +70,15 @@ renderer = afx` ```html renderer = afx` - + ` ``` **Debug multiple values:** ```html -debug = Beromir.Ray:Ray { +debug = Beromir.Ray:Debug { // Pass the values as an array - debugValues = ${[node, site]} + value = ${[node, site]} } renderer = afx` @@ -57,11 +86,11 @@ renderer = afx` ` ``` -**Use Debug Actions:** +**Use Debug Actions to debug NodeTypes:** ```html // Display the NodeType name of the node -debug = Beromir.Ray:Ray { - debugValues = ${node} +debug = Beromir.Ray:Debug { + value = ${node} debugAction = 'nodeTypeName' } @@ -72,8 +101,8 @@ renderer = afx` ```html // Display the properties of the current node and the site node -debug = Beromir.Ray:Ray { - debugValues = ${[node, site]} +debug = Beromir.Ray:Debug { + value = ${[node, site]} debugAction = 'properties' } @@ -82,12 +111,10 @@ renderer = afx` ` ``` -You can use the following Debug Actions: +You can use the following Debug Actions for NodeTypes: | Debug Action| Description | | --- | --- | -| `phpInfo` | Display PHP info | -| `backtrace` | Display entire backtrace | | `nodeTypeName` | Display the NodeType name of a node | | `context` | Display the context of a node | | `contextPath` | Display the context path of a node | From df466fdfc11e8f3867ce7d4bc22ef4047d9419e5 Mon Sep 17 00:00:00 2001 From: beromir <45039929+beromir@users.noreply.github.com> Date: Wed, 6 Oct 2021 02:49:50 +0200 Subject: [PATCH 2/2] [DOCS] Correct an error in the code snippet --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 3d21a78..c5f89f6 100644 --- a/README.md +++ b/README.md @@ -70,7 +70,7 @@ renderer = afx` ```html renderer = afx` - + ` ```