magento#4

goivvy-team · goivvy-team · commit b6fb4e86ef21 · 2020-05-08T21:41:33.000Z
diff --git a/src/guides/v2.3/extension-dev-guide/admin-grid.md b/src/guides/v2.3/extension-dev-guide/admin-grid.md
@@ -12,14 +12,75 @@ The Admin grids are used to represent, filter and sort various data in Magento b
 In this tutorial we will show you how to create a simple admin grid.
 
 
-### 1. Create a module
+### 1. Create a backbone module
 
 
-Everything starts with a module. First choose your namespace (we will be using Goivvy_Grid):
+Everything starts with a module. First choose your namespace (we will be using Dev_Grid):
 
 
 ```console
-mkdir -p app/code/Goivvy/Grid/etc
+mkdir -p app/code/Dev/Grid/etc
 ```
 
+Here are required files to get started:
 
+
+`app/code/Dev/Grid/etc/module.xml`:
+
+```xml
+<?xml version="1.0"?>
+<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:Module/etc/module.xsd">
+ <module name="Dev_Grid" setup_version="1.0.0">
+  <sequence>
+   <module name="Magento_Backend"/>
+   <module name="Magento_Ui"/>
+  </sequence>
+ </module>
+</config>
+```
+
+`app/code/Dev/Grid/registration.php`:
+
+```php
+<?php
+\Magento\Framework\Component\ComponentRegistrar::register(
+   \Magento\Framework\Component\ComponentRegistrar::MODULE,
+   'Dev_Grid',
+   __DIR__
+);
+```
+
+`app/code/Goivvy/Grid/etc/adminhtml/routes.xml`:
+
+```xml
+<?xml version="1.0"?>
+<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:App/etc/routes.xsd">
+    <router id="admin">
+        <route id="dev_grid" frontName="dev_grid">
+            <module name="Dev_Grid" before="Magento_Backend" />
+        </route>
+    </router>
+</config>
+```
+
+
+### 2. Define an admin grid
+
+
+The grid will display a list of available categories.
+
+
+The page layout file `app/code/Dev/Grid/view/adminhtml/layout/dev_grid_index.xml`:
+
+```xml
+<?xml version="1.0"?>
+<page xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:View/Layout/etc/page_configuration.xsd">
+    <body>
+        <referenceContainer name="content">
+            <uiComponent name="dev_grid_category_listing"/>
+        </referenceContainer>
+    </body>
+</page>
+```
+
+UiComponent `dev_grid_category_listing` has to be defined separately in a file with the same name 
