Merge pull request #5912 from stokito/example
authorJo-Philipp Wich <jo@mein.io>
Thu, 13 Oct 2022 11:50:37 +0000 (13:50 +0200)
committerGitHub <noreply@github.com>
Thu, 13 Oct 2022 11:50:37 +0000 (13:50 +0200)
luci-app-example: improve description

applications/luci-app-example/README.md
applications/luci-app-example/root/usr/share/rpcd/acl.d/luci-app-example.json

index 379bb7e032b4e0b598f0ba8ec840848ce613127c..23a3a3a1799c55bd3bcb92954bc1ad1e6ff23664 100644 (file)
@@ -2,10 +2,24 @@
 
 This app is meant to be a kind of template, example or starting point for developing new luci apps.
 
-It provides two pages in the admin backend. One is based on a view with a form and makes use of internal models. The other one uses the `E()`-method to create more flexibel pages.
+It provides two pages in the admin backend:
+* [htmlview.js](./htdocs/luci-static/resources/view/example/htmlview.js) is based on a view with a form and makes use of internal models.
+* [form.js](./htdocs/luci-static/resources/view/example/form.js) uses the `E()` method to create more flexible pages.
 
 The view based page is used to modify the example configuration.
 
 The html view page just shows the configured values.
 
 The configuration is stored in `/etc/config/example`.
+The file must exist and created on device boot by UCI defaults script in `/root/etc/uci-defaults/80_example`.
+More details about the UCI defaults https://openwrt.org/docs/guide-developer/uci-defaults
+
+To install the luci-app-example to your OpenWrt instance use:
+```
+scp -r root/* root@192.168.1.1:/
+scp -r htdocs/* root@192.168.1.1:/www/
+# execute the UCI defaults script to create the /etc/config/example
+ssh root@192.168.1.1 "sh /etc/uci-defaults/80_example"
+```
+
+Then you need to re-login to LUCI and you'll see a new Example item in main menu.
index 998cb4b0e1378cca1cab351974c3a0e80fa0ef14..136f9aed555cac82994a63199fc85736d35044f0 100644 (file)
@@ -1,6 +1,6 @@
 {
   "luci-app-example": {
-    "description": "Grant UCI access to LuCI app ecample",
+    "description": "Grant UCI access to LuCI app example",
     "read": {
       "ubus": {
         "uci": [